Wunderkind (Signals)

Wunderkind ist eine E-Commerce-Performance-Plattform, die proprietäre Identifizierungstechnologie nutzt, um anonyme Website-Besucher:innen zu erkennen und sie zu verwertbaren E-Mail-Adressen aufzulösen. Im Durchschnitt skaliert Wunderkind die Identifizierung von 3 bis 5 % des Website-Traffics auf 40 bis 60 %, sodass Marken personalisierte, eins-zu-eins-Nachrichten im großen Maßstab über ihren bestehenden ESP triggern können.

Diese Integration wird von Wunderkind gepflegt. Für Support besuchen Sie support.wunderkind.co.

Über die Integration

Die Integration von Wunderkind Signals ermöglicht es, Verhaltenssignale mit hoher Absicht – wie abgebrochener Einkauf, Produktabbruch und Preissenkungen – in Realtime Canvas-Journeys in Braze zu triggern. Wunderkind identifiziert anonyme Nutzer:innen auf Ihrer Website, löst deren Identität zu einer zustellbaren E-Mail-Adresse auf und liefert einen strukturierten Signal-Payload über die Canvas Entry API an Braze, wodurch Ihre vorkonfigurierten E-Mail-Flows automatisch gestartet werden.

Voraussetzungen

So funktioniert es

Wenn Wunderkind eine:n anonyme:n Nutzer:in mit hoher Absicht identifiziert und deren Identität auflöst, sendet es einen Signal-Payload über den /canvas/trigger/send-Endpunkt an Braze und triggert die entsprechende Canvas-Journey für diese:n Nutzer:in in Realtime.

Einen vollständigen technischen Überblick finden Sie im Wunderkind Developer Portal.

Integration

1. Schritt: Einen Braze-API-Schlüssel für Wunderkind erstellen

In Ihrem Braze-Dashboard:

1. Gehen Sie zu Einstellungen > API-Schlüssel und klicken Sie auf Neuen API-Schlüssel erstellen.
2. Geben Sie dem Schlüssel einen aussagekräftigen Namen (zum Beispiel Wunderkind Signals).
3. Gewähren Sie die Berechtigungen, die unter Wunderkind Zugang zu Ihrem Braze-Konto gewähren aufgeführt sind.
4. Kopieren Sie den API-Schlüssel, um ihn im nächsten Abschnitt in der Wunderkind-Plattform einzugeben.

Hinweis

Für Wunderkind Signals werden Braze REST API-Anfragen mit einem REST-API-Schlüssel authentifiziert, nicht mit OAuth-Token. Erstellen Sie einen dedizierten API-Schlüssel im Dashboard und stellen Sie diesen Schlüssel Wunderkind zur Verfügung.

2. Schritt: Braze mit der Wunderkind-Plattform verbinden

1. Melden Sie sich bei der Wunderkind-Plattform an und gehen Sie zum Integrations Hub.
2. Wählen Sie die Braze-Kachel und dann Connect aus.
3. Geben Sie Ihren Braze REST-API-Schlüssel ein und wählen Sie Ihren Cluster aus.
4. Wählen Sie Save aus.

3. Schritt: Neue Braze-Assets überprüfen

Nach der Aktivierung stellt Wunderkind neue Implementierungs-Assets in Ihrem Braze-Workspace bereit, basierend auf der mit Ihrer Wunderkind-Vertretung abgestimmten Strategie:

4. Schritt: Canvas-Einrichtung abschließen

Erstellen Sie für jeden Signals-Canvas Ihre E-Mail-Templates mit dem Drag-and-Drop-Editor oder HTML von Braze.

• Wunderkind befüllt Produkt- und Sitzungsdaten im context-Objekt jeder Empfängerin bzw. jedes Empfängers bei /canvas/trigger/send zum Sendezeitpunkt.
• Ausführliche Anleitungen zur Verwendung von Liquid mit diesem Payload in Ihren Templates finden Sie unter Canvas-Einrichtung abschließen im Wunderkind Help Center.

5. Schritt: Canvas-Berechtigung überprüfen

Gehen Sie für jeden Signals-Canvas zu den Target Audience-Einstellungen, um die Standard-Entry-Zielgruppe und Ausstiegskriterien von Wunderkind zu überprüfen.

• Um sicherzustellen, dass Sie Ihre Nutzer:innen nicht zu häufig kontaktieren, lesen Sie Nutzerzentriertes Rate-Limiting.
• Passen Sie die Einstellungen an, um zu verhindern, dass Nutzer:innen nach einem Kauf weiterhin Canvas-Nachrichten erhalten. Fügen Sie beispielsweise die Ausnahme Make Purchase hinzu.
• Bestimmte Signals-Canvases sind mit Filtern für angepasste Attribute vorkonfiguriert, damit Nutzer:innen die Nachricht mit der höchsten Absicht erhalten.
• Details zur Canvas-Berechtigung und Priorisierung finden Sie unter Canvas-Berechtigung überprüfen im Wunderkind Help Center.

6. Schritt: Testen und starten

Wunderkind führt vor dem Go-Live eine End-to-End-Qualitätssicherung durch:

