查找MailChimp广告系列或列表的已清理/退回电子邮件地址

时间:2015-11-27 14:35:01

标签: mailchimp mailchimp-api-v3.0

我想自动收集特定广告系列的取消订阅和清理电子邮件帐户。

在API游乐场中,我看到了List实体上可用的所有方法。

取消订阅

我看到它在LIST API中 GET reports/xxxxxx/unsubscribed

清理

在哪里可以找到列表或广告系列中已清理/退回的电子邮件?我知道我可以看到在各个地方反弹的计数,但我想找到实际退回的电子邮件地址,以及列表成员的名字和姓氏。基本上我想要的API与网站上提供的'export cleaning to csv'相同。

如何使用MailChimp 3.0 API执行此操作?

methods on a list

3 个答案:

答案 0 :(得分:3)

你可以做到

GET lists/list_id/members?status=unsubscribed

获取未订阅的用户

GET lists/list_id/members?status=cleaned

获得清理/退回用户

答案 1 :(得分:0)

对于特定广告系列中退回的电子邮件,您需要执行以下操作:

GET /3.0/reports/campaign_id/email-activity

并遍历广告系列中的所有收件人,并使用type=bounce手动定位操作。

    {
        "email_address": "xxx@example.com",
        "activity": [
            {
                "action": "bounce",
                "type": "hard",
                "timestamp": "2019-04-08T00:00:00+00:00"
            }
        ]
    },

不幸的是,MailChimp在此端点上的性能非常差,对于具有500个收件人的广告系列,返回活动大约需要25秒。

答案 2 :(得分:0)

由于软弹跳不会更改列表(受众群体)内的status,因此要从列表中获取软弹跳电子邮件而无需特定的广告系列,可以使用

  

获取列表/ {list-id} /成员/ {subscriber_hash} /活动

此终结点仅返回单个电子邮件(联系人),因此您需要遍历列表中的所有电子邮件(联系人)。

示例响应:

"activity": [
        {
            "action": "bounce",
            "timestamp": "2019-05-01T23:02:26+00:00",
            "type": "soft",
            "campaign_id": "xxxxxxxxxx",
            "title": "Xxxx Xxxxxxx"
        },
        {
            "action": "sent",
            "timestamp": "2019-05-01T23:00:00+00:00",
            "type": "regular",
            "campaign_id": "xxxxxxxxxx",
            "title": "Xxxx Xxxxxxx"
        }
    ],