Conéctate a la API de datos de clientes de Movable Ink

La integración de la API de datos de clientes de Braze y Movable Ink permite a los profesionales del marketing activar los datos de eventos de clientes almacenados en Braze para generar contenido personalizado dentro de Movable Ink.

Movable Ink es capaz de ingerir eventos de comportamiento de Braze a través de su API de datos de clientes. Los eventos se almacenarán en los perfiles de usuario en función del identificador único de usuario (UUID) que se pase a Movable Ink.

Para obtener más información sobre Stories, la API de datos de clientes de Movable Ink y cómo Movable Ink aprovecha los datos de comportamiento, visita los siguientes artículos del centro de soporte:

• Potenciar los contenidos con datos de comportamiento
• Introducción y guía de la API de datos de clientes
• PREGUNTAS FRECUENTES: API de datos de clientes

Requisitos previos

Integración

Paso 1: Crear una campaña webhook en Braze

Paso 1a: Crear una nueva campaña

1. En Braze, crea una campaña webhook.
2. Dé a su campaña un nombre y una descripción opcional.
3. Seleccione Plantilla en blanco como plantilla.

Paso 1b: Añade tus credenciales API de datos de clientes

1. En el campo Webhook URL, introduce la URL del punto final de Movable Ink.

2. Seleccione la pestaña Configuración. 3. Añada las siguientes cabeceras de solicitud como pares clave-valor:

Paso 1c: Configura tu carga útil

1. Vuelva a la pestaña Redactar.
2. Para tu cuerpo de solicitud, crea tu propio cuerpo de solicitud con pares clave-valor JSON o introduce la carga útil de tu evento como texto sin formato. Consulta las cargas útiles de muestra para ver ejemplos de eventos estándar de comercio electrónico.

Paso 1d: Pruebe su webhook

Tendrás que compartir una carga útil de muestra con tu equipo de Movable Ink Client Experience. Puede generar esta carga útil en la pestaña Prueba basándose en la carga útil que ha construido.

Para probar su webhook, haga lo siguiente:

1. Seleccione la pestaña Prueba.
2. Previsualice el mensaje como un usuario para ver una muestra de la carga útil del evento para ese usuario. Puede elegir entre previsualizar como usuario aleatorio, usuario específico o usuario personalizado.
3. Si todo parece correcto, haga clic en Enviar prueba para enviar una solicitud de prueba.

Paso 2: Finalice la configuración de su campaña

Paso 2a: Programa tu campaña

Cuando hayas terminado de componer y probar el webhook, programa tu campaña.

Braze admite entregas programadas, basadas en acciones y activadas por API. La entrega basada en acciones suele ser la más adecuada para la mayoría de los casos de uso de eventos de comportamiento. Si tienes preguntas sobre lo que tiene sentido para tu caso de uso, ponte en contacto con tus administradores del éxito del cliente de Braze y Movable Ink.

Para la entrega basada en acciones:

1. Especifica la acción desencadenante. Este es el evento que activará el webhook a Movable Ink.
2. Asegúrese de que el Retraso de programación está establecido en Inmediatamente. Los datos de los eventos deben enviarse a Movable Ink inmediatamente después de que se produzca el evento, sin demora.
3. Establezca la duración de la campaña especificando una hora de inicio. Es probable que no se aplique una hora de finalización, aunque puede establecerse si es necesario para el caso de uso.

Paso 2b: Especifica tu audiencia

A continuación, determina a qué usuarios quieres dirigir esta campaña. Para más información, consulte la sección Dirigirse a los usuarios.

Asegúrese de no utilizar pruebas A/B en su campaña desactivando la casilla Grupo de control. Si se incluye un grupo de control, a un porcentaje de usuarios no se les enviarán datos a Movable Ink. Toda su audiencia debe dirigirse a la variante y no al grupo de control.

Paso 2c: Elegir eventos de conversión (opcional)

Si lo desea, puede asignar eventos de conversión a esta campaña dentro de Braze.

Sin embargo, dado que el webhook sólo pretende transmitir datos, es probable que la atribución a este nivel sea menos útil que la atribución a nivel de campaña después de que los datos de comportamiento de Braze se utilicen para personalizar el contenido.

Paso 3: Lanzar la campaña

Revise la configuración de su webhook y lance su campaña.

Consideraciones

