Carregar dados do Mailchimp no BigQuery

É possível carregar dados do Mailchimp para o BigQuery usando o serviço de transferência de dados do BigQuery para o conector do Mailchimp. Com o serviço de transferência de dados do BigQuery, é possível programar jobs de transferência recorrentes que adicionam os dados mais recentes do Mailchimp ao BigQuery. O conector do Mailchimp é compatível com várias contas, incluindo as contas Standard e Express do Mailchimp.

Limitações

• A API de marketing do Mailchimp só aceita no máximo 10 conexões simultâneas por usuário. Exceder esse limite resulta no erro 429: TooManyRequests: You have exceeded the limit of 10 simultaneous connections
  • Para evitar atingir esse limite de taxa, recomendamos executar apenas uma transferência de dados por conta do Mailchimp.
  • Para mais informações, consulte o Glossário de erros.
• O tipo de dados Integer no Mailchimp tem um valor máximo aceito de 2.147.483.647 em todos os objetos.
  • No entanto, alguns campos do Mailchimp aceitam valores mais altos, como o campo Quantity em EcommerceOrderLines e EcommerceCartLines.
• Se o anexo de rede foi criado em um projeto do Google Cloud diferente do projeto do Google Cloud da transferência de dados, é necessário conceder as permissões compute.networkAttachments.get e compute.networkAttachments.update ao agente de serviço que pertence ao projeto do Google Cloud em que a transferência de dados foi criada.

Limitações de campos de matriz

O conector do Mailchimp não é compatível com campos ARRAY nos seguintes objetos do Mailchimp:

Antes de começar

As seções a seguir descrevem os pré-requisitos que você precisa cumprir antes de criar uma transferência de dados do Mailchimp.

Pré-requisitos do Mailchimp

Para ativar as transferências de dados do Mailchimp para o BigQuery, é preciso ter uma chave de API do Mailchimp para autorização e acesso. Para saber como conseguir uma chave de API, consulte Gerar uma chave de API.

Pré-requisitos do BigQuery

• Verifique se você realizou todas as ações necessárias para ativar o serviço de transferência de dados do BigQuery.
• Crie um conjunto de dados do BigQuery para armazenar os dados.

Papéis obrigatórios do BigQuery

Para receber as permissões necessárias para criar uma transferência de dados do serviço de transferência de dados do BigQuery, peça ao administrador para conceder a você o papel do IAM de Administrador do BigQuery (roles/bigquery.admin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para criar uma transferência de dados do serviço de transferência de dados do BigQuery. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para mais informações, consulte Conceder acesso ao bigquery.admin.

Se você pretende configurar notificações de execução de transferência do Pub/Sub, verifique se tem a permissão pubsub.topics.setIamPolicy do IAM. As permissões do Pub/Sub não serão necessárias caso você configure notificações por e-mail. Para saber mais informações, consulte Notificações de execução do serviço de transferência de dados do BigQuery.

Configurar uma transferência de dados do Mailchimp

Adicione dados do Mailchimp ao BigQuery definindo uma configuração de transferência usando uma das seguintes opções:

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

    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"}'

Para executar manualmente uma transferência de dados fora da programação regular, inicie uma execução de preenchimento.

Mapeamento de tipo de dados

A tabela a seguir mapeia os tipos de dados do Mailchimp para os tipos de dados correspondentes do BigQuery:

Preços

Não há custo para transferir dados do Mailchimp para o BigQuery enquanto esse recurso está em Pré-lançamento.

Resolver problemas na configuração da transferência

Se você tiver problemas para configurar a transferência de dados, consulte Problemas de transferência do Mailchimp.

A seguir

• Para uma visão geral do serviço de transferência de dados do BigQuery, consulte O que é o serviço de transferência de dados do BigQuery.
• Para informações sobre o uso de transferências, incluindo ver detalhes sobre uma configuração de transferência, listar configurações de transferência e visualizar o histórico de execução de uma transferência, consulte Gerenciar transferências.