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 fournisseur de services d’e-mailing 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, comme l’abandon de panier, l’abandon de produit ou 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 et associe leur identité à une adresse e-mail valide. Il transmet ensuite à Braze un payload de signal structuré via l’API d’entrée dans le Canvas, ce qui lance automatiquement vos flux d’e-mails préconfigurés.

Prérequis

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, ce qui déclenche en temps réel le parcours Canvas correspondant pour cet utilisateur.

Pour un aperçu technique complet, consultez le portail développeur de 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 répertoriées dans Accorder à Wunderkind l’accès à votre compte Braze.
4. Copiez la clé API pour la saisir dans la plateforme Wunderkind à la section suivante.

Remarque

Pour Wunderkind Signals, les requêtes de l’API REST de Braze sont authentifiées à l’aide d’une clé API REST, et non de jetons OAuth. Créez une clé API dédiée dans le tableau de bord et fournissez-la à Wunderkind.

Étape 2 : Connecter Braze à la plateforme Wunderkind

1. Connectez-vous à la plateforme Wunderkind et accédez à Integrations Hub.
2. Sélectionnez la vignette Braze, puis Connect.
3. Saisissez votre clé API REST Braze et sélectionnez votre cluster.
4. Sélectionnez Save.

Étape 3 : Examiner les nouvelles ressources Braze

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

Étape 4 : Terminer la configuration du Canvas

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

• Wunderkind renseigne les données de produit et de session dans l’objet context de chaque destinataire sur /canvas/trigger/send au moment de l’envoi.
• Pour savoir en détail comment utiliser Liquid avec ce payload dans vos modèles, consultez Terminer la configuration du Canvas dans le centre d’aide de Wunderkind.

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

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

• Pour éviter d’envoyer trop de messages à vos utilisateurs, consultez la section Limitation du débit centrée sur l’utilisateur.
• Ajustez les paramètres pour que les utilisateurs cessent de recevoir les messages du Canvas après avoir effectué un achat. Par exemple, ajoutez l’exception Effectuer un achat.
• Certains Canvas Signals sont préconfigurés avec des filtres d’attributs personnalisés afin que les utilisateurs reçoivent le message correspondant à l’intention la plus forte possible.
• Consultez Vérifier l’éligibilité au Canvas dans le centre d’aide de Wunderkind pour en savoir plus sur l’éligibilité et la priorité des Canvas.

Étape 6 : Tester et lancer

Wunderkind effectue un contrôle qualité de bout en bout avant la mise en ligne :

• Vérifier que les signaux sont bien envoyés aux bons ID de Canvas, sans erreur d’API.
• Vérifier que les champs context (nom du produit, image, URL) s’affichent correctement dans les modèles d’e-mail rendus.
• Consultez Tester et lancer Signals pour Braze dans le centre d’aide de Wunderkind pour savoir comment prévisualiser les modèles avec des produits Wunderkind fictifs.

Une fois le contrôle qualité validé, votre gestionnaire de déploiement Wunderkind coordonne le lancement en production avec votre équipe.

Payload de contexte de Canvas

Wunderkind prend en charge six types de signaux. Chacun transmet un ensemble distinct de clés et de valeurs dans l’objet context de chaque destinataire sur /canvas/trigger/send (voir Envoyer des messages Canvas via la livraison 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 à chaque Canvas et valeurs de WkPurpose

Exemples de payloads

Chaque objet de recipients doit inclure exactement un seul des identifiants suivants : external_user_id, user_alias, braze_id ou email. Pour plus d’informations, consultez l’objet Destinataires.

Remarque

Chaque exemple utilise un seul identifiant de destinataire Braze. Les six premiers utilisent uniquement user_alias ; le dernier utilise email avec prioritization uniquement. Le JSON d’exemple omet la clé WkChannel dans context afin que les outils de révision ne confondent pas sa valeur ("email") avec le champ email du destinataire Braze. En production, incluez "WkChannel": "email" dans context, comme indiqué dans le tableau des champs communs (tous les types de Canvas).

Les exemples suivants utilisent user_alias avec wknd_email_id, ce qui correspond à 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 que vous transmettez dans l’objet context de chaque destinataire deviennent des données d’entrée du 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, il suffit d’utiliser la bonne syntaxe Liquid.

N’imbriquez pas de balises de sortie Braze dans la condition de la balise for. Affectez d’abord le tableau Items de context à une variable, puis effectuez la boucle, comme décrit dans Utiliser Liquid. La ligne assign utilise la forme d’entrée Canvas de Braze {{context.${Items}}} (voir Étiquettes 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 :

Limites

• Aucune synchronisation des suppressions ni des désabonnements. Les suppressions doivent être gérées nativement dans Braze. Remarque : pour les clients Wunderkind existants qui migrent vers Braze Signals, Wunderkind collabore avec votre équipe afin de préserver votre configuration actuelle.
• Canal e-mail uniquement. Les SMS ne sont actuellement pas pris en charge par cette intégration.
• Le profil utilisateur doit exister avant le déclenchement du Canvas. /canvas/trigger/send avec un destinataire user_alias ne cible 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 du Canvas ne crée pas de nouveau profil à partir de l’alias seul. L’utilisateur doit d’abord être créé ou mis à jour, et l’alias wknd_email_id défini (par exemple, à l’aide de /users/track ou de /users/identify). Wunderkind peut attendre brièvement après cette mise à jour afin que Braze termine le traitement avant de lancer le déclencheur.
• L’e-mail comme identifiant. Si le déclencheur du Canvas identifie le destinataire avec email plutôt qu’avec user_alias, incluez prioritization dans cet objet destinataire, comme l’exige Braze.

Ressources supplémentaires

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