MailChimp V2
The Qlik MailChimp Connector uses the MailChimp API to access your MailChimp email activity and marketing campaign data.
Ways to access your data
To access your MailChimp data, you need to authenticate the connector with your MailChimp API key. MailChimp users who have Manager permissions can generate API keys and users with Admin permissions can view API keys.
Creating a data source connection
Loading data from tables
After you authenticate the connector with your account credentials, use the tables to fetch your data. Some tables are preconfigured to access a specific set of data while others let you create custom queries. The table below outlines some of the use cases for some of the tables that are available.
| Table | Available in | Description |
|---|---|---|
| UserInfo | 資料載入編輯器 | Returns user profile info. |
| Lists | 資料管理員 and 資料載入編輯器 | Use this table to fetch the lists that are associated with your user account. The table returns the list IDs which are required for all other list tables. |
| List | 資料管理員 and 資料載入編輯器 | Returns members of a list and all of their associated details. |
| ListGrowthHistory | 資料管理員 and 資料載入編輯器 | Returns a month-by-month summary of a specific list’s growth activity. |
| ListSegments | 資料管理員 and 資料載入編輯器 | Retrieves information about all available segments for a specific list. |
| Campaigns | 資料管理員 and 資料載入編輯器 | Use this table to fetch a list of campaigns and their details associated with your user account. The table returns the list of campaign IDs which are required for all other Campaign tables. |
| CampaignReport | 資料管理員 and 資料載入編輯器 | Retrieves a specific campaign report. |
| CampaignClickReport | 資料管理員 and 資料載入編輯器 | Get information about clicks on specific links in your MailChimp campaigns. |
| CampaignTimeSeriesReport | 資料管理員 and 資料載入編輯器 | Get information about campaign time. |
| CampaignEmailActivityReport | 資料管理員 and 資料載入編輯器 | Get a list of member's subscriber activity in a specific campaign. |
| MemberInfo | 資料載入編輯器 | Use this table to fetch data about members of a list. You need the list ID to run this table. |
To select and load data from a table, enter the required table parameters and click Preview data. Required parameters are marked with an asterisk (*) in the dialog. The table fields are displayed under the Data preview tab. You can select fields individually by selecting the box beside each field name. Select Insert script after you have made your selection.
Creating a connection and selecting data
Table parameters
To run some of the tables, you need to enter specific table parameters, usually in the form of an object ID or an object name. You can find many of these parameters when you run other tables.
For example, to run the CampaignReport table you need the campaign ID. You can fetch the list of campaigns and campaign IDs associated wit the authenticated user's account by running the Campaigns table.
Working with the MailChimp API quota limits
The Qlik 網頁連接器 use the MailChimp API 3.0 to extract data from MailChimp and load it into your Qlik Sense app. While reloading you MailChimp-based app, you might receive an error message that the connector has reached the MailChimp API rate limit and that all subsequent API calls will fail until the connector falls back under the throttling limit. If you receive this error message, then you have exceeded one of the API rate limits.
You receive an error message that you have reached the API rate limit
Reference - MailChimp developer documentation
You can refer to the MailChimp developer documentation to learn more about the requirements and restriction imposed by the MailChimp API 3.0.
Get Started with the MailChimp API
Troubleshooting
You receive an error message that you have reached the API rate limit
可能的原因
You have exceeded the API limits that are imposed on the Qlik Web Connectors by the MailChimp API.
建議的行動
To reduce the impact of reaching the API rate limits, develop your app with the following in mind:
- Extract only the data you need.
- Reload one MailChimp-based application at a time.
- Ensure that loops in your script that make API calls will not result in infinite loops.
You receive an error message when running a Campaigns table
可能的原因
If you see the following error message: DOMException: Invalid Character Error with Campaigns Table
It is being thrown from the MailChimp API and not from the Qlik MailChimp Connector.
建議的行動
We recommend that you contact MailChimp support or consult the MailChimp API documentation.