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 do Canvas em tempo real na Braze. A Wunderkind identifica usuários anônimos no seu website e resolve a identidade deles para um endereço de e-mail válido para entrega. Em seguida, envia uma carga útil de sinal estruturada para a Braze pela 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 de compra e resolve a identidade dele, ela envia uma carga útil de sinal para a Braze usando o endpoint /canvas/trigger/send. Isso dispara a jornada do Canvas relevante para esse usuário em tempo real.

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

Integração

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

No 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 Braze.
4. Copie a chave de API para inseri-la na plataforma da Wunderkind na próxima seção.

Nota

No Wunderkind Signals, as solicitações da REST API da Braze são autenticadas com uma chave da API REST, e 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 da Wunderkind

1. Faça login na plataforma da Wunderkind e acesse 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 os 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 do Signals, crie seus modelos de e-mail usando o editor de arrastar e soltar da Braze ou HTML.

• 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 obter instruções detalhadas sobre como usar Liquid com essa carga útil nos seus modelos, consulte Concluir a configuração do Canvas na Central de Ajuda da Wunderkind.

Etapa 5: Revisar a elegibilidade do Canvas

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

• Para garantir que você não está enviando mensagens aos seus usuários com muita frequência, consulte Limite de frequência centrado no usuário.
• Ajuste as configurações para evitar que os usuários continuem recebendo mensagens do Canvas depois de fazerem uma compra. Por exemplo, adicione a exceção Fazer compra.
• Alguns Canvas do Signals vêm pré-configurados com filtros de atributos personalizados para que os usuários recebam a mensagem de maior intenção possível.
• Consulte Revisar a elegibilidade do Canvas na Central de Ajuda da Wunderkind para obter detalhes sobre a elegibilidade e a prioridade do Canvas.

Etapa 6: Testar e lançar

A Wunderkind realiza um controle de qualidade de ponta a ponta antes da entrada em produção:

• Confirme que os sinais estão sendo entregues aos IDs de Canvas corretos, sem erros de API.
• Verifique se os campos de context (nome do produto, imagem, URL) estão sendo preenchidos corretamente nos modelos de e-mail renderizados.
• Consulte Testar e lançar o Signals para a Braze na Central de Ajuda da Wunderkind para obter instruções sobre como visualizar a prévia dos modelos com produtos simulados da Wunderkind.

Quando o controle de qualidade for aprovado, seu gerente de implementação da Wunderkind coordena o lançamento em produção com sua equipe.

Carga útil de contexto do Canvas

A Wunderkind oferece suporte a seis tipos de sinal. Cada um entrega um conjunto distinto de chaves e valores dentro do objeto context desse 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 do item de produto

Campos específicos de cada 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 apenas com prioritization. O JSON de exemplo omite a chave WkChannel dentro de context para que as ferramentas de revisão não confundam o valor dela ("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, de acordo com a forma como a 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 a Wunderkind chama /canvas/trigger/send, as chaves e os 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 extra é 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. Primeiro, atribua o array Items de context a uma variável e depois faça o loop, conforme descrito em Usar Liquid. A linha assign usa o formato de entrada do Canvas da Braze {{context.${Items}}} (consulte Tags de personalização compatíveis).

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

A Wunderkind ingere dados de desempenho da Braze usando o Braze Currents, que transmite eventos brutos para o Google Cloud Storage. Em seguida, a Wunderkind normaliza e agrega esses eventos com base no sinal de origem para gerar relatórios de atribuição 1:1.

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

Limitações

• Sem sincronização de supressão/cancelamento de inscrição. A supressão precisa ser gerenciada nativamente na Braze. Nota: para clientes atuais da Wunderkind que estão migrando para o Braze Signals, a Wunderkind trabalha com sua equipe para preservar sua configuração atual.
• Somente canal de e-mail. No momento, o SMS não é compatível com esta integração.
• O perfil de usuário precisa existir antes do disparo do Canvas. O /canvas/trigger/send com um destinatário user_alias só encontra perfis da Braze já existentes que tenham esse alias. Não é possível usar send_to_existing_only com aliases, e o disparo do Canvas não cria um perfil novo apenas a partir do alias. Primeiro, o usuário precisa ser criado ou atualizado e o alias wknd_email_id precisa ser definido (por exemplo, usando /users/track ou /users/identify). A Wunderkind pode aguardar alguns instantes após essa atualização para que a Braze conclua o processamento antes de disparar o Canvas.
• E-mail como identificador. Se o disparo do Canvas identificar 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 for Braze
• Portal do Desenvolvedor da Wunderkind — Visão geral da integração
• Envie mensagens do Canvas usando entrega disparada por API
• Objeto de contexto do Canvas
• Braze Currents