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

Braze es una plataforma de participación del cliente que potencia las interacciones centradas en el cliente entre consumidores y marcas en tiempo real. Uso de 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.

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

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 utilizar sus funcionalidades en un reenvío de eventos regla.

Casos de uso

Debe usar esta extensión si desea usar datos de la red perimetral en Braze para aprovechar sus 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. Uso de varios etiqueta , estos datos se envían a Edge Network en tiempo real. A partir de aquí, el Braze la extensión de reenvío de eventos envía automáticamente los eventos relevantes a Braze del lado del servidor.

Una vez enviados los datos, los equipos de análisis de la organización pueden aprovecharlos Braze’s Funcionalidades para procesar los conjuntos de datos y derivar perspectivas comerciales para generar gráficos, tableros u otras visualizaciones para informar a las partes interesadas empresariales. Consulte la 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 un Braze para utilizar sus tecnologías. Si no tiene una cuenta de, vaya al Página de introducción el Braze para conectarse a Braze Sales e inicie el proceso de creación de cuentas.

Protecciones de API

La extensión de utiliza dos de BrazeLas API de 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 API para obtener más información.
User Identify
20.000 peticiones por minuto.
Consulte la User Identify Documentación de API para obtener más información.
NOTE
Consulte la guía de Braze Límites de API para más detalles sobre los límites que imponen.

Puntos de datos facturables

Envío de atributos personalizados adicionales a Braze puede aumentar sus Braze consumo de puntos de datos. Consulte con su Braze administrador de cuentas antes de enviar atributos personalizados adicionales. Consulte la Braze documentación sobre puntos de datos facturables para obtener más información.

Recopilar detalles de configuración necesarios configuration-details

Para conectar la red perimetral a Braze, se requieren las siguientes entradas:

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

Crear un secreto

Crear 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.

Instalación y configuración de Braze extensión install

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

Seleccionar Extensiones en el panel de navegación izquierdo. En el Catálogo pestaña, seleccione Instalar en la tarjeta de Braze extensión.

Instale el Braze extensión.

En la pantalla siguiente, introduzca lo siguiente valores de configuración que recopiló anteriormente de Braze:

  • URL de extremo de resto de Bear: Puede introducir el valor de su Braze URL de extremo REST como texto sin formato en la entrada proporcionada.
  • Clave de API: seleccione la elemento de datos secreto que creó anteriormente, que contiene su Braze Clave de API.

Seleccione Guardar cuando haya terminado.

El Braze página de configuración de la extensión.

Crear un Send Event regla tracking-rule

Después de instalar la extensión, cree un nuevo reenvío de eventos regla y configure sus condiciones como desee. Al configurar las acciones de la regla, seleccione Soldar extensión y seleccione Enviar evento para el tipo de acción.

Añada 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 sugeridos.
Borrar ID de usuario
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 las etiquetas ID de usuario externo o el campo Identificador De Usuario De Braze o el campo Alias de usuario sección.

Datos de Evento

Entrada
Descripción
Requerido
Nombre del evento
Nombre del evento.
Hora del evento
Fecha-hora como cadena en ISO 8601 o en yyyy-MM-dd'T'HH:mm:ss:SSSZ formato.
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. Obtenga más información acerca de Tipos de identificadores API.
Propiedades del evento
Objeto JSON que contiene propiedades personalizadas del evento.
NOTE
El Evento Send de Braze la acción solo requiere un Nombre del evento y Hora del evento que se van a especificar, pero se debe incluir la mayor información posible en el campo propiedades personalizadas. Para obtener más información sobre Braze objeto de evento, consulte la documentación oficial.

Atributos del 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 ISO-3166-1 alpha-2 formato.
Idioma
Idioma como cadena en ISO-639-1 formato.
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 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 un Send Purchase Event regla purchase-rule

Después de instalar la extensión, cree un nuevo reenvío de eventos regla y configure sus condiciones como desee. Al configurar las acciones de la regla, seleccione Soldar extensión y seleccione Enviar evento de compra para el tipo de acción.

Añada una configuración de acción de tipo Acción de compra en bloque de la 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 sugeridos.
Borrar ID de usuario
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 las ID de usuario externo , el Identificador De Usuario De Braze o el campo Alias de usuario sección.

Datos de compra

Entrada
Descripción
Requerido
ID del producto
Identificador de la compra. (por ejemplo, Nombre de producto o Categoría de producto)
Hora de compra
Fecha-hora como cadena en ISO 8601 o en yyyy-MM-dd'T'HH:mm:ss:SSSZ formato.
Moneda
Moneda como cadena en ISO 4217 Formato de código de moneda alfabético.
Precio
Precio.
Cantidad constante
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. Obtenga más información acerca de Tipos de identificadores API.
Propiedades de compra
Un objeto JSON que contiene propiedades personalizadas de la compra.
NOTE
El Evento Send de Braze la acción solo requiere un Nombre del evento y Hora del evento no especificado, pero debe incluir la mayor cantidad de información posible en el campo propiedades personalizadas. Para obtener más información sobre Braze objeto de evento, consulte la documentación oficial.

Atributos del 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 ISO-3166-1 alpha-2 formato.
Idioma
Idioma como cadena en ISO-639-1 formato.
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 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).

Validación de datos dentro de Braze validate

Si la colección de eventos y Adobe Experience Platform integración se han realizado correctamente, verá eventos dentro de la variable Braze consolar cuando ver perfiles de usuario. Concretamente, los nuevos datos de evento se envían a Braze se refleja en la variable Purchases de la sección de un usuario en particular ficha información general.

Pasos siguientes

En esta guía se explica cómo enviar eventos de conversión a Braze uso del 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 resumen del reenvío de eventos.

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