Mailchimp

Mailchimp is an email and marketing automation platform for growing businesses.

MailChimp integration replicates data using the MailChimp API 3.0.

See the Schema section for a list of objects available for replication.

Uma visão de alto nível desse conector, incluindo links úteis e recursos compatíveis.

Recurso/Capacidade	Detalhes do suporte
Projetos do Qlik Talend Data Integration compatíveis	Apenas Projetos de replicação. Não há suporte para projetos de pipeline de dados.
Métodos de atualização de destino	Tarefas de replicação: Aplicar alterações Armazenar alterações Aterrisando dados em tarefas de data lake: Captura de dados de alterações (CDC)
Gerenciando metadados	A geração manual de metadados não é necessária.
Evolução do esquema	Somente a operação Alterar tipo de dados da coluna é compatível.
Replicação de colunas LOB (NCLOB, CLOB e BLOB)	Sem suporte.
CDC agendado	Obrigatório. É assim que o destino é mantido atualizado com as alterações na fonte. Para tarefas de replicação, consulte Programando tarefas Para tarefas de aterrisagem no lake, consulte Agendando uma CDC para tarefas de aterrisagem no lake
Notificações	Parcialmente compatível Configurando notificações sobre alterações na operação
Monitoramento	Somente CDC, pois o carregamento total não é relevante para esse conector. Monitorando uma tarefa de dados individual
Desencaixe automático de cargas úteis de colunas JSON	Sem suporte. As cargas úteis da coluna JSON nos conjuntos de dados de origem não são anuladas automaticamente no destino.

Preparing for authentication

To access your data, you need to authenticate the connection with your account credentials.

Certifique-se de que a conta que você usa tenha acesso de leitura às tabelas que deseja buscar.

To obtain your client ID and secret:

Log into your Mailchimp account.
Either:
- Create a new app. The client ID and secret are displayed when the app is created.
  As the client secret is displayed only once, copy and paste it to a secured file.
- Edit an existing app and click Rotate to generate a new client secret.
Make sure Authorized Redirect URIs is set to https://connector.qlik.com/auth/oauth/v3.htm.
Each OAuth app can only have one redirect URI.

Use a unique set of client id and client secret to authenticate each of your connections. Otherwise, your tasks associated with your older connections will fail.

Creating the connection

Para obter mais informações, consulte Conectando-se a aplicativos SAP.

Clique em Autenticar quando tiver preenchido as configurações de conexão necessárias.
Você pode ser solicitado a fazer login no aplicativo de origem.
Uma janela é exibida com um código de autenticação.
Copie o código para a área de transferência e retorne à caixa de diálogo de conexão.
Cole o código em Autenticação completa com o código fornecido pela fonte e clique em Verificar.
Nota de dicaPode ser necessário rolar para baixo para ver este campo.
Quando o status é Verificado, a autenticação é verificada.
Forneça um nome para a conexão em Nome da conexão.
Selecione Abrir metadados de conexão para definir metadados para a conexão quando ela for criada.

Connection settings
Setting	Description
Data gateway	Selecione um Gateway Data Movement se for necessário para seu caso de uso. Nota informativa Esse campo não está disponível com a assinatura do Iniciante do Qlik Talend Cloud, pois esta não é compatível com o Gateway Data Movement. Se você tiver outro nível de assinatura e não quiser usar o Gateway Data Movement, selecione Nenhum. Para obter informações sobre os benefícios do Gateway Data Movement e casos de uso que exigem isso, consulte Qlik Data Gateway - Movimentação de dados.
Start Date	Digite a data, no formato `MM/DD/YYYY`, a partir da qual os dados devem ser replicados da fonte de dados para o destino.
Email Activity Date Window	Enter the number of days for which you need to retrieve the email activity reports. Example: 10. The reports of the last 10 days will be retrieved.
Client ID	Client ID.
Client Secret	Client secret.

Schema

Schemas and naming conventions can change from version to version. It is recommended to verify your version before continuing.

The schema and info displayed below is for version 1.

Depending on your destination, table and column names may not appear as they are outlined below.

automations

