Wunderkind (Signals)

Wunderkind es una plataforma de rendimiento de comercio electrónico que utiliza tecnología de identidad propietaria para reconocer visitantes anónimos de sitios web y resolverlos a direcciones de correo electrónico procesables. En promedio, Wunderkind escala la identificación del 3 al 5 % del tráfico del sitio web al 40 al 60 %, lo que permite a las marcas desencadenar mensajes personalizados uno a uno a escala a través de su ESP existente.

Esta integración está mantenida por Wunderkind. Para soporte, visita support.wunderkind.co.

Acerca de la integración

La integración de Wunderkind Signals permite que las señales de comportamiento de alta intención, como el abandono del carrito de compras, el abandono de productos y las bajadas de precio, desencadenen recorridos de Canvas en tiempo real en Braze. Wunderkind identifica a los usuarios anónimos en tu sitio web, resuelve su identidad en una dirección de correo electrónico a la que se pueden entregar mensajes y entrega una carga útil de señal estructurada a Braze mediante la API de entrada en Canvas, lo que inicia automáticamente tus flujos de correo electrónico preconfigurados.

Requisitos previos

Cómo funciona

Cuando Wunderkind identifica a un usuario anónimo con alta intención de compra y resuelve su identidad, envía una carga útil de señal a Braze mediante el endpoint /canvas/trigger/send, lo que desencadena en tiempo real el recorrido de Canvas correspondiente para ese usuario.

Para obtener una descripción técnica completa, consulta el Portal para desarrolladores de Wunderkind.

Integración

Paso 1: Crea una clave de API de Braze para Wunderkind

En tu panel de Braze:

1. Ve a Configuración > Claves de API y haz clic en Crear nueva clave de API.
2. Dale a la clave un nombre descriptivo (por ejemplo, Wunderkind Signals).
3. Concede los permisos que se indican en Conceder a Wunderkind acceso a tu cuenta de Braze.
4. Copia la clave de API para introducirla en la plataforma de Wunderkind en la siguiente sección.

Nota

Para Wunderkind Signals, las solicitudes a la REST API de Braze se autentican con una clave de API REST, no con tokens OAuth. Crea una clave de API dedicada en el panel y proporciónasela a Wunderkind.

Paso 2: Conecta Braze a la plataforma de Wunderkind

1. Inicia sesión en la plataforma de Wunderkind y ve a Integrations Hub.
2. Selecciona el mosaico Braze y, a continuación, selecciona Connect.
3. Introduce tu clave de API REST de Braze y selecciona tu clúster.
4. Selecciona Save.

Paso 3: Revisa los nuevos activos de Braze

Tras la activación, Wunderkind aprovisiona nuevos activos de implementación en tu espacio de trabajo de Braze según la estrategia acordada con tu representante de Wunderkind:

Paso 4: Completa la configuración del Canvas

Para cada Canvas de Signals, crea tus plantillas de correo electrónico con el editor de arrastrar y soltar de Braze o con HTML.

• Wunderkind rellena los datos de producto y de sesión en el objeto context de cada destinatario en /canvas/trigger/send en el momento del envío.
• Para obtener instrucciones detalladas sobre cómo usar Liquid con esa carga útil en tus plantillas, consulta Completar la configuración del Canvas en el Centro de ayuda de Wunderkind.

Paso 5: Revisa la elegibilidad del Canvas

Para cada Canvas de Signals, ve a la configuración de Público objetivo para revisar el público de entrada predeterminado y los criterios de salida de Wunderkind.

• Para asegurarte de no enviar mensajes a tus usuarios con demasiada frecuencia, consulta Limitación de velocidad centrada en el usuario.
• Ajusta la configuración para evitar que los usuarios sigan recibiendo mensajes del Canvas después de realizar una compra. Por ejemplo, añade la excepción Realizar compra.
• Algunos Canvas de Signals vienen preconfigurados con filtros de atributos personalizados para que los usuarios reciban el mensaje de mayor intención posible.
• Consulta Revisar la elegibilidad del Canvas en el Centro de ayuda de Wunderkind para obtener detalles sobre la elegibilidad y la prioridad del Canvas.

Paso 6: Prueba y lanza

Wunderkind realiza un control de calidad de extremo a extremo antes de la puesta en marcha:

• Confirma que las señales se entregan a los ID de Canvas correctos sin errores de API.
• Verifica que los campos de context (nombre del producto, imagen, URL) se rellenan correctamente en las plantillas de correo electrónico renderizadas.
• Consulta Probar y lanzar Signals para Braze en el Centro de ayuda de Wunderkind para obtener instrucciones sobre cómo previsualizar plantillas con productos simulados de Wunderkind.

Cuando se supera el control de calidad, tu administrador de implementación de Wunderkind coordina el lanzamiento en producción con tu equipo.

