Extensión de reenvío de eventos de la API Track Events
La extensión de reenvío de eventos Braze Track Events API te permite aprovechar los datos capturados en Adobe Experience Platform Edge Network y enviarlos a Braze en forma de eventos del lado del servidor utilizando la
/users/trackAPI.
Este documento cubre los casos de uso de la extensión, cómo instalarla en tus bibliotecas de reenvío de eventos y cómo emplear sus capacidades en una regla de reenvío de eventos.
El uso del reenvío de eventos de Adobe puede aumentar el uso de punto de datos de Braze. Consulta la documentación de Braze sobre puntos de datos para obtener más información.
Casos prácticos
Esta ampliación debería utilizar los datos de la red Edge Network en Braze para aprovechar sus capacidades de análisis de clientes y segmentación.
Por ejemplo, considera una organización de comercio minorista con una presencia multicanal (sitio web y móvil) y que captura entradas transaccionales o conversacionales como datos de eventos de su sitio web y plataformas móviles.
Utilizando varias reglas de etiquetado, estos datos se envían a la red Edge Network en tiempo real. A partir de aquí, la extensión de reenvío de eventos Braze envía automáticamente los eventos relevantes a Braze desde el lado del servidor.
Límites de tarifa
| API | Límites de tarifa |
|---|---|
| Seguimiento del usuario | 50.000 solicitudes por minuto. Consulte la documentación de la API de seguimiento de usuarios para obtener más información. |
Integración
Paso 1: Recopilar los datos de configuración necesarios
Para conectar la red Edge Network a Braze, se necesita lo siguiente:
| Tipo de clave | Descripción |
|---|---|
| Instancia de soldadura | Puedes obtener tu instancia de Braze a través de tu administrador de incorporación a Braze o en la página de resumen de la API. |
| Clave REST API de Braze | Una clave Braze REST API con todos los permisos. Puede crearse en el panel Braze desde Configuración > Claves API. |
Paso 2: Crear un secreto
Cree un nuevo secreto de reenvío de eventos y establezca el valor en su clave Braze API. Esto se utilizará para autenticar la conexión a su cuenta manteniendo el valor seguro.
Paso 3: Instalar y configurar la extensión Braze
- Para instalar la extensión, cree una propiedad de reenvío de eventos o elija una propiedad existente para editarla en su lugar.
- A continuación, seleccione Extensiones en el menú de la izquierda. En la pestaña Catálogo, seleccione Instalar en la tarjeta para la extensión Braze.
- En la siguiente pantalla, introduzca su instancia REST y su clave API y seleccione Guardar cuando haya terminado.
Paso 4: Crear una regla de envío de eventos
Tras instalar la extensión, crea una nueva regla de reenvío de eventos y configura sus condiciones como desees. Al configurar las acciones para la regla, seleccione la extensión Braze y, a continuación, seleccione Enviar evento para el tipo de acción.
| Entrada de datos | Descripción |
|---|---|
| ID de usuario externo | Un UUID o GUID largo, aleatorio y bien distribuido. Si eliges un método diferente para nombrar tus identificadores de usuario, también deben ser largos, aleatorios y estar bien distribuidos. Más información sobre la convención de nomenclatura de ID de usuario sugerida. |
| ID de usuario Braze | Identificador de usuario Braze. |
| Alias de usuario | Un alias sirve como identificador único alternativo del usuario. Utilice alias para identificar a los usuarios en dimensiones diferentes a su ID de usuario principal. El objeto 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 etiquetas diferentes, pero sólo un alias_name por alias_label. |
Para vincular el evento a un usuario, debes rellenar el campo External User ID, el campo Braze User Identifier o la sección User Alias.
| Entrada de datos | Descripción | Obligatoria |
|---|---|---|
| Nombre de evento | Nombre del evento. | Sí |
| Hora del evento | Fecha-hora como cadena en formato ISO 8601 o en yyyy-MM-dd'T'HH:mm:ss:SSSZ. |
Sí |
| Identificador de la aplicación | El identificador de aplicación o app_id es un parámetro que asocia la actividad con una aplicación específica en su espacio de trabajo. Designa con qué aplicación del espacio de trabajo estás interactuando. |
No |
| Propiedades del evento | Un objeto JSON que contiene propiedades personalizadas del evento. | No |
La acción Enviar evento de Braze sólo requiere que se especifique un Nombre de evento y una Hora de evento, pero debe incluir tanta información como sea posible en el campo de propiedades personalizadas. Consulte el objeto de evento para obtener más detalles.
Los atributos de usuario pueden ser un objeto JSON que contenga campos que crearán o actualizarán un atributo con el nombre y valor suministrados en el perfil de usuario especificado. Se admiten las siguientes propiedades:
| Atributo de usuario | Descripción |
|---|---|
| Nombre | Nombre del usuario. |
| Apellido | Apellido del usuario. |
| Teléfono | Número de teléfono del usuario. |
| Correo electrónico | Dirección de correo electrónico del usuario. |
| Género | Una de las siguientes cadenas: “M”, “F”, “O” (otro), “N” (no procede), “P” (prefiero no decirlo). |
| Localidad | La ciudad del usuario. |
| País | El país del usuario como cadena en formato ISO-3166-1 alpha-2. |
| Idioma | El idioma del usuario como cadena en formato ISO-639-1. |
| Fecha de nacimiento | Los datos de nacimiento del usuario en cadena en formato “AAAA-MM-DD” (por ejemplo, 1980-12-21). |
| Zona horaria | Nombre de la zona horaria de la base de datos de zonas horarias de IANA (por ejemplo, ’America/New_York’ o “Eastern Time (US & Canada)”). |
Un hash que contiene cualquiera de los siguientes elementos: id (cadena), likes (matriz de cadenas), num_friends (entero). |
|
| X | Hash que contiene cualquiera de estos: id (entero), screen_name (cadena, X (antes Twitter) handle), followers_count (entero), friends_count (entero), statuses_count(entero). |
Todos los atributos añadidos en la configuración se enviarán cada vez que el evento se envíe a Braze, independientemente de si el valor del atributo ha cambiado. Cuando configures los atributos de usuario, asegúrate de que sabes cómo afectarán al uso de punto de datos.
Paso 5: Crear una regla de envío de evento de compra
Tras instalar la extensión, crea una nueva regla de reenvío de eventos y configura sus condiciones como desees. Al configurar las acciones para la regla, seleccione la extensión Braze y, a continuación, seleccione Enviar evento de compra para el tipo de acción.
| Entrada de datos | Descripción |
|---|---|
| ID de usuario externo | Un UUID o GUID largo, aleatorio y bien distribuido. Si eliges un método diferente para nombrar tus identificadores de usuario, también deben ser largos, aleatorios y estar bien distribuidos. Más información sobre la convención de nomenclatura de ID de usuario sugerida. |
| ID de usuario Braze | Identificador de usuario Braze. |
| Alias de usuario | Un alias sirve como identificador único alternativo del usuario. Utilice alias para identificar a los usuarios en dimensiones diferentes a su ID de usuario principal. El objeto 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 etiquetas diferentes, pero sólo un alias_name por alias_label. |
Para vincular el evento a un usuario, debes rellenar el campo External User ID, el campo Braze User Identifier o la sección User Alias.
| Entrada de datos | Descripción | Obligatoria |
|---|---|---|
| Identificación del producto | Identificador de la compra. (por ejemplo, nombre del producto o categoría del producto). | Sí |
| Tiempo de compra | Fecha-hora como cadena en formato ISO 8601 o en yyyy-MM-dd'T'HH:mm:ss:SSSZ. |
Sí |
| Divisa | Moneda como cadena en formato de código de moneda alfabético ISO 4217. | Sí |
| Precio | El precio del objeto. | Sí |
| Cantidad | La cantidad comprada. Si no se proporciona, el valor predeterminado será 1. El valor máximo debe ser inferior a 100. | No |
| Identificador de la aplicación | El identificador de aplicación o app_id es un parámetro que asocia la actividad con una aplicación específica en su espacio de trabajo. Designa con qué aplicación del espacio de trabajo estás interactuando. |
No |
| Propiedades de la compra | Un objeto JSON que contiene propiedades personalizadas de la compra. | No |
La acción Enviar evento de compra sólo requiere que se especifique Product ID, Purchase Time, Currency y Price, pero debes incluir toda la información posible en el campo propiedades de la compra. Consulte el objeto de compra para obtener más información.
Puede elegir si desea enviar atributos con cada evento dentro de la vista de configuración.
Los atributos de usuario pueden ser un objeto JSON que contenga campos que crearán o actualizarán un atributo con el nombre y valor suministrados en el perfil de usuario especificado. Se admiten las siguientes propiedades:
| Atributo de usuario | Descripción |
|---|---|
| Nombre | Nombre del usuario. |
| Apellido | Apellido del usuario. |
| Teléfono | Número de teléfono del usuario. |
| Correo electrónico | Dirección de correo electrónico del usuario. |
| Género | Una de las siguientes cadenas: “M”, “F”, “O” (otro), “N” (no procede), “P” (prefiero no decirlo). |
| Localidad | La ciudad del usuario. |
| País | El país del usuario como cadena en formato ISO-3166-1 alpha-2. |
| Idioma | El idioma del usuario como cadena en formato ISO-639-1. |
| Fecha de nacimiento | Los datos de nacimiento del usuario en cadena en formato “AAAA-MM-DD” (por ejemplo, 1980-12-21). |
| Zona horaria | Nombre de la zona horaria de la base de datos de zonas horarias de IANA (por ejemplo, ’America/New_York’ o “Eastern Time (US & Canada)”). |
Un hash que contiene cualquiera de los siguientes elementos: id (cadena), likes (matriz de cadenas), num_friends (entero). |
|
| X | Hash que contiene cualquiera de estos: id (entero), screen_name (cadena, X (antes Twitter) handle), followers_count (entero), friends_count (entero), statuses_count(entero). |
Todos los atributos añadidos en la configuración se enviarán cada vez que el evento se envíe a Braze, independientemente de si el valor del atributo ha cambiado. Cuando configures los atributos de usuario, asegúrate de que sabes cómo afectará al uso de punto de datos.
Paso 6: Validación de datos en Braze
Si la recopilación de eventos y la integración de Adobe Experience Platform se han realizado correctamente, verá los eventos en la consola Braze al ver los perfiles de usuario. En concreto, los nuevos datos de eventos enviados a Braze se reflejan en la sección Compras o Eventos personalizados de la pestaña de resumen de un usuario concreto.
Editar esta página en GitHub