The automations table contains summary info about your MailChimp account’s automations. In MailChimp, an automation is a feature that sends a series of emails to subscribers when triggered by a specific date, activity, or event.

Replication Method	Full Table
Primary Key	id
Replication Key	create_time
Useful links	MailChimp API method

Join automations with	on
campaigns	automations.recipients.list_id = campaigns.recipients.list_id
list_members	automations.recipients.list_id = list_members.list_id
list_segment_members	automations.recipients.list_id = list_segment_members.list_id
list_segments	automations.recipients.list_id = list_segments.list_id
lists	automations.recipients.list_id = lists.id
reports_email_activity	automations.recipients.list_id = reports_email_activity.list_id

create_time

DATE-TIME

emails_sent

INTEGER

STRING

recipients

OBJECT

This is a nested data structure:

create_time: DATE-TIME
emails_sent: INTEGER
id: STRING
recipients: OBJECT, which is also a nested data structure.
- list_id: STRING
- list_is_active: BOOLEAN
- list_name: STRING
- segments_opts: OBJECT, which is also a nested structure.
  - conditions: ARRAY, which is also a nested structure.
    - condition_type: STRING
    - field: STRING
    - op: STRING
    - value: STRING
  - match: STRING
  - saved_segment_id: INTEGER
- store_id: STRING
report_summary: OBJECT, which is also a nested data structure.
- click_rate: NUMBER
- clicks: INTEGER
- open_rate: NUMBER
- opens: INTEGER
- subscriber_clicks: INTEGER
- unique_opens: INTEGER
settings: OBJECT, which is also a nested data structure.
- authenticate: BOOLEAN
- auto_footer: BOOLEAN
- from_name: STRING
- inline_css: BOOLEAN
- reply_to: STRING
- title: STRING
- to_name: STRING
- use_conversation: BOOLEAN
start_time: DATE-TIME
status: STRING
tracking: OBJECT, which is also a nested data structure.
- capsule: OBJECT, which is also a nested data structure.
  - notes: BOOLEAN
- clicktale: STRING
- ecomm360: BOOLEAN
- goal_tracking: BOOLEAN
- google_analytics: STRING
- html_clicks: BOOLEAN
- opens: BOOLEAN
- salesforce: OBJECT, which is also a nested data structure.
  - campaign: BOOLEAN
  - notes: BOOLEAN
- text_clicks: BOOLEAN
trigger_settings: OBJECT, which is also a nested data structure.
- runtime: STRING
- workflow_emails_count: INTEGER
- workflow_title: STRING
- workflow_type: STRING

campaigns

The campaigns table contains info about the campaigns in your MailChimp account.

Replication Method

Full Table

Primary Key

Useful links

MailChimp API method

Join campaigns with	on
reports_email_activity	campaigns.id = reports_email_activity.campaign_id campaigns.recipients.list_id = reports_email_activity.list_id
automations	campaigns.recipients.list_id = automations.recipients.list_id
list_members	campaigns.recipients.list_id = list_members.list_id
list_segment_members	campaigns.recipients.list_id = list_segment_members.list_id
list_segments	campaigns.recipients.list_id = list_segments.list_id
lists	campaigns.recipients.list_id = lists.id

archive_url

STRING

content_type

STRING

create_time

DATE-TIME

delivery_status

OBJECT

This is a nested data structure:

enabled: BOOLEAN

emails_sent

INTEGER

has_logo_merge_tag

BOOLEAN

STRING

long_archive_url

STRING

needs_block_refresh

BOOLEAN

recipients

OBJECT

This is a nested data structure:

list_id: STRING
list_is_active: BOOLEAN
list_name: STRING
recipient_count: INTEGER
segment_opts: OBJECT, which is also a nested data structure.
- conditions: ARRAY, which is also a nested data structure.
  - condition_type: STRING
  - field: STRING
  - op: STRING
  - value: STRING
- match: STRING
- prebuilt_segment_id: STRING
- saved_segment_id: INTEGER
segment_text: STRING

report_summary

OBJECT

This is a nested data structure:

