Wunderkind (Signals)

Wunderkind é uma plataforma de desempenho para eCommerce que usa tecnologia proprietária de identidade para reconhecer visitantes anônimos de sites e resolvê-los em endereços de e-mail acionáveis. Em média, a Wunderkind aumenta a identificação de 3 a 5% do tráfego do site para 40 a 60%, permitindo que as marcas disparem mensagens personalizadas, um a um, em escala por meio do provedor de serviços de e-mail existente.

Esta integração é mantida pela Wunderkind. Para suporte, acesse support.wunderkind.co.

Sobre a integração

A integração Wunderkind Signals permite que sinais comportamentais de alta intenção — como abandono de carrinho, abandono de produto e quedas de preço — disparem jornadas de Canvas em tempo real na Braze. O Wunderkind identifica usuários anônimos no seu website, resolve a identidade deles para um endereço de e-mail válido para entrega e envia uma carga útil de sinal estruturada para a Braze por meio da API de entrada do Canvas, iniciando automaticamente seus fluxos de e-mail pré-configurados.

Pré-requisitos

Como funciona

Quando a Wunderkind identifica um usuário anônimo com alta intenção e resolve sua identidade, ela envia uma carga útil de sinal para a Braze usando o endpoint /canvas/trigger/send, disparando a jornada Canvas relevante para esse usuário em tempo real.

Para uma visão geral técnica completa, consulte o Portal do Desenvolvedor Wunderkind.

Integração

Etapa 1: Criar uma chave de API da Braze para a Wunderkind

No seu dashboard da Braze:

1. Acesse Configurações > Chaves de API e clique em Criar nova chave de API.
2. Dê à chave um nome descritivo (por exemplo, Wunderkind Signals).
3. Conceda as permissões listadas em Conceder à Wunderkind acesso à sua conta da Braze.
4. Copie a chave de API para inseri-la na plataforma Wunderkind na próxima seção.

Nota

Para o Wunderkind Signals, as solicitações da REST API da Braze são autenticadas com uma chave da API REST, não com tokens OAuth. Crie uma chave de API dedicada no dashboard e forneça essa chave à Wunderkind.

Etapa 2: Conectar a Braze à plataforma Wunderkind

1. Faça login na plataforma Wunderkind e acesse o Integrations Hub.
2. Selecione o bloco Braze e, em seguida, selecione Connect.
3. Insira sua chave da API REST da Braze e selecione seu cluster.
4. Selecione Save.

Etapa 3: Revisar novos ativos da Braze

Após a ativação, a Wunderkind provisiona novos ativos de implementação no seu espaço de trabalho da Braze com base na estratégia alinhada com seu representante da Wunderkind:

Etapa 4: Concluir a configuração do Canvas

Para cada Canvas de Signals, crie seus modelos de e-mail usando o editor de arrastar e soltar ou HTML da Braze.

• A Wunderkind preenche os dados de produto e sessão no objeto context de cada destinatário em /canvas/trigger/send no momento do envio.
• Para instruções detalhadas sobre como usar Liquid com essa carga útil nos seus modelos, consulte Complete Canvas setup no Centro de Ajuda da Wunderkind.

Etapa 5: Revisar a elegibilidade do Canvas

Para cada Canvas de Signals, acesse as configurações de Target Audience para revisar o público de entrada padrão e os critérios de saída da Wunderkind.

• Para garantir que você não esteja enviando mensagens aos seus usuários com muita frequência, consulte Limite de frequência centrado no usuário.
• Ajuste as configurações para impedir que os usuários continuem recebendo mensagens do Canvas após realizarem uma compra. Por exemplo, adicione a exceção Make Purchase.
• Certos Canvas de Signals são pré-configurados com filtros de atributos personalizados para que os usuários recebam a mensagem de maior intenção possível.
• Consulte Review Canvas eligibility no Centro de Ajuda da Wunderkind para detalhes sobre elegibilidade e prioridade do Canvas.

Etapa 6: Testar e lançar

A Wunderkind realiza o QA de ponta a ponta antes de entrar em produção:

