"MailChimp" (服务连接)

连接 MailChimp 以获得关于电子邮件推广和订阅列表的详细信息. MailChimp 是一个电子邮件市场服务平台,提供了设计、发送和保存电子邮件模板的选项. 它提供了跟踪推广结果和邮件列表回复的工具.

连接与验证

ServiceConnect["MailChimp"] 创建到 MailChimp API 的连接.

要求

ServiceExecute["MailChimp","request",params] 使用参数 params,给 MailChimp API 发送请求. 以下给出了可能的请求.

用户订阅列表

要求:

"Lists" 搜索可用列表,并且进行过滤

参数:
  • "ListID"None具有特定列表 ID 的列表;接受列表中多个 ID
    "ListName"None具有特定名称的列表
    "FromName"None具有默认 "FromName" 的列表
    "FromAddress"None具有默认 "FromAddress" 的列表
    "Subject"None具有默认 "Subject" 的列表
    "CreatedBefore"None在该日期前创建的列表;接受 DateObject 和字符串
    "CreatedAfter"None从该日期创建的列表;接受 DateObject 和字符串
    MaxItems10返回的元素数目
    "Exact"False是否使用精确数值
    "StartIndex"1起始索引
    "SortField""Created"用于排序的字段("Created""Web"
    IgnoreCaseTrue当使用 "SortField" 时是否忽略大小写
  • 订阅列表中的成员

    要求:

    "ListMembers" 显示列表中的成员,并且进行过滤

    参数:
  • "ListID"(必要的)预期列表的 ID
    "Status""Subscribed"显示具有特定状态 ("Unsubscribed", "Subscribed" 或者 "Cleaned") 的特定状态
    MaxItems10返回的元素数目
    "StartIndex"1起始索引
    "SortField"None用于排序的字段("Email", "Rating", "LastUpdateTime" 或者 "OptionTime"
    IgnoreCaseTrue当使用 "SortField""Status" 时是否忽略大小写
  • 来自订阅列表的滥用报告

    要求:

    "ListAbuse" 显示对发送给某列表的推广进行投诉的成员

    参数:
  • "ListID"必要的期待列表的 ID
    "StartDate"None从该日期开始的滥用报告;接受 DateObject 和字符串
    MaxItems10返回的元素数目
    "StartIndex"1起始索引
  • 订阅列表的活动统计数据

    要求:

    "ListActivity" 显示给定列表的每日详细综合活动统计数据

    参数:
  • "ListID"必要的期望列表的 ID
  • 用于订阅列表的客户

    要求:

    "ListClients" 列表订阅者中被标记为已经被使用的客户

    参数:
  • "ListID"必要的期望列表的 ID
  • 订阅列表的月增长

    要求:

    "ListMonthlyGrowth" 给定列表的月增长历史

    参数:
  • "ListID"必要的期望列表的 ID
  • 订阅列表的地点

    要求:

    "ListLocations" 显示列表订阅者的地点(国家)

    参数:
  • "ListID"必要的期望列表的 ID
  • 用户推广

    要求:

    "Campaigns" 搜索创建的推广,并且进行过滤

    参数:
  • "CampaignID"None推广 ID
    "ParentID"None推广的父活动的 ID
    "ListID"None列表 ID
    "FolderID"None文件夹 ID
    "TemplateID"None模板 ID
    "Status"None推广活动状态 ("Sent", "Save", "Paused", "Schedule", "Sending", "Regular")
    "Type"None推广活动类型 ("Regular", "Plaintext", "ABSplit", "RSS", "Auto")
    "FromName"None推广活动 "FromName"
    "FromAddress"None推广活动 "FromAddress"
    "Title"None推广活动标题
    "Subject"None推广活动主题
    "SendTimeStart"None推广活动的最早发送日期(接受 DateObject 和字符串)
    "SendTimeEnd"None推广活动的最新发送日期(接受 DateObject 和字符串)
    "UsesSegment"None是否只返回有或者没有分段的推广活动
    "Exact"True是否使用精确数值
    MaxItems10返回的元素数目
    "StartIndex"1起始索引
    "SortField""CreateTime"排序字段("CreateTime""SendTime""Title""Subject"
    IgnoreCaseTrue当使用 "SortField""Type""Status" 时是否忽略大小写
  • 推广中的滥用报告

    要求:

    "CampaignAbuse" 获取具有所有关于某给定推广的投诉的电子邮件地址的表格

    参数:
  • "CampaignID"必要的推广的 ID
    "StartIndex"1起始索引
    "MaxItems"10返回的元素数目
    "StartDate"None只显示某日之后的信息;接受 DateObject 和字符串
  • 点击推广 URL

    要求:

    "CampaignClicks" 对于给定推广,跟踪的 URL 和它们的点击数目

    参数:
  • "CampaignID"必要的推广的 ID
  • 按照推广的国家和地区打开

    要求:

    "CampaignLocations" 获取推广中打开的国家/区域信息

    参数:
  • "CampaignID"必要的推广的 ID
  • Summary of a Campaign

    要求:

    "CampaignSummary" 获取推广统计数据的摘要信息

    "CampaignSummaryTimeSeries" 推广的前24小时的某些信息

    参数:
  • "CampaignID"必要的推广的 ID
  • 推广的接收人

    要求:

    "CampaignRecipients" 获取发送推广的电子邮件地址

    参数:
  • "CampaignID"必要的推广的 ID
    "StartIndex"1起始索引
    MaxItems10返回的元素数目
    "Status"None按照状态过滤("Sent""Hard" 或者 "Soft"
    IgnoreCaseTrue当使用 "Status" 时是否忽略大小写
  • 在推广中打开的电子邮件

    要求:

    "CampaignOpenedBy" 获取打开给定推广的电子邮件地址

    参数:
  • "CampaignID"必要的推广的 ID
    "StartIndex"1起始索引
    MaxItems10返回的元素数目
    "Status"None按照状态过滤("Sent""Hard" 或者 "Soft"
    IgnoreCaseTrue当使用 "Status" 时是否忽略大小写
  • 推广中没有打开的电子邮件

    要求:

    "RawReportNotOpened" 获取没有打开给定推广的电子邮件地址

    参数:
  • "CampaignID"必要的推广的 ID
    "StartIndex"1起始索引
    MaxItems10返回的元素数目
  • 推广中未订阅的电子邮件

    要求:

    "CampaignUnsubscriptions" 获取给定推广的所有取消订阅的电子邮件地址

    参数:
  • "CampaignID"必要的推广的 ID
    "StartIndex"1起始索引
    MaxItems10返回的元素数目
  • Notes & Issues

    该链接的使用要求互联网连接,以及一个 MailChimp 账号.

    范例

    基本范例  (1)

    通过启动验证对话框创建新链接:

    获得为用户账号定义的所有列表:

    浏览列表中的单个项目:

    "Lists" 查询获得可用键列表:

    基于选中的键,获得重建的相关性:

    基于一组选中的键,获得前两个项目重建的相关性:

    按照特定 "ListID" 过滤列表:

    按照创建日期过滤列表:

    访问给定列表过去180天内每日详细整合活动统计数据:

    获取投诉发到某列表的推广的所有电子邮件地址:

    按照用户代理所见,获取添加了列表订阅者所用标签的客户:

    分析列表数据:

    获取与指定滤波器的推广和详细信息列表:

    快速浏览一个推广活动的项目:

    "Campaigns" 查询获取可用键列表:

    获取推广活动接受者的电子邮件列表:

    获取推广活动的整合统计数据:

    获取电子邮件推广的开启率,或者订阅者打开递交推广的比率:

    获取电子邮件推广的点击率,或者在至少一个点击下注册了多少成功递交的电子邮件推广: