Documentation de référence sur le modèle de données Klaviyo
Cette page liste les données transférées vers BigQuery lorsque vous exécutez un transfert de données Klaviyo. Les données sont organisées dans des tableaux qui listent chaque nom de champ, son type de données de destination associé et le chemin JSON à partir des données sources.
Comptes
Informations et métadonnées du compte Klaviyo.
- Nom de la table : Comptes
- Point de terminaison :
/accounts - Documentation de référence de l'API Klaviyo : Get Accounts
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours account). |
id |
STRING | $.id |
Identifiant unique du compte. |
test_account |
STRING | $.attributes.test_account |
Indique s'il s'agit d'un compte test. |
default_sender_name |
STRING | $.attributes.contact_information.default_sender_name |
Nom par défaut utilisé comme expéditeur pour les e-mails. |
default_sender_email |
STRING | $.attributes.contact_information.default_sender_email |
Adresse e-mail par défaut utilisée comme expéditeur. |
website_url |
STRING | $.attributes.contact_information.website_url |
URL du site Web de l'organisation. |
organization_name |
STRING | $.attributes.contact_information.organization_name |
Nom de l'organisation. |
address1 |
STRING | $.attributes.contact_information.street_address.address1 |
Adresse postale (ligne 1). |
address2 |
STRING | $.attributes.contact_information.street_address.address2 |
Adresse postale (ligne 2). |
city |
STRING | $.attributes.contact_information.street_address.city |
Ville de l'organisation. |
region |
STRING | $.attributes.contact_information.street_address.region |
État, province ou région. |
country |
STRING | $.attributes.contact_information.street_address.country |
Pays. |
zip |
STRING | $.attributes.contact_information.street_address.zip |
Code postal. |
industry |
STRING | $.attributes.industry |
Secteur d'activité du compte. |
timezone |
STRING | $.attributes.timezone |
Paramètre de fuseau horaire pour le compte. |
preferred_currency |
STRING | $.attributes.preferred_currency |
Devise principale utilisée par le compte. |
public_api_key |
STRING | $.attributes.public_api_key |
Clé API publique (ID de site) pour les intégrations côté client. |
locale |
STRING | $.attributes.locale |
Paramètres régionaux (par exemple, en-US). |
Bons de réduction
Bons de réduction et promotions.
- Nom de la table : Coupons
- Point de terminaison :
/coupons - Documentation de référence de l'API Klaviyo : Get Coupons
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours coupon). |
id |
STRING | $.id |
Identifiant interne unique du bon de réduction. |
external_id |
STRING | $.attributes.external_id |
Identifiant externe (souvent identique au nom/à l'ID). |
description |
STRING | $.attributes.description |
Description de l'offre du bon de réduction. |
low_balance_threshold |
STRING | $.attributes.monitor_configuration.low_balance_threshold |
Seuil pour déclencher les alertes de solde faible. |
CouponCode
Codes uniques individuels générés pour des bons de réduction spécifiques.
- Nom de la table : CouponCode
- Point de terminaison :
/coupon-codes - Documentation de référence de l'API Klaviyo : Get Coupon Codes
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours coupon-code). |
id |
STRING | $.id |
Identifiant unique de cette instance de code spécifique. |
unique_code |
STRING | $.attributes.unique_code |
Chaîne de code alphanumérique. |
expires_at |
TIMESTAMP | $.attributes.expires_at |
Code temporel d'expiration de ce code. |
status |
STRING | $.attributes.status |
État du code (par exemple, ASSIGNED, UNASSIGNED). |
coupon_id |
STRING | $.relationships.coupon.data.id |
ID de la définition du bon de réduction parent. |
Événements
Événements d'activité suivis pour les profils (par exemple, (Commande passée, Produit consulté).
- Nom de la table : "Events" (Événements)
- Point de terminaison :
/events - Documentation de référence de l'API Klaviyo : Get Events
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours event). |
id |
STRING | $.id |
Identifiant unique de l'événement. |
timestamp |
FLOAT | $.attributes.timestamp |
Code temporel Unix indiquant le moment où l'événement s'est produit. |
event_properties |
JSON | $.attributes.event_properties |
Propriétés JSON personnalisées spécifiques au type d'événement (par exemple, les articles d'une commande). |
datetime |
TIMESTAMP | $.attributes.datetime |
Code temporel ISO 8601 de l'événement. |
uuid |
STRING | $.attributes.uuid |
Identifiant universel unique de l'événement. |
profile_id |
STRING | $.relationships.profile.data.id |
ID du profil (client) associé à l'événement. |
metric_id |
STRING | $.relationships.metric.data.id |
ID de la définition de la métrique (type d'événement). |
attribution_ids |
REPEATED STRING | $.relationships.attributions.data[*].id |
ID des campagnes/flux attribués à cet événement. |
Flux
Flux marketing automatisés déclenchés par des événements ou des conditions spécifiques.
- Nom de la table : Flows
- Point de terminaison :
/flows - Documentation de référence de l'API Klaviyo : Get Flows
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours flow). |
id |
STRING | $.id |
Identifiant unique du flux. |
name |
STRING | $.attributes.name |
Nom du flux. |
status |
STRING | $.attributes.status |
État opérationnel (par exemple, "En ligne" ou "Brouillon"). |
archived |
BOOLÉEN | $.attributes.archived |
Indique si le flux est archivé. |
created |
TIMESTAMP | $.attributes.created |
Code temporel de création. |
updated |
TIMESTAMP | $.attributes.updated |
Code temporel de la dernière modification. |
trigger_type |
STRING | $.attributes.trigger_type |
Mécanisme déclenchant le flux (par exemple, "Ajouté à la liste", "Métrique"). |
flow_actions_ids |
REPEATED STRING | $.relationships.flow-actions.data[*].id |
ID des actions (étapes) de ce flux. |
tag_ids |
REPEATED STRING | $.relationships.tags.data[*].id |
ID des tags attribués à ce flux. |
Forms
Formulaires d'inscription pour collecter des informations sur les abonnés.
- Nom de la table : Forms
- Point de terminaison :
/forms - Documentation de référence de l'API Klaviyo : Get Forms
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours form). |
id |
STRING | $.id |
Identifiant unique du formulaire. |
name |
STRING | $.attributes.name |
Nom du formulaire. |
status |
STRING | $.attributes.status |
État du formulaire (par exemple, "En ligne" ou "Brouillon"). |
ab_test |
BOOLÉEN | $.attributes.ab_test |
Indique si le formulaire exécute un test A/B. |
created_at |
TIMESTAMP | $.attributes.created_at |
Code temporel de création. |
updated_at |
TIMESTAMP | $.attributes.updated_at |
Code temporel de la dernière modification. |
Images
Images importées dans Klaviyo pour être utilisées dans des campagnes et des modèles.
- Nom de la table : Images
- Point de terminaison :
/images - Documentation de référence de l'API Klaviyo : Get Images
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours image). |
id |
STRING | $.id |
Identifiant unique. |
name |
STRING | $.attributes.name |
Nom de fichier ou nom de l'image. |
image_url |
STRING | $.attributes.image_url |
URL publique permettant d'accéder à l'image. |
format |
STRING | $.attributes.format |
Format du fichier image (par exemple, jpeg, png). |
size |
FLOAT | $.attributes.size |
Taille du fichier en octets. |
hidden |
BOOLÉEN | $.attributes.hidden |
Indique si l'image est masquée dans l'UI. |
updated_at |
TIMESTAMP | $.attributes.updated_at |
Code temporel de la dernière modification. |
Listes
Listes statiques de contacts/profils.
- Nom de la table : "Lists" (Listes)
- Point de terminaison :
/lists - Documentation de référence de l'API Klaviyo : Get Lists
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours list). |
id |
STRING | $.id |
Identifiant unique de la liste. |
name |
STRING | $.attributes.name |
Nom de la liste de contacts. |
created |
TIMESTAMP | $.attributes.created |
Code temporel de création. |
updated |
TIMESTAMP | $.attributes.updated |
Code temporel de la dernière modification. |
opt_in_process |
STRING | $.attributes.opt_in_process |
Paramètre d'activation (par exemple, "single_opt_in" ou "double_opt_in"). |
tag_ids |
REPEATED STRING | $.relationships.tags.data[*].id |
ID des tags attribués à cette liste. |
flow_triggers_ids |
REPEATED STRING | $.relationships.flow-triggers.data[*].id |
ID des flux déclenchés par l'ajout de profils à cette liste. |
Métriques
Types d'événements pouvant être suivis (par exemple, "Received Email" (E-mail reçu).
- Nom de la table : Metrics
- Point de terminaison :
/metrics - Documentation de référence de l'API Klaviyo : Get Metrics
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours metric). |
id |
STRING | $.id |
Identifiant unique (par exemple, (code de six caractères pour un UUID générique et long pour un UUID personnalisé). |
name |
STRING | $.attributes.name |
Nom lisible (par exemple, "Commande passée"). |
created |
TIMESTAMP | $.attributes.created |
Code temporel de création. |
updated |
TIMESTAMP | $.attributes.updated |
Code temporel de la dernière modification. |
integration |
JSON | $.attributes.integration |
Informations sur l'intégration fournissant cette métrique (par exemple, nom, catégorie, image). |
flow_triggers_ids |
REPEATED STRING | $.relationships.flow-triggers.data[*].id |
ID des flux déclenchés par cette métrique. |
Profils
Des profils client complets contenant des attributs et l'historique des activités.
- Nom de la table : "Profiles"
- Point de terminaison :
/profiles - Documentation de référence de l'API Klaviyo : Get Profiles
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours profile). |
id |
STRING | $.id |
ID Klaviyo unique du profil. |
email |
STRING | $.attributes.email |
Adresse e-mail principale. |
phone_number |
STRING | $.attributes.phone_number |
Numéro de téléphone au format E.164. |
external_id |
STRING | $.attributes.external_id |
ID provenant d'un système externe. |
first_name |
STRING | $.attributes.first_name |
Prénom |
last_name |
STRING | $.attributes.last_name |
Nom |
organization |
STRING | $.attributes.organization |
Nom de l'entreprise ou de l'organisation. |
locale |
STRING | $.attributes.locale |
Paramètres régionaux/de langue. |
title |
STRING | $.attributes.title |
Intitulé de poste. |
image |
STRING | $.attributes.image |
URL de l'image de profil. |
created |
TIMESTAMP | $.attributes.created |
Code temporel de création du profil. |
updated |
TIMESTAMP | $.attributes.updated |
Code temporel de la dernière mise à jour. |
last_event_date |
TIMESTAMP | $.attributes.last_event_date |
Code temporel de l'événement le plus récent. |
address1 |
STRING | $.attributes.location.address1 |
Ligne d'adresse 1. |
address2 |
STRING | $.attributes.location.address2 |
Ligne d'adresse 2. |
city |
STRING | $.attributes.location.city |
Ville. |
country |
STRING | $.attributes.location.country |
Pays. |
latitude |
STRING | $.attributes.location.latitude |
Coordonnées de latitude. |
longitude |
STRING | $.attributes.location.longitude |
Coordonnées de longitude. |
region |
STRING | $.attributes.location.region |
État ou région. |
zip |
STRING | $.attributes.location.zip |
Code postal. |
timezone |
STRING | $.attributes.location.timezone |
Fuseau horaire. |
ip |
STRING | $.attributes.location.ip |
avec une adresse IP externe. |
properties |
JSON | $.attributes.properties |
Paires clé-valeur des propriétés personnalisées. |
email_marketing_can_receive_email_marketing |
BOOLÉEN | $.attributes.subscriptions.email.marketing.can_receive_email_marketing |
Indique si le profil peut recevoir des e-mails marketing. |
email_marketing_consent |
STRING | $.attributes.subscriptions.email.marketing.consent |
État du consentement (par exemple, SUBSCRIBED, UNSUBSCRIBED). |
email_marketing_consent_timestamp |
TIMESTAMP | $.attributes.subscriptions.email.marketing.consent_timestamp |
Date à laquelle le consentement a été donné. |
email_marketing_last_updated |
TIMESTAMP | $.attributes.subscriptions.email.marketing.last_updated |
Date de la dernière mise à jour de l'autorisation d'envoi d'e-mails. |
email_marketing_method |
STRING | $.attributes.subscriptions.email.marketing.method |
Méthode de consentement (par exemple, FORM). |
email_marketing_method_detail |
STRING | $.attributes.subscriptions.email.marketing.method_detail |
Source spécifique de la méthode. |
email_marketing_custom_method_detail |
STRING | $.attributes.subscriptions.email.marketing.custom_method_detail |
Détails personnalisés pour la méthode de consentement. |
email_marketing_double_optin |
BOOLÉEN | $.attributes.subscriptions.email.marketing.double_optin |
Indique si la double activation a été effectuée. |
sms_marketing_can_receive_sms_marketing |
BOOLÉEN | $.attributes.subscriptions.sms.marketing.can_receive_sms_marketing |
Indique si le profil peut recevoir des SMS marketing. |
sms_marketing_consent |
STRING | $.attributes.subscriptions.sms.marketing.consent |
État du consentement pour les SMS. |
sms_marketing_consent_timestamp |
TIMESTAMP | $.attributes.subscriptions.sms.marketing.consent_timestamp |
Date à laquelle le consentement pour les SMS a été donné. |
sms_marketing_last_updated |
TIMESTAMP | $.attributes.subscriptions.sms.marketing.last_updated |
Date de la dernière mise à jour de l'autorisation d'envoi de SMS. |
sms_marketing_method |
STRING | $.attributes.subscriptions.sms.marketing.method |
Méthode de consentement par SMS. |
sms_marketing_method_detail |
STRING | $.attributes.subscriptions.sms.marketing.method_detail |
Détails de la méthode de consentement par SMS. |
sms_transactional_can_receive_sms_transactional |
BOOLÉEN | $.attributes.subscriptions.sms.transactional.can_receive_sms_transactional |
Indique si le profil peut recevoir des SMS transactionnels. |
sms_transactional_consent |
STRING | $.attributes.subscriptions.sms.transactional.consent |
État du consentement pour les SMS transactionnels. |
sms_transactional_consent_timestamp |
TIMESTAMP | $.attributes.subscriptions.sms.transactional.consent_timestamp |
Date à laquelle le consentement transactionnel a été donné. |
sms_transactional_last_updated |
TIMESTAMP | $.attributes.subscriptions.sms.transactional.last_updated |
Date de la dernière mise à jour de l'état transactionnel. |
sms_transactional_method |
STRING | $.attributes.subscriptions.sms.transactional.method |
Méthode des SMS transactionnels. |
sms_transactional_method_detail |
STRING | $.attributes.subscriptions.sms.transactional.method_detail |
Détails de la méthode d'envoi de SMS transactionnels. |
mobile_push_can_receive_push_marketing |
BOOLÉEN | $.attributes.subscriptions.mobile_push.marketing.can_receive_push_marketing |
Indique si le profil peut recevoir des notifications push marketing. |
mobile_push_consent |
STRING | $.attributes.subscriptions.mobile_push.marketing.consent |
État du consentement pour les notifications push. |
mobile_push_consent_timestamp |
TIMESTAMP | $.attributes.subscriptions.mobile_push.marketing.consent_timestamp |
Date à laquelle l'utilisateur a autorisé les notifications push. |
predictive_analytics_historic_number_of_orders |
FLOAT | $.attributes.predictive_analytics.historic_number_of_orders |
Nombre total de commandes historiques. |
predictive_analytics_predicted_number_of_orders |
FLOAT | $.attributes.predictive_analytics.predicted_number_of_orders |
les futures commandes prévues ; |
predictive_analytics_average_days_between_orders |
FLOAT | $.attributes.predictive_analytics.average_days_between_orders |
Nombre moyen de jours entre les commandes. |
predictive_analytics_average_order_value |
FLOAT | $.attributes.predictive_analytics.average_order_value |
Valeur moyenne historique des commandes. |
predictive_analytics_historic_clv |
FLOAT | $.attributes.predictive_analytics.historic_clv |
Valeur vie client historique. |
predictive_analytics_predicted_clv |
FLOAT | $.attributes.predictive_analytics.predicted_clv |
Valeur vie client prévue. |
predictive_analytics_total_clv |
FLOAT | $.attributes.predictive_analytics.total_clv |
CLV historique et prévue. |
predictive_analytics_churn_probability |
FLOAT | $.attributes.predictive_analytics.churn_probability |
Probabilité de perte d'utilisateurs (0 à 1). |
predictive_analytics_expected_date_of_next_order |
TIMESTAMP | $.attributes.predictive_analytics.expected_date_of_next_order |
Date prévue de la prochaine commande. |
email_marketing_suppression_reason |
JSON RÉPÉTÉ | $.attributes.subscriptions.email.marketing.suppression[*] |
Motifs de suppression des e-mails (par exemple, e-mail non distribué). |
email_marketing_list_suppressions_reason |
JSON RÉPÉTÉ | $.attributes.subscriptions.email.marketing.list_suppressions[*] |
Motifs de suppression spécifiques à la liste. |
push_tokens_ids |
REPEATED STRING | $.relationships.push-tokens.data[*].id |
ID des jetons push associés. |
Avis
Avis sur les produits envoyés par les clients.
- Nom de la table : "Reviews"
- Point de terminaison :
/reviews - Documentation de référence de l'API Klaviyo : Get Reviews
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours review). |
id |
STRING | $.id |
Identifiant unique de l'avis. |
email |
STRING | $.attributes.email |
Adresse e-mail de l'auteur de l'avis. |
value |
STRING | $.attributes.status.value |
Valeur de l'état (par exemple, "publié" ou "refusé"). |
reason |
STRING | $.attributes.status.rejection_reason.reason |
Motif du refus, le cas échéant. |
status_explanation |
STRING | $.attributes.status.rejection_reason.status_explanation |
Explication détaillée de l'état. |
verified |
BOOLÉEN | $.attributes.verified |
Indique si l'achat a été validé. |
review_type |
STRING | $.attributes.review_type |
Type d'avis (par exemple, avis sur un produit). |
created |
TIMESTAMP | $.attributes.created |
Code temporel de création. |
updated |
TIMESTAMP | $.attributes.updated |
Code temporel de la dernière modification. |
images |
REPEATED STRING | $.attributes.images[*] |
URL des images jointes à l'avis. |
product_url |
STRING | $.attributes.product.url |
URL du produit évalué. |
product_name |
STRING | $.attributes.product.name |
Nom du produit. |
product_image_url |
STRING | $.attributes.product.image_url |
URL de l'image du produit. |
product_external_id |
STRING | $.attributes.product.external_id |
ID externe du produit. |
rating |
INTEGER | $.attributes.rating |
Score de la note. |
author |
STRING | $.attributes.author |
Nom de l'auteur de l'avis. |
content |
STRING | $.attributes.content |
Contenu textuel de l'avis. |
title |
STRING | $.attributes.title |
Titre de l'avis. |
smart_quote |
STRING | $.attributes.smart_quote |
Citation mise en avant dans l'avis. |
public_reply_content |
STRING | $.attributes.public_reply.content |
Contenu de la réponse publique du marchand. |
public_reply_author |
STRING | $.attributes.public_reply.author |
Auteur de la réponse. |
public_reply_updated |
STRING | $.attributes.public_reply.updated |
Code temporel de la mise à jour de la réponse. |
event_ids |
REPEATED STRING | $.relationships.events.data[*].id |
ID des événements associés. |
Segments
Groupes dynamiques de profils basés sur des critères spécifiques.
- Nom de la table : Segments
- Point de terminaison :
/segments - Documentation de référence de l'API Klaviyo : Get Segments
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours segment). |
id |
STRING | $.id |
Identifiant unique du segment. |
name |
STRING | $.attributes.name |
Nom du segment. |
created |
TIMESTAMP | $.attributes.created |
Code temporel de création. |
updated |
TIMESTAMP | $.attributes.updated |
Code temporel de la dernière modification. |
is_active |
BOOLÉEN | $.attributes.is_active |
Indique si le segment est actif. |
is_processing |
BOOLÉEN | $.attributes.is_processing |
Indique si le segment est en cours de traitement. |
is_starred |
BOOLÉEN | $.attributes.is_starred |
Indique si le segment est suivi/ajouté aux favoris. |
tag_ids |
REPEATED STRING | $.relationships.tags.data[*].id |
ID des balises associées. |
flow_triggers_ids |
REPEATED STRING | $.relationships.flow-triggers.data[*].id |
ID des flux déclenchés par ce segment. |
condition_groups |
ENREGISTREMENT RÉPÉTÉ | $.attributes.definition.condition_groups[*] |
Groupes de conditions logiques définissant le segment. |
ConditionGroup
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
conditions |
Condition REPEATED | conditions[*] |
Liste des conditions individuelles du groupe. |
Condition
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | type |
Type de condition (par exemple, profile-property). |
value |
JSON | N/A |
Valeur/configuration de la condition. |
Tags
Tags utilisés pour organiser les campagnes, les flux et les listes.
- Nom de la table : Tags
- Point de terminaison :
/tags - Documentation de référence de l'API Klaviyo : Get Tags
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours tag). |
id |
STRING | $.id |
Identifiant unique du tag. |
name |
STRING | $.attributes.name |
Nom de la balise. |
tag_group_id |
STRING | $.relationships.tag-group.data.id |
ID du groupe de balises auquel appartient cette balise. |
Modèles
Modèles d'e-mails et de messages.
- Nom de la table : "Templates" (Modèles)
- Point de terminaison :
/templates - Documentation de référence de l'API Klaviyo : Get Templates
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours template). |
id |
STRING | $.id |
Identifiant unique. |
name |
STRING | $.attributes.name |
Nom du modèle. |
editor_type |
STRING | $.attributes.editor_type |
Éditeur utilisé (par exemple, glisser-déposer). |
html |
STRING | $.attributes.html |
Contenu HTML |
text |
STRING | $.attributes.text |
Version texte du modèle. |
| amp | STRING | $.attributes.amp |
Version AMP du modèle. |
created |
TIMESTAMP | $.attributes.created |
Code temporel de création. |
updated |
TIMESTAMP | $.attributes.updated |
Code temporel de la dernière mise à jour. |
WebFeeds
Flux Web utilisés pour remplir le contenu des messages.
- Nom de la table : WebFeeds
- Point de terminaison :
/web-feeds - Documentation de référence de l'API Klaviyo : Get Web Feeds
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours web-feed). |
id |
STRING | $.id |
Identifiant unique. |
name |
STRING | $.attributes.name |
Nom du flux. |
url |
STRING | $.attributes.url |
URL de la source du flux. |
request_method |
STRING | $.attributes.request_method |
Méthode HTTP (GET/POST). |
content_type |
STRING | $.attributes.content_type |
Type de contenu (par exemple, JSON). |
status |
STRING | $.attributes.status |
État du flux. |
created |
TIMESTAMP | $.attributes.created |
Code temporel de création. |
updated |
TIMESTAMP | $.attributes.updated |
Code temporel de la dernière mise à jour. |
DataSources
Sources de données intégrées à Klaviyo.
- Nom de la table : DataSources
- Point de terminaison :
/data-sources - Documentation de référence de l'API Klaviyo : Get Data Sources (Obtenir les sources de données)
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours data-source). |
id |
STRING | $.id |
Identifiant unique. |
title |
STRING | $.attributes.title |
Titre de la source de données. |
visibility |
STRING | $.attributes.visibility |
Niveau de visibilité. |
description |
STRING | $.attributes.description |
Texte de description. |
Campagnes
Campagnes marketing envoyées à des listes ou des segments.
- Nom de la table : "Campagnes"
- Point de terminaison :
/campaigns - Documentation de référence de l'API Klaviyo : Get Campaigns
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours campaign). |
id |
STRING | $.id |
Identifiant unique. |
name |
STRING | $.attributes.name |
Nom de la campagne. |
status |
STRING | $.attributes.status |
État de la campagne (par exemple, Envoyé, Programmation). |
archived |
BOOLÉEN | $.attributes.archived |
Indique si la campagne est archivée. |
included |
REPEATED STRING | $.attributes.audiences.included |
ID des listes/segments inclus. |
excluded |
REPEATED STRING | $.attributes.audiences.excluded |
ID des listes/segments exclus. |
send_options |
JSON | $.attributes.send_options |
Configuration pour l'envoi (par exemple, l'envoi intelligent). |
tracking_options |
JSON | $.attributes.tracking_options |
Configuration du suivi (par exemple, paramètres UTM). |
send_strategy |
JSON | $.attributes.send_strategy |
Stratégie pour le délai de livraison. |
created_at |
TIMESTAMP | $.attributes.created_at |
Code temporel de création. |
scheduled_at |
TIMESTAMP | $.attributes.scheduled_at |
Date et heure d'envoi de la campagne. |
updated_at |
TIMESTAMP | $.attributes.updated_at |
Code temporel de la dernière mise à jour. |
send_time |
TIMESTAMP | $.attributes.send_time |
Heure d'envoi réelle. |
tag_ids |
REPEATED STRING | $.relationships.tags.data[*].id |
ID des balises associées. |
campaign_message_ids |
REPEATED STRING | $.relationships.campaign-messages.data[*].id |
ID des messages contenus dans cette campagne. |
CampaignMessages
Messages individuels (e-mail/SMS) d'une campagne.
- Nom de la table : CampaignMessages
- Point de terminaison :
/campaign-messages - Documentation de référence de l'API Klaviyo : Get Campaign Message
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource (toujours campaign-message). |
id |
STRING | $.id |
Identifiant unique. |
definition |
JSON | $.attributes.definition |
Contenu et configuration du message. |
send_times |
JSON RÉPÉTÉ | $.attributes.send_times[*] |
Heures d'envoi programmées. |
created_at |
TIMESTAMP | $.attributes.created_at |
Code temporel de création. |
updated_at |
TIMESTAMP | $.attributes.updated_at |
Code temporel de la dernière mise à jour. |
campaign_id |
STRING | $.relationships.campaign.data.id |
ID de la campagne parente. |
template_id |
STRING | $.relationships.template.data.id |
ID du modèle utilisé. |
image_id |
STRING | $.relationships.image.data.id |
ID de l'image jointe. |
Catégories
Catégories de produits de votre catalogue.
- Nom de la table : Categories
- Point de terminaison :
/catalog-categories - Documentation de référence de l'API Klaviyo : Get Catalog Categories
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource. |
id |
STRING | $.id |
Identifiant unique. |
name |
STRING | $.attributes.name |
Nom de la catégorie. |
external_id |
STRING | $.attributes.external_id |
ID du système externe. |
updated |
TIMESTAMP | $.attributes.updated |
Code temporel de la dernière mise à jour. |
Éléments
Produits ou articles individuels de votre catalogue.
- Nom de la table : "Items"
- Point de terminaison :
/catalog-items - Documentation de référence de l'API Klaviyo : Get Catalog Items
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource. |
id |
STRING | $.id |
Identifiant unique. |
external_id |
STRING | $.attributes.external_id |
ID du système externe. |
title |
STRING | $.attributes.title |
Titre/Nom de l'article |
description |
STRING | $.attributes.description |
Description disponible. |
price |
FLOAT | $.attributes.price |
Prix de l'article |
url |
STRING | $.attributes.url |
URL de l'article. |
image_full_url |
STRING | $.attributes.image_full_url |
URL de l'image en taille réelle. |
image_thumbnail_url |
STRING | $.attributes.image_thumbnail_url |
URL de la vignette. |
images |
REPEATED STRING | $.attributes.images[*] |
Liste des URL d'images supplémentaires. |
custom_metadata |
JSON | $.attributes.custom_metadata |
Clés-valeurs de métadonnées personnalisées. |
published |
BOOLÉEN | $.attributes.published |
État de la publication. |
created |
TIMESTAMP | $.attributes.created |
Code temporel de création. |
updated |
TIMESTAMP | $.attributes.updated |
Code temporel de la dernière mise à jour. |
variants_ids |
REPEATED STRING | $.relationships.variants.data[*].id |
ID des variantes de cet article. |
Variantes
Variantes spécifiques des éléments du catalogue (par exemple, tailles, couleurs).
- Nom de la table : Variants
- Point de terminaison :
/catalog-variants - Documentation de référence de l'API Klaviyo : Get Catalog Variants
| Nom du champ | Type | Chemin d'accès JSON | Description |
|---|---|---|---|
type |
STRING | $.type |
Type de ressource. |
id |
STRING | $.id |
Identifiant unique. |
external_id |
STRING | $.attributes.external_id |
ID du système externe. |
title |
STRING | $.attributes.title |
Titre de la variante. |
description |
STRING | $.attributes.description |
Description disponible. |
sku |
STRING | $.attributes.sku |
Unité de gestion des stocks |
inventory_policy |
FLOAT | $.attributes.inventory_policy |
Règles concernant la gestion de l'inventaire. |
inventory_quantity |
FLOAT | $.attributes.inventory_quantity |
Quantité actuelle en stock. |
price |
FLOAT | $.attributes.price |
Prix. |
url |
STRING | $.attributes.url |
URL de la variante. |
image_full_url |
BOOLÉEN | $.attributes.image_full_url |
URL complète de l'image disponible (booléen). |
image_thumbnail_url |
STRING | $.attributes.image_thumbnail_url |
URL de la vignette. |
images |
REPEATED STRING | $.attributes.images[*] |
Liste des images. |
published |
BOOLÉEN | $.attributes.published |
État de la publication. |
created |
TIMESTAMP | $.attributes.created |
Code temporel de création. |
updated |
TIMESTAMP | $.attributes.updated |
Code temporel de la dernière mise à jour. |