Riferimento al modello dei dati di Klaviyo

In questa pagina sono elencati i dati che vengono trasferiti a BigQuery quando esegui un trasferimento di dati Klaviyo. I dati sono organizzati in tabelle che elencano ogni nome di campo, il tipo di dati di destinazione associato e il percorso JSON dai dati di origine.

Account

Informazioni e metadati dell'account Klaviyo.

  • Nome tabella: Accounts
  • Endpoint: /accounts
  • Riferimento API Klaviyo: Get Accounts
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre account).
id STRING $.id Identificatore univoco dell'account.
test_account STRING $.attributes.test_account Indica se si tratta di un account di prova.
default_sender_name STRING $.attributes.contact_information.default_sender_name Nome predefinito utilizzato come mittente per le email.
default_sender_email STRING $.attributes.contact_information.default_sender_email Indirizzo email predefinito utilizzato come mittente.
website_url STRING $.attributes.contact_information.website_url URL del sito web dell'organizzazione.
organization_name STRING $.attributes.contact_information.organization_name Nome dell'organizzazione.
address1 STRING $.attributes.contact_information.street_address.address1 Riga indirizzo 1.
address2 STRING $.attributes.contact_information.street_address.address2 Riga indirizzo 2.
city STRING $.attributes.contact_information.street_address.city La città dell'organizzazione.
region STRING $.attributes.contact_information.street_address.region Stato, provincia o regione.
country STRING $.attributes.contact_information.street_address.country Paese.
zip STRING $.attributes.contact_information.street_address.zip Codice postale.
industry STRING $.attributes.industry Verticale di settore dell'account.
timezone STRING $.attributes.timezone Impostazione del fuso orario per l'account.
preferred_currency STRING $.attributes.preferred_currency Valuta principale utilizzata dall'account.
public_api_key STRING $.attributes.public_api_key Chiave API pubblica (ID sito) per le integrazioni lato client.
locale STRING $.attributes.locale Impostazione delle impostazioni internazionali (ad es. en-US).

Coupon

Coupon per sconti e promozioni.

  • Nome della tabella: Coupon
  • Endpoint: /coupons
  • Riferimento API Klaviyo: Get Coupons
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre coupon).
id STRING $.id Identificatore interno univoco del coupon.
external_id STRING $.attributes.external_id Identificatore esterno (spesso corrisponde al nome/ID).
description STRING $.attributes.description Descrizione dell'offerta del coupon.
low_balance_threshold STRING $.attributes.monitor_configuration.low_balance_threshold Soglia per attivare gli avvisi per il saldo in esaurimento.

CouponCode

Codici univoci individuali generati per coupon specifici.

Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre coupon-code).
id STRING $.id Identificatore univoco per questa istanza di codice specifica.
unique_code STRING $.attributes.unique_code La stringa di codice alfanumerico effettiva.
expires_at TIMESTAMP $.attributes.expires_at Timestamp di scadenza del codice.
status STRING $.attributes.status Stato del codice (ad es. ASSIGNED, UNASSIGNED).
coupon_id STRING $.relationships.coupon.data.id ID della definizione del coupon principale.

Eventi

Eventi di attività monitorati per i profili (ad es. Ordine effettuato, Prodotto visualizzato).

  • Nome tabella: Events
  • Endpoint: /events
  • Riferimento API Klaviyo: Get Events
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre event).
id STRING $.id Identificatore univoco dell'evento.
timestamp FLOAT $.attributes.timestamp Timestamp Unix di quando si è verificato l'evento.
event_properties JSON $.attributes.event_properties Proprietà JSON personalizzate specifiche per il tipo di evento (ad es. articoli nell'ordine).
datetime TIMESTAMP $.attributes.datetime Timestamp ISO 8601 dell'evento.
uuid STRING $.attributes.uuid Identificatore univoco universale dell'evento.
profile_id STRING $.relationships.profile.data.id ID del profilo (cliente) associato all'evento.
metric_id STRING $.relationships.metric.data.id ID della definizione della metrica (tipo di evento).
attribution_ids REPEATED STRING $.relationships.attributions.data[*].id ID delle campagne/dei flussi attribuiti a questo evento.

Flussi

Flussi di marketing automatizzati attivati da eventi o condizioni specifici.

  • Nome tabella: Flows
  • Endpoint: /flows
  • Riferimento API Klaviyo: Get Flows
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre flow).
id STRING $.id Identificatore univoco del flusso.
name STRING $.attributes.name Nome del flusso.
status STRING $.attributes.status Stato di attività (ad es. live, bozza).
archived BOOLEANO $.attributes.archived Indica se il flusso è archiviato.
created TIMESTAMP $.attributes.created Timestamp della creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultima modifica.
trigger_type STRING $.attributes.trigger_type Meccanismo che attiva il flusso (ad es. "Aggiunto all'elenco", "Metrica").
flow_actions_ids REPEATED STRING $.relationships.flow-actions.data[*].id ID delle azioni (passaggi) all'interno di questo flusso.
tag_ids REPEATED STRING $.relationships.tags.data[*].id ID dei tag assegnati a questo flusso.

