MailChimp-integraatio verkkosivustolla MailChimp API: n ja PHP: n avulla
MailChimp on yksi suosituimmista sähköpostimarkkinointipalveluista, jotka hallinnoivat verkkosivustosi tilaajia. MailChimpin avulla voit lähettää uutiskirjeen tilaajillesi. Uutiskirjeessä voit kirjoittaa uudesta sisällöstäsi, tarjouksistasi tai ilmoituksistasi verkkosivustollasi. Uutiskirjeet ovat hyödyllisiä tuomaan yleisö takaisin verkkosivustolle.
Toinen suosittu sähköpostimarkkinointipalvelujen tarjoaja on:
Suurin osa verkkosivustoista laittaa tilauslomakkeen, jossa kerätään käyttäjän sähköposti. Tämä sähköposti lähetetään suoraan MailChimpille tilaajana.
Tässä artikkelissa tutkitaan, miten MailChimp-integrointi tehdään niiden sovellusliittymien ja PHP-käyrän avulla. Aiomme lisätä sähköpostin MailChimpiin. Toisin sanoen näemme, kuinka lisätä tilaajia MailChimpiin niiden sovellusliittymän avulla.
Ennen kuin jatkat, varmista, että CURL on käytössä palvelimessa. Olemme vuorovaikutuksessa ulkoisen URL-osoitteen kanssa, joka on vain MailChimp-päätepisteitä. Pyyntöjen lähettäminen ja vastausten saaminen vaatii cURL: n.
Tämän sanottuaan katsotaanpa, kuinka tilaaja voidaan lisätä MailChimp-luetteloihinsa API: n kautta.
Voit integroida tämän MailChimp-integraation mihin tahansa PHP-pohjaiseen verkkosivustoon. Esimerkiksi verkkosivustoilla, jotka on rakennettu käyttämällä WordPressiä, Laravelia jne.
Hanki MailChimp-sovellusliittymäavain ja yleisötunnus
Jotta voisit olla vuorovaikutuksessa MailChimp-sovellusliittymän kanssa, sinun on napattava API-avain ja yleisötunnus. Seuraa alla olevia vaiheita ja hanki se.
Kirjaudu MailChimp-tilillesi. Valitse käyttäjäkuvakkeen alla Tili.
Napsauta Extra-> API-avaimet.
Napsauta API-avaimet -osiossa Luo avain. Kopioi tarvitsemasi API-avain hetkessä.
Hanki seuraavaksi yleisötunnus, johon sinun on lisättävä tilaajat. Napsauta tätä varten Yleisö-valikkoa ja valitse sitten Asetukset-vaihtoehto avattavasta Hallitse yleisöä.
Napsauta Asetukset-kohdassa Yleisön nimi ja oletusasetukset.
Seuraavalta sivulta löydät yleisötunnuksesi.
Lisää tilaaja MailChimp-luetteloon
Tässä vaiheessa olet valmis käyttämään API-avainta ja yleisötunnusta. Nyt meidän tarvitsee vain lähettää HTTP-pyyntö MailChimp-sovellusliittymään tarvittavien parametrien mukana.
Löydät luettelon kaikista API-puheluista heidän virallisista asiakirjoistaan. Opetusohjelmaamme varten tarvitaan heidän Lisää uusi luettelo -jäsenen API-kutsu.
Tämä API-kutsu vaatii API-avaimen, jossa on sähköpostiosoite ja tila. Tilan osalta voimme välittää joko tilatun tai odottavan arvon. Jos arvo on ’tilattu’, sähköpostiosoite lisätään suoraan MailChimp-luetteloon. Ja jos arvo on odottava, käyttäjälle lähetetään vahvistusviesti. Vahvistuksen jälkeen käyttäjästä tulee tilaaja.
Integroi tämä sovellusliittymä sijoittamalla alla oleva koodi PHP-tiedostoon. Muista korvata paikkamerkit todellisilla arvoilla.
<?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();
}Yllä olevassa koodissa onnistuneesta suorituksesta saat 200 vastauskoodina. Käsittelimme myös virheen, jos se heittää jostain syystä.
Mailchimp tarjoaa myös Yleisökentät, jotka tallentavat lisätietoa käyttäjistä suoraan MailChimp-hallintapaneeliin. Jos haluat lisätä yleisökenttiä, voit tehdä sen lisäämällä vielä yhden taulukkoelementin yllä olevaan POST-pyyntöön. Lisään tässä arvot oletusyleisökentille 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'
]
]);Lisää tunnisteita tilaajalle
Voit halutessasi järjestää MailChimp-yhteystiedot tunnisteilla. Tunnisteiden määrittämiseksi tilaajalle sinun on lähetettävä POST-pyyntö MailChimp-sovellusliittymään. Katso alla oleva koodi, joka antaa tunnisteet Blogger ja YouTuber tilaajalle.
<?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();
}Käyttäjä voi poistaa tunnisteita antamalla tilavaimelle ‘ei-aktiivisen’ arvon.
Poista tilaaja MailChimp-luettelosta
MailChimp-sovellusliittymä tarjoaa API-kutsun sähköpostiosoitteen poistamiseksi luettelosta. Asiakirjan mukaan tilaajan poistamiseksi meidän on lähetettävä POISTA-pyyntö API: lle. Tällä kertaa sinun on välitettävä sähköpostiosoitteen md5-hash API-päätepisteelle.
<?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();
}Toivottavasti ymmärrät MailChimp-sovellusliittymän integroinnin PHP: tä käyttävälle verkkosivustolle. Ole hyvä ja jaa ajatuksiasi ja ehdotuksiasi alla olevassa kommentissa.