Cloud Data Ingestion für Amazon S3
Auf dieser Seite finden Sie alles, was Sie benötigen, um Daten mit Cloud Data Ingestion (CDI) von Amazon S3 mit Braze zu synchronisieren: die zu erstellenden AWS-Ressourcen, wie Sie die Quelle verbinden und eine Synchronisierung in Braze erstellen, das Dateiformat für jeden Datentyp sowie S3-spezifische Fehlerbehebung.
Funktionsweise
Amazon S3-Integrationen sind ereignisgesteuert und nicht zeitgesteuert. Wenn neue Dateien in S3 veröffentlicht werden, wird eine Nachricht in einer Amazon Simple Queue Service (SQS)-Warteschlange veröffentlicht. Braze verarbeitet diese Nachricht, um die neue Datei aufzunehmen.
Für die Integration sind die folgenden Ressourcen erforderlich:
- S3-Bucket für die Datenspeicherung
- SQS-Warteschlange für Benachrichtigungen über neue Dateien
- IAM-Rolle für den Zugriff durch Braze
AWS-Definitionen
| Begriff | Definition |
|---|---|
| Amazon Resource Name (ARN) | Der ARN ist ein eindeutiger Bezeichner für AWS-Ressourcen. |
| Identity and Access Management (IAM) | IAM ist ein Webdienst, mit dem Sie den Zugriff auf AWS-Ressourcen sicher steuern können. In diesem Tutorial erstellen Sie eine IAM-Richtlinie und weisen sie einer IAM-Rolle zu, um Ihren S3-Bucket in Braze Cloud Data Ingestion zu integrieren. |
| Amazon Simple Queue Service (SQS) | SQS ist eine gehostete Warteschlange, mit der Sie verteilte Softwaresysteme und -komponenten integrieren können. |
Cloud Data Ingestion in AWS einrichten
Schritt 1: Quell-Bucket erstellen
Erstellen Sie in Ihrem AWS-Konto ein Allzweck-S3-Bucket mit den Standardeinstellungen. S3-Buckets können für mehrere Synchronisierungen wiederverwendet werden, solange der Ordner eindeutig ist.
Die Standardeinstellungen sind:
- ACLs deaktiviert
- Gesamten öffentlichen Zugriff blockieren
- Bucket-Versionierung deaktivieren
- SSE-S3-Verschlüsselung
- SSE-S3 ist der einzige unterstützte serverseitige Verschlüsselungstyp. Amazon KMS-Verschlüsselung wird nicht unterstützt.
Notieren Sie sich die Region, in der Sie das Bucket erstellt haben. Im nächsten Schritt erstellen Sie eine SQS-Warteschlange in derselben Region.
Schritt 2: SQS-Warteschlange erstellen
Erstellen Sie eine SQS-Warteschlange, um zu verfolgen, wann Objekte zu dem von Ihnen erstellten Bucket hinzugefügt werden. Verwenden Sie vorerst die Standardkonfiguration.
Eine SQS-Warteschlange muss global eindeutig sein (sie kann beispielsweise nur für eine CDI-Synchronisierung verwendet und nicht in einem anderen Workspace wiederverwendet werden).

Achten Sie darauf, diese SQS-Warteschlange in derselben Region zu erstellen, in der Sie auch das Bucket erstellt haben.
Notieren Sie sich den ARN und die URL der SQS-Warteschlange. Sie benötigen diese Angaben während der Konfiguration häufig.

Schritt 3: Zugriffsrichtlinie einrichten
Um die Zugriffsrichtlinie einzurichten, wählen Sie Erweiterte Optionen.
Fügen Sie der Zugriffsrichtlinie der Warteschlange die folgende Anweisung hinzu. Ersetzen Sie dabei YOUR-BUCKET-NAME-HERE durch Ihren Bucket-Namen, YOUR-SQS-ARN durch den ARN Ihrer SQS-Warteschlange und YOUR-AWS-ACCOUNT-ID durch Ihre AWS-Konto-ID:
{
"Sid": "braze-cdi-s3-sqs-publish",
"Effect": "Allow",
"Principal": {
"Service": "s3.amazonaws.com"
},
"Action": "SQS:SendMessage",
"Resource": "YOUR-SQS-ARN",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "YOUR-AWS-ACCOUNT-ID"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:s3:::YOUR-BUCKET-NAME-HERE"
}
}
}
Schritt 4: Ereignisbenachrichtigung zum S3-Bucket hinzufügen
- Gehen Sie in dem in Schritt 1 erstellten Bucket zu Eigenschaften > Ereignisbenachrichtigungen.
- Geben Sie der Konfiguration einen Namen. Optional können Sie ein Präfix oder Suffix angeben, wenn Braze nur eine Teilmenge der Dateien aufnehmen soll.
- Wählen Sie unter Ziel die Option SQS-Warteschlange aus und geben Sie den ARN der SQS-Warteschlange an, die Sie in Schritt 2 erstellt haben.