Moduli

Moduli di iscrizione per raccogliere le informazioni degli iscritti.

  • Nome della tabella: Forms
  • Endpoint: /forms
  • Riferimento API Klaviyo: Get Forms
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre form).
id STRING $.id Identificatore univoco del modulo.
name STRING $.attributes.name Nome del modulo.
status STRING $.attributes.status Stato del modulo (ad es. pubblicato, bozza).
ab_test BOOLEANO $.attributes.ab_test Indica se il modulo sta eseguendo un test A/B.
created_at TIMESTAMP $.attributes.created_at Timestamp della creazione.
updated_at TIMESTAMP $.attributes.updated_at Timestamp dell'ultima modifica.

Immagini

Immagini caricate su Klaviyo per l'utilizzo in campagne e modelli.

  • Nome tabella: Images
  • Endpoint: /images
  • Riferimento API Klaviyo: Get Images
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre image).
id STRING $.id Identificatore univoco.
name STRING $.attributes.name Nome file o nome dell'immagine.
image_url STRING $.attributes.image_url URL pubblico per accedere all'immagine.
format STRING $.attributes.format Formato file immagine (ad es. jpeg, png).
size FLOAT $.attributes.size Dimensioni del file in byte.
hidden BOOLEANO $.attributes.hidden Indica se l'immagine è nascosta nell'interfaccia utente.
updated_at TIMESTAMP $.attributes.updated_at Timestamp dell'ultima modifica.

Elenchi

Elenchi statici di contatti/profili.

  • Nome tabella: Lists
  • Endpoint: /lists
  • Riferimento API Klaviyo: Get Lists
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre list).
id STRING $.id Identificatore univoco dell'elenco.
name STRING $.attributes.name Il nome dell'elenco contatti.
created TIMESTAMP $.attributes.created Timestamp della creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultima modifica.
opt_in_process STRING $.attributes.opt_in_process Impostazione di attivazione (ad es. "singleoptin" o "doubleoptin").
tag_ids REPEATED STRING $.relationships.tags.data[*].id ID dei tag assegnati a questo elenco.
flow_triggers_ids REPEATED STRING $.relationships.flow-triggers.data[*].id ID dei flussi attivati dall'aggiunta di profili a questo elenco.

Metriche

Tipi di eventi che possono essere monitorati (ad es. "Email ricevuta").

  • Nome della tabella: Metrics
  • Endpoint: /metrics
  • Riferimento API Klaviyo: Get Metrics
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre metric).
id STRING $.id Identificatore univoco (ad es. codice di 6 caratteri per il tipo generico, UUID lungo per il tipo personalizzato).
name STRING $.attributes.name Nome leggibile (ad es. "Ordine effettuato").
created TIMESTAMP $.attributes.created Timestamp della creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultima modifica.
integration JSON $.attributes.integration Informazioni sull'integrazione che fornisce questa metrica (ad es. nome, categoria, immagine).
flow_triggers_ids REPEATED STRING $.relationships.flow-triggers.data[*].id ID dei flussi attivati da questa metrica.

Profili

