Як зробити інтеграцію MailChimp на ваш веб-сайт

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

Зміст

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

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

Є кілька постачальників послуг електронної пошти маркетингу в Інтернеті, як Aweber і iContact. Але, без сумніву, MailChimp є більш популярним серед людей.

Інтегрувати MailChimp на веб-сайт дуже просто. Вам просто потрібно додати шматок коду, і ви зможете легко керувати своїми передплатниками.

Раніше я писав статтю, яка також пояснює інтеграцію MailChimp на ваш веб-сайт. У цій статті я написав код для взаємодії з API MailChimp. У цій статті ми використовуватимемо бібліотеку GitHub для інтеграції MailChimp

Це вже сказано, давайте розглянемо інтеграцію MailChimp на вашому веб-сайті.

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

Для початку вам потрібно отримати ключ API та ідентифікатор аудиторії вашого облікового запису MailChimp. Ключ API є обов’язковим під час виклику API MailChimp. Ідентифікатор аудиторії – це ідентифікаційний ключ, на який мають підписатися нові абоненти.

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

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

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

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

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

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

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

Ви готові до використання ключа API та ідентифікатора списку. Далі вам потрібно встановити цю бібліотеку GitHub за допомогою Composer.

Відкрийте термінал у кореневому каталозі проекту та запустіть команду:

composer require drewm/mailchimp-api

Після встановлення бібліотеки ми включимо бібліотечне середовище у наш PHP-файл. Ми робимо це наступним чином.

<?php
require_once "vendor/autoload.php";
 
use DrewMMailChimpMailChimp;
 
$api_key = 'YOUR_API_KEY';
$list_id = 'LIST_ID';
 
$MailChimp = new MailChimp($api_key);

Обов’язково замініть заповнювачі фактичними значеннями.

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

Ми можемо додати підписаних до конкретного списку, написавши код нижче:

//subscribe a user
$result = $MailChimp->post("lists/$list_id/members", [
     'email_address' => 'PASS_EMAIL_ADDRESS_HERE',
     'status'        => 'subscribed',
]);
 
if(isset($result['id'])) {
    echo 'User subscribed successfully.';
}

Можливо, ви захочете додати поля аудиторії для передплатника. У цих полях аудиторії зберігається додаткова інформація про користувача. Скажімо, ви хочете додати значення для полів FNAME, LNAME, яке в MailChimp є типовим. У цьому випадку після коду передплати вище додайте код нижче.

$subscriber_hash = MailChimp::subscriberHash('PASS_EMAIL_ADDRESS_HERE');
$MailChimp->patch("lists/$list_id/members/$subscriber_hash", [
    'merge_fields' => ['FNAME'=>'FIRST_NAME', 'LNAME'=>'LAST_NAME']
]);

Користувач також може призначати теги передплатникам. Ви можете організувати контакти за допомогою тегів. Скажімо, я хочу додати тег "Blogger" до передплатника, тому код буде таким.

$subscriber_hash = MailChimp::subscriberHash('PASS_EMAIL_ADDRESS_HERE');
$MailChimp->post("lists/$list_id/members/$subscriber_hash/tags", [
    'tags' => [
                ['name' => 'Blogger', 'status' => 'active'],
            ]
]);

Ви можете призначити кілька тегів, використовуючи більше елементів масиву. Якщо ви хочете видалити тег, передайте значення стану як "неактивне".

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

Для видалення абонента зі списку MailChimp вам просто потрібно передати хеш електронної пошти md5 методу видалення екземпляра MailChimp. Бібліотека надає функцію, subscriberHashяка створює хеш md5 адреси електронної пошти.

//delete a subscriber
$subscriber_hash = $MailChimp->subscriberHash('PASS_EMAIL_ADDRESS_HERE');
$result = $MailChimp->delete("lists/$list_id/members/$subscriber_hash");

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

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

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