Présentation des transferts de données Klaviyo

Vous pouvez charger des données de Klaviyo dans BigQuery à l'aide du Service de transfert de données BigQuery pour Klaviyo. Avec Service de transfert de données BigQuery, vous pouvez planifier des tâches de transfert récurrentes qui ajoutent vos dernières données de Klaviyo à BigQuery.

Pour savoir comment planifier un transfert Klaviyo, consultez Charger des données Klaviyo dans BigQuery.

Options d'ingestion de données

Ces sections décrivent les options d'ingestion de données pour configurer un transfert de données Klaviyo.

Transferts complets ou incrémentiels

Vous spécifiez comment les données sont chargées dans BigQuery en sélectionnant la préférence d'écriture Full (Complète) ou Incremental (Incrémentielle) dans la configuration de transfert lorsque vous configurez un transfert Klaviyo. Les transferts incrémentiels sont compatibles avec la version preview.

Vous pouvez configurer un transfert de données complet pour transférer toutes les données de vos ensembles de données Klaviyo à chaque transfert de données.

Vous pouvez également configurer un transfert de données incrémentiel (preview) pour ne transférer que les données qui ont été modifiées depuis le dernier transfert de données, au lieu de charger l’ensemble de données à chaque transfert de données. Si vous sélectionnez Incremental (Incrémentiel) pour votre transfert de données, vous devez spécifier les modes d'écriture Append (Ajouter) ou Upsert (Faire un upsert) pour définir comment les données sont écrites dans BigQuery lors d'un transfert de données incrémentiel. Les sections suivantes décrivent les modes d'écriture disponibles.

Mode d'écriture "Append" (Ajouter)

Le mode d'écriture "Append" (Ajouter) n'insère que de nouvelles lignes dans votre table de destination. Cette option ajoute strictement les données transférées sans vérifier les enregistrements existants. Ce mode peut donc entraîner une duplication des données dans la table de destination.

Lorsque vous sélectionnez le mode "Append" (Ajouter), vous devez sélectionner une colonne de filigrane. Une colonne de filigrane est requise pour que le connecteur Klaviyo puisse suivre les modifications apportées à la table source.

Pour les transferts Klaviyo, nous vous recommandons de sélectionner une colonne qui n'est mise à jour que lorsque l'enregistrement a été créé et qui ne changera pas lors des mises à jour ultérieures, par exemple la colonne CREATED_AT.

Mode d'écriture "Upsert" (Faire un upsert)

Le mode d'écriture "Upsert" (Faire un upsert) met à jour une ligne ou en insère une nouvelle dans votre table de destination en recherchant une clé primaire. Vous pouvez spécifier une clé primaire pour permettre au connecteur Klaviyo de déterminer les modifications nécessaires pour que votre table de destination soit à jour par rapport à votre table source. Si la clé primaire spécifiée est présente dans la table BigQuery de destination lors d'un transfert de données, le connecteur Klaviyo met à jour cette ligne avec les nouvelles données de la table source. Si aucune clé primaire n'est présente lors d'un transfert de données, le connecteur Klaviyo insère une nouvelle ligne.

Lorsque vous sélectionnez le mode "Upsert" (Faire un upsert), vous devez sélectionner une colonne de filigrane et une clé primaire :

  • Une colonne de filigrane est requise pour que le connecteur Klaviyo puisse suivre les modifications apportées à la table source.
    • Sélectionnez une colonne de filigrane qui est mise à jour chaque fois qu'une ligne est modifiée. Nous vous recommandons d'utiliser des colonnes semblables aux colonnes UPDATED_AT ou LAST_MODIFIED.

  • La clé primaire peut être une ou plusieurs colonnes de votre table qui sont requises pour que le connecteur Klaviyo puisse déterminer s'il doit insérer ou mettre à jour une ligne.

    Sélectionnez des colonnes contenant des valeurs non nulles uniques dans toutes les lignes de la table. Nous vous recommandons d'utiliser des colonnes qui incluent des identifiants générés par le système, des codes de référence uniques (par exemple, des ID à incrémentation automatique) ou des ID de séquence immuables basés sur le temps.

    Pour éviter toute perte ou corruption de données, les colonnes de clé primaire que vous sélectionnez doivent avoir des valeurs uniques. Si vous avez des doutes sur l'unicité de la colonne de clé primaire que vous avez choisie, nous vous recommandons d'utiliser le mode d'écriture "Append" (Ajouter) à la place.

Mappage des types de données

Le tableau suivant mappe les types de données Klaviyo aux types de données BigQuery correspondants :

Type de données Klaviyo Type de données BigQuery
String STRING
Text STRING
Integer INTEGER
Boolean BOOLEAN
Date (YYYY-MM-DD HH:MM:SS) TIMESTAMP
List ARRAY

Tarifs

Le transfert de données Klaviyo vers BigQuery est sans frais tant que cette fonctionnalité est en version preview.

Étape suivante