Profili cliente completi contenenti attributi e cronologia attività.

  • Nome tabella: Profili
  • Endpoint: /profiles
  • Riferimento API Klaviyo: Get Profiles
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre profile).
id STRING $.id ID Klaviyo univoco del profilo.
email STRING $.attributes.email Indirizzo email principale.
phone_number STRING $.attributes.phone_number Numero di telefono nel formato E.164.
external_id STRING $.attributes.external_id ID di un sistema esterno.
first_name STRING $.attributes.first_name Nome.
last_name STRING $.attributes.last_name Cognome.
organization STRING $.attributes.organization Nome dell'azienda o dell'organizzazione.
locale STRING $.attributes.locale Impostazione della lingua/delle impostazioni internazionali.
title STRING $.attributes.title Qualifica.
image STRING $.attributes.image URL dell'immagine del profilo.
created TIMESTAMP $.attributes.created Timestamp della creazione del profilo.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultimo aggiornamento.
last_event_date TIMESTAMP $.attributes.last_event_date Timestamp dell'evento più recente.
address1 STRING $.attributes.location.address1 Riga indirizzo 1.
address2 STRING $.attributes.location.address2 Riga indirizzo 2.
city STRING $.attributes.location.city Città.
country STRING $.attributes.location.country Paese.
latitude STRING $.attributes.location.latitude Coordinate di latitudine.
longitude STRING $.attributes.location.longitude Coordinate di longitudine.
region STRING $.attributes.location.region Stato o regione.
zip STRING $.attributes.location.zip Codice postale.
timezone STRING $.attributes.location.timezone Fuso orario.
ip STRING $.attributes.location.ip Indirizzo IP.
properties JSON $.attributes.properties Coppie chiave-valore delle proprietà personalizzate.
email_marketing_can_receive_email_marketing BOOLEANO $.attributes.subscriptions.email.marketing.can_receive_email_marketing Indica se il profilo può ricevere email marketing.
email_marketing_consent STRING $.attributes.subscriptions.email.marketing.consent Stato del consenso (ad es. SUBSCRIBED, UNSUBSCRIBED).
email_marketing_consent_timestamp TIMESTAMP $.attributes.subscriptions.email.marketing.consent_timestamp Quando è stato dato il consenso.
email_marketing_last_updated TIMESTAMP $.attributes.subscriptions.email.marketing.last_updated Data e ora dell'ultimo aggiornamento del consenso via email.
email_marketing_method STRING $.attributes.subscriptions.email.marketing.method Metodo di consenso (ad es. FORM).
email_marketing_method_detail STRING $.attributes.subscriptions.email.marketing.method_detail Fonte specifica del metodo.
email_marketing_custom_method_detail STRING $.attributes.subscriptions.email.marketing.custom_method_detail Dettagli personalizzati per il metodo di consenso.
email_marketing_double_optin BOOLEANO $.attributes.subscriptions.email.marketing.double_optin Se il double opt-in è stato completato.
sms_marketing_can_receive_sms_marketing BOOLEANO $.attributes.subscriptions.sms.marketing.can_receive_sms_marketing Indica se il profilo può ricevere SMS di marketing.
sms_marketing_consent STRING $.attributes.subscriptions.sms.marketing.consent Stato del consenso per gli SMS.
sms_marketing_consent_timestamp TIMESTAMP $.attributes.subscriptions.sms.marketing.consent_timestamp Quando è stato dato il consenso per gli SMS.
sms_marketing_last_updated TIMESTAMP $.attributes.subscriptions.sms.marketing.last_updated Data e ora dell'ultimo aggiornamento del consenso per gli SMS.
sms_marketing_method STRING $.attributes.subscriptions.sms.marketing.method Metodo di consenso per gli SMS.
sms_marketing_method_detail STRING $.attributes.subscriptions.sms.marketing.method_detail Dettagli del metodo di consenso via SMS.
sms_transactional_can_receive_sms_transactional BOOLEANO $.attributes.subscriptions.sms.transactional.can_receive_sms_transactional Indica se il profilo può ricevere SMS transazionali.
sms_transactional_consent STRING $.attributes.subscriptions.sms.transactional.consent Stato del consenso agli SMS transazionali.
sms_transactional_consent_timestamp TIMESTAMP $.attributes.subscriptions.sms.transactional.consent_timestamp Quando è stato fornito il consenso transazionale.
sms_transactional_last_updated TIMESTAMP $.attributes.subscriptions.sms.transactional.last_updated Data e ora dell'ultimo aggiornamento dello stato della transazione.
sms_transactional_method STRING $.attributes.subscriptions.sms.transactional.method Metodo SMS transazionale.
sms_transactional_method_detail STRING $.attributes.subscriptions.sms.transactional.method_detail Dettagli del metodo SMS transazionale.
mobile_push_can_receive_push_marketing BOOLEANO $.attributes.subscriptions.mobile_push.marketing.can_receive_push_marketing Indica se il profilo può ricevere comunicazioni di marketing push.
mobile_push_consent STRING $.attributes.subscriptions.mobile_push.marketing.consent Invia lo stato del consenso.
mobile_push_consent_timestamp TIMESTAMP $.attributes.subscriptions.mobile_push.marketing.consent_timestamp Quando è stato dato il consenso alle notifiche push.
predictive_analytics_historic_number_of_orders FLOAT $.attributes.predictive_analytics.historic_number_of_orders Ordini storici totali.
predictive_analytics_predicted_number_of_orders FLOAT $.attributes.predictive_analytics.predicted_number_of_orders Ordini futuri previsti.
predictive_analytics_average_days_between_orders FLOAT $.attributes.predictive_analytics.average_days_between_orders Numero medio di giorni tra gli ordini.
predictive_analytics_average_order_value FLOAT $.attributes.predictive_analytics.average_order_value Valore medio storico dell'ordine.
predictive_analytics_historic_clv FLOAT $.attributes.predictive_analytics.historic_clv Lifetime value cliente storico.
predictive_analytics_predicted_clv FLOAT $.attributes.predictive_analytics.predicted_clv Customer lifetime value previsto.
predictive_analytics_total_clv FLOAT $.attributes.predictive_analytics.total_clv CLV storico + previsto.
predictive_analytics_churn_probability FLOAT $.attributes.predictive_analytics.churn_probability Probabilità di abbandono (0-1).
predictive_analytics_expected_date_of_next_order TIMESTAMP $.attributes.predictive_analytics.expected_date_of_next_order Data prevista per il prossimo ordine.
email_marketing_suppression_reason JSON RIPETUTO $.attributes.subscriptions.email.marketing.suppression[*] Motivi della soppressione delle email (ad es. rimbalzo).
email_marketing_list_suppressions_reason JSON RIPETUTO $.attributes.subscriptions.email.marketing.list_suppressions[*] Motivi di soppressione specifici per l'elenco.
push_tokens_ids REPEATED STRING $.relationships.push-tokens.data[*].id ID token di push associati.

