Crear una transformación

Braze Data Transformation le permite crear y gestionar integraciones webhook para automatizar el flujo de datos desde plataformas externas a Braze. Estas integraciones de webhooks pueden impulsar casos de uso de marketing aún más sofisticados. Puede crear su transformación de datos a partir del código predeterminado o utilizando nuestra biblioteca de plantillas específica para ayudarle a empezar con determinadas plataformas externas.

Requisitos previos

Paso 1: Identificar una plataforma de origen

Identifica una plataforma externa que quieras conectar a Braze y comprueba que la plataforma admite webhooks. Estas configuraciones se denominan a veces “notificaciones API” o “solicitudes de servicio Web”.

A continuación se muestra un ejemplo de webhook de Typeform, que se puede configurar iniciando sesión en su plataforma:

Paso 2: Crear una transformación

En el panel de Braze, ve a Configuración de Datos > Transformación de Datos.

Selecciona Crear transformación para darle un nombre a tu transformación y, a continuación, elige tu experiencia de edición.

Selecciona Utilizar una plantilla para examinar una biblioteca de plantillas, incluidos los casos de uso de Transformación de datos. O bien, selecciona Empezar de cero para cargar una plantilla de código predeterminada.

Si empiezas de cero, elige un destino para tu transformación. Todavía puedes insertar una plantilla de código de la biblioteca de plantillas.

Después de crear tu transformación, verás la vista detallada de la transformación. Aquí, puedes ver el webhook más reciente recibido para esta transformación en Detalles del webhook y un espacio para escribir tu código de transformación en Código de transformación.

Paso 3: Enviar un webhook de prueba (recomendado)

Este paso es opcional, pero recomendamos enviar un webhook de prueba desde su plataforma de origen a su transformación recién creada.

1. Copie la URL de su transformación.
2. En su plataforma de origen, busque la función “Enviar prueba” para que genere un webhook de ejemplo para enviarlo a esta URL.
   • Si su plataforma de origen le pide un tipo de solicitud, seleccione POST.
   • Si tu plataforma de origen proporciona opciones de autenticación, selecciona Sin autenticación.
   • Si tu plataforma de origen te pide secretos, selecciona Sin secretos.
3. Actualiza tu página en el panel de Braze para ver si se ha recibido el webhook. Si se ha recibido, deberías ver la carga útil del webhook en Webhook más reciente.

Esto es lo que parece para Typeform:

Paso 4: Escribir código de transformación

Si tiene poca o ninguna experiencia con código JavaScript o prefiere instrucciones más detalladas, siga las instrucciones de Beginner - POST: Seguimiento de usuarios o Principiante - PUT: Actualizar varios elementos del catálogo pestaña para escribir su código de transformación.

Si eres desarrollador o tienes mucha experiencia con código JavaScript, sigue las instrucciones de Avanzado - POST: Seguimiento de usuarios pestaña para obtener instrucciones de alto nivel en la escritura de su código de transformación.

• principiante - seguimiento de usuarios
• principiante - actualizar elementos del catálogo
• avanzado - seguimiento de usuarios

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
// Here, we will define a variable, "brazecall", to build up a `/users/track` request
// Everything from the incoming webhook is accessible via the special variable "payload"
// So you can template in desired values in your `/users/track` request with dot notation, such as payload.x.y.z

let brazecall = {
  "attributes": [
    {
      "external_id": payload.user_id,
      "_update_existing_only": true,
      "attribute_1": payload.attribute_1
    }
  ],
  "events": [
    {
      "external_id": payload.user_id,
      "_update_existing_only": true,
      "name": payload.event_1,
      "time": new Date(),
      "properties": {
        "property_1": payload.event_1.property_1
      }
    }
  ],
  "purchases": [
    {
      "external_id": payload.user_id,
      "_update_existing_only": true,
      "product_id": payload.product_id,
      "currency": payload.currency,
      "price": payload.price,
      "quantity": payload.quantity,
      "time": payload.timestamp,
      "properties": {
        "property_1": payload.purchase_1.property_1
      }
    }
  ]
};

// After the /users/track request is assigned to brazecall, you will want to explicitly return brazecall to create an output
return brazecall;

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
// This is a default template that you can use as a starting point
// Feel free to delete this entirely to start from scratch, or to edit specific components

// First, this code defines a variable, "brazecall", to build a PUT /catalogs/{catalog_name}/items request
// Everything from the incoming webhook is accessible via the special variable "payload"
// As such, you can template in desired values in your request with JS dot notation, such as payload.x.y.z

let brazecall = {
  // For Braze Data Transformation to update Catalog items, the special variable "catalog_name" is required
  // This variable is used to specify the catalog name which would otherwise go in the request URL
  "catalog_name": "catalog_name",
  
  // After defining "catalog name", construct the Update Multiple Catalog Items request as usual below
  // Documentation for the destination endpoint: https://www.braze.com/docs/api/endpoints/catalogs/catalog_items/asynchronous/put_update_catalog_items/
  "items": [
    {
      "id": payload.item_id_1,
      "catalog_column1": "string",
      "catalog_column2": 1,
      "catalog_column3": true,
      "catalog_column4": "2021-09-03T09:03:19.967+00:00",
      "catalog_column5": {
        "Latitude": 33.6112,
        "Longitude": -117.8711
      }
    },
    {
      "id": payload.item_id_2,
      "catalog_column1": "string",
      "catalog_column2": 1,
      "catalog_column3": true,
      "catalog_column4": "2021-09-03T09:03:19.967+00:00",
      "catalog_column5": {
        "Latitude": 33.6112,
        "Longitude": -117.8711
      }
    },
    {
      "id": payload.item_id_3,
      "catalog_column1": "string",
      "catalog_column2": 1,
      "catalog_column3": true,
      "catalog_column4": "2021-09-03T09:03:19.967+00:00",
      "catalog_column5": {
        "Latitude": 33.6112,
        "Longitude": -117.8711
      }
    }
  ]
};

// After the request body is assigned to brazecall, you will want to explicitly return brazecall to create an output
return brazecall;

Paso 5: Supervise su transformación

Tras activar tu transformación, consulta los análisis de la página principal de Transformaciones para ver un resumen del rendimiento.

• Solicitudes entrantes: Es el número de webhooks recibidos en la URL de esta transformación. Si las solicitudes entrantes son 0, su plataforma de origen no ha enviado ningún webhook, o la conexión no se puede realizar.
• Entregas: Tras recibir las solicitudes entrantes, Data Transformation aplica su código de transformación para enviarlas al destino Braze seleccionado.

Es un buen objetivo que el 100 % de las solicitudes entrantes den lugar a entregas. El número de entregas nunca superará el número de solicitudes entrantes.

Solución de problemas

Para una supervisión y solución de problemas más detalladas, consulta la página Registros para ver registros específicos, que es donde se registran las últimas 1.000 peticiones entrantes a todas las transformaciones de tus espacios de trabajo. Puedes seleccionar cada registro para ver el cuerpo de la solicitud entrante, la salida de la transformación y el cuerpo de la respuesta del destino de la transformación.

Si no hay entregas, comprueba que tu código de transformación no contenga errores de sintaxis y confirma que el código se compila. A continuación, comprueba si la salida es una solicitud de destino válida.

Las entregas inferiores al número de solicitudes entrantes indican que al menos algunos webhooks se entregan correctamente. Consulte los registros de transformación para ver ejemplos de errores y compruebe si la salida de la transformación es la esperada. Es posible que su código de transformación no tenga en cuenta todas las variaciones de los webhooks recibidos.