• Bestätigen, dass Signale ohne API-Fehler an die richtigen Canvas-IDs zugestellt werden.
• Überprüfen, dass context-Felder (Produktname, Bild, URL) in den gerenderten E-Mail-Templates korrekt befüllt werden.
• Anleitungen zur Vorschau von Templates mit Wunderkind-Testprodukten finden Sie unter Signals für Braze testen und starten im Wunderkind Help Center.

Wenn die Qualitätssicherung bestanden ist, koordiniert Ihre Wunderkind-Implementierungsmanagerin bzw. Ihr Implementierungsmanager den Produktionsstart mit Ihrem Team.

Canvas-Kontext-Payload

Wunderkind unterstützt sechs Signaltypen. Jeder liefert einen eigenen Satz von Schlüsseln und Werten innerhalb des context-Objekts für die jeweilige Empfängerin bzw. den jeweiligen Empfänger bei /canvas/trigger/send (siehe Canvas-Nachrichten mit API-getriggerter Zustellung senden). Das Feld WkPurpose identifiziert den Signaltyp innerhalb dieses Payloads.

Gemeinsame Felder (alle Canvas-Typen)

Produktartikel-Felder

Canvas-spezifische Felder und WkPurpose-Werte

Beispiel-Payloads

Jedes Objekt in recipients muss genau eines der folgenden Felder enthalten: external_user_id, user_alias, braze_id oder email. Weitere Informationen finden Sie im Recipients-Objekt.

Hinweis

Jedes Beispiel verwendet einen Braze-Empfänger-Bezeichner. Die ersten sechs verwenden nur user_alias; das letzte verwendet nur email mit prioritization. Das Beispiel-JSON lässt den WkChannel-Schlüssel innerhalb von context weg, damit Überprüfungstools dessen Wert ("email") nicht mit dem Braze-Empfängerfeld email verwechseln. In der Produktion fügen Sie "WkChannel": "email" in context ein, wie in der Tabelle „Gemeinsame Felder (alle Canvas-Typen)“ dokumentiert.

Die folgenden Beispiele verwenden user_alias mit wknd_email_id, entsprechend der Art, wie Wunderkind Identitäten auflöst.

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

Beispiel für die Liquid-Verwendung

Wenn Wunderkind /canvas/trigger/send aufruft, werden die Schlüssel und Werte, die Sie im context-Objekt jeder Empfängerin bzw. jedes Empfängers übergeben, zu Canvas-Eingangsdaten. In Nachrichten-Schritten referenzieren Sie diese mit dem context-Liquid-Namespace. Ein Beispiel ist {{context.${WkPurpose}}}, wie unter Canvas-Kontext-Objekt und Nachricht beschrieben. Über die korrekte Liquid-Syntax hinaus ist keine zusätzliche Konfiguration erforderlich.

Verschachteln Sie keine Braze-Ausgabe-Tags innerhalb der for-Tag-Bedingung. Weisen Sie das Items-Array aus context zuerst einer Variablen zu und iterieren Sie dann darüber, wie unter Liquid verwenden beschrieben. Die assign-Zeile verwendet das Braze Canvas-Eingangsformat {{context.${Items}}} (siehe Unterstützte Personalisierungs-Tags).

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 nimmt Performance-Daten aus Braze über Braze-Currents auf, die Roh-Ereignisse an Google Cloud Storage streamen. Wunderkind normalisiert und aggregiert diese Ereignisse dann gegen das auslösende Signal für 1:1-Attribution-Reporting.

Die folgenden Metriken werden in Kürze im Wunderkind-Reporting-Dashboard verfügbar sein:

Einschränkungen

• Keine Unterdrückungs-/Opt-out-Synchronisierung. Die Unterdrückung muss nativ in Braze verwaltet werden. Hinweis: Für bestehende Wunderkind-Kund:innen, die zu Braze Signals migrieren, arbeitet Wunderkind mit Ihrem Team zusammen, um Ihre aktuelle Einrichtung beizubehalten.
• Nur E-Mail-Kanal. SMS wird derzeit über diese Integration nicht unterstützt.
• Nutzerprofil muss vor dem Canvas-Trigger existieren. /canvas/trigger/send mit einer user_alias-Empfängerin bzw. einem user_alias-Empfänger löst nur bestehende Braze-Profile auf, die diesen Alias bereits haben. Sie können send_to_existing_only nicht mit Aliasen verwenden, und der Canvas-Trigger erstellt kein komplett neues Profil allein aus dem Alias. Die Nutzerin bzw. der Nutzer muss zuerst erstellt oder aktualisiert und der wknd_email_id-Alias gesetzt werden (zum Beispiel mit /users/track oder /users/identify). Wunderkind wartet möglicherweise kurz nach diesem Upsert, damit Braze die Verarbeitung abschließen kann, bevor der Trigger ausgelöst wird.
• E-Mail als Bezeichner. Wenn der Canvas-Trigger die Empfängerin bzw. den Empfänger mit email anstelle von user_alias identifiziert, fügen Sie prioritization zu diesem Empfängerobjekt hinzu, wie von Braze gefordert.

Zusätzliche Ressourcen

• Wunderkind Help Center — Signals für Braze – Übersicht
• Wunderkind Developer Portal — Integrationsübersicht
• Canvas-Nachrichten mit API-getriggerter Zustellung senden
• Canvas-Kontext-Objekt
• Braze-Currents