Cloud-Datenaufnahme – Tabelleneinrichtung

Verwenden Sie diese Seite, um festzulegen, wie die Cloud-Datenaufnahme (CDI) Ihre Daten liest, und um eine Quelltabelle mit einer PAYLOAD-Spalte einzurichten, falls Sie diese Methode verwenden.

Datendefinitionsoption auswählen

Wenn Sie eine Synchronisierung aus einer Data-Warehouse-Quelle erstellen, legen Sie im Schritt Datendefinition fest, wie Braze Ihre Daten liest. Welche Optionen angezeigt werden, hängt vom Synchronisierungstyp ab.

Hinweise zur Datenorganisation

Jede CDI-Synchronisierung aktualisiert jeweils einen Datentyp, z. B. Nutzerattribute, angepasste Events, Kauf-Events oder Katalogartikel. Organisieren Sie Ihre Daten beim Einrichten Ihrer Quelltabellen oder Views danach, wie Sie sie synchronisieren möchten:

• Eine Tabelle pro Datentyp: Wenn Sie für jeden Datentyp separate Tabellen oder Views erstellen (zum Beispiel user_attributes, custom_events, purchases), erhalten Sie eine klare Trennung und können unterschiedliche Synchronisierungszeitpläne und Datendefinitionen leichter verwalten.
• Gemeinsame Quelltabelle: Wenn Sie den visuellen oder den SQL-Mapper-Modus verwenden, können mehrere Synchronisierungen auf dieselbe Quelltabelle zugreifen. Beispielsweise können eine Attribut-Synchronisierung und eine Event-Synchronisierung dieselbe Tabelle abfragen. Sie erstellen im Braze-Dashboard aber dennoch separate Synchronisierungen, eine für Attribute und eine für Events. Jede Synchronisierung mappt oder fragt nur die Spalten ab, die sie benötigt.

Wählen Sie den Ansatz, der zu Ihrer Datenpipeline und der Anzahl Ihrer Anwendungsfälle passt. Beide Muster funktionieren auch, wenn die Zahl Ihrer Anwendungsfälle wächst.

Tabelleneinrichtung und Payload-Formatierung im Vergleich

Für CDI-Synchronisierungen von Nutzerdaten, die eine PAYLOAD-Spalte verwenden, konfigurieren Sie beides:

Braze liest zuerst die Zeilen aus Ihrer Quelltabelle und validiert dann das Feld PAYLOAD anhand des ausgewählten Datentyps.

Quelltabelle einrichten

Für Nutzerdaten-Synchronisierungen aus dem Data Warehouse, die eine PAYLOAD-Spalte verwenden, sollte Ihre Quelltabelle oder Ansicht Folgendes enthalten:

• UPDATED_AT
• PAYLOAD
• Eine oder mehrere unterstützte Spalten für Nutzer-Bezeichner:
  • EXTERNAL_ID
  • ALIAS_NAME und ALIAS_LABEL
  • BRAZE_ID
  • EMAIL
  • PHONE

Jede Zeile sollte jeweils nur einen Bezeichnertyp enthalten, auch wenn Ihre Tabelle mehrere Bezeichnerspalten hat.

Anforderungen an UPDATED_AT

• Speichern Sie UPDATED_AT-Werte in UTC, um Probleme mit der Zeitumstellung (Sommer-/Winterzeit) zu vermeiden.
• Braze synchronisiert Zeilen, deren UPDATED_AT-Wert später liegt als der zuletzt synchronisierte Wert.
• Zeilen mit genau dem Grenz-Zeitstempel werden möglicherweise erneut synchronisiert, wenn neue Zeilen denselben Zeitstempel haben.

Hinweise zu doppelten Zeitstempeln und inkrementellen Updates finden Sie unter Best Practices für Cloud Data Ingestion.

Hinweis

Dateispeicher-Quellen haben andere Einrichtungsanforderungen und unterstützen UPDATED_AT nicht. Weitere Informationen finden Sie im Abschnitt Erforderliche Dateiformate auf der Seite Ihrer Quelle: Amazon S3, Google Cloud Storage oder Azure Blob Storage.

Die PAYLOAD-Spalte einrichten

Der PAYLOAD-Wert verwendet für den ausgewählten Datentyp dieselben Objektformate wie der Braze-Endpunkt /users/track.

Bei verschachtelten Attributen geben Sie Datumsangaben im Format aus Datumsangaben als Objekteigenschaften erfassen an.

Payload-Beispiele

• verschachtelte angepasste attribute
• event
• kauf
• abo-gruppen

1
2
3
4
5
6
7
8
9
10
11
12

{
      "most_played_song": {
        "song_name": "Solea",
        "artist_name": "Miles Davis",
        "album_name": "Sketches of Spain",
        "genre": "Jazz",
        "play_analytics": {
            "count": 1000,
            "top_10_listeners": true
        }
      }
}

1
2
3
4
5
6
7
8
9

{
    "app_id" : "your-app-id",
    "name" : "rented_movie",
    "time" : "2013-07-16T19:20:45+01:00",
    "properties": {
        "movie": "The Sad Egg",
        "director": "Alex Smith"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12

{
    "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
    "product_id" : "Completed Order",
    "currency" : "USD",
    "price" : 219.98,
    "time" : "2013-07-16T19:20:30+01:00",
    "properties" : {
        "products" : [ { "name": "Monitor", "category": "Gaming", "product_amount": 19.99 },
        { "name": "Gaming Keyboard", "category": "Gaming ", "product_amount": 199.99 }
        ]
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

{
    "subscription_groups" : [
        {
            "subscription_group_id": "subscription_group_identifier_1",
            "subscription_state": "unsubscribed"
        },
        {
            "subscription_group_id": "subscription_group_identifier_2",
            "subscription_state": "subscribed"
        },
        {
            "subscription_group_id": "subscription_group_identifier_3",
            "subscription_state": "subscribed"
        }
      ]
}

Zugehörige Dokumentation zur CDI-Einrichtung

• Quellen für Cloud Data IngestionQuellenspezifische DDL-Beispiele und dateibasierte Einrichtung.
• Best Practices für Cloud Data IngestionHinweise zum Synchronisierungsverhalten und zur Optimierung.