为 MailChimp 活动或列表查找已清理/退回的电子邮件地址

Posted 2023-03-24

【中文标题】为 MailChimp 活动或列表查找已清理/退回的电子邮件地址

【英文标题】：Finding cleaned/bounced email addresses for a MailChimp campaign or list

【发布时间】：2016-03-01 18:57:13

【问题描述】：

我想自动收集给定活动的取消订阅和清理的电子邮件帐户。

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

退订

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

已清理

在哪里可以找到列表或活动中已清理/退回的电子邮件？我知道我可以在不同的地方看到退回的 count，但我想找到实际退回的电子邮件地址，以及列表成员的名字和姓氏。基本上，我希望 API 与网站上提供的“导出到 csv”相同。

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

【参考方案1】：

你可以的

GET lists/list_id/members?status=unsubscribed

获取退订用户

GET lists/list_id/members?status=cleaned

获得清理/反弹的用户

【讨论】：

此端点性能不佳，列表中每 10.000 个成员大约需要 10 秒

【参考方案2】：

对于特定活动中的退回电子邮件，您需要这样做：

GET /3.0/reports/campaign_id/email-activity

并遍历活动中的所有收件人，使用 type=bounce 手动定位操作。

    
        "email_address": "[e-mail]",
        "activity": [
            
                "action": "bounce",
                "type": "hard",
                "timestamp": "2019-04-08T00:00:00+00:00"
            
        ]
    ,

不幸的是，MailChimp 在此端点上的性能非常差，对于一个有 500 个收件人的活动，大约需要 25 秒才能返回活动。

【参考方案3】：

由于软退回邮件不会更改列表（受众）内的status，因此要从列表中获取软退回邮件而无需特定活动，您可以使用

获取列表/list-id/members/subscriber_hash/activity

此端点只会返回单个电子邮件（联系人），因此您需要遍历列表中的所有电子邮件（联系人）。

示例响应：

"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"
        
    ],