Recensioni

Recensioni prodotto inviate dai clienti.

  • Nome tabella: Reviews
  • Endpoint: /reviews
  • Riferimento API Klaviyo: Get Reviews
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre review).
id STRING $.id Identificatore univoco della recensione.
email STRING $.attributes.email Email del revisore.
value STRING $.attributes.status.value Valore dello stato (ad es. pubblicato, rifiutato).
reason STRING $.attributes.status.rejection_reason.reason Motivo del rifiuto, se applicabile.
status_explanation STRING $.attributes.status.rejection_reason.status_explanation Spiegazione dettagliata dello stato.
verified BOOLEANO $.attributes.verified Indica se l'acquisto è stato verificato.
review_type STRING $.attributes.review_type Tipo di recensione (ad es. recensione prodotto).
created TIMESTAMP $.attributes.created Timestamp della creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultima modifica.
images REPEATED STRING $.attributes.images[*] URL delle immagini allegate alla recensione.
product_url STRING $.attributes.product.url URL del prodotto recensito.
product_name STRING $.attributes.product.name Nome del prodotto.
product_image_url STRING $.attributes.product.image_url URL dell'immagine del prodotto.
product_external_id STRING $.attributes.product.external_id ID esterno del prodotto.
rating INTEGER $.attributes.rating Punteggio di valutazione.
author STRING $.attributes.author Nome del recensore.
content STRING $.attributes.content Contenuto di testo della recensione.
title STRING $.attributes.title Il titolo della recensione.
smart_quote STRING $.attributes.smart_quote Citazione evidenziata della recensione.
public_reply_content STRING $.attributes.public_reply.content Contenuto della risposta pubblica del commerciante.
public_reply_author STRING $.attributes.public_reply.author Autore della risposta.
public_reply_updated STRING $.attributes.public_reply.updated Timestamp dell'aggiornamento della risposta.
event_ids REPEATED STRING $.relationships.events.data[*].id ID evento associati.

