DocumentaciónExperience PlatformEtiquetas

Extensión de reenvío de eventos de Braze Track Events API

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Desarrollador

Braze es una plataforma de participación del cliente que potencia las interacciones centradas en el cliente entre consumidores y marcas en tiempo real. Con Braze, puede hacer lo siguiente:

  • Ofrezca datos (como mensajes de marketing) a los usuarios segmentados en función de sus preferencias de idioma, ubicación, preferencias, etc. para aumentar las tasas de conversión y lograr objetivos comerciales clave.
  • Envíe a los clientes mensajes personalizados en varios canales, incluidos correo electrónico, notificaciones push y mensajes en la aplicación, en el momento adecuado y en sus idiomas preferidos.
  • Oriente a usuarios específicos para campañas promocionales y de marketing a fin de aumentar el número de clientes repetidos.
  • Estudiar el comportamiento y los patrones de los usuarios para dirigirse a audiencias específicas con mensajes personalizados, lo que podría ayudar a aumentar los ingresos.

La extensión Braze Track Events API reenvío de eventos le permite aprovechar los datos capturados en el Edge Network de Adobe Experience Platform y enviarlos a Braze en forma de eventos del lado del servidor mediante la API Braze User Track.

Este documento describe los casos de uso de la extensión, cómo instalarla en las bibliotecas de reenvío de eventos y cómo emplear sus capacidades en una regla de reenvío de eventos.

Casos de uso

Esta extensión debe usarse si desea usar datos del Edge Network en Braze para aprovechar las capacidades de segmentación y análisis de clientes.

Por ejemplo, considere una organización minorista que tenga presencia multicanal (sitio web y móvil) y que capture entradas transaccionales o conversacionales como datos de evento de su sitio web y plataformas móviles. Con varias reglas tag, estos datos se envían al Edge Network en tiempo real. Desde aquí, la extensión de reenvío de eventos Braze envía automáticamente los eventos relevantes a Braze desde el servidor.

Una vez enviados los datos, los equipos de análisis de la organización pueden aprovechar las capacidades de Braze’s para procesar los conjuntos de datos y obtener perspectivas comerciales para generar gráficos, tableros u otras visualizaciones para informar a las partes interesadas empresariales. Consulte la página Braze clientes para obtener más información sobre los distintos casos de uso de la plataforma.

Braze requisitos previos y protecciones prerequisites

Debe tener una cuenta de Braze para poder usar sus tecnologías. Si no tiene una cuenta, vaya a la página de introducción en Braze para conectarse a Braze Sales e iniciar el proceso de creación de cuentas.

Protecciones de API

La extensión usa dos de las API de Braze y sus límites se describen a continuación:

API
Límites de velocidad
User Track
50.000 peticiones por minuto.
Consulte la User Track documentación de la API para obtener detalles.
User Identify
20.000 peticiones por minuto.
Consulte la User Identify documentación de la API para obtener detalles.
NOTE
Consulte la guía de Braze límites de API para obtener más información sobre los límites que imponen.

Puntos de datos facturables

Si envía atributos personalizados adicionales a Braze, podría aumentar su consumo de puntos de datos Braze. Consulte con su administrador de cuentas de Braze antes de enviar atributos personalizados adicionales. Consulte la documentación de Braze sobre puntos de datos facturables para obtener más información.

Recopilar detalles de configuración necesarios configuration-details

Para conectar el Edge Network a Braze, se requieren las siguientes entradas:

Tipo de clave
Descripción
Ejemplo
Instancia de Braze
El extremo REST asociado con la cuenta Braze. Consulte la documentación de Braze en instancias para obtener instrucciones.
https://rest.iad-03.braze.com
Clave de API
La clave de API Braze asociada con la cuenta Braze.
Consulte la documentación de Braze sobre la clave de API de REST para obtener instrucciones.
YOUR-BRAZE-REST-API-KEY

Crear un secreto

Cree un nuevo secreto de reenvío de eventos y establezca el valor en su Braze clave de API. Se utilizará para autenticar la conexión con su cuenta y mantener el valor seguro.

Instalar y configurar la extensión Braze install

Para instalar la extensión, cree una propiedad de reenvío de eventos o elija una propiedad existente para editar en su lugar.

