Referencia del modelo de datos de Klaviyo

En esta página, se enumeran los datos que se transfieren a BigQuery cuando ejecutas una transferencia de datos de Klaviyo. Los datos se organizan en tablas que enumeran cada nombre de campo, su tipo de datos de destino asociado y la ruta de acceso JSON desde los datos de origen.

Cuentas

Información y metadatos de la cuenta de Klaviyo

• Nombre de la tabla: Accounts
• Endpoint: /accounts
• Referencia de la API de Klaviyo: Get Accounts

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre account)
id	STRING	$.id	Es el identificador único de la cuenta.
test_account	STRING	$.attributes.test_account	Indica si se trata de una cuenta de prueba.
default_sender_name	STRING	$.attributes.contact_information.default_sender_name	Nombre predeterminado que se usa como remitente de los correos electrónicos.
default_sender_email	STRING	$.attributes.contact_information.default_sender_email	Es la dirección de correo electrónico predeterminada que se usa como remitente.
website_url	STRING	$.attributes.contact_information.website_url	Es la URL del sitio web de la organización.
organization_name	STRING	$.attributes.contact_information.organization_name	Nombre de la organización.
address1	STRING	$.attributes.contact_information.street_address.address1	Línea 1 de la dirección
address2	STRING	$.attributes.contact_information.street_address.address2	Línea 2 de la dirección
city	STRING	$.attributes.contact_information.street_address.city	Ciudad de la organización.
region	STRING	$.attributes.contact_information.street_address.region	Estado, provincia o región
country	STRING	$.attributes.contact_information.street_address.country	País.
zip	STRING	$.attributes.contact_information.street_address.zip	Código postal
industry	STRING	$.attributes.industry	Es la vertical de la industria de la cuenta.
timezone	STRING	$.attributes.timezone	Es el parámetro de configuración de zona horaria de la cuenta.
preferred_currency	STRING	$.attributes.preferred_currency	Es la moneda principal que usa la cuenta.
public_api_key	STRING	$.attributes.public_api_key	Es la clave de API pública (ID del sitio) para las integraciones del cliente.
locale	STRING	$.attributes.locale	Parámetro de configuración regional (p. ej., en-US)

Cupones

Cupones para descuentos y promociones

• Nombre de la tabla: Coupons
• Endpoint: /coupons
• Referencia de la API de Klaviyo: Get Coupons

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre coupon)
id	STRING	$.id	Es el identificador interno único del cupón.
external_id	STRING	$.attributes.external_id	Es el identificador externo (a menudo, el mismo que el nombre o el ID).
description	STRING	$.attributes.description	Es la descripción de la oferta del cupón.
low_balance_threshold	STRING	$.attributes.monitor_configuration.low_balance_threshold	Es el umbral para activar las alertas de saldo bajo.

CouponCode

Códigos únicos individuales generados para cupones específicos.

• Nombre de la tabla: CouponCode
• Endpoint: /coupon-codes
• Referencia de la API de Klaviyo: Get Coupon Codes

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre coupon-code)
id	STRING	$.id	Es el identificador único de esta instancia de código específica.
unique_code	STRING	$.attributes.unique_code	Es la cadena de código alfanumérico real.
expires_at	TIMESTAMP	$.attributes.expires_at	Es la marca de tiempo en la que vence este código.
status	STRING	$.attributes.status	Estado del código (p.ej., ASSIGNED, UNASSIGNED).
coupon_id	STRING	$.relationships.coupon.data.id	Es el ID de la definición del cupón principal.

Eventos

Eventos de actividad registrados para los perfiles (p.ej., Pedido realizado, Producto visto).

• Nombre de la tabla: Events
• Endpoint: /events
• Referencia de la API de Klaviyo: Get Events

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre event)
id	STRING	$.id	Identificador único para el evento.
timestamp	FLOAT	$.attributes.timestamp	Es la marca de tiempo de Unix que indica cuándo ocurrió el evento.
event_properties	JSON	$.attributes.event_properties	Son propiedades JSON personalizadas específicas del tipo de evento (p.ej., artículos en el pedido).
datetime	TIMESTAMP	$.attributes.datetime	Es la marca de tiempo ISO 8601 del evento.
uuid	STRING	$.attributes.uuid	Es el identificador único universal del evento.
profile_id	STRING	$.relationships.profile.data.id	Es el ID del perfil (cliente) asociado al evento.
metric_id	STRING	$.relationships.metric.data.id	Es el ID de la definición de la métrica (tipo de evento).
attribution_ids	REPEATED STRING	$.relationships.attributions.data[*].id	Son los IDs de los flujos o las campañas atribuidos a este evento.

