Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 Abonnenten Import Anlegen/Aktualisieren von Abonnenten (Batch-Funktion) zurück.

Verfügbar ab Backclick-Version: 5.7.5

...

  • ID des Mandanten
  • API-Key (optionale Authentifizierung, wenn nicht angegeben, dann wird die Authentifizierung über die IP-Adressen vorgenommen)
  • Ist ist die Angabe der Verteilerlisten additiv oder komplett (Standard: "listsAdditive" => false); optionale Angabe
  • Sollen leere Abonnentenfelder gelöscht werden (Standard: "deleteBlankFields" => false); optionale Angabe
  • Soll beim Abonnieren von neuen Verteilerlisten der letzte Newsletter der jeweiligen Verteilerliste versendet werden (Standard: "sendLastNewsletter" => false); optionale Angabe
  • Soll beim Abonnieren von neuen Verteilerlisten der Versand der Willkommensmail ausgelöst werden (Standard: "sendWelcome" => false); optionale Angabe
  • Soll beim Abonnieren von neuen Verteilerlisten die Antispamfunktionalität berücksichtigt werden (Standard: "filterAntiSpam" => true); optionale Angabe
  • Abonnenten, die hinzugefügt/aktualisiert werden sollen:
    • E-Mail Adresse des Abonnenten
    • Verteilerlisten, welche der Abonnent abonnieren soll
    • ID des Mandanten
    • ID des Double-Opt-In Templates für das Abonnieren von neuen Verteilerlisten (Standard: "doubleOptinTemplateId" => 0 (kein Template)); optionale Angabe
    • ID des Profiländern Templates für das Verändern von Abonnentendatensätzen (Standard: "changeProfileTemplateId" => 0 (kein Template)); optionale Angabe
    • Abonnentendaten:
      • Name des Felds (Pflichtfeld, wenn die Daten eines Abonnenten angegeben werden)
      • Wert des Felds (Pflichtfeld, wenn die Daten eines Abonnenten angegeben werden)
      • Soll eine Veränderung durch den Abonnenten bestätigt werden (Standard: "confirmChange" => false); optionale Angabe

...

  • Invalid field name in request. => Es wurde ein Feld bei einem Abonnenten angegeben, welches nicht existiert.

Beispiel

Code Block
firstline
languagephp
themeEclipse
languagefirstlinephp2
titleVollständiges Beispiel für das Hinzufügen/Aktualisieren von Abonnenten
2linenumberstrue
$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";
}


Code Block
languagephp
themeEclipse
languagefirstlinephp2
titleBeispielausgabefirstline2
linenumberstrue
object(stdClass)#2 (2) {
  ["responseCode"]=>
  int(0)
  ["invalidAddresses"]=>
  string(0) ""
}


Code Block
languagephp
themeEclipse
languagefirstlinephp2
titleMinimalbeispiel für das Hinzufüren eines Abonnentenfirstline2
linenumberstrue
$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";
}

...