如何在 MailChimp 中更新现有订阅者的段和组 API 3

Question

我已经编写了一种方法来为用户订阅 MailChimp。 'special' 它会根据用户的购物车项目、心愿单项目以及他订阅的项目和/或类别，自动将用户订阅到列表中的组和列表中的细分.

与 MailChimp 的集成非常简单 - 我获取数据 > 发送 curl > 获取响应 > 处理响应。

我正在寻找一种方法来根据用户在我的商店中的操作不断更新用户组和细分。

现在，MailChimp 唯一可以接受的状态是 'subscribed'、'pending' 和 'clean'。所有这些都没有更新，只是插入新的订阅者。如果电子邮件已被订阅，则不会更新任何内容，甚至不会更新与订阅者在我的 MailChimp 列表中的个人资料不同的数据。

这是我的代码供参考：

    protected static function subscribeToMailchimp($email, $fullname)
{
    $params     = EkerbaseJoomla::getPluginParams('system', 'ekerbaseusers');
    $interests  = self::getUserInterestsObject();

    $apikey                 = $params->mailChimpApiKey;
    $listId                 = $params->mailChimpListId;
    $interestCategoryId     = $params->mailChimpInterestCategoryId;

    $auth                   = base64_encode( 'user:' . $apikey );
    $apiUrl                 = 'https://'.substr($params->mailChimpApiKey, -3).'.api.mailchimp.com/3.0/lists/'.$listId;
    $possibleGroups         = json_decode(file_get_contents($apiUrl . '/interest-categories/' . $interestCategoryId . '/interests?apikey=' . $apikey))->interests;
    $segments               = json_decode(file_get_contents($apiUrl . '/segments?apikey=' . $apikey))->segments;

    $data = [
        'apikey'            => $apikey,
        'email_address'     => $email,
        'status'            => 'subscribed',
        'merge_fields'      =>
            [
                'FNAME'     => $fullname
            ]
    ];

    if( ! empty($interests->categories) ) {

        $data['interests'] = [];

        foreach( $possibleGroups as $group ) {

            if( in_array($group->name, $interests->categories) ) {
                $data['interests'][$group->id] = true;
            }

        }

    }

    if( ! empty($interests->items) ) {

        $data['segments'] = [];

        foreach( $segments as $segment ) {

            if( in_array($segment->name, $interests->items) ) {
                $data['segments'][$segment->id] = true;
            }

        }

    }

    $ch = curl_init();

    curl_setopt($ch, CURLOPT_URL, $apiUrl . '/members/');
    curl_setopt($ch, CURLOPT_HTTPHEADER,
        [
            'Content-Type: application/json',
            'Authorization: Basic '.$auth
        ]
    );

    curl_setopt($ch, CURLOPT_USERAGENT, 'PHP-MCAPI/3.0');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

    $result     = curl_exec($ch);
    $response   = json_decode($result);

    switch( $response->status ) {

        case 'subscribed':
            $responseMessage = JText::_('EKERBASE_SUCCESS_NEWSLETTER');
            $responseStatus  = 'success';
            $responseResult  = 'mailchimp subscribing succeeded';
            break;

        default:

            $responseStatus  = 'error';
            $responseMessage = $response->title;
            $responseResult  = 'mailchimp subscribing failed';

            if( $response->title === 'Member Exists' ) {
                $responseMessage = JText::_('EKERBASE_NEWSLETTER_ALREADY_SUBSCRIBER');
            }

            break;

    }

    return EkerbaseAjax::buildJsonResponse($responseMessage, $responseStatus, $responseResult);
}

Answer 1

如果您的集成按预期添加了全新的订阅者，并且该问题似乎只出现在该方法正在更新现有订阅者记录的情况下，则该问题可能与 HTTP 方法有关，and/or api端点。

因为 MailChimp 的 v3 API 只允许在使用 POST 方法时初始化订阅者（看起来它可能在这里被硬编码到 cURL 中），并且可能是全新订阅者的原因正在毫无问题地添加。

这就是说，当想要添加或更新新订阅者时，建议使用 PUT，并在他们的文档中指定。

此外，为了确保现有订阅者得到更新，除了使用这种替代方法外，您还需要将他们电子邮件的小写版本的 MD5 哈希附加到端点。 只需要对现有订阅者执行此操作。

例如/members/{lowercase_email_MD5_hash}

如果您首先使用 MailChimp 检查订阅者是否存在，如果您想回收订阅者，则应在响应中提供。

如何在 MailChimp 中更新现有订阅者的段和组 API 3

How to update segments and groups of an existing subscriber in MailChimp API 3

php

mailchimp

mailchimp-api-v3.0