Flows

Flujos de marketing automatizados que se activan con eventos o condiciones específicos

• Nombre de la tabla: Flows
• Endpoint: /flows
• Referencia de la API de Klaviyo: Get Flows

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre flow)
id	STRING	$.id	Es el identificador único del flujo.
name	STRING	$.attributes.name	Es el nombre del flujo.
status	STRING	$.attributes.status	Estado operativo (p. ej., activo, borrador)
archived	BOOLEAN	$.attributes.archived	Indica si el flujo está archivado.
created	TIMESTAMP	$.attributes.created	Marca de tiempo de creación
updated	TIMESTAMP	$.attributes.updated	Es la marca de tiempo de la última modificación.
trigger_type	STRING	$.attributes.trigger_type	Mecanismo que activa el flujo (p.ej., "Agregado a la lista", "Métrica").
flow_actions_ids	REPEATED STRING	$.relationships.flow-actions.data[*].id	Son los IDs de las acciones (pasos) dentro de este flujo.
tag_ids	REPEATED STRING	$.relationships.tags.data[*].id	Son los IDs de las etiquetas asignadas a este flujo.

Formularios

Formularios de registro para recopilar información de los suscriptores

• Nombre de la tabla: Forms
• Endpoint: /forms
• Referencia de la API de Klaviyo: Get Forms

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre form)
id	STRING	$.id	Es el identificador único del formulario.
name	STRING	$.attributes.name	Nombre del formulario.
status	STRING	$.attributes.status	Estado del formulario (p.ej., activo o borrador).
ab_test	BOOLEAN	$.attributes.ab_test	Indica si el formulario está ejecutando una prueba A/B.
created_at	TIMESTAMP	$.attributes.created_at	Marca de tiempo de creación
updated_at	TIMESTAMP	$.attributes.updated_at	Es la marca de tiempo de la última modificación.

Imágenes

Son las imágenes que se suben a Klaviyo para usarlas en campañas y plantillas.

• Nombre de la tabla: Images
• Endpoint: /images
• Referencia de la API de Klaviyo: Get Images

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre image)
id	STRING	$.id	Es un identificador único.
name	STRING	$.attributes.name	Nombre de archivo o nombre de la imagen.
image_url	STRING	$.attributes.image_url	Es la URL pública para acceder a la imagen.
format	STRING	$.attributes.format	Formato de archivo de imagen (p. ej., jpeg, png)
size	FLOAT	$.attributes.size	Tamaño del archivo en bytes.
hidden	BOOLEAN	$.attributes.hidden	Indica si la imagen está oculta en la IU.
updated_at	TIMESTAMP	$.attributes.updated_at	Es la marca de tiempo de la última modificación.

Listas

Listas estáticas de contactos o perfiles

• Nombre de la tabla: Lists
• Endpoint: /lists
• Referencia de la API de Klaviyo: Get Lists

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre list)
id	STRING	$.id	Es el identificador único de la lista.
name	STRING	$.attributes.name	Es el nombre de la lista de contactos.
created	TIMESTAMP	$.attributes.created	Marca de tiempo de creación
updated	TIMESTAMP	$.attributes.updated	Es la marca de tiempo de la última modificación.
opt_in_process	STRING	$.attributes.opt_in_process	Parámetro de configuración de aceptación (p.ej., "single_opt_in" o "double_opt_in").
tag_ids	REPEATED STRING	$.relationships.tags.data[*].id	Son los IDs de las etiquetas asignadas a esta lista.
flow_triggers_ids	REPEATED STRING	$.relationships.flow-triggers.data[*].id	Son los IDs de los flujos que se activan cuando se agregan perfiles a esta lista.

Métricas

Tipos de eventos de los que se puede hacer un seguimiento (p.ej., "Received Email").

