Wunderkind (Signals)

Wunderkind est une plateforme de performance e-commerce qui utilise une technologie d’identification propriétaire pour reconnaître les visiteurs anonymes d’un site web et les associer à des adresses e-mail exploitables. En moyenne, Wunderkind fait passer l’identification de 3 à 5 % du trafic d’un site web à 40 à 60 %, permettant aux marques de déclencher des messages personnalisés et individuels à grande échelle via leur ESP existant.

Cette intégration est maintenue par Wunderkind. Pour obtenir de l’assistance, rendez-vous sur support.wunderkind.co.

À propos de l’intégration

L’intégration Wunderkind Signals permet à des signaux comportementaux à forte intention — tels que l’abandon de panier, l’abandon de produit et les baisses de prix — de déclencher des parcours Canvas en temps réel dans Braze. Wunderkind identifie les utilisateurs anonymes sur votre site web, résout leur identité vers une adresse e-mail exploitable, et transmet un payload de signal structuré à Braze via l’API Canvas Entry, initiant automatiquement vos flux d’e-mails préconfigurés.

Conditions préalables

Fonctionnement

Lorsque Wunderkind identifie un utilisateur anonyme à forte intention et résout son identité, il envoie un payload de signal à Braze via l’endpoint /canvas/trigger/send, déclenchant le parcours Canvas correspondant pour cet utilisateur en temps réel.

Pour un aperçu technique complet, consultez le Portail développeur Wunderkind.

Intégration

Étape 1 : Créer une clé API Braze pour Wunderkind

Dans votre tableau de bord de Braze :

1. Accédez à Paramètres > Clés API et cliquez sur Créer une nouvelle clé API.
2. Donnez à la clé un nom descriptif (par exemple, Wunderkind Signals).
3. Accordez les autorisations listées dans Accorder à Wunderkind l’accès à votre compte Braze.
4. Copiez la clé API pour la saisir dans la plateforme Wunderkind à l’étape suivante.

Étape 2 : Connecter Braze à la plateforme Wunderkind

1. Connectez-vous à la plateforme Wunderkind et accédez au Hub d’intégrations.
2. Sélectionnez la tuile Braze, puis sélectionnez Connect.
3. Saisissez votre clé API REST Braze et sélectionnez votre cluster.
4. Sélectionnez Enregistrer.

Étape 3 : Vérifier les nouvelles ressources Braze

Lors de l’activation, Wunderkind provisionne de nouvelles ressources d’implémentation dans votre espace de travail Braze en fonction de la stratégie définie avec votre conseiller Wunderkind :

Étape 4 : Finaliser la configuration du Canvas

Pour chaque Canvas Signals, créez vos modèles d’e-mails à l’aide de l’éditeur par glisser-déposer de Braze ou en HTML.

• Wunderkind renseigne les données produit et de session dans l’objet context de chaque destinataire sur /canvas/trigger/send au moment de l’envoi.
• Pour des instructions détaillées sur l’utilisation de Liquid avec ce payload dans vos modèles, consultez Finaliser la configuration du Canvas dans le Centre d’aide Wunderkind.

Étape 5 : Vérifier l’éligibilité du Canvas

Pour chaque Canvas Signals, accédez aux paramètres Audience cible pour vérifier l’audience d’entrée par défaut et les critères de sortie définis par Wunderkind.

• Pour vous assurer de ne pas envoyer trop de messages à vos utilisateurs, consultez Limitation du débit centrée sur l’utilisateur.
• Ajustez les paramètres pour empêcher les utilisateurs de continuer à recevoir des messages Canvas après un achat. Par exemple, ajoutez l’exception Effectuer un achat.
• Certains Canvas Signals sont préconfigurés avec des filtres d’attributs personnalisés pour que les utilisateurs reçoivent le message à la plus forte intention possible.
• Consultez Vérifier l’éligibilité du Canvas dans le Centre d’aide Wunderkind pour plus de détails sur l’éligibilité et la priorité des Canvas.

Étape 6 : Tester et lancer

Wunderkind effectue une assurance qualité de bout en bout avant la mise en production :

