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 E-Mail-Anbieter triggern können.

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

Über die Integration

Die Wunderkind Signals-Integration ermöglicht es, verhaltensbasierte Signale mit hoher Kaufabsicht – wie abgebrochene Einkäufe, Produktabbrüche und Preissenkungen – zu nutzen, um in Braze Realtime-Canvas-Journeys auszulösen. Wunderkind identifiziert anonyme Nutzer:innen auf Ihrer Website, löst deren Identität zu einer zustellbaren E-Mail-Adresse auf und übermittelt ein strukturiertes Signal-Payload über die Canvas Entry API an Braze, um Ihre vorkonfigurierten E-Mail-Flows automatisch zu starten.

Voraussetzungen

Funktionsweise

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

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

Integration

Schritt 1: 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.

Schritt 2: 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.

Schritt 3: 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:

Schritt 4: 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.

Schritt 5: Canvas-Berechtigung überprüfen

Gehen Sie für jeden Signals-Canvas zu den Target Audience-Einstellungen, um die Standard-Entry-Zielgruppe und Exit-Kriterien 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.

Schritt 6: 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 über API-getriggerte Zustellung senden). Das Feld WkPurpose identifiziert den Signaltyp innerhalb dieses Payloads.

Gemeinsame Felder (alle Canvas-Typen)

Produktartikelfelder

Canvas-spezifische Felder und WkPurpose-Werte

Beispiel-Payloads

Jedes Objekt in recipients muss genau eines der Felder external_user_id, user_alias, braze_id oder email enthalten. Weitere Informationen finden Sie unter Empfängerobjekt.

Hinweis

Jedes Beispiel verwendet einen Braze-Empfängerbezeichner. Die ersten sechs verwenden nur user_alias; das letzte verwendet email mit prioritization. Im Beispiel-JSON wird der Schlüssel WkChannel innerhalb von context weggelassen, damit Prüftools seinen 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 Identitätsauflösung von Wunderkind.

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-Entry-Daten. In Nachrichtenschritten referenzieren Sie diese über den Liquid-Namespace context. Ein Beispiel ist {{context.${WkPurpose}}}, wie unter Canvas-Kontextobjekt und Nachricht beschrieben. Über die korrekte Liquid-Syntax hinaus ist keine weitere Konfiguration erforderlich.

Verschachteln Sie keine Braze-Ausgabetags innerhalb der for-Tag-Bedingung. Weisen Sie das Items-Array aus context zuerst einer Variablen zu und iterieren Sie dann, wie unter Liquid verwenden beschrieben. Die assign-Zeile verwendet das Canvas-Entry-Format von Braze {{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 Synchronisierung von Unterdrückung/Opt-out. 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 durch diese Integration nicht unterstützt.
• Das Nutzerprofil muss vor dem Canvas-Trigger existieren. /canvas/trigger/send mit einem user_alias-Empfänger löst nur bestehende Braze-Profile auf, die diesen Alias bereits besitzen. Sie können send_to_existing_only nicht mit Aliassen verwenden, und der Canvas-Trigger erstellt kein völlig neues Profil allein aus dem Alias. Die Nutzer:innen müssen zuerst erstellt oder aktualisiert und der wknd_email_id-Alias gesetzt werden (beispielsweise über /users/track oder /users/identify). Wunderkind wartet nach diesem Upsert möglicherweise kurz, damit Braze die Verarbeitung abschließen kann, bevor der Trigger ausgelöst wird.
• E-Mail als Bezeichner. Wenn der Canvas-Trigger die Empfänger:innen mit email statt mit user_alias identifiziert, fügen Sie prioritization zu diesem Empfängerobjekt hinzu, wie von Braze gefordert.

Weitere Ressourcen

• Wunderkind Help Center — Signals for Braze Overview
• Wunderkind Developer Portal — Integration Overview
• Canvas-Nachrichten mit API-getriggerter Zustellung senden
• Canvas-Kontextobjekt
• Braze-Currents