• Nombre de la tabla: Metrics
• Endpoint: /metrics
• Referencia de la API de Klaviyo: Get Metrics

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre metric)
id	STRING	$.id	Identificador único (p.ej., Código de 6 caracteres para UUID genérico y largo para la personalización.
name	STRING	$.attributes.name	Nombre legible por humanos (p.ej., "Pedido realizado").
created	TIMESTAMP	$.attributes.created	Marca de tiempo de creación
updated	TIMESTAMP	$.attributes.updated	Es la marca de tiempo de la última modificación.
integration	JSON	$.attributes.integration	Es información sobre la integración que proporciona esta métrica (p.ej., nombre, categoría, imagen).
flow_triggers_ids	REPEATED STRING	$.relationships.flow-triggers.data[*].id	Son los IDs de los flujos activados por esta métrica.

Perfiles

Perfiles integrales de los clientes que contienen atributos y el historial de actividad

• Nombre de la tabla: Profiles
• Endpoint: /profiles
• Referencia de la API de Klaviyo: Get Profiles

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre profile)
id	STRING	$.id	Es el ID único de Klaviyo para el perfil.
email	STRING	$.attributes.email	Dirección de correo electrónico principal.
phone_number	STRING	$.attributes.phone_number	Número de teléfono en formato E.164.
external_id	STRING	$.attributes.external_id	Es el ID de un sistema externo.
first_name	STRING	$.attributes.first_name	Nombre.
last_name	STRING	$.attributes.last_name	Apellido.
organization	STRING	$.attributes.organization	Nombre de la empresa o la organización
locale	STRING	$.attributes.locale	Parámetro de configuración de idioma o configuración regional
title	STRING	$.attributes.title	Es el cargo.
image	STRING	$.attributes.image	Es la URL de la imagen de perfil.
created	TIMESTAMP	$.attributes.created	Es la marca de tiempo de creación del perfil.
updated	TIMESTAMP	$.attributes.updated	Es la marca de tiempo de la última actualización.
last_event_date	TIMESTAMP	$.attributes.last_event_date	Es la marca de tiempo del evento más reciente.
address1	STRING	$.attributes.location.address1	Línea 1 de la dirección.
address2	STRING	$.attributes.location.address2	Línea de dirección 2.
city	STRING	$.attributes.location.city	Ciudad.
country	STRING	$.attributes.location.country	País.
latitude	STRING	$.attributes.location.latitude	Son las coordenadas de latitud.
longitude	STRING	$.attributes.location.longitude	Son las coordenadas de longitud.
region	STRING	$.attributes.location.region	Estado o región
zip	STRING	$.attributes.location.zip	Código postal
timezone	STRING	$.attributes.location.timezone	Zona horaria.
ip	STRING	$.attributes.location.ip	una dirección IP externa.
properties	JSON	$.attributes.properties	Son pares clave-valor de propiedades personalizadas.
email_marketing_can_receive_email_marketing	BOOLEAN	$.attributes.subscriptions.email.marketing.can_receive_email_marketing	Indica si el perfil puede recibir marketing por correo electrónico.
email_marketing_consent	STRING	$.attributes.subscriptions.email.marketing.consent	Estado del consentimiento (p.ej., SUBSCRIBED, UNSUBSCRIBED).
email_marketing_consent_timestamp	TIMESTAMP	$.attributes.subscriptions.email.marketing.consent_timestamp	Cuándo se otorgó el consentimiento.
email_marketing_last_updated	TIMESTAMP	$.attributes.subscriptions.email.marketing.last_updated	Cuándo se actualizó por última vez el consentimiento por correo electrónico.
email_marketing_method	STRING	$.attributes.subscriptions.email.marketing.method	Método de consentimiento (p.ej., FORM).
email_marketing_method_detail	STRING	$.attributes.subscriptions.email.marketing.method_detail	Es la fuente específica del método.
email_marketing_custom_method_detail	STRING	$.attributes.subscriptions.email.marketing.custom_method_detail	Son los detalles personalizados del método de consentimiento.
email_marketing_double_optin	BOOLEAN	$.attributes.subscriptions.email.marketing.double_optin	Indica si se completó la doble verificación.
sms_marketing_can_receive_sms_marketing	BOOLEAN	$.attributes.subscriptions.sms.marketing.can_receive_sms_marketing	Indica si el perfil puede recibir marketing por SMS.
sms_marketing_consent	STRING	$.attributes.subscriptions.sms.marketing.consent	Es el estado de consentimiento para recibir SMS.
sms_marketing_consent_timestamp	TIMESTAMP	$.attributes.subscriptions.sms.marketing.consent_timestamp	Fecha y hora en que se otorgó el consentimiento para recibir SMS.
sms_marketing_last_updated	TIMESTAMP	$.attributes.subscriptions.sms.marketing.last_updated	Cuándo se actualizó por última vez el consentimiento para recibir SMS.
sms_marketing_method	STRING	$.attributes.subscriptions.sms.marketing.method	Es el método de consentimiento de SMS.
sms_marketing_method_detail	STRING	$.attributes.subscriptions.sms.marketing.method_detail	Son los detalles del método de consentimiento por SMS.
sms_transactional_can_receive_sms_transactional	BOOLEAN	$.attributes.subscriptions.sms.transactional.can_receive_sms_transactional	Indica si el perfil puede recibir SMS transaccionales.
sms_transactional_consent	STRING	$.attributes.subscriptions.sms.transactional.consent	Es el estado de consentimiento para recibir SMS transaccionales.
sms_transactional_consent_timestamp	TIMESTAMP	$.attributes.subscriptions.sms.transactional.consent_timestamp	Fecha y hora en que se otorgó el consentimiento para la transacción.
sms_transactional_last_updated	TIMESTAMP	$.attributes.subscriptions.sms.transactional.last_updated	Cuándo se actualizó el estado transaccional por última vez.
sms_transactional_method	STRING	$.attributes.subscriptions.sms.transactional.method	Es el método de SMS transaccional.
sms_transactional_method_detail	STRING	$.attributes.subscriptions.sms.transactional.method_detail	Es el detalle del método de SMS transaccional.
mobile_push_can_receive_push_marketing	BOOLEAN	$.attributes.subscriptions.mobile_push.marketing.can_receive_push_marketing	Indica si el perfil puede recibir notificaciones push de marketing.
mobile_push_consent	STRING	$.attributes.subscriptions.mobile_push.marketing.consent	Es el estado de consentimiento push.
mobile_push_consent_timestamp	TIMESTAMP	$.attributes.subscriptions.mobile_push.marketing.consent_timestamp	Fecha y hora en que se otorgó el consentimiento para recibir notificaciones push.
predictive_analytics_historic_number_of_orders	FLOAT	$.attributes.predictive_analytics.historic_number_of_orders	Es la cantidad total de pedidos históricos.
predictive_analytics_predicted_number_of_orders	FLOAT	$.attributes.predictive_analytics.predicted_number_of_orders	Pedidos futuros previstos
predictive_analytics_average_days_between_orders	FLOAT	$.attributes.predictive_analytics.average_days_between_orders	Promedio de días entre pedidos.
predictive_analytics_average_order_value	FLOAT	$.attributes.predictive_analytics.average_order_value	Es el valor promedio histórico del pedido.
predictive_analytics_historic_clv	FLOAT	$.attributes.predictive_analytics.historic_clv	Es el valor histórico del ciclo de vida del cliente.
predictive_analytics_predicted_clv	FLOAT	$.attributes.predictive_analytics.predicted_clv	Es el valor previsto del ciclo de vida del cliente.
predictive_analytics_total_clv	FLOAT	$.attributes.predictive_analytics.total_clv	CLV histórico y previsto
predictive_analytics_churn_probability	FLOAT	$.attributes.predictive_analytics.churn_probability	Probabilidad de deserción (de 0 a 1).
predictive_analytics_expected_date_of_next_order	TIMESTAMP	$.attributes.predictive_analytics.expected_date_of_next_order	Fecha prevista del próximo pedido.
email_marketing_suppression_reason	JSON REPETIDO	$.attributes.subscriptions.email.marketing.suppression[*]	Son los motivos por los que se suprimió el correo electrónico (p.ej., se rechazó).
email_marketing_list_suppressions_reason	JSON REPETIDO	$.attributes.subscriptions.email.marketing.list_suppressions[*]	Son los motivos de la exclusión específicos de la lista.
push_tokens_ids	REPEATED STRING	$.relationships.push-tokens.data[*].id	Son los IDs de los tokens de envío asociados.