click_rate: NUMBER
clicks: INTEGER
ecommerce: OBJECT, which is also a nested data structure.
- total_orders: INTEGER
- total_revenue: INTEGER
- total_spent: INTEGER
open_rate: NUMBER
opens: INTEGER
subscriber_clicks: INTEGER
unique_opens: INTEGER

resendable

BOOLEAN

send_time

DATE-TIME

settings

OBJECT

This is a nested data structure:

authenticate: BOOLEAN
auto_footer: BOOLEAN
auto_tweet: BOOLEAN
drag_and_drop: BOOLEAN
fb_comments: BOOLEAN
folder_id: STRING
from_name: STRING
inline_css: BOOLEAN
preview_text: STRING
reply_to: STRING
subject_line: STRING
template_id: STRING
timewarp: BOOLEAN
title: STRING
to_name: STRING
use_conversation: BOOLEAN

social_card

OBJECT

This is a nested data structure:

description: STRING
image_url: STRING
title: STRING

status

STRING

tracking

OBJECT

This is a nested data structure:

clicktale: STRING
ecomm360: BOOLEAN
goal_tracking: BOOLEAN
google_analytics: STRING
html_clicks: BOOLEAN
opens: BOOLEAN
text_clicks: BOOLEAN

type

STRING

web_id

INTEGER

list_members

The list_members table contains info about the members in a specific MailChimp list, including currently subscribed, unsubscribed, and bounced members.

Replication Method	CDC
Primary Keys	id list_id
Replication Key	last_changed
Useful links	MailChimp API method

Join list_members with	on
automations	list_members.list_id = automations.recipients.list_id
campaigns	list_members.list_id = campaigns.recipients.list_id
list_segment_members	list_members.list_id = list_segment_members.list_id
list_segments	list_members.list_id = list_segments.list_id
lists	list_members.list_id = lists.id
reports_email_activity	list_members.list_id = reports_email_activity.list_id

email_address

STRING

email_client

STRING

email_type

STRING

ip_opt

STRING

ip_signup

STRING

language

STRING

last_changed

DATE-TIME

list_id

STRING

location

OBJECT

This is a nested data structure:

country_code: STRING
dstoff: INTEGER
gmtoff: INTEGER
latitude: NUMBER
longitude: NUMBER
timezone: STRING

member_rating

NUMBER

source

STRING

stats

OBJECT

This is a nested data structure:

avg_click_rate: NUMBER
avg_open_rate: NUMBER

status

STRING

tags

ARRAY

This is a nested data structure:

id: INTEGER
name: STRING

tags_count

INTEGER

timestamp_opt

DATE-TIME

timestamp_signup

DATE-TIME

unique_email_id

STRING

unsubscribe_reason

STRING

vip

BOOLEAN

web_id

INTEGER

list_segment_members

The list_segment_members table contains info about members in a saved segment

Replication Method

Full Table

Primary Key

Useful links

MailChimp API method

Join list_segment_members with	on
automations	list_segment_members.list_id = automations.recipients.list_id
campaigns	list_segment_members.list_id = campaigns.recipients.list_id
list_members	list_segment_members.list_id = list_members.list_id
list_segments	list_segment_members.list_id = list_segments.list_id
lists	list_segment_members.list_id = lists.id
reports_email_activity	list_segment_members.list_id = reports_email_activity.list_id

email_address

STRING

email_client

STRING

email_type

STRING

ip_opt

STRING

ip_signup

STRING

language

STRING

last_changed

DATE-TIME

list_id

STRING

location

OBJECT

This is a nested data structure:

country_code: STRING
dstoff: INTEGER
gmtoff: INTEGER
latitude: NUMBER
longitude: NUMBER
timezone: STRING

member_rating

NUMBER

stats

OBJECT

This is a nested data structure:

avg_click_rate: NUMBER
avg_open_rate: NUMBER

status

STRING

timestamp_opt

DATE-TIME

timestamp_signup

STRING

unique_email_id

STRING

vip

BOOLEAN

list_segments

The list_segments table contains info about the available segments for a specific list.

Replication Method	Full Table
Primary Key	id
Replication Key	updated_at
Useful links	MailChimp API method