Wenn Sie Ihre Dateien in den Stammordner eines S3-Buckets hochladen und anschließend einige der Dateien in einen bestimmten Ordner im Bucket verschieben, kann ein unerwarteter Fehler auftreten. Stattdessen können Sie die Ereignisbenachrichtigungen so ändern, dass sie nur für Dateien mit dem Präfix gesendet werden, vermeiden, Dateien außerhalb dieses Präfixes im S3-Bucket abzulegen, oder die Integration ohne Präfix aktualisieren, sodass alle Dateien aufgenommen werden.
Schritt 5: IAM-Richtlinie erstellen
Erstellen Sie eine IAM-Richtlinie, damit Braze mit Ihrem Quell-Bucket interagieren kann. Melden Sie sich zunächst als Kontoadministrator:in bei der AWS Management Console an.
-
Gehen Sie in der AWS Console zum Bereich IAM, wählen Sie in der Navigationsleiste Richtlinien und anschließend Richtlinie erstellen aus.

-
Öffnen Sie den Tab JSON und geben Sie das folgende Code-Snippet in den Abschnitt Richtliniendokument ein. Ersetzen Sie dabei
YOUR-BUCKET-NAME-HEREdurch Ihren Bucket-Namen undYOUR-SQS-ARN-HEREdurch den Namen Ihrer SQS-Warteschlange:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:ListBucket", "s3:GetObjectAttributes", "s3:GetObject"],
"Resource": ["arn:aws:s3:::YOUR-BUCKET-NAME-HERE"]
},
{
"Effect": "Allow",
"Action": ["s3:ListBucket", "s3:GetObjectAttributes", "s3:GetObject"],
"Resource": ["arn:aws:s3:::YOUR-BUCKET-NAME-HERE/*"]
},
{
"Effect": "Allow",
"Action": [
"sqs:DeleteMessage",
"sqs:GetQueueUrl",
"sqs:ReceiveMessage",
"sqs:GetQueueAttributes"
],
"Resource": "YOUR-SQS-ARN-HERE"
}
]
}
-
Wählen Sie anschließend Richtlinie überprüfen aus.
-
Geben Sie der Richtlinie einen Namen und eine Beschreibung und wählen Sie dann Richtlinie erstellen aus.


Schritt 6: Authentifizierung einrichten
Braze greift mit der folgenden Authentifizierungsmethode auf Ihr Bucket und Ihre Warteschlange zu:
| Methode | So authentifiziert Braze | Was Sie in Braze eingeben |
|---|---|---|
| IAM role | Braze assumes an AWS Identity and Access Management (IAM) role in your account, using an external ID that Braze generates for your workspace. | Role ARN |
IAM role
Braze übernimmt eine IAM-Rolle in Ihrem AWS-Konto. Erstellen Sie die Rolle und hängen Sie die von Ihnen erstellte IAM-Richtlinie daran an.
- Gehen Sie im selben IAM-Bereich der Konsole, in dem Sie die IAM-Richtlinie erstellt haben, zu Roles > Create Role.

- Wählen Sie in AWS Another AWS Account als SELEKTOR-Typ für die vertrauenswürdige Entität aus.
- Gehen Sie in Braze zu Dateneinstellungen > Cloud-Datenaufnahme > Quellen, wählen Sie Datenquelle hinzufügen und dann im Bereich für Dateiquellen Amazon S3 aus.
- Kopieren Sie die automatisch generierte Braze-Konto-ID und externe ID. Braze generiert die externe ID für Ihren Workspace. Sie ist für alle Amazon-S3-Zugangsdaten in diesem Workspace identisch.

- Fügen Sie in AWS die Konto-ID ein. Aktivieren Sie das Kontrollkästchen Require external ID, fügen Sie die externe ID ein und wählen Sie dann Next aus.

