Beschreibung

Mit Hilfe der Funktion SaveOrCreateSubscriber können Sie Ihre Abonnenten synchronisieren. Sie können neue Abonnenten dem System hinzufügen, oder bestehende Abonnenten aktualisieren. Beim Hinzufügen von Abonnenten können Sie ein Double-Opt-In auslösen, so dass der Abonnent seine Anmeldung noch einmal bestätigen muss. Wenn Sie Abonnentendaten aktualisieren, dann können Sie eine Bestätigung dieser Abonnentendaten anfordern. Backclick versendet dann eine E-Mail mit einem Link, auf welchen der Abonnent klicken muss. Erst nach dem Klick auf den Link werden die Daten in Backclick geändert. So können Sie sicherstellen, dass dritte keine Daten ungefragt ändern können.

Diese Funktion ist nicht dazu gedacht, mehrere tausend Abonnenten in einem Request in das System zu importieren. Falls Sie dies machen wollen, dann greifen Sie bitte auf die Funktion Anlegen/Aktualisieren von Abonnenten (Batch-Funktion) zurück.

Verfügbar ab Backclick-Version: 5.7.5

Wenn Sie einen Abonnenten hinzufügen/aktualisieren wollen, dann müssen Sie folgende Angaben machen:

Als Ergebnis bekommen Sie den Status des Aufrufs. Er enthält einen Responsecode und eine Liste syntaktisch ungültiger E-Mail-Adressen. Der Responsecode kann folgende Werte annehmen:

Folgende Fehlermeldungen können bei fehlerhaften Requests auftreten:

Beispiel

$client = new SoapClient($wsdlUrl);
$saveOrCreateSubscriberRequest = new StdClass();
$saveOrCreateSubscriberRequest->mandatorId = 0;
$saveOrCreateSubscriberRequest->listsAdditive = false;
$saveOrCreateSubscriberRequest->deleteBlankFields = false;
$saveOrCreateSubscriberRequest->sendLastNewsletter = false;
$saveOrCreateSubscriberRequest->sendWelcome = false;
$saveOrCreateSubscriberRequest->filterAntiSpam = true;
$saveOrCreateSubscriberRequest->subscribers = array();

$subscriber = new StdClass();
$subscriber->subscriberEmail = "user@example.com";
$subscriber->newsletterListIds = array(1);
$subscriber->mandatorId = 0;
$subscriber->doubleOptinTemplateId = 0;
$subscriber->changeProfileTemplateId = 0;
$subscriber->subscriberFields = array();

$subscriberField = new StdClass();
$subscriberField->fieldName = utf8_encode("VORNAME");
$subscriberField->fieldValue = utf8_encode("Vorname");
$subscriberField->confirmChange = false;
array_push($subscriber->subscriberFields, $subscriberField);

$subscriberField = new StdClass();
$subscriberField->fieldName = utf8_encode("NACHNAME");
$subscriberField->fieldValue = utf8_encode("Nachname");
$subscriberField->confirmChange = false;  
array_push($subscriber->subscriberFields, $subscriberField);

array_push($saveOrCreateSubscriberRequest->subscribers, $subscriber);
try {
  $result = $client->SaveOrCreateSubscriber($saveOrCreateSubscriberRequest);
  var_dump($result);
} catch (Exception $e) {
  echo "Error: " . $e->getMessage() . "\n";
}


object(stdClass)#2 (2) {
  ["responseCode"]=>
  int(0)
  ["invalidAddresses"]=>
  string(0) ""
}


$client = new SoapClient($wsdlUrl);
$saveOrCreateSubscriberRequest = new StdClass();
$saveOrCreateSubscriberRequest->mandatorId = 0;
$saveOrCreateSubscriberRequest->subscribers = array();

$subscriber = new StdClass();
$subscriber->subscriberEmail = "user@example.com";
$subscriber->newsletterListIds = array(1);
$subscriber->mandatorId = 0;
array_push($saveOrCreateSubscriberRequest->subscribers, $subscriber);
try {
  $result = $client->SaveOrCreateSubscriber($saveOrCreateSubscriberRequest);
  var_dump($result);
} catch (Exception $e) {
  echo "Error: " . $e->getMessage() . "\n";
}

Quellcode

Um ein funktionsfähiges Beispiel testen können, steht hier der Quellcode zum Download zur Verfügung.

Beispiel um einen Abonnenten im System hinzuzufügen