Looker

Looker, una plataforma de análisis de inteligencia empresarial y big data, te permite explorar, analizar y compartir análisis empresariales en tiempo real fácilmente.

La integración de Braze y Looker permite a los usuarios de la empresa aprovechar los bloques de Looker de origen y las acciones de Looker para marcar usuarios a través de la REST API. Estos usuarios marcados pueden añadirse a segmentos para segmentar futuras Campaigns o Canvas de Braze. Para utilizar Looker con Braze, te recomendamos que envíes tus datos de Braze a un almacén de datos utilizando Braze Currents y que después utilices los bloques de Looker de Braze para modelar y visualizar rápidamente tus datos de Braze en Looker.

Requisitos previos

Consideraciones

• Este proceso solo funciona con datos que no hayan sido pivotados.
• La API procesa un máximo de 100.000 filas a la vez.
• El recuento final de la marca de un usuario puede ser inferior debido a duplicados o no usuarios.

Integración

Bloques de Looker

Nuestros bloques de Looker ayudan a los clientes de Braze a acceder rápidamente a una vista de los datos granulares que ofrecemos a través de Currents. Nuestros bloques proporcionan visualizaciones y modelos prediseñados para los datos de Currents, de modo que los clientes de Braze puedan implementar fácilmente patrones analíticos como la retención, evaluar la capacidad de entrega de mensajes, echar un vistazo más detallado al comportamiento del usuario y mucho más.

Para implementar los bloques de Looker, sigue las instrucciones de los archivos README del código de GitHub.

• README del bloque de análisis de interacción de mensajes
• README del bloque de análisis del comportamiento del usuario

Ambas integraciones suponen que tu integración inicial de Braze, así como tu integración de Braze con un almacén de datos compatible con Looker, están configuradas adecuadamente para capturar y enviar los datos necesarios.

Importante

Braze ha construido nuestros bloques de Looker utilizando Snowflake como almacén de datos. Aunque nuestro objetivo es que nuestros bloques funcionen con el mayor número posible de almacenes de datos, algunas funciones SQL pueden diferir en disponibilidad, sintaxis o comportamiento entre dialectos.

Advertencia

¡Ten en cuenta las diferentes convenciones de nomenclatura! Los nombres personalizados pueden causar incongruencias en los datos, a menos que cambies todos los nombres correspondientes. Si has personalizado algún nombre de vista/tabla o modelo, renombra cada uno de ellos en el LookML con el nombre que hayas seleccionado.

Bloques disponibles

Acciones de Looker

Las acciones de Looker te permiten marcar usuarios dentro de Braze a través del punto de conexión de la REST API desde un Look de Looker. Las acciones requieren que una dimensión esté etiquetada con braze_id. La acción añadirá el valor marcado al atributo personalizado looker_export del usuario.

Importante

Solo se marcarán los usuarios existentes. No puedes utilizar Looks pivotados al marcar datos en Braze.

Paso 1: Configurar una acción Braze Looker

Configura una acción Braze Looker con tu clave de API REST de Braze y tu punto de conexión REST.

Paso 2: Configurar Looker Develop

Dentro de Looker Develop, selecciona las vistas adecuadas. Añade braze_id a la etiqueta de dimensiones y confirma los cambios. Esta etiqueta braze_id se utiliza para determinar qué campo es la clave única.

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

Asegúrate de confirmar los cambios. Las acciones de Looker solo funcionarán con la configuración de producción.

Paso 3: Establecer atributos de usuario en etiquetas

Opcionalmente, se puede establecer cualquier atributo utilizando una etiqueta braze[] con el nombre del atributo entre corchetes. Por ejemplo, si quisieras que se enviara un atributo personalizado user_segment, la etiqueta sería braze[user_segment].

Ten en cuenta las siguientes limitaciones:

• Los atributos solo se enviarán si se incluyen como campo dentro del Look.
• Los tipos admitidos son Strings, Boolean, Numbers y Dates.
• Los nombres de los atributos distinguen entre mayúsculas y minúsculas.
• También se pueden establecer atributos estándar, siempre que coincidan exactamente con los nombres de perfil de usuario estándar.
• La etiqueta completa debe ir entre comillas. Por ejemplo, tags: ["braze[first_name]"]. También se pueden asignar otras etiquetas, pero se ignorarán.
• Puedes encontrar información adicional en GitHub.

Paso 4: Enviar la acción Looker

1. Dentro de un Look con una dimensión braze_id seleccionada, haz clic en el engranaje de configuración ( ) en la parte superior derecha y selecciona Send….
2. Selecciona la acción Braze personalizada.
3. En Unique Key, proporciona la clave de mapeado de usuario principal para la cuenta de Braze (external_id o braze_id).
4. Dale un nombre a la exportación. Si no se indica ninguno, se utilizará LOOKER_EXPORT.
5. En Advanced Options, selecciona Results in Table o All Results y, a continuación, Send.
   
   
   
   Si la exportación se envió correctamente, LOOKER_EXPORT debería aparecer en el perfil del usuario como un atributo personalizado con el valor que introdujiste en la acción.
   
   

Ejemplo de API saliente

A continuación se muestra un ejemplo de llamada saliente a la API, que se enviará al punto de conexión /users/track/.

Encabezado

1
Authorization: Bearer [API_KEY]

Cuerpo

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 usuarios en Braze

En Braze, para crear un segmento de estos usuarios marcados, ve a Segments en Engagement, asigna un nombre a tu segmento y selecciona Looker_Export como filtro. A continuación, utiliza la opción “includes value” y proporciona la marca del atributo personalizado que asignaste en Looker.

Una vez guardado, puedes hacer referencia a este segmento durante la creación de Canvas o Campaigns en el paso de segmentación de usuarios.

Solución de problemas

Si tienes problemas con la acción Looker, añade un usuario de prueba a los grupos internos y comprueba lo siguiente:

• La clave de API tiene los permisos users.track.
• Se introduce el punto de conexión REST correcto, como https://rest.iad-01.braze.com.
• Se establece una etiqueta braze_id en la vista de dimensión.
• Tu consulta incluye la dimensión o atributo ID como columna.
• Los resultados de Looker no están pivotados.
• La clave única está correctamente seleccionada. Por lo general, external_id.
• braze_id en la dimensión es diferente de braze_id en la API. braze_id en la dimensión se utiliza para indicar que es el campo id para la API de Braze. Para la mayoría de los propósitos, al enviar, external_id es la clave primaria.
• El usuario external_id existe en la plataforma Braze.
• El campo looker_export está configurado como Automatically Detect en Braze Platform > Settings > Manage Settings > Custom Attributes.
• Los cambios se confirman en producción. Las acciones de Looker funcionan con la configuración de producción.