Segmenti

Gruppi dinamici di profili in base a criteri specifici.

  • Nome tabella: Segmenti
  • Endpoint: /segments
  • Riferimento API Klaviyo: Get Segments
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre segment).
id STRING $.id Identificatore univoco del segmento.
name STRING $.attributes.name Nome segmento.
created TIMESTAMP $.attributes.created Timestamp della creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultima modifica.
is_active BOOLEANO $.attributes.is_active Indica se il segmento è attivo.
is_processing BOOLEANO $.attributes.is_processing Indica se il segmento è in fase di elaborazione.
is_starred BOOLEANO $.attributes.is_starred Indica se il segmento è stato aggiunto a Speciali/Preferiti.
tag_ids REPEATED STRING $.relationships.tags.data[*].id ID dei tag associati.
flow_triggers_ids REPEATED STRING $.relationships.flow-triggers.data[*].id ID dei flussi attivati da questo segmento.
condition_groups REPEATED ConditionGroup $.attributes.definition.condition_groups[*] Gruppi di condizioni logiche che definiscono il segmento.

ConditionGroup

Nome campo Tipo Percorso JSON Descrizione
conditions Condizione REPEATED conditions[*] Elenco delle singole condizioni all'interno del gruppo.

Condizione

Nome campo Tipo Percorso JSON Descrizione
type STRING type Tipo di condizione (ad es. profile-property).
value JSON N/A Valore/configurazione della condizione.

Tag

Tag utilizzati per organizzare campagne, flussi ed elenchi.

  • Nome della tabella: Tags
  • Endpoint: /tags
  • Riferimento API Klaviyo: Get Tags
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre tag).
id STRING $.id Identificatore univoco del tag.
name STRING $.attributes.name Nome del tag.
tag_group_id STRING $.relationships.tag-group.data.id ID del gruppo di tag a cui appartiene questo tag.

Modelli

Modelli di email e messaggi.

  • Nome tabella: Modelli
  • Endpoint: /templates
  • Riferimento API Klaviyo: Get Templates
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre template).
id STRING $.id Identificatore univoco.
name STRING $.attributes.name Nome del modello.
editor_type STRING $.attributes.editor_type Editor utilizzato (ad es. trascinamento).
html STRING $.attributes.html Contenuti HTML
text STRING $.attributes.text Versione di testo del modello.
amp STRING $.attributes.amp Versione AMP del modello.
created TIMESTAMP $.attributes.created Timestamp della creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultimo aggiornamento.

WebFeeds

Feed web utilizzati per compilare i contenuti dei messaggi.

  • Nome della tabella: WebFeeds
  • Endpoint: /web-feeds
  • Riferimento API Klaviyo: Get Web Feeds
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre web-feed).
id STRING $.id Identificatore univoco.
name STRING $.attributes.name Nome del feed.
url STRING $.attributes.url URL dell'origine del feed.
request_method STRING $.attributes.request_method Metodo HTTP (GET/POST).
content_type STRING $.attributes.content_type Tipo di contenuti (ad es. JSON).
status STRING $.attributes.status Stato del feed.
created TIMESTAMP $.attributes.created Timestamp della creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultimo aggiornamento.

DataSources

Origini dei dati integrate in Klaviyo.

  • Nome della tabella: DataSources
  • Endpoint: /data-sources
  • Riferimento API Klaviyo: Get Data Sources
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre data-source).
id STRING $.id Identificatore univoco.
title STRING $.attributes.title Titolo dell'origine dati.
visibility STRING $.attributes.visibility Livello di visibilità.
description STRING $.attributes.description Testo della descrizione.

Campagne

