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.

Immagine di alto livello di questo connettore, inclusi collegamenti utili e funzionalità supportate.

Funzionalità/Capacità	Dettagli del supporto
Progetti Qlik Talend Data Integration supportati	Solo i progetti di replica. I progetti delle pipeline di dati non sono supportati.
Metodi di aggiornamento della destinazione	Attività di replica: Applica modifiche Archivia modifiche Trasferimento dei dati nelle attività di un data lake: Change Data Capture (CDC)
Gestione dei metadati	La generazione manuale dei metadati non è richiesta.
Evoluzione dello schema	È supportata solo l'operazione Cambia tipo di dati colonne.
Replica delle colonne LOB (NCLOB, CLOB e BLOB)	Operazione non supportata.
CDC pianificato	Operazione richiesta. In questo modo la destinazione viene aggiornata con le modifiche apportate alla sorgente. Per le attività di replica, vedere Attività di pianificazione Per le attività di trasferimento su data lake, vedere Pianificazione delle attività CDC per i processi di trasferimento su data lake
Notifiche	Operazione parzialmente supportata Impostare notifiche quando vengono apportate modifiche al funzionamento
Monitoraggio	Solo attività CDC, in quanto il caricamento completo non è rilevante per questo connettore. Monitoraggio di un'attività dati individuale
Annullamento automatico della nidificazione dei payload nelle colonne JSON	Operazione non supportata. La nidificazione per i payload della colonna JSON nei set di dati di origine non viene annullata automaticamente nella destinazione.

Preparing for authentication

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

Assicurarsi che l'account utilizzata disponga di accesso di lettura per le tabelle che si desidera recuperare.

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

Per ulteriori informazioni, vedere Connessione alle applicazioni SaaS.

Una volta completate le impostazioni di connessione richieste, fare clic su Autenticazione.
Potrebbe essere visualizzato un messaggio che richiede di accedere all'applicazione di origine.
Viene visualizzata una finestra con un codice di autenticazione.
Copiare il codice negli appunti e tornare alla finestra di dialogo della connessione.
Incollare il codice in Completare l'autenticazione con il codice fornito dalla sorgente e fare clic su Verifica.
Nota di suggerimentoPer visualizzare questo campo, potrebbe essere necessario scorrere in basso.
Quando lo stato è Verificato, l'autenticazione viene verificata.
Fornire un nome per la connessione in Nome connessione.
Selezionare Apri metadati di connessione per definire i metadati della connessione al momento della creazione.

Connection settings
Setting	Description
Data gateway	Selezionare un Gateway Data Movement se richiesto dal proprio caso di utilizzo. Nota informatica Questo campo non è disponibile con la sottoscrizione a Avvio Qlik Talend Cloud, poiché non supporta il Gateway Data Movement. Se si dispone di un altro livello di sottoscrizione e non si desidera utilizzare il Gateway Data Movement, selezionare Nessuno. Per informazioni sui vantaggi del Gateway Data Movement e quando è richiesto, vedere Qlik Data Gateway - Movimento dati.
Start Date	Inserire la data, nel formato `MM/DD/YYYY`, a partire dalla quale i dati devono essere replicati dalla sorgente alla destinazione.
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

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – ti pregiamo di farcelo sapere!

Lascia qui il tuo feedback