Alineación con un identificador único de usuario

Asegúrese de que el valor del identificador único de usuario (UUID) que está utilizando como su mi_u, está disponible dentro de Braze y se puede incluir en las cargas útiles de eventos enviados a Movable Ink.

Esto garantiza que los eventos de comportamiento a los que Movable Ink hace referencia al generar una imagen están asociados al mismo cliente para el que recibieron los eventos de comportamiento. Si el valor UUID no es el mismo que el de Braze external_id, el UUID debe capturarse y pasarse a Braze como atributo o en las propiedades de evento de un evento Braze para aprovechar este identificador.

Braze rastrea el comportamiento de los usuarios en múltiples plataformas (como la web y la aplicación móvil), por lo que un mismo usuario puede tener varios identificadores anónimos distintos. Estos identificadores pueden fusionarse en el perfil de usuario único conocido de Stories cuando se envía un evento identify a Movable Ink, siempre y cuando el evento identify incluya tanto un identificador anónimo como el identificador único conocido.

Una vez que Movable Ink recibe un user_id para un único usuario, todos los eventos futuros para ese usuario deben incluir ese mismo user_id.

Compartir cargas útiles de eventos con Movable Ink

Antes de configurar el conector a la API de Datos de Cliente de Movable Ink, asegúrate de compartir tus cargas útiles de eventos con tu equipo de Experiencia del Cliente de Movable Ink. Esto permite a Movable Ink asignar tus eventos a su esquema de eventos y evitará cualquier llamada a la API rechazada o fallida.

Puede generar una carga útil de evento dentro de Braze utilizando cualquier propiedad de evento. Generar una carga útil de muestra para un usuario aleatorio o buscando un ID de usuario específico. Consulte el paso 1d anterior para obtener más información.

Comparta esta carga útil de muestra con su equipo de Movable Ink Client Experience. Asegúrate de que no hay información sensible de identificación personal en la carga útil de la muestra (como dirección de correo electrónico, número de teléfono o fechas de nacimiento completas).

Para obtener más información sobre las propiedades de eventos personalizados y el formato esperado de los datos contenidos en las propiedades, consulte Propiedades de eventos personalizados.

Usuarios conocidos frente a anónimos

En Braze, los eventos pueden registrarse bajo un perfil de usuario anónimo. Los identificadores que se vinculan al perfil de usuario durante el registro de eventos dependen de cómo se creó el usuario (a través de Braze SDK o API) y de su etapa actual en el ciclo de vida del usuario.

Sólo reenvío de eventos Braze para usuarios conocidos

En su campaña webhook, utilice el filtro External User ID para dirigirse únicamente a los usuarios que tengan un external_id con el filtro External User ID is not blank.

Reenvío de eventos Braze para usuarios anónimos y conocidos

Si quieres reenviar eventos Braze de usuarios anónimos (usuarios antes de que se asigne un external_id a su perfil), tendrás que decidir qué identificador utilizar como anonymous_id para Movable Ink hasta que esté disponible un external_id. Elige un anonymous_id que permanecerá constante en tu perfil de usuario Braze. Puede utilizar la lógica Liquid en el cuerpo del webhook para decidir si pasa un anonymous_id o un user_id.

Para más información, consulte los webhooks de ejemplo en payloads de ejemplo.

Ejemplos de cargas útiles

Evento de vista del producto

• example braze trigger event
• expected movable ink request payload
• example webhook

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
  "events": [
    {
      "email": "[email protected]",
      "name": "Product Viewed",
      "time": "2023-12-06T19:20:45+01:00",
      "properties": {
        "categories": [
          {
            "id": "Bathroom",
            "url": "https://example.com/cat/bathroom"
          }
        ],
        "meta": {
          "color": "green"
        },
        "title": "All-Purpose Cleaning Wipes",
        "price": 1.99,
        "id": "56544",
        "url": "https://www.example.com/variants_id/5f08cb918dcc595aa74b0fbc"
      }
    }
  ]
}

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
curl --location --request POST 'https://collector.movableink-dmz.com/behavioral/{{key}}' \
--header 'Authorization: Basic {{authorization}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "anonymous_id": "123-abc-678",
  "event": "product_viewed",
  "properties": {
    "categories": [
      {
        "id": "Bathroom",
        "url": "https://example.com/cat/bathroom"
      }
    ],
    "meta": {
      "color": "green"
    },
    "title": "All-Purpose Cleaning Wipes",
    "price": 1.99,
    "id": "56544",
    "url": "https://www.example.com/variants_id/5f08cb918dcc595aa74b0fbc"
  },
  "timestamp": 1257894000000,
  "timezone": "America/New_York",
  "type": "track",
  "user_id": "5c3aa83113dd490100d3d8d7"
}'

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
// Converts the timestamp of "now" to seconds since 1970 and assigns it to a local variable "timestamp"
{% assign timestamp = "now" | date: "%s" %}

