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.

Sobre 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 Canvas en tiempo real en Braze. Wunderkind identifica usuarios anónimos en tu sitio web, resuelve su identidad a una dirección de correo electrónico entregable y envía una carga útil de señal estructurada a Braze a través de la API de entrada a Canvas, iniciando automáticamente tus flujos de correo electrónico preconfigurados.

Requisitos previos

Cómo funciona

Cuando Wunderkind identifica a un usuario anónimo de alta intención y resuelve su identidad, envía una carga útil de señal a Braze usando el punto de conexión /canvas/trigger/send, desencadenando el recorrido Canvas correspondiente para ese usuario en tiempo real.

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

Integración

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

En tu dashboard 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 listados en Conceder acceso a Wunderkind a tu cuenta de Braze.
4. Copia la clave de API para ingresarla en la plataforma Wunderkind en la siguiente sección.

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 Conectar.
3. Ingresa tu clave de API REST de Braze y selecciona tu clúster.
4. Selecciona Guardar.

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 según la estrategia alineada 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 usando 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 Completar la configuración de Canvas en el Centro de ayuda de Wunderkind.

Paso 5: Revisar la elegibilidad de Canvas

Para cada Canvas de Signals, ve a la configuración de Audiencia objetivo para revisar la audiencia de entrada predeterminada y los criterios de salida de Wunderkind.

• Para asegurarte de que no estás enviando 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 Realizar compra.
• Ciertos Canvas de Signals están preconfigurados con filtros de atributos personalizados para que los usuarios reciban el mensaje de mayor intención posible.
• Consulta Revisar la elegibilidad de Canvas en el Centro de ayuda de Wunderkind para 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:

• Confirma que las señales se entregan a los Canvas ID 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 instrucciones sobre cómo previsualizar plantillas con productos simulados 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 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 Canvas usando entrega activada 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ículo 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.

Los siguientes ejemplos usan user_alias con wknd_email_id, coincidiendo 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 de Canvas. En los pasos de mensaje, haz referencia a ellos con el espacio de nombres 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 Liquid correcta.

No anides etiquetas de salida de Braze dentro de la condición de la etiqueta for. Asigna primero el array Items de context a una variable y luego itera, como se describe en Uso de Liquid. La línea assign usa el formato 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 usando Braze Currents, que transmite eventos sin procesar a Google Cloud Storage. Wunderkind luego normaliza y agrega estos eventos contra la señal de origen para informes de atribución 1:1.

Las siguientes métricas estarán disponibles próximamente en el dashboard 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 clientes existentes de Wunderkind que migran a Braze Signals, Wunderkind trabaja con tu equipo para preservar tu configuración actual.
• Solo canal de correo electrónico. SMS no está soportado actualmente 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 resuelve solo 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 ser creado o actualizado 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 actualización para que Braze termine de procesar antes de disparar el desencadenador.
• 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, como lo requiere Braze.

Recursos adicionales

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