Carga útil de contexto de Canvas

Wunderkind admite seis tipos de señales. Cada una entrega un conjunto distinto de claves y valores dentro del objeto context para ese destinatario en /canvas/trigger/send (consulta Enviar mensajes de Canvas mediante entrega desencadenada por API). El campo WkPurpose identifica el tipo de señal dentro de esa carga útil.

Campos comunes (todos los tipos de Canvas)

Campos de artículos de producto

Campos específicos de Canvas y valores de WkPurpose

Ejemplos de cargas útiles

Cada objeto en recipients debe incluir exactamente uno de los siguientes: external_user_id, user_alias, braze_id o email. Para más información, consulta el objeto Destinatarios.

Nota

Cada ejemplo usa un identificador de destinatario de Braze. Los seis primeros usan solo user_alias; el último usa email solo con prioritization. El JSON de ejemplo omite la clave WkChannel dentro de context para que las herramientas de revisión no confundan su valor ("email") con el campo email del destinatario de Braze. En producción, incluye "WkChannel": "email" en context tal como se documenta en la tabla de campos comunes (todos los tipos de Canvas).

Los siguientes ejemplos usan user_alias con wknd_email_id, que coincide con la forma en que Wunderkind resuelve las identidades.

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

{
  "canvas_id": "<your_canvas_id>",
  "recipients": [
    {
      "user_alias": {
        "alias_name": "[email protected]",
        "alias_label": "wknd_email_id"
      },
      "context": {
        "Origin": "wunderkind",
        "DataOnly": "Y",
        "UserType": "prospect",
        "WkOpen": "https://example.com/cart",
        "WkPurpose": "cart abandonment",
        "WKCouponCode": "",
        "WKCouponPurpose": "",
        "WkCartReplenUrl": "https://example.com/cart/replenish",
        "Items": [
          {
            "WkCopy": "Product name",
            "WkId": "012345",
            "WkImageUrl": "https://example.com/image.jpg",
            "WkUrl": "https://example.com/product"
          }
        ]
      }
    }
  ]
}

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

{
  "canvas_id": "<your_canvas_id>",
  "recipients": [
    {
      "user_alias": {
        "alias_name": "[email protected]",
        "alias_label": "wknd_email_id"
      },
      "context": {
        "Origin": "wunderkind",
        "DataOnly": "Y",
        "UserType": "prospect",
        "WkOpen": "https://example.com/product",
        "WkPurpose": "product abandonment",
        "WKCouponCode": "",
        "WKCouponPurpose": "",
        "Items": [
          {
            "WkCopy": "Product name",
            "WkId": "012345",
            "WkImageUrl": "https://example.com/image.jpg",
            "WkUrl": "https://example.com/product"
          }
        ]
      }
    }
  ]
}

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

{
  "canvas_id": "<your_canvas_id>",
  "recipients": [
    {
      "user_alias": {
        "alias_name": "[email protected]",
        "alias_label": "wknd_email_id"
      },
      "context": {
        "Origin": "wunderkind",
        "DataOnly": "Y",
        "UserType": "prospect",
        "WkOpen": "https://example.com/category",
        "WkPurpose": "category recap",
        "WKCouponCode": "",
        "WKCouponPurpose": "",
        "WkCategoryUrl": "https://example.com/category",
        "Items": [
          {
            "WkCopy": "Product name",
            "WkId": "012345",
            "WkImageUrl": "https://example.com/image.jpg",
            "WkUrl": "https://example.com/product"
          }
        ]
      }
    }
  ]
}

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

{
  "canvas_id": "<your_canvas_id>",
  "recipients": [
    {
      "user_alias": {
        "alias_name": "[email protected]",
        "alias_label": "wknd_email_id"
      },
      "context": {
        "Origin": "wunderkind",
        "DataOnly": "Y",
        "UserType": "prospect",
        "WkOpen": "https://example.com/product",
        "WkPurpose": "back in stock",
        "WKCouponCode": "",
        "WKCouponPurpose": "",
        "Items": [
          {
            "WkCopy": "Product name",
            "WkId": "012345",
            "WkImageUrl": "https://example.com/image.jpg",
            "WkUrl": "https://example.com/product"
          }
        ]
      }
    }
  ]
}

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

{
  "canvas_id": "<your_canvas_id>",
  "recipients": [
    {
      "user_alias": {
        "alias_name": "[email protected]",
        "alias_label": "wknd_email_id"
      },
      "context": {
        "Origin": "wunderkind",
        "DataOnly": "Y",
        "UserType": "prospect",
        "WkOpen": "https://example.com/product",
        "WkPurpose": "price drop",
        "WKCouponCode": "",
        "WKCouponPurpose": "",
        "Items": [
          {
            "WkCopy": "Product name",
            "WkId": "012345",
            "WkImageUrl": "https://example.com/image.jpg",
            "WkUrl": "https://example.com/product",
            "WkPrice": "49.99",
            "WKSalePrice": "39.99"
          }
        ]
      }
    }
  ]
}

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

