Dokumentation Backclick 5
Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

Beschreibung

Eine Transaktionsmail ist eine einzelne E-Mail, die durch Backclick versendet werden soll. Sie ist weder an eine Kampagne, noch an eine Verteilerliste gebunden. Vor dem Versand der E-Mail wird geprüft, ob der angegebene Mandant berechtigt ist, für die Domain der Absenderadresse zu versenden. Ist dies nicht der Fall, dann bekommen Sie eine Fehlermeldung. Für die Transaktionsmails gibt es spezielle Auswertungsbausteine im Reportmanager für Backclick, so dass sowohl die Versendungen als auch die Reaktionen auf Transaktionsmails getrackt und ausgewertet werden können. Die Transaktionsmails können personalisiert werden (über die normale Personalisierungsvariante, wie Sie sie aus Backclick kennen) und es ist eine Onlineansicht der Mails verfügbar.

Beim Versand der E-Mail haben Sie natürlich alle technischen Vorteile von Backclick, d.h. die E-Mail wird RFC-Konform generiert und wenn DKIM für die Absenderdomain konfiguriert ist, dann wird die E-Mail auch entsprechend signiert.

Um eine Transaktionsmail zu versenden, müssen Sie folgende Parameter angeben:

  • ID des Mandanten
  • API-Key (optionale Authentifizierung, wenn nicht angegeben, dann wird die Authentifizierung über die IP-Adressen vorgenommen)
  • Channel-ID
  • Kampagnen-ID
  • Betreff der E-Mail
  • Absenderadresse der E-Mail
  • Absendername der E-Mail
  • Inhalt der E-Mail (dabei kann entweder Text oder HTML übergeben werden. Backclick kodiert die E-Mail automatisch im richtigen Format)
  • Empfänger der E-Mail:
    • E-Mail Adresse des Empfängers
    • Persöhnliche Informationen des Empfängers
  • Liste, auf welche der Empfänger zusätzlich in Backclick gespeichert werden soll

Optional können Sie auch noch den Alternativtext der E-Mail angeben. Wenn Sie Alternativtext angeben, dann muss der Inhalt "HTML" und der Alternativtext "Text" sein.

Folgende Fehlermeldungen können bei fehlerhaften Requests auftreten:

  • Invalid domain of sender address ("example.com"). If you want to send email for this domain, please contact your admin. => Die angegebene Absenderdomain darf unter dem Mandanten nicht verwendet werden.
  • No templateId AND no newsletterContent given! => Sie haben keinen Inhalt für de Transaktionsmail angegeben.
  • Template with ID Ihre ID does not exist! => Das Tempalte mit der ID, welche Sie angegeben haben existiert nicht.
  • Both (mailContent AND alternativeMailContent is HTML.) => Sie haben sowohl im Inhalt, als auch im Alternativtext HTML angegeben.
  • Both (mailContent AND alternativeMailContent is TEXT.) => Sie haben sowohl im Inhalt, als auch im Alternativtext TEXT angegeben.
  • Both templateId AND newsletterContent given, don't know, what to send. => Sie haben den Inhalt sowohl über Text/HTML als auch über eine Tempalte-ID angegeben.
  • Channel with ID Ihre ID does not exist. => Der von Ihnen angegebene Channel für Transaktionsmails existiert nicht.
  • Address was unsubscribed, anti spam option is enabled. => Wenn Sie den Empfänger auf einer Liste speichern wollen, hat als letztes eine Abmeldung stattgefunden. Der Abonnent wird nicht gespeichert.
  • Address is at robinson list. => Wenn Sie den Empfänger auf einer Liste speichern wollen, befindet sich dieser auf der Robinsonliste.
  • Error creating subscriber. => Es ist ein Fehler beim Anlegen des Abonnenten aufgetreten.
  • Sending denied: Recipient address is on one of the black lists. => Versand der Transaktionsmail wird verweigert, da die Adresse auf einer der Blacklisten ist.

  • Error compiling newsletter template Ihre ID => Beim Erzeugen des Inhalts aus dem Tempalte ist ein Fehler aufgetreten.

  • Field "fieldName" does not exist in Backclick. => Sie haben ein Personalisierungsfeld angegeben, welches nicht in Backclick existiert.
  • Error creating transction mail. If this error remains, please contact Backclick support. => Bitte wenden Sie sich an den Support, es ist ein Fehler aufgetreten, der bisher unbekannt ist.

Beispiel

Versand einer Transaktionsmail
$client = new SoapClient($wsdlUrl);
date_default_timezone_set('Europe/Berlin');
$transactionMail = new StdClass();
$transactionMail->mandatorId = 0;
$transactionMail->channelId = 1;
$transactionMail->senderName = 'Name des Absenders';
$transactionMail->senderEmail = 'sender@example.net';
$transactionMail->recipient = new StdClass();
$transactionMail->recipient->emailAddress = 'user@recipient.domain';

$transactionMail->recipient->recipientFields = array();

$recipientField = new StdClass();
$recipientField->fieldName = 'VORNAME';
$recipientField->fieldValue = utf8_encode('Max');
array_push($transactionMail->recipient->recipientFields, $recipientField);

$recipientField = new StdClass();
$recipientField->fieldName = 'NACHNAME';
$recipientField->fieldValue = utf8_encode('Mustermann');
array_push($transactionMail->recipient->recipientFields, $recipientField);

$transactionMail->subject = utf8_encode('Transaktionsmail an $$VORNAME$$ $$NACHNAME$$');
$transactionMail->mailContent = utf8_encode('<html><body>Hallo $$VORNAME$$ $$NACHNAME$$</body></html>');
try {
  $result = $client->sendTransactionMail($transactionMail);
  var_dump($result);
} catch (Exception $e) {
  echo "Fehler aufgetreten: " . $e->getMessage() . "\n";
}
Beispielausgabe
object(stdClass)#2 (1) {
  ["success"]=>
  bool(true)
}

 Quellcode

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

Beispiel für den Versand einer Transaktionsmail

  • No labels