Zero-Copy-Personalisierung mit CDI

Erfahren Sie, wie Sie Canvas-Trigger mithilfe von CDI für eine Zero-Copy-Personalisierung synchronisieren. Dieses Feature greift auf nutzerspezifische Informationen aus Ihrer Datenspeicher-Lösung zu und überträgt sie an ein Ziel-Canvas. Canvas-Schritte können optional Personalisierungsfelder enthalten, die nicht dauerhaft in Braze-Nutzerprofilen gespeichert werden.

Canvas-Trigger synchronisieren

Schnellstart

Wenn Sie bereits mit Braze CDI vertraut sind, beachten Sie, dass die Einrichtung einer Canvas-Trigger-Synchronisierung weitgehend dem Prozess für Nutzerdaten-Synchronisierungen mit derselben Quelle folgt. Dabei gelten folgende Einschränkungen:

• Es werden nur externe IDs oder Nutzer-Alias-Bezeichner unterstützt. E-Mail-Adressen und Telefonnummern werden nicht als Bezeichner unterstützt.
• Es können nur bestehende Braze-Nutzer:innen synchronisiert werden. Neue Nutzer:innen können nicht angelegt werden.
• PROPERTIES ersetzt die Spalte PAYLOAD. Dabei handelt es sich um einen JSON-String mit den Feldern, die Sie als Canvas-Entry-Eigenschaften für die Personalisierung verwenden möchten.

Wählen Sie zum Start beim Erstellen einer neuen Synchronisierung den Datentyp Canvas-Trigger aus.

Schritt 1: Datenquelle für Canvas-Trigger einrichten

Um die Quelltabelle oder das Dateiformat für Ihre Quelle einzurichten, öffnen Sie die Seite Ihrer Quelle und wählen Sie den Tab Canvas-Trigger aus. Schließen Sie auf dieser Seite auch die Einrichtung der Zugangsdaten und des Netzwerks ab.

Wenn Sie bereits Zugangsdaten aus einer bestehenden Synchronisierung haben, können Sie diese wiederverwenden. Stellen Sie jedoch sicher, dass der Zugriff auf die Quelltabelle für Canvas-Trigger erweitert wird.

Schritt 2: Ziel-Canvas konfigurieren

1. Richten Sie Ihr Ziel-Canvas für Canvas-Trigger ein. Erstellen Sie ein neues API-getriggertes Canvas oder wählen Sie ein bestehendes aus. Unter Entry-Zeitplantypen erfahren Sie, wie Sie ein Canvas mit dem Zustellungs-Zeitplantyp „API-getriggert“ erstellen.
2. Nachdem Sie den Zustellungs-Zeitplantyp „API-getriggert“ ausgewählt haben, fahren Sie mit der Canvas-Einrichtung fort und erstellen Sie Ihr Canvas. Canvases reichen von einfachen Einzelnachrichten bis hin zu komplexen Kunden-Workflows mit mehreren Schritten.
3. Verwenden Sie in Ihren Canvas-Schritten Canvas-Entry-Eigenschaften, um Nachrichten mit Eigenschaftsfeldern zu personalisieren, die Sie aus Ihrer Quelltabelle synchronisieren möchten.
   • Wenn Sie beispielsweise in Schritt 1 ein Eigenschaftsfeld für account_balance angelegt haben, würden Sie folgendes Liquid-Template verwenden, um Ihre Nachricht zu personalisieren: \{\{canvas_entry_properties.\$\{account_balance\}\}\}.
4. Nachdem Sie Ihr Canvas erstellt haben, starten Sie es und fahren Sie mit Schritt 3 fort.

Schritt 3: Zero-Copy-Synchronisierung erstellen

Wenn die Einrichtung der Quelle abgeschlossen und das Ziel-Canvas gestartet ist, erstellen Sie eine neue Datensynchronisierung:

