Beschreibung

Mit Hilfe der Funktion EditConversions können Conversions nachtäglich gelöscht oder verändert werden. Beim Ändern/Löschen von Conversions wird in dem angegeben Zeitraum nach den Zutreffenden Conversions gesucht und dann die entsprechende Aktion ausgelöst. Wenn das Flag "uniqueMatch" mit true belegt ist, und mehrere Conversions zu der Suche gefunden werden, dann wird keine Aktion ausgelöst. Ist dieses Flag nicht, oder mit flase belegt, so ist im Feld "numAffected" die Anzahl der geänderten Einträge zu finden. Wenn eine Conversion erfolgreich geändert ist, so wird dies im Feld "resultCode" der Antwort mit dem Code "0" bestätigt.

Verfügbar ab Backclick-Version: 5.9.0

Um eine Änderung an einer Conversion zu starten müssen folgende Angaben machen:

• ID des Mandanten
• API-Key (optionale Authentifizierung, wenn nicht angegeben, dann wird die Authentifizierung über die IP-Adressen vorgenommen)
• Angabe zu den Conversions (dabei können Sie mehrere Conversions mit einmal ändern oder löschen)
  • E-Mail Adresse des Abonnenten, zu welchem die Conversion zugeordnet ist
  • Tracking-ID, die dem Newsletter zugeordnet war
  • Währung, die in der Conversion hinterlegt ist
  • Höhe des Umsatzes, der in der Conversion hinterlegt ist.
  • Neue Währung, diese kann auch weg gelassen werden, allerding muss dann entweder der neue Umsatz gesetzt sein, oder die Conversion gelöscht werden; optionale Angabe
  • Neuer Umsatz, diese kann auch weg gelassen werden, allerding muss dann entweder die neue Währung gesetzt sein, oder die Conversion gelöscht werden; optionale Angabe
  • Soll die Conversion gelöscht werden, dies kann auch weg gelassen werden, allerding muss dann entweder die neue Währung oder der neue Umsatz gesetzt sein; optionale Angabe
  • Nur Ändern bei eindeutigem Fund (Standard: false); optionale Angabe
  • Zeitpunkt, zu dem die Conversion in etwa erzeugt worden ist ("xs:dateTime"-Format, z.B. 2017-10-23T20:29:00)
    
  • Abweichung in Minuten, Zum Erzeugen eines Zeitraums für die Suche nach der Conversion

Als Ergebnis wird ein strukturiertes Objekt zurück gegeben, welches alle Eingabeparameter und die Zusatzinformationen zu der Änderung enthält (Statuscode, Anzahl betroffener Conversions).

Folgende Fehlermeldungen können bei fehlerhaften Requests auftreten:

• No valid conversion datasets given in request. All n  datasets are invalid! => Alle Datensätze, die zur Änderung angegeben worden sind, sind ungültig, bitte überprüfen.

• Too many conversion datasets in request! Maximum datasets per request: n => Es sollen zu viele Conversions auf einmal geändert werden. Die maximal zulässige Anzahl an gleixhzeitigen Änderungen steht am Ende der Fehlermeldung.

Beispiel

$client = new SoapClient($wsdlUrl);
date_default_timezone_set('Europe/Berlin');
$editConversion = new StdClass();
$editConversion->mandatorId = 0;

$conversion = new StdClass();
$conversion->emailAddress = "[email protected]";
$conversion->trackingId = "Gux34SI6pm";
$conversion->currency = "EUR";
$conversion->amount = "1000";
$conversion->estimatedLogtime = mktime(9, 40, 0, 7, 4, 2013);
$conversion->maxMinutesDifference = 10;
$conversion->newAmount = 50.56;

$editConversion->conversions = array();
array_push($editConversion->conversions, $conversion);

try {
  $result = $client->editConversions($editConversion);
  var_dump($result);
} catch (Exception $e) {
  echo "Error: " . $e->getMessage() . "\n";
}

object(stdClass)#4 (2) {
  ["summaryResult"]=>
  bool(false)
  ["conversions"]=>
  object(stdClass)#5 (1) {
    ["item"]=>
    object(stdClass)#6 (12) {
      ["emailAddress"]=>
      string(16) "[email protected]"
      ["trackingId"]=>
      string(10) "Gux34SI6pm"
      ["currency"]=>
      string(3) "EUR"
      ["amount"]=>
      float(1000)
      ["newCurrency"]=>
      string(3) "EUR"
      ["newAmount"]=>
      float(50.56)
      ["deleteAction"]=>
      bool(false)
      ["uniqueMatch"]=>
      bool(false)
      ["estimatedLogtime"]=>
      string(29) "2013-07-04T09:40:00.000+02:00"
      ["maxMinutesDifference"]=>
      int(10)
      ["numAffected"]=>
      int(0)
      ["resultCode"]=>
      int(0)
    }
  }
}

Quellcode

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

Beispiel für das Editieren einer Conversion