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 señales de comportamiento de alta intención —como abandono del carrito de compras, abandono de producto y 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 a una dirección de correo electrónico entregable y entrega una carga útil de señal estructurada a Braze a través de la API de entrada de Canvas, iniciando 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 y resuelve su identidad, envía una carga útil de señal a Braze mediante el endpoint /canvas/trigger/send, lo que desencadena el recorrido de Canvas correspondiente para ese usuario en tiempo real.

Para obtener un resumen técnico completo, consulta el Portal para desarrolladores de Wunderkind.

Integración

Paso 1: Crear 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. Otorga los permisos listados en Otorgar a Wunderkind acceso a tu cuenta de Braze.
4. Copia la clave de API para ingresarla en la plataforma 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 proporciona esa clave a Wunderkind.

Paso 2: Conectar Braze a la plataforma Wunderkind

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

Paso 3: Revisar los nuevos activos de Braze

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

Paso 4: Completar la configuración de Canvas

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

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

Paso 5: Revisar la elegibilidad de Canvas

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

• Para asegurarte de que no envías mensajes a tus usuarios con demasiada frecuencia, consulta Límite de velocidad centrado en el usuario.
• Ajusta la configuración para evitar que los usuarios sigan recibiendo mensajes de Canvas después de realizar una compra. Por ejemplo, agrega la excepción Make Purchase.
• Ciertos Canvas de Signals vienen preconfigurados con filtros de atributos personalizados para que los usuarios reciban el mensaje de mayor intención posible.
• Consulta Review Canvas eligibility en el Centro de ayuda de Wunderkind para obtener detalles sobre la elegibilidad y prioridad de Canvas.

Paso 6: Probar y lanzar

Wunderkind realiza un control de calidad de extremo a extremo antes del lanzamiento:

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

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

Carga útil del contexto de Canvas

Wunderkind admite seis tipos de señales. Cada uno 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

Cargas útiles de ejemplo

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

Nota

Cada ejemplo utiliza un identificador de destinatario de Braze. Los primeros seis usan solo user_alias; el último usa email con prioritization únicamente. 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 de destinatario de Braze. En producción, incluye "WkChannel": "email" en context como se documenta en la tabla de campos comunes (todos los tipos de Canvas).

Los siguientes ejemplos usan user_alias con wknd_email_id, lo que coincide con la forma en que Wunderkind resuelve 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 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 de Liquid context. Un ejemplo es {{context.${WkPurpose}}} como se describe en Objeto de contexto de Canvas y Mensaje. No se requiere 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 el array Items de context a una variable y luego itera, como se describe en Usar Liquid. La línea assign usa el formato de entrada de Canvas de Braze {{context.${Items}}} (consulta Etiquetas de personalización admitidas).

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. Luego, Wunderkind normaliza y agrega estos eventos en relación con 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/exclusión. La supresión debe gestionarse de forma nativa en Braze. Nota: Para los clientes actuales de Wunderkind que migran a Braze Signals, Wunderkind trabaja con tu equipo para preservar tu configuración actual.
• Solo canal de correo electrónico. Actualmente no se admite SMS a través de esta integración.
• El perfil de usuario debe existir antes del desencadenador de 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 desencadenador de Canvas no crea un perfil completamente nuevo solo a partir del alias. El usuario debe crearse o actualizarse y el alias wknd_email_id debe establecerse primero (por ejemplo, usando /users/track o /users/identify). Wunderkind puede esperar brevemente después de esa operación de upsert para que Braze pueda terminar de procesar antes de activar el desencadenador.
• El correo electrónico como identificador. Si el desencadenador de Canvas identifica al destinatario con email en lugar de user_alias, incluye prioritization en ese objeto de destinatario, tal como lo requiere Braze.

Recursos adicionales

• Centro de ayuda de Wunderkind — Resumen de Signals para 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