Introducción a las transferencias de Klaviyo

Puedes cargar datos de Klaviyo a BigQuery con el Servicio de transferencia de datos de BigQuery para Klaviyo. Con el Servicio de transferencia de datos de BigQuery, puedes programar trabajos de transferencia recurrentes que agreguen tus datos más recientes de Klaviyo a BigQuery.

Para obtener información sobre cómo programar una transferencia de Klaviyo, consulta Cómo cargar datos de Klaviyo en BigQuery.

Limitaciones

Las transferencias incrementales de Klaviyo están sujetas a las siguientes limitaciones:

  • Solo puedes elegir columnas TIMESTAMP como columnas de marca de agua.
  • La transferencia incremental solo se admite para los recursos con columnas de marca de agua válidas.
  • Los valores de una columna de marca de agua deben aumentar de forma monótona.
  • Las transferencias incrementales no pueden sincronizar las operaciones de eliminación en la tabla de origen.
  • Una sola configuración de transferencia solo puede admitir la transferencia incremental o completa.
  • No puedes actualizar objetos en la lista asset después de la primera ejecución de transferencia incremental.
  • No puedes cambiar el modo de escritura en una configuración de transferencia después de la primera ejecución de transferencia incremental.
  • No puedes cambiar la columna de marca de agua ni la clave primaria después de la primera ejecución de transferencia incremental.
  • La tabla de destino de BigQuery se agrupa con la clave primaria proporcionada y está sujeta a las limitaciones de las tablas agrupadas.
  • Cuando actualizas una configuración de transferencia existente al modo de transferencia incremental por primera vez, la primera transferencia de datos después de esa actualización transfiere todos los datos disponibles de tu fuente de datos. Cualquier transferencia de datos incremental posterior transferirá solo las filas nuevas y actualizadas de tu fuente de datos.

Opciones de transferencia de datos

En estas secciones, se describen las opciones de transferencia de datos para configurar una transferencia de datos de Klaviyo.

Transferencias completas o incrementales

Para especificar cómo se cargan los datos en BigQuery, selecciona la preferencia de escritura Completa o Incremental en la configuración de transferencia cuando configures una transferencia de Klaviyo. Las transferencias incrementales se admiten en la vista previa.

Puedes configurar una transferencia de datos completa para transferir todos los datos de tus conjuntos de datos de Klaviyo con cada transferencia de datos.

Como alternativa, puedes configurar una transferencia de datos incremental (vista previa) para transferir solo los datos que se cambiaron desde la última transferencia de datos, en lugar de cargar todo el conjunto de datos con cada transferencia de datos. Si seleccionas Incremental para tu transferencia de datos, debes especificar los modos de escritura Append o Upsert para definir cómo se escriben los datos en BigQuery durante una transferencia de datos incremental. En las siguientes secciones, se describen los modos de escritura disponibles.

Modo de escritura Append

El modo de escritura Append solo inserta filas nuevas en tu tabla de destino. Esta opción agrega estrictamente los datos transferidos sin verificar si existen registros, por lo que este modo puede causar duplicación de datos en la tabla de destino.

Cuando seleccionas el modo Append, debes seleccionar una columna de marca de agua. Se requiere una columna de marca de agua para que el conector de Klaviyo haga un seguimiento de los cambios en la tabla de origen.

Para las transferencias de Klaviyo, te recomendamos que selecciones una columna que solo se actualice cuando se creó el registro y que no cambie con las actualizaciones posteriores, por ejemplo, la columna CREATED_AT.

Modo de escritura Upsert

El modo de escritura Upsert actualiza una fila o inserta una fila nueva en tu tabla de destino verificando una clave primaria. Puedes especificar una clave primaria para permitir que el conector de Klaviyo determine qué cambios son necesarios para mantener actualizada tu tabla de destino con tu tabla de origen. Si la clave primaria especificada está presente en la tabla de destino de BigQuery durante una transferencia de datos, el conector de Klaviyo actualiza esa fila con datos nuevos de la tabla de origen. Si no hay una clave primaria durante una transferencia de datos, el conector de Klaviyo inserta una fila nueva.

Cuando seleccionas el modo Upsert, debes seleccionar una columna de marca de agua y una clave primaria:

  • Se requiere una columna de marca de agua para que el conector de Klaviyo haga un seguimiento de los cambios en la tabla de origen.
    • Selecciona una columna de marca de agua que se actualice cada vez que se modifique una fila. Recomendamos columnas similares a las columnas UPDATED_AT o LAST_MODIFIED.

  • La clave primaria puede ser una o más columnas de tu tabla que son necesarias para que el conector de Klaviyo determine si necesita insertar o actualizar una fila.

    Selecciona columnas que contengan valores no nulos que sean únicos en todas las filas de la tabla. Recomendamos columnas que incluyan identificadores generados por el sistema, códigos de referencia únicos (por ejemplo, IDs de incremento automático) o IDs de secuencia inmutables basados en el tiempo.

    Para evitar la posible pérdida o corrupción de datos, las columnas de clave primaria que selecciones deben tener valores únicos. Si tienes dudas sobre la singularidad de la columna de clave primaria elegida, te recomendamos que uses el modo de escritura Append.

Asignación de tipos de datos

En la siguiente tabla, se asignan los tipos de datos de Klaviyo a los tipos de datos de BigQuery correspondientes:

Tipo de datos de Klaviyo Tipo de datos de BigQuery
String STRING
Text STRING
Integer INTEGER
Boolean BOOLEAN
Date (YYYY-MM-DD HH:MM:SS) TIMESTAMP
List ARRAY

Precios

No se aplican costos por transferir datos de Klaviyo a BigQuery mientras esta función está en vista previa.

¿Qué sigue?