Opiniones

Opiniones sobre productos enviadas por los clientes

• Nombre de la tabla: Reviews
• Endpoint: /reviews
• Referencia de la API de Klaviyo: Get Reviews

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre review)
id	STRING	$.id	Es el identificador único de la opinión.
email	STRING	$.attributes.email	Correo electrónico del revisor.
value	STRING	$.attributes.status.value	Valor del estado (p. ej., publicado, rechazado)
reason	STRING	$.attributes.status.rejection_reason.reason	Motivo del rechazo, si corresponde
status_explanation	STRING	$.attributes.status.rejection_reason.status_explanation	Explicación detallada del estado.
verified	BOOLEAN	$.attributes.verified	Indica si se verificó la compra.
review_type	STRING	$.attributes.review_type	Tipo de opinión (p.ej., opinión sobre el producto).
created	TIMESTAMP	$.attributes.created	Marca de tiempo de creación
updated	TIMESTAMP	$.attributes.updated	Es la marca de tiempo de la última modificación.
images	REPEATED STRING	$.attributes.images[*]	Son las URLs de las imágenes adjuntas a la opinión.
product_url	STRING	$.attributes.product.url	Es la URL del producto sobre el que se escribió la opinión.
product_name	STRING	$.attributes.product.name	Es el nombre del producto.
product_image_url	STRING	$.attributes.product.image_url	Es la URL de la imagen del producto.
product_external_id	STRING	$.attributes.product.external_id	Es el ID externo del producto.
rating	INTEGER	$.attributes.rating	Puntuación de la clasificación.
author	STRING	$.attributes.author	Nombre del usuario que dejó la opinión.
content	STRING	$.attributes.content	Es el contenido de texto de la opinión.
title	STRING	$.attributes.title	Es el título de la opinión.
smart_quote	STRING	$.attributes.smart_quote	Es la cita destacada de la opinión.
public_reply_content	STRING	$.attributes.public_reply.content	Es el contenido de la respuesta pública del comercio.
public_reply_author	STRING	$.attributes.public_reply.author	Es el autor de la respuesta.
public_reply_updated	STRING	$.attributes.public_reply.updated	Es la marca de tiempo de la actualización de la respuesta.
event_ids	REPEATED STRING	$.relationships.events.data[*].id	Son los IDs de eventos asociados.

