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 wird eine entsprechende Fehlermeldung erzeugt.
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 in Backclick funktioniert) und es ist eine Onlineansicht der Mails verfügbar.
An Transaktionsmails können auch Attachments angehangen werden. Diese müssen als Base64 kodierte Dateien angegeben werden.
Beim Versand der E-Mail sind natürlich alle technischen Vorteile von Backclick vorhanden, 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.
Verfügbar ab Backclick-Version: 5.8.4
Um eine Transaktionsmail zu versenden, müssen Sie folgende Parameter angeben:
Optional kann auch noch der Alternativtext der E-Mail angegeben werden. Wenn der Alternativtext angegeben wird, dann muss der Inhalt "HTML" und der Alternativtext "Text" sein.
Folgende Fehlermeldungen können bei fehlerhaften Requests auftreten:
Error compiling newsletter template Ihre ID => Beim Erzeugen des Inhalts aus dem Tempalte ist ein Fehler aufgetreten.
$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->replyTo = 'reply@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";
}
|
object(stdClass)#2 (1) {
["success"]=>
bool(true)
} |
Um ein funktionsfähiges Beispiel testen können, steht hier der Quellcode zum Download zur Verfügung.
Beispiel für den Versand einer Transaktionsmail