Présentation des transferts de données Klaviyo

Vous pouvez charger des données de Klaviyo dans BigQuery à l'aide du BigQuery Data Transfer Service pour Klaviyo. Avec le 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.

Limites

Les transferts Klaviyo incrémentiels sont soumis aux limites suivantes :

  • Vous ne pouvez choisir que des colonnes TIMESTAMP comme colonnes de filigrane.
  • L'ingestion incrémentielle n'est compatible qu'avec les éléments comportant des colonnes de filigrane valides.
  • Les valeurs d'une colonne de filigrane doivent augmenter de façon linéaire.
  • Les transferts incrémentiels ne peuvent pas synchroniser les opérations de suppression dans la table source.
  • Une seule configuration de transfert ne peut prendre en charge que l'ingestion incrémentielle ou complète.
  • Vous ne pouvez pas mettre à jour les objets dans la liste asset après la première exécution d'ingestion incrémentielle.
  • Vous ne pouvez pas modifier le mode d'écriture dans une configuration de transfert après la première exécution d'ingestion incrémentielle.
  • Vous ne pouvez pas modifier la colonne de filigrane ni la clé primaire après la première exécution d'ingestion incrémentielle.
  • La table BigQuery de destination est groupée à l'aide de la clé primaire fournie et est soumise aux limites des tables groupées.
  • Lorsque vous mettez à jour une configuration de transfert existante vers le mode d'ingestion incrémentielle pour la première fois, le premier transfert de données après cette mise à jour transfère toutes les données disponibles à partir de votre source de données. Tous les transferts de données incrémentiels suivants ne transféreront que les lignes nouvelles et mises à jour de votre source de données.

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 Complète ou 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 (version 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 complet à chaque transfert de données. Si vous sélectionnez Incrémentiel pour votre transfert de données, vous devez spécifier les modes d'écriture Ajouter ou 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 "Ajouter"

Le mode d'écriture "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 "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"

Le mode d'écriture "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", 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 se met à 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 quant à l'unicité de la colonne de clé primaire que vous avez choisie, nous vous recommandons d'utiliser le mode d'écriture "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