Zum Inhalt springen

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).

Notieren Sie sich den ARN und die URL der SQS-Warteschlange. Sie benötigen diese Angaben während der Konfiguration häufig.

Auswahl von „Erweitert“ mit einem Beispiel-JSON-Objekt, das festlegt, wer auf eine Warteschlange zugreifen kann.

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

  1. Gehen Sie in dem in Schritt 1 erstellten Bucket zu Eigenschaften > Ereignisbenachrichtigungen.
  2. 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.
  3. 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.

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.

  1. Gehen Sie in der AWS Console zum Bereich IAM, wählen Sie in der Navigationsleiste Richtlinien und anschließend Richtlinie erstellen aus.

    Der Button „Richtlinie erstellen“ in der AWS Console.

  2. Öffnen Sie den Tab JSON und geben Sie das folgende Code-Snippet in den Abschnitt Richtliniendokument ein. Ersetzen Sie dabei YOUR-BUCKET-NAME-HERE durch Ihren Bucket-Namen und YOUR-SQS-ARN-HERE durch 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"
        }
    ]
}

  1. Wählen Sie anschließend Richtlinie überprüfen aus.

  2. Geben Sie der Richtlinie einen Namen und eine Beschreibung und wählen Sie dann Richtlinie erstellen aus.

Eine Beispielrichtlinie mit dem Namen „new-policy-name“.

Das Beschreibungsfeld für die Richtlinie.

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.

  1. Gehen Sie im selben IAM-Bereich der Konsole, in dem Sie die IAM-Richtlinie erstellt haben, zu Roles > Create Role.

Der Button „Create role“.

  1. Wählen Sie in AWS Another AWS Account als SELEKTOR-Typ für die vertrauenswürdige Entität aus.
  2. 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.
  3. 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.

Die Seite „Add New Source“ mit den Bereichen „Source Name“ und „S3 Connection Details“.

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

Die S3-Seite „Create Role“. Diese Seite enthält Felder für Rollenname, Rollenbeschreibung, vertrauenswürdige Entitäten, Richtlinien und Berechtigungsgrenze.

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

Rollen-ARN mit ausgewählter Richtlinie „new-policy-name“.

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

Eine Beispielrolle mit dem Namen „new-role-name“.

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

Cloud Data Ingestion in Braze einrichten

  1. 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.
  2. 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

Der Abschnitt „S3-Verbindungsdetails“ mit den Feldern für Zugangsdaten (AWS-Einrichtung und Braze-Einrichtung) und Konfigurationen.

  1. 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.
  1. Erstellen Sie als Nächstes eine neue Synchronisierung. Gehen Sie zu Dateneinstellungen > Cloud Data Ingestion > Synchronisierungen und wählen Sie Datensynchronisierung erstellen aus.
  1. 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.
  2. 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.
  1. 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.

Der Schritt „Datendefinition“ mit „Vorschau und Validierung“ und einer Tabellenvorschau der zur Aufnahme verfügbaren Dateien.

  1. 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.
  2. 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.

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""}"

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}}"}

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\"}}"}

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.

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:

  1. Erstellen Sie eine neue Cloud Data Ingestion-Synchronisierung mit derselben Einrichtung wie bei anderen Synchronisierungen.
  2. Setzen Sie beim Konfigurieren der Synchronisierung in Braze Data Type auf Delete Users.
  3. Laden Sie Dateien in Ihren Quell-Bucket hoch, die ausschließlich Nutzer-Bezeichner-Spalten enthalten. Fügen Sie keine Spalte PAYLOAD hinzu – 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.

Katalogartikel löschen

So entfernen Sie Artikel aus einem Katalog mithilfe von Dateispeicher:

  1. Verwenden Sie dieselbe Synchronisierung, die Sie zum Synchronisieren von Katalogdaten nutzen (Datentyp Kataloge).
  2. Fügen Sie Ihren CSV- oder JSON-Dateien eine optionale Spalte deleted (oder DELETED) hinzu.
  3. Setzen Sie deleted für jeden Katalogartikel, den Sie in Braze aus dem Katalog entfernen möchten, auf true.

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:

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.

New Stuff!