{
  "canvas_id": "<your_canvas_id>",
  "recipients": [
    {
      "user_alias": {
        "alias_name": "[email protected]",
        "alias_label": "wknd_email_id"
      },
      "context": {
        "Origin": "wunderkind",
        "DataOnly": "Y",
        "UserType": "prospect",
        "WkOpen": "https://example.com/product",
        "WkPurpose": "low stock",
        "WKCouponCode": "",
        "WKCouponPurpose": "",
        "Items": [
          {
            "WkCopy": "Product name",
            "WkId": "012345",
            "WkImageUrl": "https://example.com/image.jpg",
            "WkUrl": "https://example.com/product",
            "WkQuantity": "1"
          }
        ]
      }
    }
  ]
}

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

{
  "canvas_id": "<your_canvas_id>",
  "recipients": [
    {
      "email": "[email protected]",
      "prioritization": ["unidentified", "most_recently_updated"],
      "context": {
        "Origin": "wunderkind",
        "DataOnly": "Y",
        "UserType": "prospect",
        "WkOpen": "https://example.com/product",
        "WkPurpose": "product abandonment",
        "WKCouponCode": "",
        "WKCouponPurpose": "",
        "Items": [
          {
            "WkCopy": "Product name",
            "WkId": "012345",
            "WkImageUrl": "https://example.com/image.jpg",
            "WkUrl": "https://example.com/product"
          }
        ]
      }
    }
  ]
}

Ejemplo de uso de Liquid

Cuando Wunderkind llama a /canvas/trigger/send, las claves y los valores que pasas en el objeto context de cada destinatario se convierten en datos de entrada del Canvas. En los pasos de Mensaje, haz referencia a ellos con el espacio de nombres context de Liquid. Un ejemplo es {{context.${WkPurpose}}}, como se describe en Objeto de contexto de Canvas y Mensaje. No se requiere ninguna configuración adicional más allá de usar la sintaxis correcta de Liquid.

No anides etiquetas de salida de Braze dentro de la condición de la etiqueta for. Primero asigna la matriz Items de context a una variable y luego recórrela, como se describe en Uso de Liquid. La línea assign usa la forma de entrada de Canvas de Braze {{context.${Items}}} (consulta Etiquetas de personalización compatibles).

1
2
3
4
5
6
7
8
9
10
11

{% assign wk_items = {{context.${Items}}} %}
{% for item in wk_items %}
  <tr>
    <td>
      <a href="{{ item.WkUrl }}">
        <img src="{{ item.WkImageUrl }}" />
        <p>{{ item.WkCopy }}</p>
      </a>
    </td>
  </tr>
{% endfor %}

Informes

Wunderkind ingiere datos de rendimiento de Braze mediante Braze Currents, que transmite eventos sin procesar a Google Cloud Storage. Después, Wunderkind normaliza y agrega estos eventos en función de la señal de origen para generar informes de atribución 1:1.

Las siguientes métricas estarán disponibles próximamente en el panel de informes de Wunderkind:

Limitaciones

• Sin sincronización de supresión o exclusión voluntaria. La supresión debe gestionarse de forma nativa en Braze. Nota: Si ya eres cliente de Wunderkind y estás migrando a Braze Signals, Wunderkind trabaja con tu equipo para conservar tu configuración actual.
• Solo canal de correo electrónico. Actualmente, esta integración no admite el servicio de mensajes cortos (SMS).
• El perfil de usuario debe existir antes del desencadenante del Canvas. /canvas/trigger/send con un destinatario user_alias solo resuelve perfiles de Braze existentes que ya tienen ese alias. No puedes usar send_to_existing_only con alias, y el desencadenante del Canvas no crea un perfil completamente nuevo solo a partir del alias. Primero debes crear o actualizar el usuario y establecer el alias wknd_email_id (por ejemplo, con /users/track o /users/identify). Wunderkind puede esperar un breve momento después de esa actualización para que Braze termine de procesarla antes de activar el desencadenante.
• Correo electrónico como identificador. Si el desencadenante del Canvas identifica al destinatario con email en lugar de user_alias, incluye prioritization en ese objeto de destinatario, tal como exige Braze.

Recursos adicionales

• Centro de ayuda de Wunderkind — Resumen de Signals for Braze
• Portal para desarrolladores de Wunderkind — Resumen de la integración
• Enviar mensajes de Canvas mediante entrega desencadenada por API
• Objeto de contexto de Canvas
• Braze Currents