- Hängen Sie die IAM-Richtlinie an die Rolle an. Suchen Sie die Richtlinie über die Suchleiste und setzen Sie ein Häkchen neben der Richtlinie, um sie anzuhängen. Wählen Sie anschließend Next aus.

- Geben Sie der Rolle einen Namen und eine Beschreibung und wählen Sie Create Role aus.

- Notieren Sie sich den ARN der erstellten Rolle, da Sie ihn zum Erstellen der Integration für die Cloud-Datenaufnahme benötigen.

Die Vertrauensrichtlinie Ihrer Rolle muss genau die externe ID verlangen, die in Braze angezeigt wird. Wenn Sie Zugangsdaten testen oder speichern, prüft Braze, ob Ihre Rolle jede andere externe ID ablehnt. Eine Rolle, die keine externe ID verlangt oder ein Muster wie braze-cdi-* akzeptiert, besteht den Verbindungstest nicht.
Cloud Data Ingestion in Braze einrichten
- Erstellen Sie zunächst eine neue Quelle im Braze-Dashboard. Gehen Sie zu Dateneinstellungen > Cloud Data Ingestion > Quellen, wählen Sie Datenquelle hinzufügen und dann Amazon S3 aus.
- Geben Sie einen Namen für die Quelle ein und füllen Sie dann die Felder unter Amazon S3-Verbindungsdetails aus:
- Zugangsdaten: Geben Sie einen Namen für die Zugangsdaten und die Felder für Ihre Authentifizierungsmethode ein. Geben Sie Folgendes ein: Role ARN.
- Konfigurationen: Bucket und Region

- Wählen Sie Verbindung testen aus, um zu bestätigen, dass Braze auf Ihren Bucket zugreifen kann. Wählen Sie nach einem erfolgreichen Test Mit Quelle verbinden aus. Schlägt die Verbindung fehl, wird eine Fehlermeldung angezeigt, die Ihnen bei der Fehlerbehebung hilft.
- Erstellen Sie als Nächstes eine neue Synchronisierung. Gehen Sie zu Dateneinstellungen > Cloud Data Ingestion > Synchronisierungen und wählen Sie Datensynchronisierung erstellen aus.
- Geben Sie einen Namen für die Synchronisierung ein, wählen Sie einen Datentyp und Ihre S3-Quelle aus. Wählen Sie dann Weiter: Datendefinition aus.
- Geben Sie im Schritt Datendefinition die restlichen Informationen aus der AWS-Einrichtung ein:
- SQS-URL: Geben Sie eine URL ein, die für jede neue Integration eindeutig ist.
- Ordnerpfad (optional): Geben Sie einen Pfad ein, der innerhalb eines Workspace über alle Synchronisierungen hinweg eindeutig ist.
- Wählen Sie Vorschau und Validierung aus, um zu bestätigen, dass Braze die zur Aufnahme verfügbaren Dateien auflisten kann (nicht die Daten in diesen Dateien). Wählen Sie nach einer erfolgreichen Vorschau Weiter: Benachrichtigungen aus.

- Fügen Sie Kontakt-E-Mail-Adressen für Benachrichtigungen hinzu, falls die Synchronisierung aufgrund von Zugriffs- oder Berechtigungsproblemen fehlschlägt. Optional können Sie Benachrichtigungen für Fehler auf Nutzerebene und erfolgreiche Synchronisierungen aktivieren.
- Erstellen Sie die Synchronisierung.
Erforderliche Dateiformate
Cloud Data Ingestion unterstützt JSON-, CSV- und Parquet-Dateien. Welche Spalten erforderlich sind, hängt vom Datentyp ab. Braze stellt keine zusätzlichen Anforderungen an Dateinamen, die über die Vorgaben Ihres Dateispeicheranbieters hinausgehen. Dateinamen sollten eindeutig sein. Ein angehängter Zeitstempel hilft dabei, die Eindeutigkeit sicherzustellen.