Seleccione Extensiones en el panel de navegación izquierdo. En la ficha Catálogo, seleccione Instalar en la tarjeta de la extensión Braze.

Instalar la extensión Braze.

En la siguiente pantalla, escriba los siguientes valores de configuración que recopiló anteriormente de Braze:

  • URL de extremo REST de Braze: puede escribir el valor de su URL de extremo REST Braze como texto sin formato en la entrada proporcionada.
  • Clave API: Seleccione el elemento de datos secreto que creó anteriormente, que contiene su clave API Braze.

Seleccione Guardar cuando haya terminado.

Página de configuración de la extensión Braze.

Crear una regla Send Event tracking-rule

Después de instalar la extensión, cree una nueva regla de reenvío de eventos rule y configure sus condiciones como desee. Al configurar las acciones de la regla, seleccione la extensión Braze y, a continuación, seleccione Enviar evento para el tipo de acción.

Agregar una configuración de acción de regla de reenvío de eventos.

Identificación de usuario

Entrada
Descripción
ID de usuario externo
UUID o GUID largos, aleatorios y bien distribuidos. Si elige un método diferente para asignar un nombre a los ID de usuario, estos también deben ser largos, aleatorios y estar bien distribuidos. Más información sobre convención de nomenclatura de ID de usuario sugerida.
Identificador de usuario de Braze
Identificador de usuario de Bear.
Alias de usuario
Un alias sirve como identificador de usuario único alternativo. Utilice alias para identificar a usuarios con dimensiones diferentes a las del ID de usuario principal.

: el objeto de alias de usuario consta de dos partes: un alias_name para el propio identificador y un alias_label que indica el tipo de alias. Los usuarios pueden tener varios alias con diferentes etiquetas, pero solo un alias_name por alias_label.
NOTE
Para vincular el evento a un usuario, debe rellenar el campo ID de usuario externo, el campo Identificador de usuario de Bear o la sección Alias de usuario.

Datos de evento

Entrada
Descripción
Requerido
Nombre del evento
Nombre del evento.
Sí
Hora del evento
Fecha-hora como cadena en formato ISO 8601 o yyyy-MM-dd'T'HH:mm:ss:SSSZ.
Sí
Identificador de aplicación
El identificador de la aplicación o app_id es un parámetro que asocia la actividad con una aplicación específica de su grupo de aplicaciones. Designa con qué aplicación del grupo de aplicaciones está interactuando. Más información sobre los tipos de identificadores de API.
Propiedades de evento
Objeto JSON que contiene propiedades personalizadas del evento.
NOTE
La acción Braze Send Event solo requiere que se especifiquen Event Name y Event Time, pero debe incluir la mayor información posible en el campo de propiedades personalizadas. Para obtener más información sobre el objeto de evento Braze, consulte la documentación oficial.

Atributos de usuario

Los atributos de usuario pueden ser un objeto JSON que contenga campos que creen o actualicen un atributo con el nombre y el valor proporcionados en el perfil de usuario especificado. Se admiten las siguientes propiedades:

Atributo de usuario
Descripción
Nombre
Apellidos
Teléfono
Correo electrónico
Sexo
Una de las siguientes cadenas: "M", "F", "O" (otro), "N" (no aplicable), "P" (prefiero no decir).
Ciudad
País
País como cadena en formato ISO-3166-1 alpha-2.
Idioma
Idioma como cadena en formato ISO-639-1.
Fecha de nacimiento
Cadena en formato "AAAA-MM-DD" (por ejemplo, 1980-12-21).
Zona horaria
Nombre de zona horaria de base de datos de zona horaria de IANA (por ejemplo, 'América/Nueva_York' o 'Hora del Este (EE.UU. y Canadá)').
Facebook
Hash que contiene cualquiera de id (cadena), likes (matriz de cadenas), num_friends (entero).
Twitter
Hash que contiene cualquiera de id (entero), screen_name (cadena, identificador de Twitter), followers_count (entero), friends_count (entero), statuses_count(entero).

Crear una regla Send Purchase Event purchase-rule

Después de instalar la extensión, cree una nueva regla de reenvío de eventos rule y configure sus condiciones como desee. Al configurar las acciones de la regla, seleccione la extensión Braze y, a continuación, seleccione Enviar evento de compra para el tipo de acción.

