Інтеграція MailChimp на веб-сайті за допомогою API MailChimp та PHP

Останнє оновлення Жов 17, 2021

Зміст

Отримайте ключ API MailChimp та ідентифікатор аудиторії

MailChimp – це одна з популярних служб маркетингу електронною поштою, яка керує передплатниками вашого веб-сайту. Використовуючи MailChimp, ви можете надсилати бюлетень своїм передплатникам. У бюлетені ви можете писати про свій новий вміст, пропозиції чи оголошення на своєму веб-сайті. Інформаційні бюлетені корисні для повернення аудиторії на веб-сайт.

Іншими популярними постачальниками послуг електронного маркетингу є:

Більшість веб-сайтів розміщують форму передплати, де збирають електронну пошту користувача. Цей електронний лист безпосередньо надходитиме в MailChimp як передплатник.

У цій статті ми вивчаємо, як зробити інтеграцію MailChimp за допомогою їх API та PHP cURL. Ми збираємось додати електронний лист до MailChimp. Іншими словами, ми побачимо, як додати передплатників до MailChimp за допомогою їх API.

Перш ніж продовжити, переконайтеся, що у вас на сервері ввімкнено curl. Ми взаємодіємо із зовнішньою URL-адресою, яка є нічим іншим, як кінцевими точками MailChimp. Для надсилання запитів та отримання відповідей потрібен файл curl.

Сказавши це, давайте подивимось, як можна додати передплатника до своїх списків MailChimp за допомогою API.

Ви можете інтегрувати цю інтеграцію MailChimp на будь-які веб-сайти, що працюють на PHP. Наприклад, на веб-сайтах, які створені за допомогою WordPress, Laravel тощо.

Отримайте ключ API MailChimp та ідентифікатор аудиторії

Для взаємодії з API MailChimp вам потрібно взяти ключ API та ідентифікатор аудиторії. Виконайте наведені нижче дії та отримайте його

Увійдіть до свого акаунта MailChimp. Під значком користувача виберіть Обліковий запис.

Клацніть на Extra-> API-ключі.

У розділі Ваші ключі API натисніть Створити ключ. Скопіюйте свій ключ API, який нам потрібен за мить.

Далі отримайте ідентифікатор аудиторії, до якого вам потрібно додати своїх передплатників. Для цього натисніть меню Аудиторія, а потім виберіть параметр Налаштування зі спадного меню Керування аудиторією.

У розділі "Налаштування" натисніть "Назва аудиторії та за замовчуванням".

На наступній сторінці ви знайдете свій ідентифікатор аудиторії.

Додати абонента до списку MailChimp

На цьому етапі ви готові зі своїм ключем API та ідентифікатором аудиторії. Тепер нам потрібно лише надіслати HTTP-запит до API MailChimp разом із необхідними параметрами.

Список усіх викликів API можна знайти в їх офіційній документації. Для нашого підручника нам потрібен їх виклик API додавання нового члена списку.

Для цього виклику API потрібен ключ API із адресою електронної пошти та статусом. Для статусу ми можемо передавати значення "передплачене" або "очікує на розгляд". Якщо значення "передплачене", електронна адреса додається безпосередньо до списку MailChimp. І якщо значення "очікує на розгляд", тоді користувачеві буде надіслано електронне повідомлення з підтвердженням. Після підтвердження користувач стає передплатником.

Щоб інтегрувати цей API, розмістіть наведений нижче код у вашому файлі PHP. Обов’язково замініть заповнювачі фактичними значеннями.

<?php
$email = 'EMAIL_ADDRESS';
$list_id = 'LIST_ID';
$api_key = 'API_KEY';
 
$data_center = substr($api_key,strpos($api_key,'-')+1);
 
$url = 'https://'. $data_center .'.api.mailchimp.com/3.0/lists/'. $list_id .'/members';
 
$json = json_encode([
    'email_address' => $email,
    'status'        => 'subscribed', //pass 'subscribed' or 'pending'
]);
 
try {
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_USERPWD, 'user:'. $api_key);
    curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
    $result = curl_exec($ch);
    $status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
 
    if (200 == $status_code) {
        echo "The user added successfully to the MailChimp.";
    }
} catch(Exception $e) {
    echo $e->getMessage();
}

У наведеному вище коді при успішному виконанні ви отримаєте 200 як код відповіді. Ми також обробили помилку, якщо вона видає з якихось причин.

Mailchimp також надає поля аудиторії, які зберігають додаткову інформацію про користувачів безпосередньо на інформаційній панелі MailChimp. Про всяк випадок, якщо ви хочете додати поля аудиторії, ви можете це зробити, додавши ще один елемент масиву у наведеному вище запиті POST. Тут я додаю значення для полів аудиторії за замовчуванням FNAME та LNAME.

<?php
...
...
$json = json_encode([
    'email_address' => $email,
    'status'        => 'subscribed', //pass 'subscribed' or 'pending'
    'merge_fields'  => [
        'FNAME' => 'ENTER_FIRST_NAME',
        'LNAME' => 'ENTER_LAST_NAME'
    ]
]);

Додавання тегів передплатнику

Можливо, ви захочете впорядкувати контакти MailChimp за тегами. Для присвоєння тегів абоненту вам потрібно надіслати запит POST до API MailChimp. Зверніться до коду нижче, який призначає теги Blogger та YouTuber передплатнику.

<?php
$email = 'EMAIL_ADDRESS';
$list_id = 'LIST_ID';
$api_key = 'API_KEY';
 
$data_center = substr($api_key,strpos($api_key,'-')+1);
$subscriber_hash = md5(strtolower($email));
 
$url = 'https://'. $data_center .'.api.mailchimp.com/3.0/lists/'. $list_id .'/members/'. $subscriber_hash .'/tags';
 
$json = json_encode([
    'tags' => [
                ['name' => 'Blogger', 'status' => 'active'],
                ['name' => 'YouTuber', 'status' => 'active'],
            ]
]);
 
try {
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_USERPWD, 'user:'. $api_key);
    curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
    $result = curl_exec($ch);
    $status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
 
    if (204 == $status_code) {
        echo "The tags added successfully to the User.";
    }
} catch(Exception $e) {
    echo $e->getMessage();
}

Користувач може видаляти теги, надаючи значення "неактивне" для ключа стану.

Видаліть абонента зі списку MailChimp

API MailChimp забезпечує виклик API для видалення адреси електронної пошти зі списку. Відповідно до документації для видалення абонента, нам потрібно надіслати запит DELETE до API. Цього разу вам потрібно передати хеш md5 електронної адреси кінцевій точці API.

<?php
$email = 'EMAIL_ADDRESS';
$list_id = 'LIST_ID';
$api_key = 'API_KEY';
 
$data_center = substr($api_key,strpos($api_key,'-')+1);
 
$url = 'https://'. $data_center .'.api.mailchimp.com/3.0/lists/'. $list_id .'/members/'. md5(strtolower($email));
 
try {
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_USERPWD, 'user:'. $api_key);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    $result = curl_exec($ch);
    $status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
} catch(Exception $e) {
    echo $e->getMessage();
}

Сподіваюся, ви розумієте інтеграцію API MailChimp на веб-сайті за допомогою PHP. Будь ласка, поділіться своїми думками та пропозиціями в коментарі нижче.

Пов’язані статті

Джерело запису: artisansweb.net