Segmentos

Son grupos dinámicos de perfiles basados en criterios específicos.

• Nombre de la tabla: Segments
• Endpoint: /segments
• Referencia de la API de Klaviyo: Get Segments

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre segment)
id	STRING	$.id	Es el identificador único del segmento.
name	STRING	$.attributes.name	Nombre del segmento.
created	TIMESTAMP	$.attributes.created	Marca de tiempo de creación
updated	TIMESTAMP	$.attributes.updated	Es la marca de tiempo de la última modificación.
is_active	BOOLEAN	$.attributes.is_active	Indica si el segmento está activo.
is_processing	BOOLEAN	$.attributes.is_processing	Indica si se está procesando el segmento.
is_starred	BOOLEAN	$.attributes.is_starred	Indica si el segmento se destacó o se agregó a favoritos.
tag_ids	REPEATED STRING	$.relationships.tags.data[*].id	Son los IDs de las etiquetas asociadas.
flow_triggers_ids	REPEATED STRING	$.relationships.flow-triggers.data[*].id	Son los IDs de los flujos activados por este segmento.
condition_groups	REPEATED RECORD	$.attributes.definition.condition_groups[*]	Son grupos de condiciones lógicas que definen el segmento.

ConditionGroup

Nombre del campo	Tipo	Ruta de JSON	Descripción
conditions	Condición REPEATED	conditions[*]	Es la lista de condiciones individuales dentro del grupo.

Condición

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	type	Es el tipo de condición (p.ej., propiedad del perfil).
value	JSON	N/A	Valor o configuración de la condición.

Etiquetas

Son las etiquetas que se usan para organizar campañas, flujos y listas.

• Nombre de la tabla: Tags
• Endpoint: /tags
• Referencia de la API de Klaviyo: Get Tags

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre tag)
id	STRING	$.id	Es el identificador único de la etiqueta.
name	STRING	$.attributes.name	Nombre de la etiqueta.
tag_group_id	STRING	$.relationships.tag-group.data.id	Es el ID del grupo de etiquetas al que pertenece esta etiqueta.