Anders als bei Data-Warehouse-Quellen ist die Spalte UPDATED_AT für Dateispeicher-Synchronisierungen weder erforderlich noch unterstützt.
Beispiele für alle unterstützten Dateitypen finden Sie in den Beispieldateien unter braze-examples.
Wählen Sie den Tab für den Datentyp aus, den Sie synchronisieren möchten.
Jede Zeile benötigt genau einen Nutzer-Bezeichner und eine Spalte PAYLOAD. Eine Quelldatei kann Zeilen mit unterschiedlichen Bezeichnertypen enthalten, aber jede einzelne Zeile sollte nur einen davon verwenden.
| Bezeichner | Beschreibung |
|---|---|
EXTERNAL_ID |
Identifiziert die Nutzer:in, die Sie aktualisieren möchten. Dieser Wert sollte mit dem in Braze verwendeten external_id-Wert übereinstimmen. |
ALIAS_NAME und ALIAS_LABEL |
Diese beiden Spalten erstellen ein Nutzer-Alias-Objekt. alias_name sollte ein eindeutiger Bezeichner sein, und alias_label gibt den Typ des Alias an. Nutzer:innen können mehrere Aliase mit unterschiedlichen Labels haben, aber nur einen alias_name pro alias_label. |
BRAZE_ID |
Der Braze-Nutzer-Bezeichner. Er wird vom Braze SDK generiert. Über Cloud Data Ingestion können keine neuen Nutzer:innen mit einer Braze-ID angelegt werden. Um neue Nutzer:innen anzulegen, geben Sie eine externe Nutzer-ID oder einen Nutzer-Alias an. |
EMAIL |
Die E-Mail-Adresse der Nutzer:in. Wenn mehrere Profile mit derselben E-Mail-Adresse existieren, wird das zuletzt aktualisierte Profil bei Updates bevorzugt. Wenn Sie sowohl E-Mail-Adresse als auch Telefonnummer angeben, verwendet Braze die E-Mail-Adresse als primären Bezeichner. |
PHONE |
Die Telefonnummer der Nutzer:in. Wenn mehrere Profile mit derselben Telefonnummer existieren, wird das zuletzt aktualisierte Profil bei Updates bevorzugt. |
Die Spalte PAYLOAD enthält einen JSON-String mit den Feldern, die Sie mit der Nutzer:in in Braze synchronisieren möchten, im Format des Nutzerattribut-Objekts.
JSON-Beispiel
{"external_id":"s3-qa-0","payload":"{\"name\": \"GT896\", \"age\": 74, \"subscriber\": true, \"retention\": {\"previous_purchases\": 21, \"vip\": false}, \"last_visit\": \"2023-08-08T16:03:26.600803\"}"}
{"external_id":"s3-qa-1","payload":"{\"name\": \"HSCJC\", \"age\": 86, \"subscriber\": false, \"retention\": {\"previous_purchases\": 0, \"vip\": false}, \"last_visit\": \"2023-08-08T16:03:26.600824\"}"}
{"external_id":"s3-qa-2","payload":"{\"name\": \"YTMQZ\", \"age\": 43, \"subscriber\": false, \"retention\": {\"previous_purchases\": 23, \"vip\": true}, \"last_visit\": \"2023-08-08T16:03:26.600831\"}"}
CSV-Beispiel
external_id,payload
s3-qa-load-0-d0daa196-cdf5-4a69-84ae-4797303aee75,"{""name"": ""SNXIM"", ""age"": 54, ""subscriber"": true, ""retention"": {""previous_purchases"": 19, ""vip"": true}, ""last_visit"": ""2023-08-08T16:03:26.598806""}"
s3-qa-load-1-d0daa196-cdf5-4a69-84ae-4797303aee75,"{""name"": ""0J747"", ""age"": 73, ""subscriber"": false, ""retention"": {""previous_purchases"": 22, ""vip"": false}, ""last_visit"": ""2023-08-08T16:03:26.598816""}"

Jede Zeile in Ihrer Quelldatei muss gültiges JSON enthalten, andernfalls wird die Datei übersprungen.
Angepasste Events verwenden dieselben Nutzer-Bezeichner-Spalten wie Nutzerattribute. Die Spalte PAYLOAD folgt dem Format des Event-Objekts.
{"external_id":"s3-qa-0","payload":"{\"app_id\": \"YOUR_APP_ID\", \"name\": \"view-206\", \"time\": \"2024-04-02T14:34:08\", \"properties\": {\"bool_value\": false, \"preceding_event\": \"unsubscribe\", \"important_number\": 206}}"}
{"external_id":"s3-qa-1","payload":"{\"app_id\": \"YOUR_APP_ID\", \"name\": \"view-206\", \"time\": \"2024-04-02T14:34:08\", \"properties\": {\"bool_value\": false, \"preceding_event\": \"unsubscribe\", \"important_number\": 206}}"}