Campagne di marketing inviate a elenchi o segmenti.

  • Nome tabella: Campagne
  • Endpoint: /campaigns
  • Riferimento API Klaviyo: Get Campaigns
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre campaign).
id STRING $.id Identificatore univoco.
name STRING $.attributes.name Nome della campagna.
status STRING $.attributes.status Stato della campagna (ad es. Inviata, Programmazione).
archived BOOLEANO $.attributes.archived Indica se la campagna è archiviata.
included REPEATED STRING $.attributes.audiences.included ID degli elenchi/segmenti inclusi.
excluded REPEATED STRING $.attributes.audiences.excluded ID degli elenchi/segmenti esclusi.
send_options JSON $.attributes.send_options Configurazione per l'invio (ad es. invio smart).
tracking_options JSON $.attributes.tracking_options Configurazione per il monitoraggio (ad es. parametri utm).
send_strategy JSON $.attributes.send_strategy Strategia per i tempi di consegna.
created_at TIMESTAMP $.attributes.created_at Timestamp della creazione.
scheduled_at TIMESTAMP $.attributes.scheduled_at Quando è pianificato l'invio della campagna.
updated_at TIMESTAMP $.attributes.updated_at Timestamp dell'ultimo aggiornamento.
send_time TIMESTAMP $.attributes.send_time Ora effettiva di invio.
tag_ids REPEATED STRING $.relationships.tags.data[*].id ID dei tag associati.
campaign_message_ids REPEATED STRING $.relationships.campaign-messages.data[*].id ID dei messaggi contenuti in questa campagna.

CampaignMessages

Singoli messaggi (email/SMS) all'interno di una campagna.

  • Nome tabella: CampaignMessages
  • Endpoint: /campaign-messages
  • Riferimento API Klaviyo: Get Campaign Message
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa (sempre campaign-message).
id STRING $.id Identificatore univoco.
definition JSON $.attributes.definition Contenuto e configurazione del messaggio.
send_times JSON RIPETUTO $.attributes.send_times[*] Orari di invio programmati.
created_at TIMESTAMP $.attributes.created_at Timestamp della creazione.
updated_at TIMESTAMP $.attributes.updated_at Timestamp dell'ultimo aggiornamento.
campaign_id STRING $.relationships.campaign.data.id ID della campagna principale.
template_id STRING $.relationships.template.data.id ID del template utilizzato.
image_id STRING $.relationships.image.data.id ID dell'immagine allegata.

Categorie

Categorie di prodotti del tuo catalogo.

Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa.
id STRING $.id Identificatore univoco.
name STRING $.attributes.name Nome categoria.
external_id STRING $.attributes.external_id ID sistema esterno.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultimo aggiornamento.

Elementi

Singoli prodotti o articoli nel tuo catalogo.

  • Nome tabella: Items
  • Endpoint: /catalog-items
  • Riferimento API Klaviyo: Get Catalog Items
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa.
id STRING $.id Identificatore univoco.
external_id STRING $.attributes.external_id ID sistema esterno.
title STRING $.attributes.title Titolo/nome dell'articolo.
description STRING $.attributes.description Descrizione disponibile.
price FLOAT $.attributes.price Prezzo dell'articolo.
url STRING $.attributes.url URL dell'elemento.
image_full_url STRING $.attributes.image_full_url URL dell'immagine a grandezza originale.
image_thumbnail_url STRING $.attributes.image_thumbnail_url URL dell'immagine in miniatura.
images REPEATED STRING $.attributes.images[*] Elenco di URL di immagini aggiuntive.
custom_metadata JSON $.attributes.custom_metadata Coppie chiave-valore dei metadati personalizzate.
published BOOLEANO $.attributes.published Stato della pubblicazione.
created TIMESTAMP $.attributes.created Timestamp della creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultimo aggiornamento.
variants_ids REPEATED STRING $.relationships.variants.data[*].id ID delle varianti di questo articolo.

Varianti

