Carga datos de Klaviyo en BigQuery

Console

1. Ve a la página Transferencia de datos en la Cloud de Confiance consola.

   Ir a Transferencia de datos

2. Haz clic en add Crear transferencia.

3. En la sección Tipo de fuente, en Fuente, elige Klaviyo - Vista previa.

4. En la sección Detalles de fuente de datos, haz lo siguiente:

   • En Clave de API privada, ingresa tu clave de API privada. Para obtener más información, consulta Requisitos previos de Klaviyo.
   • Opcional: En Fecha de inicio, especifica una fecha de inicio para que los registros nuevos se incluyan en la transferencia de datos. Solo los registros creados en esta fecha o después de ella se incluyen en la transferencia de datos. El valor predeterminado es 3 meses antes de la fecha de ejecución de la transferencia.
   • En Objetos de Klaviyo para transferir, haz clic en Explorar para seleccionar los objetos que se transferirán al conjunto de datos de destino de BigQuery. También puedes ingresar de forma manual los objetos que se incluirán en la transferencia de datos en este campo.

5. En la sección Configuración de destino, en Conjunto de datos, elige el conjunto de datos que creaste para almacenar tus datos.

6. En la sección Nombre de configuración de la transferencia (Transfer config name), en Nombre visible (Display name), ingresa un nombre para la transferencia de datos.

7. En la sección Opciones de programación, haz lo siguiente:

   • En la lista Frecuencia de repetición, selecciona una opción para especificar la frecuencia con la que se ejecuta esta transferencia de datos. Para especificar una frecuencia de repetición personalizada, selecciona Personalizado. Si seleccionas Según demanda, esta transferencia se ejecuta cuando activas la transferencia de forma manual.
   • Si corresponde, selecciona Comenzar ahora o Comenzar a la hora definida y detalla una fecha de inicio y una hora de ejecución.

8. Opcional: En la sección Opciones de notificación, haz lo siguiente:

   • Para habilitar las notificaciones por correo electrónico, haz clic en el botón de activar o desactivar Notificación por correo electrónico. Si habilitas esta opción, el administrador de transferencias recibirá una notificación por correo electrónico cuando falle la ejecución de una transferencia.
   • Si quieres habilitar las notificaciones de ejecución de transferencias de Pub/Sub para esta transferencia, haz clic en el botón de activar Notificaciones de Pub/Sub. Puedes seleccionar el nombre del tema o hacer clic en Crear un tema para crear uno.

9. Haz clic en Guardar.

bq

Ingresa el bq mk comando y suministra la marca de creación de transferencias --transfer_config:

bq mk
    --transfer_config
    --project_id=PROJECT_ID
    --data_source=DATA_SOURCE
    --display_name=NAME
    --target_dataset=DATASET
    --params='PARAMETERS'

Reemplaza lo siguiente:

• PROJECT_ID (opcional): Es el ID del Cloud de Confiance by S3NS proyecto. Si no se proporciona --project_id para especificar un proyecto en particular, se usa el proyecto predeterminado.
• DATA_SOURCE: La fuente de datos: klaviyo.
• NAME: el nombre visible de la configuración de transferencia de datos. El nombre de la transferencia puede ser cualquier valor que te permita identificarla con facilidad si es necesario hacerle modificaciones más tarde.
• DATASET es el conjunto de datos de destino para la configuración de transferencia.

• PARAMETERS son los parámetros de la configuración de transferencia creada en formato JSON. Por ejemplo: --params='{"param":"param_value"}'. Los siguientes son los parámetros para una transferencia de datos de Klaviyo:

  • assets: la ruta de acceso a los objetos de Klaviyo que se transferirán a BigQuery.
  • connector.authentication.privateApiKey: la clave de API privada para la cuenta de Klaviyo.
  • connector.startDate: (Opcional) una fecha de inicio para que los registros nuevos se incluyan en la transferencia de datos, en el formato YYYY-MM-DD. Solo los registros creados en esta fecha o después de ella se incluyen en la transferencia de datos. El valor predeterminado es 3 meses antes de la fecha de ejecución de la transferencia.

El siguiente comando crea una transferencia de datos de Klaviyo en el proyecto predeterminado.

    bq mk
        --transfer_config
        --target_dataset=mydataset
        --data_source=klaviyo
        --display_name='My Transfer'
        --params= ' {
            "assets": [ "Events" , "Flows"] ,
            "connector.authentication.privateApiKey" : "pk_123456789123",
            "connector.startDate": "2025-10-20"
            }'