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 ermittelt hat, setzt die Orchestrierung diese Entscheidungen um, indem sie personalisierte Kommunikation über Ihre CEP auslöst.
Stellen Sie es sich so vor:
- Decisioning Studio entscheidet, was gesendet wird und wann es gesendet wird
- Ihre CEP übernimmt, wie es gesendet wird
CEP auswählen
Der erste Schritt besteht darin, zu entscheiden, 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 eine möglichst reibungslose 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, Segments 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 Sie für Ihre Campaigns verwenden möchten (zu finden unter Einstellungen > E-Mail-Einstellungen). |
| Basis-Templates | Die Nachrichten-Templates, die Ihr Agent für die Orchestrierung verwendet. Sie erstellen API-getriggerte Campaigns für jedes Template. |
| Testnutzer:in-ID | Eine Nutzer:in-ID zum Testen der Integration vor dem Launch. |
| 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. |
| Eigene Engineering-Ressourcen | Ihr Team muss die Integration aufbauen, um Empfehlungsdateien zu lesen und Kommunikation auszulösen. |
Campaigns planen
Bevor Sie die Orchestrierung einrichten, sollten Sie die folgenden Details berücksichtigen:
Basis-Templates
Ein Basis-Template ist jedes Nachrichten-Template, das Ihr Decisioning-Agent möglicherweise verwendet. Beachten Sie:
- Wie viele Templates? Ihr Agent kann mit einem oder mehreren Templates 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 personalisiert (z. B. Betreffzeilen, CTAs, Angebote, Timing). Diese werden zu API-Trigger-Eigenschaften oder dynamischen Platzhaltern.
Einstellungen für erneute Berechtigung
Ihre Campaigns sollten es Nutzer:innen ermöglichen, Nachrichten mehrfach zu erhalten:
- Zum Testen senden Sie dieselbe Campaign wiederholt an dieselbe:n Nutzer:in
- 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 für Tests 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
Planen Sie für Braze-Integrationen, welche Dimensionen Ihr Agent optimiert. Diese werden zu API-Trigger-Eigenschaften, die dynamische Werte an 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 Ihre Customer-Engagement-Plattform aus dieser Liste 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-Serviceleistungen-Team steht Ihnen dabei zur Verfügung):
Schritt 1: 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. | ✓ |
Schritt 2: API-getriggerte Campaigns einrichten
Richten Sie eine API-getriggerte Campaign für jedes Basis-Template ein, mit API-Trigger-Eigenschaften für alle optimierten Dimensionen.
Ein Basis-Template ist jedes Template, das der Decisioning Agent für die Orchestrierung von Nachrichten verwenden könnte. Ein Decisioning Agent kann ein einzelnes Basis-Template oder mehrere haben – in diesem Fall ist die Auswahl des richtigen Basis-Templates für jede:n Kund:in eine der Entscheidungen, die der Agent personalisiert.
Schritt 3: Wiederberechtigung 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 versendet, möchten Sie zu Testzwecken die Möglichkeit haben, dieselben Campaigns mehrmals am Tag zu versenden.
Schritt 4: 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. Die Konfiguration könnte folgendermaßen aussehen:
Wenn der Agent die Auswahl von Templates und die Call-to-Action-Nachricht (CTA) optimiert, sollte für jedes Template eine API-getriggerte Campaign erstellt werden. Der CTA-Bereich eines Templates könnte so aussehen:
Beispiel 2: Push-Campaign
Angenommen, ein Decisioning Studio Agent optimiert die Nachricht einer Push-Campaign. Die Konfiguration könnte folgendermaßen aussehen:
Das Ergebnis ist die folgende Nachricht:
Beispiel 3: SMS-Campaign
Angenommen, der Decisioning Studio Agent optimiert Felder in einer SMS-Campaign. Die Konfiguration könnte folgendermaßen aussehen:
Das Ergebnis ist die folgende Nachricht:
SFMC-Integration einrichten
Decisioning Studio unterstützt eine native Integration mit Salesforce Marketing Cloud. Decisioning Studio triggert API-Ereignisse in einer Journey mit den Daten, die zum Befüllen dynamischer Elemente erforderlich sind.
Für Ihre Konfiguration müssen API-IDs in Großbuchstaben eingegeben werden. Dies umfasst Journey-IDs, Campaign-IDs und alle anderen Bezeichner. Wenn API-IDs in Kleinbuchstaben eingegeben werden, Ihre SFMC-Daten jedoch UUIDs in Großbuchstaben enthalten, stimmen die Ereignisfilter nicht überein und die Berichtsmetriken werden nicht korrekt befüllt.
Andere CEP-Integrationen einrichten
Decisioning Studio kann mit jeder Customer-Engagement-Plattform integriert werden. Dies kann jedoch einige individuelle Entwicklungsarbeit 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 könnte die folgende Empfehlungsdatei:
verwendet werden, um eine E-Mail-Campaign zu optimieren, die folgendermaßen aussieht:
Best Practices
Behalten Sie diese Best Practices im Hinterkopf, wenn 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 wissen, was funktioniert.
- Testen Sie gründlich: Testen Sie Ihre Integration vor dem Start mit einer kleinen Gruppe von Nutzer:innen, um sicherzustellen, dass dynamischer Content korrekt befüllt wird.
- Dokumentieren Sie Ihr Setup: Behalten Sie den Überblick über Campaign-IDs, Template-IDs, API-Schlüssel und andere Bezeichner. Sie benötigen diese als Referenz im Decisioning Studio-Portal.
- Koordinieren Sie sich mit Ihrem Team: Das Orchestrierungs-Setup kann Marketing-, Engineering- und Daten-Teams einbeziehen. Stellen Sie sicher, dass alle ihre Rolle im Prozess verstehen.
- Planen Sie für Feedback-Daten: Die Orchestrierung sendet Nachrichten und sammelt Engagement- und Konversionsdaten, die Ihrem Agenten beim Lernen helfen. Weitere Details finden Sie unter Daten vorbereiten.
Nächste Schritte
Nachdem Sie die Orchestrierung eingerichtet haben, fahren Sie mit dem Design Ihres Agenten fort: