Configuration des tables pour l’ingestion de données cloud

Utilisez cette page pour choisir comment l’ingestion de données cloud (CDI) lit vos données, et pour configurer une table source avec une colonne payload si vous utilisez cette méthode.

Choisir une option de définition des données

Lorsque vous créez une synchronisation à partir d’une source d’entrepôt de données, vous choisissez comment Braze lit vos données à l’étape Définition des données. Les options affichées dépendent du type de synchronisation.

Comprendre la configuration de la table par rapport au formatage du payload

Pour les synchronisations de données utilisateur CDI qui utilisent une colonne payload, configurez les deux éléments suivants :

Braze lit d’abord les lignes de votre table source, puis valide le champ payload en fonction du type de données sélectionné.

Configurer votre table source

Pour les synchronisations de données utilisateur d’entrepôt de données qui utilisent une colonne payload, votre table ou vue source doit inclure :

• UPDATED_AT
• payload
• Une ou plusieurs colonnes d’identifiant utilisateur prises en charge :
  • EXTERNAL_ID
  • ALIAS_NAME et ALIAS_LABEL
  • BRAZE_ID
  • EMAIL
  • PHONE

Chaque ligne ne doit inclure qu’un seul type d’identifiant à la fois, même si votre table contient plusieurs colonnes d’identifiant.

Exigences pour UPDATED_AT

• Stockez les valeurs UPDATED_AT en UTC pour éviter les problèmes liés aux changements d’heure.
• Braze synchronise les lignes dont la valeur UPDATED_AT est postérieure à la dernière valeur synchronisée.
• Les lignes se trouvant exactement à l’horodatage limite peuvent être re-synchronisées si de nouvelles lignes partagent cet horodatage.

Pour des conseils sur les horodatages en double et les mises à jour incrémentales, consultez les Bonnes pratiques pour l’ingestion de données cloud.

Remarque

Les sources de stockage de fichiers utilisent des exigences de configuration différentes et ne prennent pas en charge UPDATED_AT. Pour plus de détails, consultez Intégrations de stockage de fichiers.

Configurer la colonne payload

La valeur payload suit les mêmes formats d’objets utilisés par l’endpoint Braze /users/track pour le type de données sélectionné.

Pour les attributs imbriqués, incluez les dates en utilisant le format décrit dans Capturer des dates en tant que propriétés d’objet.

Exemples de payload

• attributs personnalisés imbriqués
• événement
• achat
• subscription groups

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

Documentation de configuration CDI associée

• Pour des exemples DDL spécifiques à chaque source, consultez Intégrations d’entrepôts de données.
• Pour la configuration basée sur les fichiers, consultez Intégrations de stockage de fichiers.
• Pour des conseils sur le comportement de synchronisation et l’optimisation, consultez Bonnes pratiques pour l’ingestion de données cloud.