![Curso do Braze Learning] (/docs/pt-br/assets/img/bl_icon3.png?90e224bc203230fce2ea8b5e0093b685)Looker

A Looker, uma plataforma de análise de dados e análises de big data, o capacita a explorar, analisar e compartilhar análises de business intelligence em tempo real sem problemas.

A integração entre o Braze e o Looker permite que os usuários do Braze aproveitem a sinalização de usuários dos blocos do Looker e do Looker Actions por meio da API REST. Esses usuários sinalizados podem ser adicionados a segmentos para direcionamento de futuras campanhas ou canvas do Braze. Para usar o Looker com a Braze, recomendamos enviar seus dados da Braze para um data warehouse usando o Braze Currents e, em seguida, usar os blocos do Looker da Braze para modelar e visualizar rapidamente seus dados da Braze no Looker.

Pré-requisitos

Limitações

• O processo só funciona com dados que não tenham sido dinamizados.
• A API processa um máximo de 100.000 linhas por vez.
• A contagem final da bandeira de um usuário pode ser menor devido a duplicatas ou não usuários.

Integração

Blocos do Looker

Nossos blocos do Looker ajudam os clientes do Braze a acessar rapidamente uma visão dos dados granulares que oferecemos via Currents. Nossos blocos fornecem visualizações e modelagens pré-fabricadas para os dados do Currents, de modo que os clientes do Braze possam implementar facilmente padrões analíticos, como retenção, avaliar a entregabilidade das mensagens, analisar mais detalhadamente o comportamento dos usuários e muito mais.

Para implementar os blocos do Looker, siga as instruções nos arquivos README do código do GitHub.

• README do bloco de análise de dados de engajamento com mensagem
• README do bloco de análise de dados de comportamento do usuário

Ambas as integrações pressupõem que sua integração inicial da Braze e sua integração da Braze com um data warehouse compatível com o Looker estejam configuradas adequadamente para capturar e enviar os dados necessários.

Blocos disponíveis

Looker Actions

As Looker Actions permitem que você sinalize usuários no Braze por meio do endpoint da API REST de um Looker Look. As ações exigem que uma dimensão seja marcada com tags com braze_id. A ação anexará o valor sinalizado ao atributo personalizado looker_export do usuário.

Etapa 1: configurar uma ação do Looker da Braze

Configure uma ação do Looker da Braze com sua chave da API REST e o endpoint REST da Braze.

Etapa 2: Configurar o Looker Develop

No Looker Develop, selecione as visualizações apropriadas. Adicione braze_id à tag dimensions e confirme as alterações. A tag braze_id é usada para determinar qual campo é a chave exclusiva.

1
2
3
4
5
6
dimension: external_id {
    type: string
    primary_key: yes
    sql: ${TABLE}.external_id ;;
    tags: ["braze_id"]
}

Certifique-se de confirmar as alterações. A ação do Looker só funciona em configurações de produção.

Etapa 3: Defina as atribuições do usuário nas tags

Opcionalmente, qualquer atributo pode ser definido usando uma tag braze[] com o nome do atributo entre colchetes. Por exemplo, se você quisesse que um atributo personalizado user_segment fosse enviado, a tag seria braze[user_segment].

Observe as seguintes limitações:

• Os atributos só serão enviados se forem incluídos como campo no look.
• Os tipos suportados são Strings, Boolean, Numbers e Dates.
• Os nomes de atribuições diferenciam maiúsculas de minúsculas.
• As atribuições padrão também podem ser definidas, desde que correspondam exatamente aos nomes de perfil de usuário padrão.
• A tag completa deve ser formatada entre aspas. Por exemplo, tags: ["braze[first_name]"]. Outras tags também podem ser atribuídas, mas serão ignoradas.
• Informações adicionais podem ser encontradas no GitHub.

Etapa 4: Enviar a ação Looker

1. Em um Look com uma dimensão braze_id selecionada, clique na engrenagem de configurações () no canto superior direito e selecione Send… (Enviar…).
2. Selecione a ação personalizada da Braze.
3. Em Unique Key (Chave única), forneça a chave de mapeamento do usuário primário para a conta Braze (external_id ou braze_id).
4. Dê um nome à exportação. Se nenhum for fornecido, será usado o endereço LOOKER_EXPORT.
5. Em Advanced Options (Opções avançadas), selecione Results in Table (Resultados na tabela ) ou All Results (Todos os resultados ) e, em seguida, Send (Enviar).
   
   
   
   Se a exportação tiver sido enviada corretamente, o endereço LOOKER_EXPORT deverá aparecer no perfil do usuário como um atributo personalizado com o valor inserido na ação.
   
   

Exemplo de API de saída

A seguir, confira um exemplo de uma chamada de API de saída, que será enviada para o endpoint/users/track/.

Cabeçalho

1
Authorization: Bearer [API_KEY]

Corpo

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
   "attributes" : [
      {
        "external_id" : "user_01",
        "_update_existing_only" : true,
        "looker_export" : { "add" : ["LOOKER"] }
      },
      {
        "external_id" : "user_02",
        "_update_existing_only" : true,
        "looker_export" : { "add" : ["LOOKER"] }
      },
      {
        "external_id" : "user_03",
        "_update_existing_only" : true,
        "looker_export" : { "add" : ["LOOKER"] }
      },
      .....
   ]
}

Usuários do segmento no Braze

No Braze, para criar um segmento desses usuários sinalizados, navegue até Segments (Segmentos ) em Engagement (Engajamento), nomeie seu segmento e selecione Looker_Export como o filtro. Em seguida, use a opção “includes value” (inclui valor) e forneça o sinalizador de atributo personalizado que você atribuiu no Looker.

Depois de salvo, você pode referenciar este segmento durante a criação da canva ou campanha na etapa de direcionamento de usuários.

Solução de problemas

Se estiver tendo problemas com as ações do Looker, adicione um usuário teste a internal groups e verifique se os itens a seguir estão corretos:

• A chave de API tem as permissões users.track.
• O endpoint REST correto foi inserido, como https://rest.iad-01.braze.com.
• Uma tag braze_id é definida na visualização da dimensão.
• Sua consulta inclui a dimensão ou atributo Id como uma coluna.
• Os resultados do Looker não são dinamizados.
• A chave exclusiva foi selecionada corretamente. Normalmente, o external_id.
• braze_id na dimensão é diferente do braze_id na API. braze_id na dimensão é usado para indicar que é o campo id para a API do Braze. Para a maioria das finalidades, external_id é a chave primária no ato do envio.
• O usuário external_id existe na plataforma Braze.
• O campo looker_export é definido como Automatically Detect em Braze Platform > Settings > Manage Settings > Custom Attributes.
• As alterações são confirmadas para a produção. O Looker Actions funciona em configurações de produção.