Plantillas

Plantillas de correos electrónicos y mensajes

• Nombre de la tabla: Templates
• Endpoint: /templates
• Referencia de la API de Klaviyo: Get Templates

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre template)
id	STRING	$.id	Es un identificador único.
name	STRING	$.attributes.name	Nombre de la plantilla
editor_type	STRING	$.attributes.editor_type	Editor utilizado (p.ej., arrastrar y soltar).
html	STRING	$.attributes.html	Contenido HTML
text	STRING	$.attributes.text	Es la versión de texto de la plantilla.
amp	STRING	$.attributes.amp	Es la versión de AMP de la plantilla.
created	TIMESTAMP	$.attributes.created	Marca de tiempo de creación
updated	TIMESTAMP	$.attributes.updated	Es la marca de tiempo de la última actualización.

WebFeeds

Feeds web que se usan para propagar contenido en los mensajes.

• Nombre de la tabla: WebFeeds
• Endpoint: /web-feeds
• Referencia de la API de Klaviyo: Get Web Feeds

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre web-feed)
id	STRING	$.id	Es un identificador único.
name	STRING	$.attributes.name	Nombre del feed.
url	STRING	$.attributes.url	Es la URL de la fuente del feed.
request_method	STRING	$.attributes.request_method	Método HTTP (GET/POST).
content_type	STRING	$.attributes.content_type	Tipo de contenido (p.ej., JSON).
status	STRING	$.attributes.status	Es el estado del feed.
created	TIMESTAMP	$.attributes.created	Marca de tiempo de creación
updated	TIMESTAMP	$.attributes.updated	Es la marca de tiempo de la última actualización.

DataSources

Fuentes de datos integradas en Klaviyo.

• Nombre de la tabla: DataSources
• Endpoint: /data-sources
• Referencia de la API de Klaviyo: Get Data Sources

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre data-source)
id	STRING	$.id	Es un identificador único.
title	STRING	$.attributes.title	Es el título de la fuente de datos.
visibility	STRING	$.attributes.visibility	Es el nivel de visibilidad.
description	STRING	$.attributes.description	Es el texto de la descripción.

Campañas

Son las campañas de marketing que se envían a listas o segmentos.

• Nombre de la tabla: Campaigns
• Endpoint: /campaigns
• Referencia de la API de Klaviyo: Get Campaigns

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre campaign)
id	STRING	$.id	Es un identificador único.
name	STRING	$.attributes.name	Nombre de la campaña.
status	STRING	$.attributes.status	Estado de la campaña (p.ej., Enviado, Programando).
archived	BOOLEAN	$.attributes.archived	Indica si la campaña está archivada.
included	REPEATED STRING	$.attributes.audiences.included	Son los IDs de las listas o los segmentos incluidos.
excluded	REPEATED STRING	$.attributes.audiences.excluded	Son los IDs de las listas o los segmentos excluidos.
send_options	JSON	$.attributes.send_options	Es la configuración para el envío (p.ej., envío inteligente).
tracking_options	JSON	$.attributes.tracking_options	Es la configuración para el seguimiento (p.ej., parámetros utm).
send_strategy	JSON	$.attributes.send_strategy	Es la estrategia para el tiempo de entrega.
created_at	TIMESTAMP	$.attributes.created_at	Marca de tiempo de creación
scheduled_at	TIMESTAMP	$.attributes.scheduled_at	Fecha y hora programadas para el envío de la campaña.
updated_at	TIMESTAMP	$.attributes.updated_at	Es la marca de tiempo de la última actualización.
send_time	TIMESTAMP	$.attributes.send_time	Es la fecha y hora reales de envío.
tag_ids	REPEATED STRING	$.relationships.tags.data[*].id	Son los IDs de las etiquetas asociadas.
campaign_message_ids	REPEATED STRING	$.relationships.campaign-messages.data[*].id	Son los IDs de los mensajes incluidos en esta campaña.

CampaignMessages

Son los mensajes individuales (por correo electrónico o SMS) dentro de una campaña.

