Mailchimp

Plataforma de automação de marketing e serviço de e-mail marketing para gerenciar listas de e-mail e criar campanhas de e-mail marketing oferecido pela Mailchimp®. A Dadosfera replica os dados estatísticos do software e carrega na Dadosfera.

# Funcionalidades

| Funcionalidade                 | Suportado | Notas                                                                                       |
| :----------------------------- | :-------- | :------------------------------------------------------------------------------------------ |
| Definir frequência da pipeline | Sim       | Para mais detalhes, [acesse](https://docs.dadosfera.ai/docs/frequ%C3%AAncia-da-pipeline-1). |
| Sincronização Full load        | Sim       |                                                                                             |
| Conexão via OAuth              | Sim       |                                                                                             |

> 📘 Este conector coleta as seguintes tabelas do mailchimp:
>
> - [lists](https://developer.mailchimp.com/documentation/mailchimp/reference/lists/#read-get_lists)
> - [list_members](https://developer.mailchimp.com/documentation/mailchimp/reference/lists/members/#read-get_lists_list_id_members)
> - [list_segments](https://developer.mailchimp.com/documentation/mailchimp/reference/lists/segments/#read-get_lists_list_id_segments)
> - [list_segment_members](https://developer.mailchimp.com/documentation/mailchimp/reference/lists/segments/members/#read-get_lists_list_id_segments_segment_id_members)
> - [campaigns](https://developer.mailchimp.com/documentation/mailchimp/reference/campaigns/#read-get_campaigns)
> - [reports_email_activity](https://developer.mailchimp.com/documentation/mailchimp/reference/reports/email-activity/#read-get_reports_campaign_id_email_activity)

# Guia rápido

Para iniciar a criação de uma Pipeline, basta ir no módulo **Coletar**, **"Pipelines"** aperte em **"Nova Pipeline"**.

## Escolha a fonte de dados

###### Utilize uma fonte já cadastrada ou cadastre uma nova

## Informações da pipeline

###### Atribua o Nome e uma Breve descrição para sua Pipeline.

## Parâmetros para configurações da pipeline

| Nome do campo  | Descrição                                           | Exemplo    |
| :------------- | :-------------------------------------------------- | :--------- |
| Data de início | Determina quantos dados históricos serão extraídos. | dd/mm/aaaa |

Clique em **"Salvar e Continuar"**.

## Especificar os objetos

Sincronização disponível para cada objeto:

- `lists`
  - Replication strategy: FULL_TABLE
- `list_members`
  - Replication strategy: INCREMENTAL | FULL_TABLE
- `list_segments`
  - Replication strategy: FULL_TABLE
- `list_segment_members`
  - Replication strategy: FULL_TABLE
- `campaigns`
  - Replication strategy: FULL_TABLE
- `reports_email_activity`
  - Replication strategy: INCREMENTAL | FULL_TABLE
- `unsubscribes`
  - Replication strategy: FULL_TABLE
- `automations`
  - Replication strategy: FULL_TABLE

Após inserir as credenciais você estará apto a visualizar e selecionar quais entidades da fonte conectada serão importados na coleta de dados e as colunas que serão importadas.

Além disso, pode definir o modo de sincronização por objeto.

> 📘
>
> Ao selecionar mais de uma entidade, para cada tabela ou view importada será criado um dataset diferente no catálogo.

## Frequência

- Por último, configure a frequência desejada para que sua pipeline rode. É possível escolher dentre as opções apresentadas ou inserir uma frequência customizada através de uma expressão cron. Para saber mais, [acesse](https://docs.dadosfera.ai/docs/frequ%C3%AAncia-da-pipeline-1).

> 📘
>
> - O fuso horário padrão utilizado na frequência é o UTC.
>
> - Todos os métodos de frequência definem quando as extrações serão iniciadas. Eles não controlam por quanto tempo o trabalho de replicação será executado ou quando os dados estarão efetivamente no destino.

Pronto! Agora basta aguardar a coleta ser feita no horário e dia agendado.

Caso queira executar a pipeline imediatamente, é possível executá-la manualmente em até 30 segundos após a criação da pipeline. Vá em "Pipelines", **"Lista"** e **"Sincronizar Pipeline"**.

Após alguns minutos, sua pipeline estará catalogada na aba de exploração como um Data Asset.

É possível também consultar na lista de pipelines os detalhes da pipeline, como: resumo, lista de entidades e colunas coletadas, histórico de execução e de micro-transformação, em **"Ver pipeline"**.