1. Gehen Sie in Braze zu Dateneinstellungen > Cloud-Datenaufnahme.
2. Richten Sie die Verbindung ein, indem Sie die Verbindungsdetails eingeben (oder bestehende Zugangsdaten wiederverwenden) und die Quelltabelle aus Schritt 1 angeben.
3. Geben Sie einen Namen für die Integration ein.
4. Wählen Sie den Datentyp Canvas-Trigger aus.
5. Wählen Sie Ihr Ziel-Canvas (aus Schritt 2) aus.
6. Wählen Sie eine Synchronisierungshäufigkeit aus.
7. Legen Sie die Benachrichtigungseinstellungen fest.
8. Wählen Sie Verbindung testen aus, um zu bestätigen, dass alles wie erwartet funktioniert. Wenn Sie eine Verbindung zu Snowflake herstellen, fügen Sie zunächst den im Dashboard angezeigten Public Key zu dem Nutzer hinzu, der für die Verbindung von Braze mit Snowflake angelegt wurde. Für diesen Schritt benötigen Sie in Snowflake mindestens SECURITYADMIN-Zugriff.
9. Speichern Sie die Synchronisierung, um mit der Synchronisierung der Canvas-Trigger zu beginnen.

Sobald die Synchronisierung läuft, treten die Nutzer:innen aus Ihrer Quelltabelle in das Canvas ein. Überwachen Sie die Performance mithilfe der Canvas-Analytics und der Seite mit den Synchronisierungsprotokollen der Cloud-Datenaufnahme.

Tipp

Überprüfen Sie Ihre gesamte Konfiguration (vom Synchronisierungsverhalten bis zur Canvas-Einrichtung), um unerwartete Sendungen zu vermeiden. Canvas-Einstellungen wie Rate-Limiting, Frequency-Capping und Segmentierungsfilter können die Zustellung von Nachrichten zusätzlich verfeinern.

Braze empfiehlt, vor der Umsetzung produktiver Anwendungsfälle einen Testlauf mit einer kleinen Zielgruppe oder einer Testzielgruppe durchzuführen.

Überlegungen

CDI-Canvas-Trigger nutzen Ihr REST API Rate-Limit für /canvas/trigger/send. Wenn Sie diesen Endpunkt gleichzeitig mit CDI-Canvas-Triggern und Ihrer REST-API-Integration verwenden, wird die kombinierte Nutzung auf Ihr Rate-Limit angerechnet.

Jeder Synchronisierungslauf lässt Nutzer:innen mit einer maximalen Rate von etwa 3,75 Millionen Nutzer:innen pro Stunde in das jeweilige Ziel-Canvas eintreten. Rechnen Sie mit längeren Zeiten von der Quelle bis zum Canvas-Eintritt, wenn Sie:

• mehr als 3,75 Millionen Nutzer:innen pro Synchronisierungslauf synchronisieren.
• CDI-Canvas-Trigger verwenden, während Sie das Rate-Limit Ihrer REST API für /canvas/trigger/send bereits ausschöpfen.

Beachten Sie Folgendes zu Zero-Copy-CDI, wenn Message Archiving aktiviert ist:

• Die Ergebnisse der Tabelle werden während der Verarbeitung vorübergehend in Braze gespeichert. Außerdem werden sie für 30 Tage nach Snowflake exportiert, damit Sie genau sehen können, was synchronisiert wurde.
• Archivierte Nachrichten werden nirgendwo innerhalb von Braze gespeichert. Die Kopien werden ausschließlich an Ihren konfigurierten Speicher gesendet und dort abgelegt.
• Wenn Sie Zero-Copy-CDI mit Canvas-Triggern verwenden, speichert Braze keine Sicherungskopie der Abfrageergebnisse aus dem Data Warehouse, und es werden keine Daten in das Nutzerprofil kopiert.
• Canvas-Kontexteigenschaften können bis zu 30 Tage lang in internen Systemen protokolliert werden.