MailChimpi integreerimine veebisaidil, kasutades MailChimp API-d ja PHP-d
MailChimp on üks populaarsemaid e-turundusteenuseid, mis haldavad teie veebisaidi tellijaid. MailChimpi kasutades saate oma tellijatele uudiskirja saata. Infolehes võite kirjutada oma veebisaidi värskest sisust, pakkumistest või teadaannetest. Infolehed on kasulikud, et publik tagasi veebisaidile tuua.
Teine populaarne e-turunduse teenuse pakkuja on
Enamik veebisaite paneb tellimisvormi, kus nad koguvad kasutaja e-posti aadressi. See meil saadetakse tellijana otse MailChimpile.
Selles artiklis uurime, kuidas teha MailChimpi integreerimist nende API-de ja PHP-CURL-i abil. Lisame MailChimpile e-kirja. Teisisõnu näeme, kuidas lisada liitujaid MailChimpi nende API abil.
Enne jätkamist veenduge, et serveris oleks CURL lubatud. Me suhtleme välise URL-iga, mis pole midagi muud kui MailChimpi lõpp-punktid. Taotluste saatmiseks ja vastuste saamiseks on vajalik CURL.
Seda öeldes vaatame, kuidas saab API kaudu abonenti oma MailChimp-i loenditesse lisada.
Selle MailChimpi integreerimise saate integreerida mis tahes PHP-ga töötavatele veebisaitidele. Näiteks veebisaitidel, mis on loodud WordPressi, Laraveli jms abil.
Hankige MailChimpi API võti ja vaatajaskonna ID
MailChimp API-ga suhtlemiseks peate haarama API võtme ja vaatajaskonna ID. Järgige alltoodud samme ja hankige see.
Logige sisse oma MailChimpi kontole. Valige kasutajaikooni alt konto.
Klõpsake nuppu Extra-> API võtmed.
Klõpsake jaotises Teie API võtmed nuppu Loo võti. Kopeerige hetkega vajalik API-võti.
Järgmisena hankige vaatajaskonna ID, millele peate oma tellijad lisama. Selleks klõpsake menüül Vaatajaskond ja valige seejärel rippmenüüst Sihtrühma haldamine suvand Seaded.
Klõpsake jaotises Seaded nupul „Vaatajaskonna nimi ja vaikesätted".
Järgmisel lehel leiate oma vaatajaskonna ID.
Lisage abonent MailChimpi loendisse
Selles etapis olete valmis oma API-võtmega ja vaatajaskonna ID-ga. Nüüd on meil vaja ainult saata HTTP-päring koos vajalike parameetritega MailChimp API-le.
Kõigi API-kõnede loendi leiate nende ametlikust dokumendist. Meie õpetuse jaoks vajame nende uue loendi liikme API-kõne lisamist.
Selle API-kõne jaoks on vaja e-posti aadressi ja olekuga API-võtit. Staatuse saamiseks võime edastada väärtuse „tellitud” või „ootel”. Kui väärtus on "tellitud", lisatakse e-posti aadress otse MailChimpi loendisse. Ja kui väärtus on ootel, saadetakse kasutajale kinnitusmeil. Pärast kinnitamist saab kasutaja abonendiks.
Selle API integreerimiseks pange allolev kood oma PHP-faili. Asendage kohatäited tegelike väärtustega.
<?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();
}Ülaltoodud koodis saate eduka täitmise korral vastuskoodina 200. Samuti tegelesime veaga, kui see mingil põhjusel viskab.
Samuti pakub Mailchimp väljad Vaatajaskond, mis salvestavad lisateavet kasutajate kohta otse MailChimpi juhtpaneelil. Igaks juhuks, kui soovite lisada vaatajaskonna välju, saate seda teha, lisades ülaltoodud POST-i päringule veel ühe massiivi elemendi. Lisan siin väärtused vaatajaskonna väljadele FNAME ja LNAME.
<?php
...
...
$json = json_encode([
'email_address' => $email,
'status' => 'subscribed', //pass 'subscribed' or 'pending'
'merge_fields' => [
'FNAME' => 'ENTER_FIRST_NAME',
'LNAME' => 'ENTER_LAST_NAME'
]
]);Lisage abonendile sildid
Võite korraldada oma MailChimpi kontaktid siltidega. Abonendile siltide määramiseks peate saatma POST-päringu MailChimp API-le. Vaadake allolevat koodi, mis määrab abonendile sildid Blogger ja 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();
}Kasutaja saab märgendeid eemaldada, lisades olekuvõtmele väärtuse „passiivne”.
Kustutage abonent MailChimpi loendist
MailChimp API pakub API-kõnet e-posti aadressi kustutamiseks loendist. Vastavalt abonendi kustutamise dokumentatsioonile peame API-le saatma DELETE taotluse. Seekord peate edastama API lõpp-punktile e-posti aadressi md5 räsi.
<?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();
}Loodetavasti saate aru MailChimpi API integreerimisest PHP-d kasutaval veebisaidil. Palun jagage oma mõtteid ja ettepanekuid allolevas kommentaaris.