Как сделать интеграцию MailChimp на вашем сайте

Последнее обновление Июл 12, 2021

Содержание

Получите ключ API MailChimp и идентификатор аудитории

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

В Интернете есть несколько поставщиков услуг электронного маркетинга, таких как Aweber и iContact. Но несомненно, MailChimp более популярен среди людей.

Интегрировать MailChimp на сайт очень просто. Вам просто нужно добавить фрагмент кода, и вы сможете легко управлять своими подписчиками.

В прошлом я писал статью, в которой также объясняется интеграция MailChimp на ваш сайт. В той статье я написал код для взаимодействия с API MailChimp. В этой статье мы будем использовать библиотеку GitHub для интеграции с MailChimp.

При этом давайте посмотрим на интеграцию MailChimp на вашем сайте.

Получите ключ API MailChimp и идентификатор аудитории

Для начала вам необходимо получить ключ API и идентификатор аудитории вашей учетной записи MailChimp. Ключ API является обязательным при вызове MailChimp API. Идентификатор аудитории – это идентификационный ключ, на который должны подписываться новые подписчики.

Войдите в свою учетную запись 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