Jede Zeile in Ihrer Quelldatei muss gültiges JSON enthalten, andernfalls wird die Datei übersprungen.
Kauf-Events verwenden dieselben Nutzer-Bezeichner-Spalten wie Nutzerattribute. Die Spalte PAYLOAD folgt dem Format des Kauf-Objekts.
{"external_id":"s3-qa-0","payload":"{\"app_id\": \"YOUR_APP_ID\", \"product_id\": \"product-11\", \"currency\": \"BSD\", \"price\": 8.511527858335066, \"time\": \"2024-04-02T14:34:08\", \"quantity\": 19, \"properties\": {\"is_a_boolean\": true, \"important_number\": 40, \"preceding_event\": \"click\"}}"}
{"external_id":"s3-qa-1","payload":"{\"app_id\": \"YOUR_APP_ID\", \"product_id\": \"product-11\", \"currency\": \"BSD\", \"price\": 8.511527858335066, \"time\": \"2024-04-02T14:34:08\", \"quantity\": 19, \"properties\": {\"is_a_boolean\": true, \"important_number\": 40, \"preceding_event\": \"click\"}}"}

Jede Zeile in Ihrer Quelldatei muss gültiges JSON enthalten, andernfalls wird die Datei übersprungen.
Katalogdateien verwenden andere Bezeichner als Nutzerdaten-Dateien. Bevor Sie eine Katalog-Synchronisierung erstellen, legen Sie den Zielkatalog in Braze an. Den vollständigen Katalog-Workflow finden Sie unter Katalogdaten synchronisieren und löschen.
| Spalte | Erforderlich | Beschreibung |
|---|---|---|
ID |
Ja | Der eindeutige Bezeichner für den Katalogartikel. Wird verwendet, um den Artikel in Braze zu erstellen, zu aktualisieren oder zu löschen. |
PAYLOAD |
Ja | Ein JSON-String mit den zu synchronisierenden Katalogfeldern und -werten. Muss dem Schema Ihres Katalogs in Braze entsprechen. |
DELETED |
Nein | Bei true wird der Katalogartikel mit der passenden ID aus dem Katalog in Braze entfernt. Lassen Sie diese Spalte weg oder setzen Sie sie auf false, um Artikel zu erstellen oder zu aktualisieren. |
JSON-Beispiel
{"id":"85","payload":"{\"product_name\":\"Product 85\",\"price\":85.85}"}
{"id":"86","payload":"{\"product_name\":\"Product 86\",\"price\":86.86}"}
{"id":"1","payload":"{\"product_name\":\"Product 1\",\"price\":1.01}","deleted":true}
CSV-Beispiel mit der Spalte DELETED
ID,PAYLOAD,DELETED
85,"{""product_name"": ""Product 85"", ""price"": 85.85}",false
86,"{""product_name"": ""Product 86"", ""price"": 86.86}",false
1,"{""product_name"": ""Product 1"", ""price"": 1.01}",true
CSV-Beispiel ohne die Spalte DELETED
ID,PAYLOAD
85,"{""product_name"": ""Product 85"", ""price"": 85.85}"
86,"{""product_name"": ""Product 86"", ""price"": 86.86}"
Bevor Sie eine Datenobjekt-Synchronisierung erstellen, legen Sie den Datenobjekttyp und seine Felder in Braze an. Den vollständigen Workflow finden Sie unter Datenobjekte synchronisieren.
Anders als bei Data-Warehouse-Quellen werden die Datenobjektfelder bei Dateispeicher-Quellen in einer Spalte PAYLOAD übertragen statt in einer eigenen Spalte pro Feld.
| Spalte | Erforderlich | Beschreibung |
|---|---|---|
OBJECT_ID |
Ja | Der Bezeichner des Datenobjekt-Datensatzes. Wird verwendet, um den Datensatz in Braze zu erstellen, zu aktualisieren oder zu löschen. |
PAYLOAD |
Ja | Ein JSON-String mit den zu synchronisierenden Feldern und Werten. Jeder Schlüssel muss einem Feld entsprechen, das für den Datenobjekttyp in Braze definiert ist, einschließlich der Groß- und Kleinschreibung. |
DELETED |
Nein | Bei true wird der Datensatz mit der passenden OBJECT_ID in Braze gelöscht. Lassen Sie diese Spalte weg oder setzen Sie sie auf false, um Datensätze zu erstellen oder zu aktualisieren. |
JSON-Beispiel
{"object_id":"acct-001","payload":"{\"name\":\"Acme Corp\",\"team_id\":42}"}
{"object_id":"acct-002","payload":"{\"name\":\"Initech\",\"team_id\":17}"}
{"object_id":"acct-003","payload":"{\"name\":\"Hooli\",\"team_id\":5}","deleted":true}
CSV-Beispiel
OBJECT_ID,PAYLOAD,DELETED
acct-001,"{""name"": ""Acme Corp"", ""team_id"": 42}",false
acct-002,"{""name"": ""Initech"", ""team_id"": 17}",false
acct-003,"{""name"": ""Hooli"", ""team_id"": 5}",true
Mit dieser Synchronisierung verknüpfen Sie Nutzer:innen mit Datenobjekt-Datensätzen, zum Beispiel Nutzer:innen mit den Konten, zu denen sie gehören. Legen Sie die Beziehung in Braze an, bevor Sie sie synchronisieren.
Jede Zeile benötigt OBJECT_ID sowie mindestens einen Nutzer-Bezeichner.
| Spalte | Erforderlich | Beschreibung |
|---|---|---|
OBJECT_ID |
Ja | Der Bezeichner des Datenobjekt-Datensatzes, mit dem die Nutzer:in verknüpft ist. |
EXTERNAL_ID |
Ja, mindestens ein Nutzer-Bezeichner pro Zeile | Entspricht der in Braze verwendeten external_id. |
ALIAS_NAME und ALIAS_LABEL |
Ja, mindestens ein Nutzer-Bezeichner pro Zeile | Beide Spalten zusammen identifizieren die Nutzer:in über den Alias. |
EMAIL |
Ja, mindestens ein Nutzer-Bezeichner pro Zeile | Die E-Mail-Adresse der Nutzer:in. |
PHONE |
Ja, mindestens ein Nutzer-Bezeichner pro Zeile | Die Telefonnummer der Nutzer:in. |
PAYLOAD |
Nein | Ein JSON-String mit den Feldern und Werten der Beziehung selbst. |
DELETED |
Nein | Bei true wird die Beziehung zwischen dem Datensatz und der Nutzer:in entfernt. |

