Riferimento al modello dei dati di Klaviyo

Questa pagina elenca i dati trasferiti a BigQuery quando esegui un trasferimento di dati di Klaviyo. I dati sono organizzati in tabelle che elencano il nome di ogni 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 L'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 Lo stato, la provincia o la regione.
country STRING $.attributes.contact_information.street_address.country Paese.
zip STRING $.attributes.contact_information.street_address.zip Codice postale o CAP.
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 Impostazioni internazionali (ad es. en-US).

Coupon

Coupon per sconti e promozioni.

  • Nome tabella: Coupons
  • 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 uguale a 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 tabella: CouponCode
  • Endpoint: /coupon-codes
  • Riferimento API Klaviyo: Get Coupon Codes
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. ASSEGNATE, ASSEGNAZIONE ANNULLATA).
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: Flussi
  • 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 Il nome del flusso.
status STRING $.attributes.status Stato operativo (ad es. live, bozza).
archived BOOLEANO $.attributes.archived Indica se il flusso è archiviato.
created TIMESTAMP $.attributes.created Timestamp creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultima modifica.
trigger_type STRING $.attributes.trigger_type Meccanismo che attiva il flusso (ad es. Aggiunta 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 sugli iscritti.

  • Nome 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 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 del file o dell'immagine.
image_url STRING $.attributes.image_url URL pubblico per accedere all'immagine.
format STRING $.attributes.format Formato del file immagine (ad es. jpeg, png).
size FLOAT $.attributes.size Dimensioni del file in byte.
hidden BOOLEANO $.attributes.hidden 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 creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultima modifica.
opt_in_process STRING $.attributes.opt_in_process Impostazione di attivazione (ad es. "single_opt_in" o "double_opt_in").
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. "Received Email").

  • Nome 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 UUID generico e lungo per UUID personalizzato).
name STRING $.attributes.name Nome leggibile (ad es. Ordine effettuato).
created TIMESTAMP $.attributes.created Timestamp 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 delle attività.

  • Nome tabella: Profiles
  • 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 per il profilo.
email STRING $.attributes.email Indirizzo email principale.
phone_number STRING $.attributes.phone_number Numero di telefono in 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 internazionale/della lingua.
title STRING $.attributes.title Qualifica.
image STRING $.attributes.image URL dell'immagine del profilo.
created TIMESTAMP $.attributes.created Timestamp di 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 Lo stato o la regione.
zip STRING $.attributes.location.zip Codice postale o CAP.
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 Se il profilo può ricevere email di 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 Data in cui è stato fornito il consenso.
email_marketing_last_updated TIMESTAMP $.attributes.subscriptions.email.marketing.last_updated Data dell'ultimo aggiornamento del consenso all'invio di 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 Origine 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 Indica se è stata completata l'attivazione doppia.
sms_marketing_can_receive_sms_marketing BOOLEANO $.attributes.subscriptions.sms.marketing.can_receive_sms_marketing Se il profilo può ricevere SMS di marketing.
sms_marketing_consent STRING $.attributes.subscriptions.sms.marketing.consent Stato del consenso agli SMS.
sms_marketing_consent_timestamp TIMESTAMP $.attributes.subscriptions.sms.marketing.consent_timestamp Quando è stato fornito il consenso per gli SMS.
sms_marketing_last_updated TIMESTAMP $.attributes.subscriptions.sms.marketing.last_updated Data dell'ultimo aggiornamento del consenso per gli SMS.
sms_marketing_method STRING $.attributes.subscriptions.sms.marketing.method Metodo di consenso via 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 Se il profilo può ricevere SMS transazionali.
sms_transactional_consent STRING $.attributes.subscriptions.sms.transactional.consent Stato del consenso per gli 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 transazionale.
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 notifiche push di marketing.
mobile_push_consent STRING $.attributes.subscriptions.mobile_push.marketing.consent Trasferisci lo stato del consenso.
mobile_push_consent_timestamp TIMESTAMP $.attributes.subscriptions.mobile_push.marketing.consent_timestamp Quando è stato fornito 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 Giorni medi 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 Lifetime value cliente 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 del prossimo ordine.
email_marketing_suppression_reason JSON RIPETUTO $.attributes.subscriptions.email.marketing.suppression[*] Motivi della soppressione delle email (ad es. mancata consegna).
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 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 recensore.
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 Se l'acquisto è stato verificato.
review_type STRING $.attributes.review_type Tipo di recensione (ad es. recensione prodotto).
created TIMESTAMP $.attributes.created Timestamp 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 L'URL dell'immagine del prodotto.
product_external_id STRING $.attributes.product.external_id ID esterno del prodotto.
rating INTEGER $.attributes.rating Punteggio della classificazione.
author STRING $.attributes.author Nome del recensore.
content STRING $.attributes.content Il contenuto testuale della recensione.
title STRING $.attributes.title 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 L'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 del segmento.
created TIMESTAMP $.attributes.created Timestamp 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 RECORD $.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. proprietà del profilo).
value JSON N/A Valore/configurazione della condizione.

Tag

Tag utilizzati per organizzare campagne, flussi ed elenchi.

  • Nome 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 L'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. drag and drop).
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 creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultimo aggiornamento.

WebFeeds

Feed web utilizzati per popolare i contenuti nei messaggi.

  • Nome 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 origine 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 creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultimo aggiornamento.

DataSources

Origini dei dati integrate in Klaviyo.

  • Nome 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. Inviato, Pianificazione).
archived BOOLEANO $.attributes.archived 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 intelligente).
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 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 Contenuti e configurazione dei messaggi.
send_times JSON RIPETUTO $.attributes.send_times[*] Orari di invio programmati.
created_at TIMESTAMP $.attributes.created_at Timestamp 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 modello utilizzato.
image_id STRING $.relationships.image.data.id ID dell'immagine allegata.

Categorie

Categorie di prodotto 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 della 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'articolo.
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 degli URL delle immagini aggiuntive.
custom_metadata JSON $.attributes.custom_metadata Coppie chiave-valore di metadati personalizzati.
published BOOLEANO $.attributes.published Stato della pubblicazione.
created TIMESTAMP $.attributes.created Timestamp creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultimo aggiornamento.
variants_ids REPEATED STRING $.relationships.variants.data[*].id ID delle varianti per 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 Norme per la gestione dell'inventario.
inventory_quantity FLOAT $.attributes.inventory_quantity Quantità attuale di scorte.
price FLOAT $.attributes.price Prezzo.
url STRING $.attributes.url URL della variante.
image_full_url BOOLEANO $.attributes.image_full_url URL completo dell'immagine disponibile (booleano).
image_thumbnail_url STRING $.attributes.image_thumbnail_url URL dell'immagine in miniatura.
images REPEATED STRING $.attributes.images[*] Elenco di immagini.
published BOOLEANO $.attributes.published Stato della pubblicazione.
created TIMESTAMP $.attributes.created Timestamp creazione.
updated TIMESTAMP $.attributes.updated Timestamp dell'ultimo aggiornamento.