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.

Ogólne informacje o tym łączniku, w tym przydatne linki i obsługiwane cechy.

Cecha/możliwość	Szczegóły obsługi
Wspierane projekty Qlik Talend Data Integration	Tylko projekty replikacji. Projekty potoków danych nie są obsługiwane.
Metody aktualizacji celu	Zadania replikacji: Zastosuj zmiany Zapisz zmiany Umieszczanie danych w zadaniach jeziora danych: Przechwytywanie zmian danych (CDC)
Zarządzanie metadanymi	Ręczne tworzenie metadanych nie jest wymagane.
Ewolucja schematu	Obsługiwana jest tylko operacja Zmień typ danych kolumny.
Replikacja kolumn LOB (NCLOB, CLOB i BLOB)	Brak obsługi.
Zaplanowane CDC	Wymagane. W ten sposób cel jest na bieżąco informowany o zmianach w źródle. W kwestii zadań replikacji zobacz Planowanie zadań W sprawie zadań umieszczania w jeziorze zobacz Harmonogram CDC dla zadań umieszczania w jeziorze
Powiadomienia	Częściowa obsługa Ustawianie powiadomień o zmianach w działaniu
Monitorowanie	Tylko CDC, ponieważ pełne ładowanie jest nieodpowiednie dla tego łącznika. Monitorowanie indywidualnego zadania danych
Automatyczne eliminowanie zagnieżdżeń zawartości kolumn JSON	Brak obsługi. Ładunki kolumn JSON w źródłowych zestawach danych nie są automatycznie rozwijane w docelowych.

Preparing for authentication

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

Upewnij się, że używane konto ma uprawnienia do odczytu interesujących Cię tabel.

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

Więcej informacji zawiera temat Łączenie się z aplikacjami SaaS.

Po wprowadzaniu wymaganych ustawień połączenia kliknij przycisk Uwierzytelnij.
Możesz zostać poproszony o zalogowanie się w aplikacji źródłowej.
Zostanie wyświetlone okno z kodem uwierzytelniającym.
Skopiuj ten kod do schowka i wróć do okna dialogowego połączeń.
Wklej kod w polu Ukończ uwierzytelnianie przy użyciu kodu podanego przez źródło i kliknij przycisk Weryfikuj.
WskazówkaByć może trzeba będzie przewinąć w dół, aby zobaczyć to pole.
Status Zweryfikowano oznacza, że uwierzytelnianie zostało zweryfikowane.
Podaj nazwę połączenia w polu Nazwa połączenia.
Wybierz opcję Otwórz metadane połączenia, aby zdefiniować metadane połączenia po jegu utworzeniu.

Connection settings
Setting	Description
Data gateway	Wybierz bramę Brama danych ruchu danych, jeżeli jest wymagana do danego zastosowania. Informacja To pole jest niedostępne w subskrypcji Qlik Talend Cloud Starter, ponieważ brama Brama danych ruchu danych jest w niej nieobsługiwana. Jeśli masz inny poziom subskrypcji i nie chcesz korzystać z bramy Brama danych ruchu danych, wybierz opcję Brak. Informacje o zaletach bramy Brama danych ruchu danych i o okolicznościach, w których jest wymagana, zawiera temat Brama danych Qlik — ruch danych.
Start Date	Wprowadź datę, w formacie `MM/DD/YYYY`, od której dane muszą być replikowane ze źródła do celu.
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

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać!

Przekaż tu opinię