BRAZE_ID wird für Synchronisierungen von Nutzerbeziehungen nicht unterstützt, anders als bei Synchronisierungen von Nutzerattributen. Verwenden Sie einen der oben aufgeführten Bezeichner.
JSON-Beispiel
{"object_id":"acct-001","external_id":"user-1","payload":"{\"role\":\"admin\"}"}
{"object_id":"acct-001","email":"[email protected]","payload":"{\"role\":\"member\"}"}
{"object_id":"acct-002","external_id":"user-9","deleted":true}
Mit dieser Synchronisierung verknüpfen Sie Datenobjekt-Datensätze miteinander, zum Beispiel Konten mit ihren übergeordneten Konten. Legen Sie die Beziehung in Braze an, bevor Sie sie synchronisieren.
| Spalte | Erforderlich | Beschreibung |
|---|---|---|
OBJECT_ID |
Ja | Der Datensatz, von dem die Beziehung ausgeht. |
RELATED_OBJECT_ID |
Ja | Der Datensatz, auf den die Beziehung verweist. |
PAYLOAD |
Nein | Ein JSON-String mit den Feldern und Werten der Beziehung selbst. |
DELETED |
Nein | Bei true wird die Beziehung zwischen den beiden Datensätzen entfernt. |
JSON-Beispiel
{"object_id":"acct-001","related_object_id":"acct-010","payload":"{\"tier\":\"parent\"}"}
{"object_id":"acct-001","related_object_id":"acct-011","payload":"{\"tier\":\"parent\"}"}
{"object_id":"acct-002","related_object_id":"acct-020","deleted":true}
Canvas-Trigger ermöglichen Zero-Copy-Personalisierung. Informationen zur Einrichtung des Ziel-Canvas und zu wichtigen Hinweisen finden Sie unter Zero-Copy-Personalisierung.
| Feld | Erforderlich | Beschreibung |
|---|---|---|
EXTERNAL_ID |
Ja, entweder external_id oder alias_name und alias_label |
Identifiziert die Nutzer:in, die Sie aktualisieren möchten. Dieser Wert sollte mit dem in Braze verwendeten external_id-Wert übereinstimmen. |
ALIAS_NAME und ALIAS_LABEL |
Ja, entweder external_id oder alias_name und alias_label |
Diese beiden Spalten erstellen ein Nutzer-Alias-Objekt. alias_name sollte ein eindeutiger Bezeichner sein, und alias_label gibt den Typ des Alias an. Nutzer:innen können mehrere Aliase mit unterschiedlichen Labels haben, aber nur einen alias_name pro alias_label. |
PROPERTIES |
Ja | JSON-String mit Feldern, die in Ihrem Canvas als Personalisierungseigenschaften verfügbar sein sollen. Dieser sollte nutzerspezifische Informationen enthalten. |
Wählen Sie zum Einstieg beim Erstellen einer neuen Synchronisierung den Datentyp Canvas Triggers aus.
So löschen Sie Nutzerprofile in Braze mithilfe von Dateien in Ihrem Quell-Bucket:
- Erstellen Sie eine neue Cloud Data Ingestion-Synchronisierung mit derselben Einrichtung wie bei anderen Synchronisierungen.
- Setzen Sie beim Konfigurieren der Synchronisierung in Braze Data Type auf Delete Users.
- Laden Sie Dateien in Ihren Quell-Bucket hoch, die ausschließlich Nutzer-Bezeichner-Spalten enthalten. Fügen Sie keine Spalte
PAYLOADhinzu – die Synchronisierung schlägt fehl, wenn ein Payload vorhanden ist, um versehentliche Löschungen zu vermeiden.
Jede Zeile in der Datei muss genau eine Nutzer:in über einen der folgenden Bezeichner identifizieren:
| Bezeichner | Beschreibung |
|---|---|
EXTERNAL_ID |
Entspricht der in Braze verwendeten external_id. |
ALIAS_NAME und ALIAS_LABEL |
Beide Spalten zusammen identifizieren die Nutzer:in über den Alias. |
BRAZE_ID |
Von Braze generierte Nutzer-ID (nur für bestehende Nutzer:innen). |
JSON-Beispiel
{"external_id":"user-to-delete-001"}
{"external_id":"user-to-delete-002"}
{"braze_id":"braze-id-from-profile"}
CSV-Beispiel
external_id
user-to-delete-001
user-to-delete-002
Wenn die Synchronisierung ausgeführt wird, verarbeitet Braze neue Dateien im Bucket und löscht die entsprechenden Nutzerprofile.