Join list_segments with	on
automations	list_segments.list_id = automations.recipients.list_id
campaigns	list_segments.list_id = campaigns.recipients.list_id
list_members	list_segments.list_id = list_members.list_id
list_segment_members	list_segments.list_id = list_segment_members.list_id
lists	list_segments.list_id = lists.id
reports_email_activity	list_segments.list_id = reports_email_activity.list_id

created_at

DATE-TIME

STRING

list_id

STRING

member_count

INTEGER

name

STRING

options

OBJECT

This is a nested data structure:

conditions: ARRAY, which is also a nested data structure.
- condition_type: STRING
- field: STRING
- op: STRING
- value: STRING
match: STRING

type

STRING

updated_at

DATE-TIME

lists

The lists table contains info about all the lists in your MailChimp account. A list is also known as an audience, and is where all contacts are stored and managed in MailChimp.

Replication Method

Full Table

Primary Key

Useful links

MailChimp API method

Join lists with	on
automations	lists.id = automations.recipients.list_id
campaigns	lists.id = campaigns.recipients.list_id
list_members	lists.id = list_members.list_id
list_segment_members	lists.id = list_segment_members.list_id
list_segments	lists.id = list_segments.list_id
reports_email_activity	lists.id = reports_email_activity.list_id

beamer_address

STRING

campaign_defaults

OBJECT

This is a nested data structure:

from_email: STRING
from_name: STRING
language: STRING
subject: STRING

contact

OBJECT

This is a nested data structure:

address1: STRING
address2: STRING
city: STRING
company: STRING
country: STRING
phone: STRING
state: STRING
zip: STRING

date_created

DATE-TIME

double_optin

BOOLEAN

email_type_option

BOOLEAN

has_welcome

BOOLEAN

STRING

list_rating

INTEGER

marketing_permissions

BOOLEAN

modules

ARRAY

name

STRING

notify_on_subscribe

STRING

notify_on_unsubscribe

STRING

permission_reminder

STRING

stats

OBJECT

This is a nested data structure:

avg_sub_rate: NUMBER
avg_unsub_rate: NUMBER
campaign_count: INTEGER
campaign_last_sent: DATE-TIME
cleaned_count: INTEGER
cleaned_count_since_send: INTEGER
click_rate: NUMBER
last_sub_date: DATE-TIME
last_unsub_date: DATE-TIME
member_count_since_send: INTEGER
merge_field_count: INTEGER
open_rate: NUMBER
target_sub_rate: NUMBER
unsubscribe_count: INTEGER
unsubscribe_count_since_send: INTEGER

subscribe_url_long

STRING

subscribe_url_short

STRING

use_archive_bar

BOOLEAN

visibility

STRING

web_id

STRING

reports_email_activity

The reports_email_activity table contains info about a member’s subscriber activity in a specific campaign.

Replication Method

CDC

Primary Keys

action

campaign_id

email_id

timestamp

Useful links

MailChimp documentation

MailChimp API method

Join reports_email_activity with	on
campaigns	reports_email_activity.campaign_id = campaigns.id reports_email_activity.list_id = campaigns.recipients.list_id
automations	reports_email_activity.list_id = automations.recipients.list_id
list_members	reports_email_activity.list_id = list_members.list_id
list_segment_members	reports_email_activity.list_id = list_segment_members.list_id
list_segments	reports_email_activity.list_id = list_segments.list_id
lists	reports_email_activity.list_id = lists.id

action

STRING

campaign_id

STRING

email_address

STRING

email_id

STRING

list_id

STRING

list_is_active

BOOLEAN

timestamp

DATE-TIME

type

STRING

url

STRING

unsubscribes

The unsubscribes table contains info about members who have unsubscribed from a specific campaign.

Replication Method

Full Table

Primary Keys

campaign_id

email_id

Useful links

MailChimp API method

campaign_id

STRING

email_address

STRING

email_id

STRING

list_id

STRING

list_is_active

BOOLEAN

reason

STRING

timestamp

DATE-TIME

vip

BOOLEAN

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo – um erro de digitação, uma etapa ausente ou um erro técnico – avise-nos!

Deixe seu feedback aqui