• Nombre de la tabla: CampaignMessages
• Endpoint: /campaign-messages
• Referencia de la API de Klaviyo: Get Campaign Message

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso (siempre campaign-message)
id	STRING	$.id	Es un identificador único.
definition	JSON	$.attributes.definition	Contenido y configuración del mensaje
send_times	JSON REPETIDO	$.attributes.send_times[*]	Horarios de envío programado
created_at	TIMESTAMP	$.attributes.created_at	Marca de tiempo de creación
updated_at	TIMESTAMP	$.attributes.updated_at	Es la marca de tiempo de la última actualización.
campaign_id	STRING	$.relationships.campaign.data.id	Es el ID de la campaña principal.
template_id	STRING	$.relationships.template.data.id	Es el ID de la plantilla utilizada.
image_id	STRING	$.relationships.image.data.id	ID de la imagen adjunta.

Categorías

Son las categorías de productos de tu catálogo.

• Nombre de la tabla: Categories
• Endpoint: /catalog-categories
• Referencia de la API de Klaviyo: Get Catalog Categories

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso.
id	STRING	$.id	Es un identificador único.
name	STRING	$.attributes.name	Nombre de la categoría.
external_id	STRING	$.attributes.external_id	Es el ID del sistema externo.
updated	TIMESTAMP	$.attributes.updated	Es la marca de tiempo de la última actualización.

Elementos

Son los productos o artículos individuales de tu catálogo.

• Nombre de la tabla: Items
• Endpoint: /catalog-items
• Referencia de la API de Klaviyo: Get Catalog Items

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso.
id	STRING	$.id	Es un identificador único.
external_id	STRING	$.attributes.external_id	Es el ID del sistema externo.
title	STRING	$.attributes.title	Título o nombre del elemento.
description	STRING	$.attributes.description	Descripción disponible.
price	FLOAT	$.attributes.price	Precio del artículo.
url	STRING	$.attributes.url	URL del elemento.
image_full_url	STRING	$.attributes.image_full_url	Es la URL de la imagen en tamaño completo.
image_thumbnail_url	STRING	$.attributes.image_thumbnail_url	Es la URL de la imagen en miniatura.
images	REPEATED STRING	$.attributes.images[*]	Es una lista de URLs de imágenes adicionales.
custom_metadata	JSON	$.attributes.custom_metadata	Pares clave-valor de metadatos personalizados.
published	BOOLEAN	$.attributes.published	Es el estado de publicación.
created	TIMESTAMP	$.attributes.created	Marca de tiempo de creación
updated	TIMESTAMP	$.attributes.updated	Es la marca de tiempo de la última actualización.
variants_ids	REPEATED STRING	$.relationships.variants.data[*].id	Son los IDs de las variantes de este artículo.

Variantes

Son las variantes específicas de los artículos del catálogo (p.ej., tamaños y colores).

• Nombre de la tabla: Variants
• Endpoint: /catalog-variants
• Referencia de la API de Klaviyo: Get Catalog Variants

Nombre del campo	Tipo	Ruta de JSON	Descripción
type	STRING	$.type	Tipo de recurso.
id	STRING	$.id	Es un identificador único.
external_id	STRING	$.attributes.external_id	Es el ID del sistema externo.
title	STRING	$.attributes.title	Es el título de la variante.
description	STRING	$.attributes.description	Descripción disponible.
sku	STRING	$.attributes.sku	Es la unidad de referencia de inventario.
inventory_policy	FLOAT	$.attributes.inventory_policy	Política de administración del inventario
inventory_quantity	FLOAT	$.attributes.inventory_quantity	Cantidad actual en stock.
price	FLOAT	$.attributes.price	Precio
url	STRING	$.attributes.url	Es la URL de la variante.
image_full_url	BOOLEAN	$.attributes.image_full_url	URL completa de la imagen disponible (booleano).
image_thumbnail_url	STRING	$.attributes.image_thumbnail_url	URL de la imagen en miniatura.
images	REPEATED STRING	$.attributes.images[*]	Es la lista de imágenes.
published	BOOLEAN	$.attributes.published	Es el estado de publicación.
created	TIMESTAMP	$.attributes.created	Marca de tiempo de creación
updated	TIMESTAMP	$.attributes.updated	Es la marca de tiempo de la última actualización.