Das Löschen von Nutzer:innen ist dauerhaft und kann nicht rückgängig gemacht werden. Nehmen Sie nur Nutzer:innen auf, die Sie tatsächlich entfernen möchten. Weitere Details finden Sie unter Nutzer:innen mit Cloud Data Ingestion löschen.
Katalogartikel löschen
So entfernen Sie Artikel aus einem Katalog mithilfe von Dateispeicher:
- Verwenden Sie dieselbe Synchronisierung, die Sie zum Synchronisieren von Katalogdaten nutzen (Datentyp Kataloge).
- Fügen Sie Ihren CSV- oder JSON-Dateien eine optionale Spalte
deleted(oderDELETED) hinzu. - Setzen Sie
deletedfür jeden Katalogartikel, den Sie in Braze aus dem Katalog entfernen möchten, auftrue.
Jede Zeile benötigt weiterhin ID und PAYLOAD. Bei Zeilen, die zum Löschen markiert sind, kann der Payload minimal sein, da Braze den Artikel anhand der ID entfernt.
Wenn die Synchronisierung ausgeführt wird, führen Zeilen mit deleted: true dazu, dass der entsprechende Katalogartikel in Braze gelöscht wird. Weitere Informationen zum vollständigen Verhalten beim Synchronisieren und Löschen von Katalogen finden Sie unter Katalogdaten synchronisieren und löschen.
Wissenswertes
- Dateien, die dem Quell-Bucket oder -Container hinzugefügt werden, sollten 512 MB nicht überschreiten. Diese Grenze gilt für Amazon S3, Google Cloud Storage und Azure Blob Storage. Dateien, die größer als 512 MB sind, führen zu einem Fehler und werden nicht mit Braze synchronisiert. Azure Blob Storage selbst erlaubt deutlich größere Dateien, CDI wendet jedoch für alle Dateispeicherquellen dieselbe Grenze von 512 MB an.
- Es gibt zwar keine zusätzliche Begrenzung der Anzahl der Zeilen pro Datei, Braze empfiehlt jedoch, kleinere Dateien zu verwenden, damit Ihre Synchronisierungen schneller laufen. Beispielsweise dauert die Aufnahme einer 500 MB großen Datei erheblich länger als die von fünf separaten 100 MB großen Dateien.
- Es gibt keine zusätzliche Begrenzung der Anzahl der Dateien, die in einem bestimmten Zeitraum hochgeladen werden.
- Eine Reihenfolge wird weder innerhalb von Dateien noch zwischen Dateien unterstützt. Braze empfiehlt, Updates regelmäßig in Batches zu bündeln, wenn Sie mögliche Race-Conditions überwachen.
- CDI verarbeitet nur Dateien, die nach dem Erstellen der Synchronisierung hinzugefügt werden. Sie können vorhandene Dateien verwenden, um zu prüfen, ob Braze auf Ihren Bucket zugreifen und Dateien für die Aufnahme erkennen kann. Diese Dateien werden jedoch nicht mit Braze synchronisiert. Damit CDI sie verarbeitet, laden Sie alle vorhandenen Dateien, die synchronisiert werden sollen, erneut in den Quell-Bucket hoch.
- Braze löscht eine SQS-Nachricht erst, wenn die Datei erfolgreich gelesen und die daraus resultierenden Zeilen in die internen Systeme von Braze aufgenommen wurden. Braze verlängert das Sichtbarkeits-Timeout nicht. Wenn Sie Nachrichten in Ihrer Dead-Letter-Warteschlange sehen, sollten Sie das Sichtbarkeits-Timeout so erhöhen, dass es der Verarbeitungsdauer Ihrer größten Dateien entspricht. Braze erfasst außerdem Metadaten für jede Datei: Wurde eine Datei erfolgreich aufgenommen und erscheint eine doppelte SQS-Nachricht für diese Datei, löscht Braze die doppelte Nachricht sofort. Wurde die Datei nicht erfolgreich aufgenommen, verarbeitet Braze die SQS-Nachricht wie gewohnt.
Fehlerbehebung
Hochladen und Verarbeiten von Dateien
CDI verarbeitet nur Dateien, die nach dem Erstellen der Synchronisierung hinzugefügt werden. Dabei sucht Braze nach neu hinzugefügten Dateien, die eine neue Benachrichtigung triggern. Dadurch wird eine neue Synchronisierung gestartet, um die neue Datei zu verarbeiten. Bei Amazon S3 ist die Benachrichtigung eine Nachricht an SQS.
Mit vorhandenen Dateien können Sie überprüfen, ob Braze auf Ihr Bucket zugreifen und aufzunehmende Dateien erkennen kann, sie werden jedoch nicht mit Braze synchronisiert. Damit CDI vorhandene Dateien verarbeitet, müssen Sie alle Dateien, die synchronisiert werden sollen, erneut in das Quell-Bucket hochladen.
Umgang mit unerwarteten Dateifehlern
Wenn Sie eine hohe Anzahl von Fehlern oder fehlgeschlagenen Dateien beobachten, fügt möglicherweise ein anderer Prozess Dateien zum S3-Bucket in einem anderen Ordner als dem Zielordner für CDI hinzu.
Wenn Dateien in das Quell-Bucket, aber nicht in den Quellordner hochgeladen werden, verarbeitet CDI die SQS-Benachrichtigung, führt jedoch keine Aktion für die Datei aus. Dies kann als Fehler angezeigt werden.
Wenn Ihr Problem mit S3-Benachrichtigungen oder Berechtigungen für das SQS-Ziel zusammenhängt (z. B. Fehler bei der Zielvalidierung), lesen Sie die AWS-Dokumentation:
- Aktivieren und Konfigurieren von Ereignisbenachrichtigungen über die Amazon S3-Konsole
- Erteilen von Berechtigungen zum Veröffentlichen von Ereignisbenachrichtigungen an ein Ziel
- Fehlerbehebung bei Problemen in Amazon SQS
Fehler „Incorrect Integration Object“
Dieser Fehler tritt auf, wenn zwei oder mehr Workspaces Integrationen haben, die auf dasselbe Cloud-Speicher-Bucket oder denselben Ordner verweisen. Jeder Cloud-Speicherort kann jeweils nur von einer Integration verwendet werden. Schritte zur Lösung finden Sie in den FAQ.
Zugehörige Seiten
- Tabellen-Setup für erforderliche Spalten und die Formatierung von Payloads
- Best Practices für die Planung von Synchronisierungen und eine effiziente Nutzung von Datenpunkten
- Synchronisierungsprotokolle und Beobachtbarkeit für das Monitoring von Synchronisierungsläufen
- FAQ für häufige Fragen zu allen Quellen