Orchestrierung einrichten
Decisioning Agents müssen sich mit einer Customer-Engagement-Plattform (CEP) verbinden, um Kommunikation zu orchestrieren, nachdem sie Kundendaten aufgenommen und auf 1:1-Ebene personalisiert haben. Dieser Artikel beschreibt, was Sie vorbereiten müssen und wie Sie die Integration für jede unterstützte CEP konfigurieren.
Was ist Orchestrierung?
Orchestrierung ist die Verbindung zwischen Decisioning Studio und Ihrer Customer-Engagement-Plattform (CEP). Sobald Ihr Decisioning Agent die optimale Aktion für jede:n Kund:in bestimmt hat, führt die Orchestrierung diese Entscheidungen aus, indem sie personalisierte Kommunikation über Ihre CEP triggert.
Stellen Sie es sich so vor:
- Decisioning Studio entscheidet, was gesendet wird und wann es gesendet wird
- Ihre CEP übernimmt, wie es gesendet wird
Wählen Sie Ihre CEP
Der erste Schritt besteht darin, zu wählen, welche CEP Sie mit Decisioning Studio verwenden möchten. Ihre Wahl beeinflusst die Komplexität der Einrichtung und die verfügbaren Features.
Unterstützte CEPs
| CEP | Integrationstyp | Komplexität der Einrichtung |
|---|---|---|
| Braze | Native API-Integration (empfohlen) | Niedrig |
| Salesforce Marketing Cloud | API-Events + Journey Builder | Mittel |
| Andere CEPs | Angepasst (Empfehlungsdatei) | Hoch |
Wenn Sie Braze bereits als Ihre CEP verwenden, empfehlen wir die native Braze-Integration für die reibungsloseste Einrichtung.
Voraussetzungen
Bevor Sie die Orchestrierung einrichten, sammeln Sie die folgenden Elemente basierend auf Ihrer gewählten CEP.
| Anforderung | Beschreibung |
|---|---|
| REST-API-Schlüssel | Ein neuer API-Schlüssel mit Berechtigungen für Nutzerdaten, Nachrichten, Campaigns, Canvas, Segmente und Templates. |
| Braze-Dashboard-URL | Die URL Ihrer Braze-Instanz (zum Beispiel https://dashboard-01.braze.com). |
| App-ID | Der API-Schlüssel, der mit der App verknüpft ist, die Sie tracken möchten (zu finden unter Einstellungen > App-Einstellungen). |
| E-Mail-Anzeigename und -Adresse | Die Absenderinformationen, die für Ihre Campaigns verwendet werden sollen (zu finden unter Einstellungen > E-Mail-Präferenzen). |
| Basis-Templates | Die Nachrichten-Templates, die Ihr Agent für die Orchestrierung verwenden wird. Sie erstellen API-getriggerte Campaigns für jedes Template. |
| Testnutzer:in-ID | Eine Nutzer-ID zum Testen der Integration vor dem Start. |
| Anforderung | Beschreibung |
|---|---|
| App-Paket-Zugangsdaten | Client-ID, Client Secret, Authentication Base URI, REST Base URI und SOAP Base URI aus einem installierten Paket mit Server-zu-Server-API-Integration. |
| API-Berechtigungen | Scopes für Kanäle, Assets, Automatisierungen, Journeys, Kontakte, Data Extensions und Tracking-Events. |
| Data Extensions | Sie benötigen Data Extensions für Abonnent:innen-Daten, Engagement-Daten und Empfehlungen. |
| E-Mail-Templates | Die Templates, die Decisioning Studio verwenden soll, mit Template-IDs für jedes einzelne. |
| Journey Builder-Zugang | Zugang zum Erstellen und Aktivieren von mehrstufigen Journeys mit API-Event-Einstiegsquellen. |
Wenn Sie eine andere CEP als Braze oder Salesforce Marketing Cloud verwenden, kann Decisioning Studio über einen Empfehlungsdatei-Ansatz integriert werden:
| Element | Beschreibung |
|---|---|
| Datenaufnahme-Fähigkeit | Ihre CEP muss in der Lage sein, Empfehlungsdateien (typischerweise CSV oder JSON) aufzunehmen, die personalisierte Entscheidungen für jede:n Kund:in enthalten. |
| Unterstützung für dynamischen Content | Ihre Campaigns müssen das dynamische Befüllen von Feldern basierend auf Empfehlungsdaten unterstützen. |
| Angepasste Engineering-Ressourcen | Ihr Team muss die Integration erstellen, um Empfehlungsdateien zu lesen und Kommunikation zu triggern. |
Planen Sie Ihre Campaigns
Bevor Sie die Orchestrierung einrichten, berücksichtigen Sie die folgenden Details:
Basis-Templates
Ein Basis-Template ist jedes Nachrichten-Template, das Ihr Decisioning Agent verwenden könnte. Berücksichtigen Sie:
- Wie viele Templates? Ihr Agent kann mit einem Template oder mehreren arbeiten. Bei mehreren kann der Agent personalisieren, welches Template jede:r Kund:in erhält.
- Welche Kanäle? E-Mail, Push, SMS oder eine Kombination. Jeder Kanal kann separate Templates und Campaigns erfordern.
- Welche dynamischen Elemente? Identifizieren Sie, welche Teile Ihrer Nachricht der Agent personalisieren wird (Betreffzeilen, CTAs, Angebote, Timing usw.). Diese werden zu API-Trigger-Eigenschaften oder dynamischen Platzhaltern.
Einstellungen zur erneuten Berechtigung
Ihre Campaigns sollten es Nutzer:innen ermöglichen, Nachrichten mehrfach zu erhalten:
- Zum Testen möchten Sie dieselbe Campaign wiederholt an dieselbe:n Nutzer:in senden
- In der Produktion kann der Agent bestimmen, dass dieselbe Campaign an aufeinanderfolgenden Tagen optimal für eine:n Nutzer:in ist
Während Sie die erneute Berechtigung zum Testen einrichten, sind Decisioning Studio Agents so konzipiert, dass sie Frequency Caps respektieren und dieselbe Campaign in der Produktion nicht mehr als einmal pro Tag an eine:n Nutzer:in senden.
API-Trigger-Eigenschaften
Für Braze-Integrationen planen Sie, welche Dimensionen Ihr Agent optimieren wird. Diese werden zu API-Trigger-Eigenschaften, die dynamische Werte in Ihre Campaigns übergeben:
| Beispieldimension | API-Trigger-Eigenschaft |
|---|---|
| Betreffzeile | {{api_trigger_properties.${subject_line}}} |
| Call to Action | {{api_trigger_properties.${cta_message}}} |
| Angebot | {{api_trigger_properties.${offer_id}}} |
| Rabattbetrag | {{api_trigger_properties.${discount}}} |
Einrichtung der Integration
Wählen Sie unten Ihre CEP aus, um mit der Einrichtung der Integration zu beginnen.
Braze-Integration einrichten
Befolgen Sie diese Schritte, um einen Decisioning Studio Agent mit den Orchestrierungsfunktionen von Braze zu integrieren (das Braze-Serviceteam steht Ihnen zur Unterstützung zur Verfügung):
1. Schritt: API-Schlüssel erstellen
Gehen Sie zu Einstellungen > API-Schlüssel und erstellen Sie einen neuen Schlüssel mit den folgenden Berechtigungen:
| Berechtigung | Zweck | Erforderlich? |
|---|---|---|
/users/track |
Aktualisiert angepasste Attribute in Nutzerprofilen und erstellt zusätzlich temporäre Nutzerprofile, wenn Sie Testsendungen verwenden. | ✓ |
/users/delete |
Löscht temporäre Nutzerprofile, die während der Verwendung von Testsendungen erstellt wurden. | Nur für Testsendungen |
/users/export/segment |
Aktualisiert die verfügbaren Zielgruppen-Kommunikationen jeden Morgen, indem die Liste der Nutzer:innen aus jedem ausgewählten Segment exportiert wird. | ✓ |
/users/export/ids |
Ruft eine Liste von Bezeichnern ab, wenn das Targeting von Nutzer:innen über eine external_id anstelle eines Segments erfolgt. Da Decisioning Studio keine personenbezogenen Daten (PII) akzeptiert, müssen Sie sicherstellen, dass Ihr fields_to_export-Parameter nur Felder ohne PII zurückgibt. |
Nur bei Verwendung von external_ids |
/messages/send |
Versendet empfohlene Varianten zum empfohlenen Zeitpunkt mithilfe von API-Kampagnen, die für den Experimentator von Decisioning Studio konfiguriert sind. | ✓ |
/campaigns/list |
Ruft die Liste der aktiven Kampagnen ab und extrahiert verfügbare E-Mail-Inhalte für Experimente. | ✓ |
/campaigns/data_series |
Exportiert aggregierte Kampagnendaten, um Berichterstellung, Validierung und Fehlerbehebung in Decisioning Studio zu ermöglichen, sodass Sie Berichtswerte vergleichen und die Basis-Performance analysieren können. Diese Berechtigung ist zwar nicht erforderlich, wird aber empfohlen. |
|
/campaigns/details |
Ruft HTML-Inhalte, Betreffzeilen und Bildressourcen aus bestehenden Campaigns für Experimente ab. | ✓ |
/canvas/list |
Ruft die Liste der aktiven Canvases ab, um verfügbare E-Mail-Inhalte für Experimente zu extrahieren. | ✓ |
/canvas/data_series |
Exportiert aggregierte Canvas-Daten für Berichterstellung und Validierung, insbesondere wenn BAU über Canvas orchestriert wird. Diese Berechtigung ist zwar nicht erforderlich, wird aber empfohlen. |
|
/canvas/details |
Ruft HTML-Inhalte, Betreffzeilen und Bildressourcen aus bestehenden Canvases für Experimente ab. | ✓ |
/segments/list |
Ruft alle vorhandenen Segmente als potenzielle Zielgruppen für den Decisioning-Studio-Experimentator ab. | ✓ |
/segments/data_series |
Exportiert Informationen zur Segmentgröße, die in Decisioning Studio bei der Auswahl einer Zielgruppe angezeigt werden. | ✓ |
/segments/details |
Ruft Segmentdetails wie Eingangs- und Exit-Kriterien ab, um Veränderungen in der Zielgruppengröße oder Performance besser zu verstehen. | |
/templates/email/create |
Erstellt Kopien ausgewählter Basis-HTML-Templates mit dynamischen Platzhaltern (Liquid-Tags von Braze) für Experimente und vermeidet so Änderungen an den Originalen. | ✓ |
/templates/email/update |
Überträgt Updates an die von Decisioning Studio erstellten Template-Kopien, wenn sich die Experimentierkriterien ändern, beispielsweise bei Handlungsaufforderungen. | ✓ |
/templates/email/info |
Ruft Informationen zu den von Decisioning Studio erstellten Templates in Ihrer Braze-Instanz ab. | ✓ |
/templates/email/list |
Überprüft, ob die Templates erfolgreich in Ihre Braze-Instanz kopiert wurden. | ✓ |
2. Schritt: API-getriggerte Campaigns einrichten
Richten Sie eine API-getriggerte Campaign für jedes Basis-Template mit API-Trigger-Eigenschaften für alle optimierten Dimensionen ein.
Ein Basis-Template ist jedes Template, das der Decisioning Agent für die Orchestrierung von Nachrichten verwenden könnte. Ein Decisioning Agent kann 1 Basis-Template oder mehrere haben. Im letzteren Fall wird die Auswahl des richtigen Basis-Templates für jede:n Kund:in eine der Entscheidungen sein, die der Agent personalisiert.
3. Schritt: Erneute Berechtigung konfigurieren
Stellen Sie sicher, dass alle API-getriggerten Campaigns es Nutzer:innen ermöglichen, innerhalb von 15 Minuten erneut berechtigt zu werden.
Obwohl der Decisioning Studio Agent dieselbe Campaign nie mehr als einmal pro Tag sendet, möchten Sie die Möglichkeit haben, dieselben Campaigns zu Testzwecken mehrmals am Tag zu senden.
4. Schritt: Dynamische Platzhalter hinzufügen
Diese dienen als dynamische Platzhalter für Entscheidungen, die der Decisioning Studio Agent optimiert.
Beispiel 1: E-Mail-Campaign
Angenommen, der Decisioning Studio Agent optimiert eine E-Mail-Campaign. Dies könnte so konfiguriert werden:
Angenommen, der Agent optimiert die Auswahl von Templates und Call-to-Action-(CTA)-Nachrichten, dann sollte eine API-getriggerte Campaign für jedes Template erstellt werden, und der CTA-Abschnitt eines Templates könnte so aussehen:
Beispiel 2: Push-Campaign
Angenommen, ein Decisioning Studio Agent optimiert die Nachricht einer Push-Campaign. Dies könnte so konfiguriert werden:
Das Ergebnis ist die folgende Nachricht:
Beispiel 3: SMS-Campaign
Angenommen, der Decisioning Studio Agent optimiert Felder in einer SMS-Campaign. Dies könnte so konfiguriert werden:
Das Ergebnis ist die folgende Nachricht:
SFMC-Integration einrichten
Decisioning Studio unterstützt eine native Integration mit Salesforce Marketing Cloud. Decisioning Studio triggert API-Events in eine Journey mit den Daten, die zum Befüllen dynamischer Elemente erforderlich sind.
Für detaillierte Schritte zur Konfiguration der SFMC-Integration folgen Sie den SFMC-Anweisungen in der Decisioning Studio Go-Dokumentation.
Andere CEP-Integrationen einrichten
Decisioning Studio kann mit jeder Customer-Engagement-Plattform integriert werden. Dies kann jedoch einige angepasste Engineering-Arbeit von Ihrem Team erfordern, da Decisioning Studio Kommunikation nicht direkt triggern kann.
In diesem Szenario liefert der Agent eine „Empfehlungsdatei“. Diese Datei enthält Zeilen für jede:n Kund:in mit Spalten, die alle personalisierten Entscheidungen für diese:n Kund:in angeben.
Zum Beispiel die folgende Empfehlungsdatei:
Könnte verwendet werden, um eine E-Mail-Campaign zu optimieren, die so aussieht:
Best Practices
Behalten Sie diese Best Practices im Hinterkopf, während Sie sich auf die Orchestrierung vorbereiten:
- Beginnen Sie mit einem engen Umfang. Verwenden Sie zunächst einen Kanal und ein oder zwei Templates. Sie können später erweitern, wenn Sie gelernt haben, was funktioniert.
- Testen Sie gründlich. Bevor Sie starten, testen Sie Ihre Integration mit einer kleinen Gruppe von Nutzer:innen, um zu überprüfen, dass dynamischer Content korrekt befüllt wird.
- Dokumentieren Sie Ihre Einrichtung. Behalten Sie den Überblick über Campaign-IDs, Template-IDs, API-Schlüssel und andere Bezeichner. Sie müssen diese im Decisioning Studio-Portal referenzieren.
- Koordinieren Sie mit Ihrem Team. Die Einrichtung der Orchestrierung kann Marketing-, Engineering- und Datenteams einbeziehen. Stellen Sie sicher, dass alle ihre Rolle im Prozess verstehen.
- Planen Sie für Feedback-Daten. Orchestrierung umfasst das Senden von Nachrichten und das Sammeln von Engagement- und Conversion-Daten, die Ihrem Agent beim Lernen helfen. Weitere Details finden Sie unter Bereiten Sie Ihre Daten vor.
Nächste Schritte
Nachdem Sie die Orchestrierung eingerichtet haben, fahren Sie mit dem Entwerfen Ihres Agents fort: