Looker

O Looker, uma plataforma de business intelligence e análise de big data, permite que você explore, analise e compartilhe análises de negócios em tempo real de forma integrada.

A integração entre a Braze e o Looker permite que os usuários da empresa aproveitem a sinalização de usuários dos blocos do Looker e do Looker Actions por meio da REST API. Esses usuários sinalizados podem ser adicionados a segmentos para direcionar futuras Campaigns ou Canvas da 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

Considerações

• Esse processo só funciona com dados que não tenham sido pivotados.
• A API processa um máximo de 100.000 linhas por vez.
• A contagem final da sinalização 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 da 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 da 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 engajamento com mensagem
• README do bloco de análise de comportamento do usuário

Ambas as integrações pressupõem que sua integração inicial da Braze, bem como 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 na Braze por meio do endpoint da REST API a partir de um Looker Look. As ações exigem que uma dimensão seja marcada 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 de dimensões e confirme as alterações. A tag braze_id é usada para determinar qual campo é a chave exclusiva.

dimension: external_id {
    type: string
    primary_key: yes
    sql: ${TABLE}.external_id ;;
    tags: ["braze_id"]
}

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

Etapa 3: Definir atributos 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 atributos diferenciam maiúsculas de minúsculas.
• Os atributos padrão também podem ser definidos, desde que correspondam exatamente aos nomes do 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 do 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….
2. Selecione a ação personalizada da Braze.
3. Em Unique Key, 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, LOOKER_EXPORT será usado.
5. Em Advanced Options, selecione Results in Table ou All Results e, em seguida, Send.
   
   
   
   Se a exportação tiver sido enviada corretamente, 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, 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"] }
      },
      .....
   ]
}

Segmentar usuários na Braze

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

Depois de salvo, você pode fazer referência a esse segmento durante a criação de Canvas ou Campaign na etapa de direcionamento de usuários.

Solução de problemas

Se estiver tendo problemas com o Looker Actions, adicione um usuário teste aos grupos internos e verifique o seguinte:

• 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 está 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 pivotados.
• A chave exclusiva foi selecionada corretamente. Normalmente, o external_id.
• O braze_id na dimensão é diferente do braze_id na API. O braze_id na dimensão é usado para indicar que é o campo id para a API da Braze. Para a maioria das finalidades, o external_id é a chave primária no ato do envio.
• O usuário external_id existe na plataforma Braze.
• O campo looker_export está 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.