Varianti specifiche degli articoli del catalogo (ad es. taglie, colori).

Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa.
id STRING $.id Identificatore univoco.
external_id STRING $.attributes.external_id ID sistema esterno.
title STRING $.attributes.title Titolo della variante.
description STRING $.attributes.description Descrizione disponibile.
sku STRING $.attributes.sku Stock Keeping Unit.
inventory_policy FLOAT $.attributes.inventory_policy Policy per la gestione dell'inventario.
inventory_quantity FLOAT $.attributes.inventory_quantity Quantità attuale in stock.
price FLOAT $.attributes.price Prezzo.
url STRING $.attributes.url URL della variante.
image_full_url STRING $.attributes.image_full_url URL immagine completo disponibile (booleano).
image_thumbnail_url STRING $.attributes.image_thumbnail_url URL immagine in miniatura.
images REPEATED STRING $.attributes.images[*] Elenco di immagini.
published BOOLEANO $.attributes.published Stato della pubblicazione.
created TIMESTAMP $.attributes.created Timestamp della creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultimo aggiornamento.

FlowActions

Azioni di flusso associate a un flusso.

  • Nome tabella: FlowActions
  • Endpoint: /flows/{id}/flow-actions
  • Riferimento API Klaviyo: Get Flow Actions
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa. Sempre flow-action.
id STRING $.id Identificatore univoco dell'azione del flusso.
created TIMESTAMP $.attributes.created Timestamp della creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultima modifica.
message_id STRING $.attributes.definition.id ID univoco per la definizione del messaggio di azione.
message_temporary_id STRING $.attributes.definition.temporary_id ID temporaneo assegnato alla definizione del messaggio.
message_type STRING $.attributes.definition.type Tipo di messaggio, ad esempio email, sms.
condition_groups REPEATED ConditionGroup $.attributes.definition.data.action_output_filter.condition_groups[*] Condizioni associate al filtro di output dell'azione del flusso.
next_if_true STRING $.attributes.definition.links.next_if_true ID dell'azione del flusso successiva se la condizione restituisce true.
next_if_false STRING $.attributes.definition.links.next_if_false ID dell'azione del flusso successiva se la condizione restituisce false.

FormVersions

Versioni di un determinato modulo.

  • Nome tabella: FormVersions
  • Endpoint: /forms/{id}/form-versions
  • Riferimento API Klaviyo: Get Form Versions
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa. Sempre form-version.
id STRING $.id Identificatore univoco della versione del modulo.
form_type STRING $.attributes.form_type Tipo di modulo, ad esempio popup, embed, banner.
variation_name STRING $.attributes.variation_name Il nome della variante del modulo.
ab_test JSON $.attributes.ab_test Impostazioni di configurazione e variazione del test A/B.
status STRING $.attributes.status Stato operativo della versione del modulo, ad esempio draft, live.
created_at TIMESTAMP $.attributes.created_at Timestamp della creazione.
updated_at TIMESTAMP $.attributes.updated_at Timestamp dell'ultima modifica.

PushTokens

Token push associati ai profili delle app mobile per le notifiche push.

  • Nome tabella: PushTokens
  • Endpoint: /push-tokens
  • Riferimento API Klaviyo: Get Push Tokens
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa. Sempre push-token.
id STRING $.id Identificatore univoco del token push.
created TIMESTAMP $.attributes.created Timestamp della creazione.
token STRING $.attributes.token Stringa del token di push del dispositivo.
enablement_status STRING $.attributes.enablement_status Stato di attivazione delle notifiche push, ad esempio AUTHORIZED, UNAUTHORIZED.
platform STRING $.attributes.platform Piattaforma mobile, ad esempio ios, android.
vendor STRING $.attributes.vendor Fornitore di servizi del fornitore, ad esempio apns, fcm.
background STRING $.attributes.background Stato di aggiornamento in background per le notifiche push.
recorded_date TIMESTAMP $.attributes.recorded_date Data di registrazione del token push.
metadata JSON $.attributes.metadata Metadati personalizzati del dispositivo o del token push.
profile_id STRING $.relationships.profile.data.id ID del profilo cliente associato a questo token push.

TagGroups

Gruppi di tag utilizzati per organizzare e categorizzare i tag.

  • Nome della tabella: TagGroups
  • Endpoint: /tag-groups
  • Riferimento API Klaviyo: Get Tag Groups
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa. Sempre tag-group.
id STRING $.id Identificatore univoco del gruppo di tag.
name STRING $.attributes.name Il nome del gruppo di tag.
exclusive BOOLEANO $.attributes.exclusive Indica se i tag all'interno di questo gruppo si escludono a vicenda.
default BOOLEANO $.attributes.default Indica se questo è il gruppo di tag predefinito per l'account.

