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.

便利なリンクやサポートされている機能など、このコネクタの概要について説明します。

機能/性能	サポートの詳細
サポートされている Qlik Talend Data Integration プロジェクト	レプリケーションプロジェクトのみ。データパイプラインプロジェクトはサポートされていません。
ターゲットの更新方法	レプリケーションタスク: 変更を適用変更の保存データレイクタスクにデータをランディング: 変更データキャプチャ (CDC)
メタデータの管理	手動でのメタデータ生成は必要ありません。
スキーマの進化	[列のデータ型を変更] 操作のみサポートされています。
LOB 列 (NCLOB、CLOB、BLOB) のレプリケーション	サポートされていません。
スケジュールされた CDC	必須。これにより、ソースの変更に応じてターゲットが最新の状態に保たれます。レプリケーションタスクについては、「タスクのスケジューリング」を参照してください。レイクランディングタスクについては、「レイクランディングタスクの CDC のスケジュール設定」を参照してください。
通知	部分的にサポート動作変更時の通知の設定
監視	このコネクタではフルロードは関係ないため、CDC のみ。個々のデータタスクの監視
JSON 列ペイロードの自動ネスト解除	サポートされていません。ソースデータセット内の JSON 列ペイロードは、ターゲット上で自動的にネスト解除されません。

Preparing for authentication

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

使用するアカウントに、フェッチするテーブルへのアクセス権があることを確認してください。

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

For more information, see SaaSアプリケーションへの接続.

Click Authenticate when you have filled in the required connection settings.
You may be asked to log in to the source application.
A window is displayed with an authentication code.
Copy the code to the clipboard and return to the connection dialog.
Paste the code in Complete authentication with the code provided by the source and click Verify.
ヒントメモYou may need to scroll down to see this field.
When status is Verified, the authentication is verified.
Provide a name for the connection in Connection name.
Select Open connection metadata to define metadata for the connection when it has been created.

Connection settings
Setting	Description
Data gateway	ユースケースに応じて Data Movement gateway を選択します。情報メモ Qlik Talend Cloud スターターサブスクリプションでは Data Movement gateway をサポートしていないため、この項目は使用できません。別のサブスクリプションティアを利用しており、Data Movement gateway を使用しない場合は、 [None] (なし) を選択します。 Data Movement gateway の利点とそれを必要とするユースケースの詳細については、「Qlik データゲートウェイ - データ移動」を参照してください。
Start Date	ソースからターゲットにデータをレプリケートする必要がある日付を `MM/DD/YYYY` 形式で入力します。
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

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。

こちらにフィードバックをお寄せください