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.

Una visión detallada de este conector, incluye enlaces útiles y funcionalidad compatible.

Función/Capacidad	Detalles de compatibilidad
Compatibilidad con proyectos de Qlik Talend Data Integration	Solo proyectos de replicación. No se admiten proyectos de canalización de datos.
Métodos de actualización de destinos	Tareas de replicación: Aplicar los cambios Guardar cambios Tareas de aterrizaje de datos en un lago de datos: Captura de datos de cambios (CDC)
Administrar los metadatos	No es necesario generar metadatos manualmente.
Evolución del esquema	Solo se admite la operación Cambiar tipo de datos de columna.
Replicación de columnas LOB (NCLOB, CLOB y BLOB)	No admitido.
CDC programado	Obligatorio. Así es como el destino se mantiene actualizado con los cambios en la fuente. Para tareas de replicación, vea Programar tareas Para tareas de aterrizaje en un lago de datos, vea Programación de CDC para tareas de destino/aterrizaje en un lago de datos
Notificaciones	Parcialmente compatible Configuración de notificaciones sobre cambios
Supervisión	Solo CDC, ya que la carga completa no es relevante para este conector. Supervisar una tarea individual de datos
Descarte automático de cargas útiles de columnas JSON	No admitido. Las cargas útiles de columnas JSON en los conjuntos de datos de origen no se deniegan automáticamente en el destino.

Preparing for authentication

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

Asegúrese de que la cuenta que utiliza tenga acceso de lectura a las tablas que desea recuperar.

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 más información, vea Conectar con aplicaciones SaaS.

Haga clic en Autenticar cuando haya completado la configuración de conexión requerida.
Es posible que se le solicite que inicie sesión en la aplicación de origen.
Se mostrará una ventana con un código de autenticación.
Copie el código en el portapapeles y regrese al cuadro de diálogo de conexión.
Pegue el código en Autenticación completa con el código proporcionado por la fuente y haga clic en Verificar.
Nota de sugerenciaEs posible que tenga que desplazarse hacia abajo para ver este campo.
Cuando el estado es Verificado, se verifica la autenticación.
Proporcione un nombre para la conexión en Nombre de la conexión.
Seleccione Abrir metadatos de conexión para definir metadatos para la conexión cuando se haya creado.

Connection settings
Setting	Description
Data gateway	Seleccione una Data Movement gateway si su caso de uso así lo requiere. Nota informativa Este campo no está disponible con la suscripción Qlik Talend Cloud Starter porque Data Movement gateway no se admite. Si tiene otro nivel de suscripción y no desea utilizar Data Movement gateway, seleccione Ninguna. Para obtener información sobre las ventajas de Data Movement gateway y los casos de uso que lo requieren, consulte Pasarela de movimiento de datos de Qlik.
Start Date	Indique la fecha, en el formato `MM/DD/YYYY`, a partir de la cual deben replicarse los datos de su fuente a su 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 le ha sido útil?

Si encuentra algún problema con esta página o su contenido (errores tipográficos, pasos que faltan o errores técnicos), no dude en ponerse en contacto con nosotros.

Deje aquí sus comentarios