Jak zrobić integrację MailChimp w swojej witrynie?

Ostatnia aktualizacja paź 18, 2021

Zadowolony

Uzyskaj klucz API MailChimp i identyfikator odbiorców

Czy chcesz zintegrować biuletyn MailChimp ze swoją witryną? MailChimp to jedna z popularnych usług e-mail marketingowych, która zarządza subskrybentami Twojej witryny. W tym artykule zajmiemy się integracją MailChimp w PHP.

W Internecie jest kilku dostawców usług e-mail marketingu, takich jak Aweber i iContact. Ale bez wątpienia MailChimp jest bardziej popularny wśród ludzi.

Integracja MailChimp ze stroną jest bardzo prosta. Wystarczy, że dodasz kawałek kodu i będziesz mógł łatwo zarządzać swoimi subskrybentami.

Napisałem w przeszłości artykuł, w którym wyjaśniono również integrację MailChimp z Twoją witryną. W tym artykule napisałem kod do interakcji z API MailChimp. W tym artykule wykorzystalibyśmy bibliotekę GitHub do integracji z MailChimp

To powiedziawszy, przyjrzyjmy się integracji MailChimp w Twojej witrynie.

Uzyskaj klucz API MailChimp i identyfikator odbiorców

Aby rozpocząć, musisz uzyskać klucz API i identyfikator odbiorców swojego konta MailChimp. Klucz API jest obowiązkowy podczas wywoływania API MailChimp. Audience ID jest kluczem identyfikacyjnym, do którego listy powinni zostać zasubskrybowani nowi subskrybenci.

Zaloguj się na swoje konto MailChimp. Pod ikoną użytkownika wybierz Konto.

Kliknij Extra->Klucze API.

W sekcji Twoje klucze API kliknij Utwórz klucz i skopiuj klucz API, którego potrzebujemy za chwilę.

Teraz masz gotowy klucz API. Następnie zdobądź identyfikator odbiorców, do którego musisz dodać swoich subskrybentów. W tym celu kliknij menu Odbiorcy, a następnie wybierz opcję Ustawienia z menu rozwijanego Zarządzaj odbiorcami.

W Ustawieniach kliknij nazwę odbiorców i ustawienia domyślne.

Na następnej stronie znajdziesz swój identyfikator odbiorców.

Dodaj subskrybenta do listy MailChimp

Jesteś teraz gotowy z kluczem API i identyfikatorem listy. Następnie musisz zainstalować tę bibliotekę GitHub za pomocą Composera.

Otwórz terminal w katalogu głównym projektu i uruchom polecenie:

composer require drewm/mailchimp-api

Po zainstalowaniu biblioteki dołączymy środowisko biblioteczne do naszego pliku PHP. Robimy to w następujący sposób.

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

Pamiętaj, aby zastąpić symbole zastępcze rzeczywistymi wartościami.

Aby dodać subskrybenta do listy, musimy podać adres e-mail i status. Status może być subskrybowany lub oczekujący. Jeśli wartość statusu jest subskrybowana, adres e-mail zostanie dodany bezpośrednio do listy MailChimp. A jeśli wartość statusu jest w toku, do użytkownika zostanie wysłany e-mail z potwierdzeniem. Po potwierdzeniu użytkownik zostanie dodany do listy.

Subskrybowanych możemy dodać do konkretnej listy, pisząc poniższy kod:

//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.';
}

Możesz dodać pola odbiorców dla subskrybenta. Te pola odbiorców służą do przechowywania dodatkowych informacji o użytkowniku. Powiedzmy, że chcesz dodać wartości dla pól FNAME, LNAME, które są domyślne w MailChimp. W takim przypadku po powyższym kodzie subskrypcji dodaj poniższy kod.

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

Użytkownik może również przypisać subskrybentom tagi. Możesz organizować kontakty za pomocą tagów. Załóżmy, że chcę dodać subskrybentowi tag „Blogger", więc kod będzie wyglądał następująco.

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

Możesz przypisać wiele tagów, używając większej liczby elementów tablicy. Jeśli chcesz usunąć tag, przekaż wartość statusu jako „nieaktywny”.

Usuń subskrybenta z listy MailChimp

Aby usunąć subskrybenta z listy MailChimp, wystarczy przekazać skrót md5 wiadomości e-mail do metody usuwania instancji MailChimp. Biblioteka udostępnia funkcję, subscriberHashktóra tworzy skrót md5 adresu e-mail.

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

Otóż to! Wszystko sprowadza się do dodawania lub usuwania subskrybentów MailChimp. Mam nadzieję, że rozumiesz integrację MailChimp na stronie internetowej z PHP. Podziel się swoimi przemyśleniami w poniższym komentarzu.

Powiązane artykuły

Źródło nagrywania: artisansweb.net