API / Callback Schnittstelle

Newsletterempfänger und Kundendaten konsistent halten

 

Bislang war es eine Schwäche automatischer Newslettersysteme, dass Empfänger, die sich vom Newsletter abgemeldet hatten, nach dem nächsten Import einer aktualisierten Empfängerliste (z.B. Kunden aus einem Webshop) erneut Emails erhielten, da deren Email-Adressen erneut importiert wurden. Wir haben eine Lösung für dieses Problem gefunden.

 

Wir haben eine Callback-Funktion entwickelt, die den betreffenden Empfänger an Ihr System überträgt, wo die Email-Adresse aus Ihrer eigenen Liste der Newsletter-Empfänger ausgetragen werden kann.

 

Mit Hilfe des Callbacks können Sie also Ihre Empfängerliste – parallel zum Datenbestand des Newslettersystems – aktuell halten.

 

Geben Sie Ihre Callback URL unter „Ihr Konto“ -> „Versand, Import & Export“ -> „Abmelde Optionen“ an.

 

Der Callback wird mit der HTTP-Methode POST aufgerufen. Als Datenstruktur kommt ein recipient-Array welches alle gespeicherten Daten beinhalt.

 

Beispiel:

 

Der Header des Callbacks wird wie folgt gesendet:

callback.php POST
Content-Type: application/xml; charset=UTF-8

 

Der encodierte Body sieht wie folgt aus:

 

	reason=unsubscribed&
	recipient%5Bapproved%5D=true&
	recipient%5Bbirthdate%5D=1988-14-01&
	recipient%5Bcached_tag_list%5D=Kunden&
	recipient%5Bccode%5D=DE&
	recipient%5Bcity%5D=Bremen&
	recipient%5Bcreated_at%5D=Wed+Sep+23+12%3A58%3A14+UTC+2009&
	recipient%5Bemail%5D=ceo%40microsoft.de&
	recipient%5Bfirstname%5D=Digi&
	recipient%5Bgender%5D=m&
	recipient%5Bid%5D=15&
	recipient%5Bimport_id%5D=9&
	recipient%5Bkey%5D=1312&
	recipient%5Blastname%5D=Neo&
	recipient%5Bonly_text%5D=false&
	recipient%5Bpcode%5D=28203&
	recipient%5Bstreet%5D=Wiener%20Strasse%201&
	recipient%5Bupdated_at%5D=Wed+Sep+23+12%3A58%3A14+UTC+2009&
	recipient%5Buser_id%5D=1

 

In PHP können Sie per $_POST auf die Daten zugreifen:

Array (
  [reason] => "unsubscribed"
  [recipient] => Array (
    [key] => 1312
    [email] => ceo@microsoft.com
    [firstname] => Digi
    [lastname] => Neo
    [gender] => m
    [birthdate] => 1988-14-01
    [street] => Wiener Strasse 1
    [city] => Bremen
    [pcode] => 28359
    [ccode] => DE
    [cached_tag_list] => Kunden
    [only_text] => 0
    [approved] => 1
  )
)
Der Schlüssel recipient enthält die Daten des Empfängers, der vom Newsletterversand abgemeldet wurde. Der Schlüssel reason enthält die Begründung für die Abmeldung vom Newsletters:
unsubscribed
Empfänger hat sich vom Newsletter abgemeldet.
bounced
Empfänger-Adresse ist ungültig und wurde aus diesem Grund vom empfangenden Mail-Server mehrmals zurückgewiesen.
deleted
Der Empfänger wurde aus der Datenbank entfernt.

Zurück zu: API