• Confirmar que os sinais estão sendo entregues aos IDs de Canvas corretos sem erros de API.
• Verificar se os campos de context (nome do produto, imagem, URL) estão sendo preenchidos corretamente nos modelos de e-mail renderizados.
• Consulte Test and launch Signals for Braze no Centro de Ajuda da Wunderkind para instruções sobre como pré-visualizar modelos com produtos simulados da Wunderkind.

Quando o QA for aprovado, seu gerente de implementação da Wunderkind coordenará o lançamento em produção com sua equipe.

Carga útil de contexto do Canvas

O Wunderkind suporta seis tipos de sinais. Cada um entrega um conjunto distinto de chaves e valores dentro do objeto context para aquele destinatário em /canvas/trigger/send (consulte Enviar mensagens do Canvas usando entrega disparada por API). O campo WkPurpose identifica o tipo de sinal dentro dessa carga útil.

Campos comuns (todos os tipos de Canvas)

Campos de item de produto

Campos específicos do Canvas e valores de WkPurpose

Exemplos de carga útil

Cada objeto em recipients deve incluir exatamente um entre external_user_id, user_alias, braze_id ou email. Para saber mais, consulte o Objeto de destinatários.

Nota

Cada exemplo usa um identificador de destinatário da Braze. Os seis primeiros usam apenas user_alias; o último usa email com prioritization apenas. O JSON de exemplo omite a chave WkChannel dentro de context para que as ferramentas de revisão não confundam o valor ("email") com o campo email de destinatário da Braze. Em produção, inclua "WkChannel": "email" em context conforme documentado na tabela de campos comuns (todos os tipos de Canvas).

Os exemplos a seguir usam user_alias com wknd_email_id, correspondendo à forma como o Wunderkind resolve 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"
          }
        ]
      }
    }
  ]
}

Exemplo de uso de Liquid

Quando o Wunderkind chama /canvas/trigger/send, as chaves e valores que você passa no objeto context de cada destinatário se tornam dados de entrada do Canvas. Nas etapas de mensagem, faça referência a eles com o namespace Liquid context. Um exemplo é {{context.${WkPurpose}}}, conforme descrito em Objeto de contexto do Canvas e Mensagem. Nenhuma configuração adicional é necessária além de usar a sintaxe Liquid correta.

Não aninhe tags de saída da Braze dentro da condição da tag for. Atribua o array Items de context a uma variável primeiro e, em seguida, faça o loop, conforme descrito em Usando Liquid. A linha assign usa o formato de entrada do Canvas da Braze {{context.${Items}}} (consulte Tags de personalização suportadas).

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 %}

Relatórios

O Wunderkind ingere dados de desempenho da Braze usando Braze Currents, que transmite eventos brutos para o Google Cloud Storage. Em seguida, o Wunderkind normaliza e agrega esses eventos em relação ao sinal de origem para relatórios de atribuição 1:1.

As seguintes métricas estarão disponíveis em breve no dashboard de relatórios do Wunderkind:

Limitações

• Sem sincronização de supressão/opt-out. A supressão deve ser gerenciada nativamente na Braze. Nota: Para clientes Wunderkind existentes que estão migrando para o Braze Signals, a Wunderkind trabalha com sua equipe para preservar a configuração atual.
• Apenas canal de e-mail. SMS não é suportado atualmente por essa integração.
• O perfil de usuário deve existir antes do disparador do Canvas. /canvas/trigger/send com um destinatário user_alias resolve apenas perfis da Braze existentes que já possuem esse alias. Não é possível usar send_to_existing_only com aliases, e o disparador do Canvas não cria um perfil totalmente novo apenas a partir do alias. O usuário deve ser criado ou atualizado e o alias wknd_email_id deve ser definido primeiro (por exemplo, usando /users/track ou /users/identify). A Wunderkind pode aguardar brevemente após esse upsert para que a Braze finalize o processamento antes de disparar o trigger.
• E-mail como identificador. Se o disparador do Canvas identifica o destinatário com email em vez de user_alias, inclua prioritization nesse objeto de destinatário, conforme exigido pela Braze.

Recursos adicionais

• Central de Ajuda da Wunderkind — Visão geral do Signals para Braze
• Portal do Desenvolvedor da Wunderkind — Visão geral da integração
• Enviar mensagens do Canvas usando entrega disparada por API
• Objeto de contexto do Canvas
• Braze Currents