Carga datos de Mailchimp en BigQuery

Versión preliminar

Esta función está con sujeción a las "Condiciones de las Ofertas de la Fase Previa a la DG" de la sección Términos Generales del Servicio de los Términos Específicos del Servicio. Las funciones de la fase previa a la DG están disponibles sin modificaciones y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Nota: Para obtener asistencia o enviar comentarios sobre esta función, comunícate con [e-mail].

Puedes cargar datos de Mailchimp en BigQuery con el conector del Servicio de transferencia de datos de BigQuery para Mailchimp. Con el Servicio de transferencia de datos de BigQuery, puedes programar trabajos de transferencia recurrentes que agreguen tus datos más recientes de Mailchimp a BigQuery. El conector de Mailchimp admite varias cuentas, incluidas las cuentas de Mailchimp estándar y Express.

Limitaciones

• La API de Marketing de Mailchimp solo admite un máximo de 10 conexiones simultáneas por usuario. Si se supera este límite, se genera el error 429: TooManyRequests: You have exceeded the limit of 10 simultaneous connections.
  • Para evitar alcanzar este límite de frecuencia, te recomendamos que solo ejecutes una transferencia de datos por cuenta de Mailchimp.
  • Para obtener más información, consulta el Glosario de errores.
• El tipo de datos Integer en Mailchimp tiene un valor máximo admitido de 2,147,483,647 en todos los objetos.
  • Sin embargo, algunos campos de Mailchimp admiten valores más altos, como el campo Quantity en EcommerceOrderLines y EcommerceCartLines.

Limitaciones de los campos de matriz

El conector de Mailchimp no admite campos ARRAY en los siguientes objetos de Mailchimp:

Objeto de Mailchimp	Campos ARRAY no admitidos
Campaigns	VariateSettings_SubjectLines VariateSettings_SendTimes VariateSettings_FromNames VariateSettings_ReplyToAddresses VariateSettings_Contents VariateSettings_Combinations
EcommerceCarts	Lines
EcommerceProducts	Variants
ListMembers	TagsAggregate
ListMergeFields	Options_Choices
Lists	Modules
AuthorizedApps	Users
AutomationEmails	Settings_AutoFbPost
CampaignOpenEmailDetails	Opens
EcommerceProductImages	VariantIds
ListSignupForms	Contents, Styles
ReportEmailActivity	Activity
Reports	Timewarp

Antes de comenzar

En las siguientes secciones, se describen los requisitos previos que debes cumplir antes de crear una transferencia de datos de Mailchimp.

Requisitos previos de Mailchimp

Para habilitar las transferencias de datos de Mailchimp a BigQuery, debes tener una clave de API de Mailchimp para la autorización y el acceso. Para obtener información sobre cómo obtener una clave de API, consulta Genera una clave de API.

Requisitos previos de BigQuery

• Verifica si completaste todas las acciones necesarias para habilitar el Servicio de transferencia de datos de BigQuery
• Crea un conjunto de datos de BigQuery para almacenar tus datos.

Roles de BigQuery requeridos

Para obtener los permisos que necesitas para crear una transferencia de datos del Servicio de transferencia de datos de BigQuery, pídele a tu administrador que te otorgue el rol de IAM de administrador de BigQuery (roles/bigquery.admin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para crear una transferencia de datos del Servicio de transferencia de datos de BigQuery. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear una transferencia de datos del Servicio de transferencia de datos de BigQuery:

• Permisos del Servicio de transferencia de datos de BigQuery:
  • bigquery.transfers.update
  • bigquery.transfers.get
• Permisos de BigQuery:
  • bigquery.datasets.get
  • bigquery.datasets.getIamPolicy
  • bigquery.datasets.update
  • bigquery.datasets.setIamPolicy
  • bigquery.jobs.create

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para obtener más información, consulta Cómo otorgar acceso a bigquery.admin.

Si quieres configurar las notificaciones de ejecución de transferencias para Pub/Sub, asegúrate de tener el permiso pubsub.topics.setIamPolicy de IAM. Los permisos de Pub/Sub no son necesarios si solo configuras las notificaciones por correo electrónico. Para obtener más información, consulta la sección sobre notificaciones de ejecución del Servicio de transferencia de datos de BigQuery.

Configura una transferencia de datos de Mailchimp

Para agregar datos de Mailchimp a BigQuery, configura una transferencia con una de las siguientes opciones:

Console

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

   Ir a Transferencias de datos

2. Haz clic en Crear transferencia.

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

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

   • En Clave de API, ingresa tu clave de API de Mailchimp. Para obtener más información, consulta Requisitos previos de Mailchimp.
   • Opcional: En Fecha de inicio, especifica una fecha de inicio para que los registros nuevos se incluyan en la transferencia de datos. Solo se incluyen en la transferencia de datos los registros creados a partir de esta fecha.
     • Ingresa una fecha en el formato YYYY-MM-DD. El valor mínimo es 2001-01-01.
   • En Objetos de Mailchimp 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 cualquier objeto que quieras incluir 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 el nombre de 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 comando bq mk 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): Tu ID del proyecto de Google Cloud . Si no se proporciona --project_id para especificar un proyecto en particular, se usa el proyecto predeterminado.
• DATA_SOURCE: La fuente de datos: mailchimp.
• 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 Mailchimp:

  • assets: Es la ruta de acceso a los objetos de Mailchimp que se transferirán a BigQuery.
  • connector.authentication.apiKey: Es la clave de API de Mailchimp.
  • connector.startDate: (Opcional) Es la fecha de inicio de los registros nuevos que se incluirán en la transferencia de datos, en el formato YYYY-MM-DD. En la transferencia de datos, solo se incluyen los registros creados a partir de esta fecha.

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

    bq mk
        --transfer_config
        --target_dataset=mydataset
        --data_source=mailchimp
        --display_name='My Transfer'
        --params='{"assets": "Lists",
            "connector.authentication.apiKey":"1234567",
            "connector.startDate":"2025-01-01"}'

Cuando guardas la configuración de transferencia, el conector de Mailchimp activa automáticamente una ejecución de transferencia según la opción de programación que elijas. Con cada ejecución de transferencia, el conector de Mailchimp transfiere todos los datos disponibles de Mailchimp a BigQuery.

Para ejecutar manualmente una transferencia de datos fuera de tu programa habitual, puedes iniciar una ejecución de reabastecimiento.

Asignación de tipos de datos

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

Tipo de datos de Mailchimp	Tipo de datos de BigQuery	Descripción
String	STRING
Integer	INT64
Number	BIGNUMERIC	Los objetos de datos de Mailchimp Number se asignan al tipo de datos BIGNUMERIC para los campos relacionados con las finanzas, como Price y OrderTotal, o al tipo de datos FLOAT64 para otros campos, como Stats_OpenRate y Location_Latitude.
Number	FLOAT64
Boolean	BOOLEAN
String en formato de fecha y hora	TIMESTAMP	Los tipos de datos STRING en formato de fecha y hora se representan en formato ISO 8601. Por ejemplo, 2019-08-24T14:15:22Z.

Precios

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

Soluciona problemas con la configuración de una transferencia

Si tienes problemas para configurar tu transferencia de datos, consulta Problemas de transferencia de Mailchimp.

¿Qué sigue?

• Si deseas obtener una descripción general del Servicio de transferencia de datos de BigQuery, consulta ¿Qué es el Servicio de transferencia de datos de BigQuery?.
• Para obtener información sobre el uso de las transferencias (por ejemplo, cómo obtener información sobre una configuración de transferencia, mostrar distintas configuraciones o visualizar su historial de ejecuciones), consulta Manejar transferencias.