• Confirmer que les signaux sont transmis aux bons Canvas ID sans erreurs API.
• Vérifier que les champs context (nom du produit, image, URL) s’affichent correctement dans les modèles d’e-mails rendus.
• Consultez Tester et lancer Signals pour Braze dans le Centre d’aide Wunderkind pour les instructions de prévisualisation des modèles avec des produits Wunderkind fictifs.

Une fois l’assurance qualité validée, votre responsable d’implémentation Wunderkind coordonne le lancement en production avec votre équipe.

Payload de contexte Canvas

Wunderkind prend en charge six types de signaux. Chacun transmet un ensemble distinct de clés et de valeurs dans l’objet context pour ce destinataire sur /canvas/trigger/send (voir Envoyer des messages Canvas via une distribution déclenchée par API). Le champ WkPurpose identifie le type de signal dans ce payload.

Champs communs (tous les types de Canvas)

Champs des articles produit

Champs spécifiques au Canvas et valeurs de WkPurpose

Exemples de payloads

Chaque objet dans recipients doit inclure exactement l’un des éléments suivants : external_user_id, user_alias, braze_id ou email. Pour en savoir plus, consultez l’objet Recipients.

Les exemples suivants utilisent user_alias avec wknd_email_id, conformément à la manière dont Wunderkind résout les identités.

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"
          }
        ]
      }
    }
  ]
}

Exemple d’utilisation de Liquid

Lorsque Wunderkind appelle /canvas/trigger/send, les clés et valeurs transmises dans l’objet context de chaque destinataire deviennent des données d’entrée Canvas. Dans les étapes Message, référencez-les avec l’espace de noms Liquid context. Par exemple {{context.${WkPurpose}}}, comme décrit dans Objet de contexte Canvas et Message. Aucune configuration supplémentaire n’est nécessaire au-delà de l’utilisation de la syntaxe Liquid correcte.

N’imbriquez pas les balises de sortie Braze dans la condition de la balise for. Assignez d’abord le tableau Items depuis context à une variable, puis effectuez la boucle, comme décrit dans Utiliser Liquid. La ligne assign utilise le format d’entrée Canvas de Braze {{context.${Items}}} (voir Balises de personnalisation prises en charge).

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

Reporting

Wunderkind ingère les données de performance depuis Braze à l’aide de Braze Currents, qui diffuse les événements bruts vers Google Cloud Storage. Wunderkind normalise et agrège ensuite ces événements par rapport au signal d’origine pour un reporting d’attribution 1:1.

Les indicateurs suivants seront bientôt disponibles dans le tableau de bord de reporting Wunderkind :

Limitations

• Pas de synchronisation des suppressions/désinscriptions. La suppression doit être gérée nativement dans Braze. Remarque : pour les clients Wunderkind existants migrant vers Braze Signals, Wunderkind collabore avec votre équipe pour préserver votre configuration actuelle.
• Canal e-mail uniquement. Le SMS n’est actuellement pas pris en charge par cette intégration.
• Le profil utilisateur doit exister avant le déclencheur Canvas. /canvas/trigger/send avec un destinataire user_alias ne résout que les profils Braze existants qui possèdent déjà cet alias. Vous ne pouvez pas utiliser send_to_existing_only avec des alias, et le déclencheur Canvas ne crée pas de nouveau profil à partir de l’alias seul. L’utilisateur doit être créé ou mis à jour et l’alias wknd_email_id doit être défini au préalable (par exemple, en utilisant /users/track ou /users/identify). Wunderkind peut attendre brièvement après cette mise à jour afin que Braze termine le traitement avant de déclencher le signal.
• E-mail comme identifiant. Si le déclencheur Canvas identifie le destinataire avec email au lieu de user_alias, incluez prioritization dans l’objet destinataire, comme requis par Braze.

Ressources supplémentaires

• Centre d’aide Wunderkind — Aperçu de Signals pour Braze
• Portail développeur Wunderkind — Aperçu de l’intégration
• Envoyer des messages Canvas via une distribution déclenchée par API
• Objet de contexte Canvas
• Braze Currents