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.

Eine Option für die Datendefinition wählen

Wenn Sie eine Synchronisation aus einer Data-Warehouse-Quelle erstellen, wählen Sie im Schritt Datendefinition aus, wie Braze Ihre Daten liest. Die angezeigten Optionen hängen vom Synchronisationstyp ab.

Unterschiede zwischen Tabelleneinrichtung und Payload-Formatierung

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

Braze liest zuerst die Zeilen aus Ihrer Quelltabelle und validiert dann das PAYLOAD-Feld basierend auf dem ausgewählten Datentyp.

Quelltabelle einrichten

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

• UPDATED_AT
• PAYLOAD
• Eine oder mehrere unterstützte Spalten für Nutzer:innen-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 enthält.

Anforderungen für UPDATED_AT

• Speichern Sie UPDATED_AT-Werte in UTC, um Probleme mit der Sommerzeit zu vermeiden.
• Braze synchronisiert Zeilen, bei denen UPDATED_AT später als der zuletzt synchronisierte Wert ist.
• Zeilen mit dem exakten Grenz-Zeitstempel können erneut synchronisiert werden, wenn neue Zeilen denselben Zeitstempel verwenden.

Hinweise zu doppelten Zeitstempeln und inkrementellen Updates finden Sie unter Best Practices für die Cloud-Datenaufnahme.

Hinweis

Dateispeicherquellen verwenden andere Einrichtungsanforderungen und unterstützen UPDATED_AT nicht. Details finden Sie unter Dateispeicher-Integrationen.

PAYLOAD-Spalte einrichten

Der PAYLOAD-Wert folgt denselben Objektformaten, die vom Braze-Endpunkt /users/track für den ausgewählten Datentyp verwendet werden.

Für verschachtelte Attribute geben Sie Datumsangaben im Format an, das unter Datumsangaben als Objekteigenschaften erfassen beschrieben ist.

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

Verwandte CDI-Einrichtungsdokumentation

• Quellenspezifische DDL-Beispiele finden Sie unter Data-Warehouse-Integrationen.
• Informationen zur dateibasierten Einrichtung finden Sie unter Dateispeicher-Integrationen.
• Hinweise zum Synchronisationsverhalten und zur Optimierung finden Sie unter Best Practices für die Cloud-Datenaufnahme.