UniversalContent

Blocchi di contenuti universali riutilizzabili per messaggi e modelli.

  • Nome tabella: UniversalContent
  • Endpoint: /template-universal-content
  • Riferimento API Klaviyo: Get Universal Content
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa. Sempre template-universal-content.
id STRING $.id Identificatore univoco del blocco di contenuti universale.
name STRING $.attributes.name Nome del blocco di contenuti universale.
definition_content_type STRING $.attributes.definition.content_type Tipo di contenuti della definizione, ad esempio block, template.
definition_type STRING $.attributes.definition.type Tipo di componente dei contenuti, ad esempio text, button, image.
definition_data JSON $.attributes.definition.data Dati strutturali e payload della definizione dei contenuti.
created TIMESTAMP $.attributes.created Timestamp della creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultima modifica.
screenshot_status STRING $.attributes.screenshot_status Stato della generazione dello screenshot di anteprima, ad esempio completed, pending.
screenshot_url STRING $.attributes.screenshot_url URL pubblico dello screenshot dell'anteprima dei contenuti.

MetricProperties

Proprietà e attributi strutturali definiti per metriche specifiche.

  • Nome della tabella: MetricProperties
  • Endpoint: /metrics/{id}/metric-properties
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa. Sempre metric-property.
id STRING $.id Identificatore univoco della proprietà della metrica.
sample_values JSON $.attributes.sample_values Valori dei dati campionati acquisiti per questa proprietà della metrica.
label STRING $.attributes.label Etichetta leggibile per la proprietà.
property STRING $.attributes.property Nome della chiave della proprietà dell'evento.
inferred_type STRING $.attributes.inferred_type Tipo di dati dedotto da Klaviyo per questa proprietà, ad esempio string, boolean, numeric.
metric_id STRING $.relationships.metric.data.id ID della definizione della metrica principale.

TrackingSettings

Parametri di monitoraggio UTM a livello di account per campagne e flussi.

  • Nome della tabella: TrackingSettings
  • Endpoint: /tracking-settings
  • Riferimento API Klaviyo: Get Tracking Settings
Nome campo Tipo Percorso JSON Descrizione
type STRING $.type Tipo di risorsa. Sempre tracking-setting.
id STRING $.id Identificatore univoco delle impostazioni di monitoraggio.
auto_add_parameters BOOLEANO $.attributes.auto_add_parameters Se i parametri UTM vengono aggiunti automaticamente ai link dei messaggi.
utm_source UtmParameter $.attributes.utm_source Configurazione di _utm_source parameter in flussi e campagne.
utm_medium UtmParameter $.attributes.utm_medium Configurazione di _utm_medium parameter in flussi e campagne.
utm_campaign UtmParameter $.attributes.utm_campaign Configurazione del parametro _utm_campaign in flussi e campagne.
utm_id UtmParameter $.attributes.utm_id Configurazione del parametro _utm_id in flussi e campagne.
utm_term UtmParameter $.attributes.utm_term Configurazione del parametro _utm_term in flussi e campagne.
custom_parameters REPEATED CustomParameter $.attributes.custom_parameters Parametri di monitoraggio personalizzati aggiunti ai link della campagna e del flusso.

UtmParameter

Nome campo Tipo Percorso JSON Descrizione
flow ParameterContext flow Contesto delle impostazioni dei parametri UTM per i flussi.
campaign ParameterContext campaign Contesto delle impostazioni dei parametri UTM per le campagne.

ParameterContext

Nome campo Tipo Percorso JSON Descrizione
type STRING type Tipo di risorsa.
value STRING value Valore del modello di parametro o chiave dell'attributo, ad esempio emailsubject, campaignid.

CustomParameter

Nome campo Tipo Percorso JSON Descrizione
flow ParameterContext flow Contesto del parametro di monitoraggio personalizzato per i flussi.
campaign ParameterContext campaign Contesto del parametro di monitoraggio personalizzato per le campagne.
name STRING name Nome del parametro di monitoraggio personalizzato.