// Example of md5 hashing the email address to use as the anonymous_id
{% assign anon_id = {{${email_address}}} | md5 %}

// Condition logic to determine which identifier to use. If an external_id is available use that, otherwise use the anonymous_id
{% if {{${user_id}}} %}
{% capture user_identifier %}"user_id": "{{${user_id}}}"{% endcapture %}
{% else %}
{% capture user_identifier %}"anonymous_id": "{{anon_id}}"{% endcapture %}
{% endif %}

{
  {{user_identifier}}
  "event": "product_viewed",
  "properties": {
    "categories": [
      {
        "id": "{{event_properties.${categories}[0].id}}",
        "url": "{{event_properties.${categories}[0].url}}"
      }
    ],
    "meta": {
      "color": "{{event_properties.${meta}.color}}"
    },
    "title": "{{event_properties.${title}}}",
    "price": "{{event_properties.${price}}}",
    "id": "{{event_properties.${id}}}",
    "url": "{{event_properties.${url}}}"
  },
  "timestamp": "{{timestamp}}",
  "timezone": "{{${time_zone}}}",
  "type": "track",
}

Evento de vista de categoría

• example braze trigger event
• expected movable ink request payload
• example webhook

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "events": [
    {
      "external_id": "123456789",
      "name": "Category Viewed",
      "time": "2023-12-06T19:20:45+01:00",
      "properties": {
        "id": "bathroom-1",
        "title": "Bathroom Stuff",
        "url": "https://www.example.com/categories/bathroom"
      }
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
curl --location --request POST 'https://collector.movableink-dmz.com/behavioral/{{key}}' \
--header 'Authorization: Basic {{authorization}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "anonymous_id": "123-abc-678",
  "event": "category_viewed",
  "properties": {
    "id": "bathroom-1",
    "title": "Bathroom Stuff",
    "url": "https://www.example.com/categories/bathroom"
  },
  "timestamp": 1257894000000,
  "timezone": "America/New_York",
  "type": "track",
  "user_id": "5c3aa83113dd490100d3d8d7"
}'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// Converts the timestamp of "now" to seconds since 1970 and assigns it to a local variable "timestamp"
{% assign timestamp = "now" | date: "%s" %}

{
  "event": "category_viewed",
  "properties": {
    "id": "{{event_properties.${id}}}",
    "title": "{{event_properties.${title}}}",
    "url": "{{event_properties.${url}}}"
  },
  "timestamp": "{{timestamp}}",
  "timezone": "{{${time_zone}}}",
  "type": "track",
  "user_id": "{{${user_id}}}"
}

Identificar el evento

• example braze trigger event
• expected movable ink request payload
• example webhook

1
2
3
4
5
6
7
8
9
{
  "events": [
    {
      "external_id": "123456789",
      "name": "Account Created",
      "time": "2023-12-06T19:20:45+01:00"
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
curl --location --request POST 'https://collector.movableink-dmz.com/behavioral/{{key}}' \
--header 'Authorization: Basic {{authorization}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "anonymous_id": "jg0iq5gd30dqpwn8zmx05p06mzjmjir4r8",
  "timestamp": 1257894000000,
  "timezone": "America/New_York",
  "type": "identify",
  "user_id": "mycustomerid123"
}'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// Converts the timestamp of "now" to seconds since 1970 and assigns it to a local variable "timestamp"
{% assign timestamp = "now" | date: "%s" %}

// Example of md5 hashing the email address to use as the anonymous_id
{% assign anon_id = {{${email_address}}} | md5 %}

{
  "anonymous_id": "{{anon_id}}",
  "timestamp": "{{timestamp}}",
  "timezone": "{{${time_zone}}}",
  "type": "identify",
  "user_id": "{{${user_id}}}"
}