Agregar una configuración de acción de reenvío de eventos de tipo Acción de compra en bloque.

Identificación de usuario

Entrada
Descripción
ID de usuario externo
UUID o GUID largos, aleatorios y bien distribuidos. Si elige un método diferente para asignar un nombre a los ID de usuario, estos también deben ser largos, aleatorios y estar bien distribuidos. Más información sobre convención de nomenclatura de ID de usuario sugerida.
Identificador de usuario de Braze
Identificador de usuario de Bear.
Alias de usuario
Un alias sirve como identificador de usuario único alternativo. Utilice alias para identificar a usuarios con dimensiones diferentes a las del ID de usuario principal.

: el objeto de alias de usuario consta de dos partes: un alias_name para el propio identificador y un alias_label que indica el tipo de alias. Los usuarios pueden tener varios alias con diferentes etiquetas, pero solo un alias_name por alias_label.
NOTE
Para vincular el evento a un usuario, debe completar el campo Id. de usuario externo, el campo Identificador de usuario independiente o la sección Alias de usuario.

Datos de compra

Entrada
Descripción
Requerido
ID de producto
Identificador de la compra. (por ejemplo, Nombre de producto o Categoría de producto)
Sí
Hora de compra
Fecha-hora como cadena en formato ISO 8601 o yyyy-MM-dd'T'HH:mm:ss:SSSZ.
Sí
Moneda
Moneda como cadena en formato de código alfabético de moneda ISO 4217.
Sí
Precio
Precio.
Sí
Cantidad
Si no se proporciona, el valor predeterminado será 1. El valor máximo debe ser inferior a 100.
Identificador de aplicación
El identificador de la aplicación o app_id es un parámetro que asocia la actividad con una aplicación específica de su grupo de aplicaciones. Designa con qué aplicación del grupo de aplicaciones está interactuando. Más información sobre los tipos de identificadores de API.
Propiedades de compra
Un objeto JSON que contiene propiedades personalizadas de la compra.
NOTE
La acción Braze Send Event solo requiere que se especifiquen Event Name y Event Time, pero debe incluir la mayor información posible en el campo de propiedades personalizadas. Para obtener más información sobre el objeto de evento Braze, consulte la documentación oficial.

Atributos de usuario

Los atributos de usuario pueden ser un objeto JSON que contenga campos que creen o actualicen un atributo con el nombre y el valor proporcionados en el perfil de usuario especificado. Se admiten las siguientes propiedades:

Atributo de usuario
Descripción
Nombre
Apellidos
Teléfono
Correo electrónico
Sexo
Una de las siguientes cadenas: "M", "F", "O" (otro), "N" (no aplicable), "P" (prefiero no decir).
Ciudad
País
País como cadena en formato ISO-3166-1 alpha-2.
Idioma
Idioma como cadena en formato ISO-639-1.
Fecha de nacimiento
Cadena en formato "AAAA-MM-DD" (por ejemplo, 1980-12-21).
Zona horaria
Nombre de zona horaria de base de datos de zona horaria de IANA (por ejemplo, 'América/Nueva_York' o 'Hora del Este (EE.UU. y Canadá)').
Facebook
Hash que contiene cualquiera de id (cadena), likes (matriz de cadenas), num_friends (entero).
Twitter
Hash que contiene cualquiera de id (entero), screen_name (cadena, identificador de Twitter), followers_count (entero), friends_count (entero), statuses_count(entero).

Validar datos dentro de Braze validate

Si la recopilación de eventos y la integración de Adobe Experience Platform se realizaron correctamente, verá eventos dentro de la consola Braze al ver perfiles de usuario. Específicamente, los nuevos datos de evento enviados a Braze se reflejan en la sección Purchases de la ficha de información general de un usuario en particular.

Pasos siguientes

En esta guía se explica cómo enviar eventos de conversión a Braze mediante el reenvío de eventos. Para obtener más información sobre las aplicaciones de flujo descendente para los datos de evento enviados a Braze, consulte la documentación oficial.

Para obtener más información sobre las funcionalidades de reenvío de eventos en Experience Platform, consulte la descripción general del reenvío de eventos.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743