Transaction Notification DE
From Wiki
→ English . Español . Français . Italiano . Nederlands . Polski . Português (Brasil) . Svenska .
Contents |
Transaktionsbenachrichtigung
Wir bieten unseren Publishern eine echtzeitnahe Berichtsfunktion, die sicherstellt, dass immer dann eine Benachrichtigung an das System des Publishers gesendet wird, wenn eine Transaktion erfasst wird. Diese Benachrichtigung erhält zudem alle mit der Transaktion verbundenen Informationen.
Um Zugang zu dieser Funktion zu erhalten, müssen Sie sie zunächst aktivieren, indem Sie von Ihrer Publisher-Benutzeroberfläche aus ein Ticket erstellen und dort die Anfrage beschreiben.
Einrichtung
- Wurde die Funktion für Sie aktiviert, finden Sie den Link zur Transaktionsbenachrichtigung unter Erweitert.
- Es sind vier Einstellungen zu berücksichtigen, wie unten beschrieben:
Callback-URL: Dies ist der Pfad zum Skript, zu dem die entsprechenden Daten gesendet werden. Von hier aus werden die Daten in der Datei benutzerdefiniert verwaltet und in die von Ihnen angegebenen Komponenten Ihres Systems geparst. Dabei könnte es sich zum Beispiel um eine PHP-Datei in der entsprechenden Domäne handeln, aber unsere Transaktionsbenachrichtigungen sind nicht auf PHP-Dateien beschränkt. Unterstützt werden die Ports 80 und 443.
Callback-Methode: Hier können Sie auswählen, wie Sie die Daten geliefert bekommen. Beispiele zur Verwendung der einzelnen Methoden finden Sie unten.
Produktdaten: Markieren Sie diese Option, wenn Sie Daten über aktuell gekaufte Produkte zurückgesendet haben möchten. Voraussetzung dafür ist, dass der Advertiser Produktebenen-Tracking verwendet und diese Daten aktiv mit Publishern teilt – was nicht immer der Fall sein wird. (Im Zweifel wenden Sie sich an die Account-Ansprechpartner für das Advertiser-Programm.)
Klickdaten: Dies sind Daten zu dem ursprünglich geklickten Link, der auf den Pfad zur stattgefundenen Transaktion führt.
- Wenn Sie die Daten eingegeben haben, klicken Sie auf Senden. Anschließend sollten Sie die Meldung Ihre Änderungen wurden erfolgreich gespeichert erhalten.
Anfragetypen
GET-Anfrage
Die Transaktionsdaten werden als GET-Anfrage an die URL gesendet, die Sie angegeben haben. Makros können verwendet werden, um den Pfad oder Anfrage-Teil der URL zu ändern, sodass die Anfrage dynamisch wird.
Makros
| Makro | Beschreibung | Beispiel |
!!!affiliateId!!!
|
Mit der Transation verbundene Publisher-ID | 45628 |
!!!bannerId!!!
|
Mit dem konvertierenden Klick verknüpfte Werbemittel-ID | 291555 |
!!!clickRef!!!
|
Vom Publisher angegebener Klick-/View-Identifier/Referenz. Siehe Klick-Referenzen | LINKCMP2013-06 |
!!!clickRef2!!!
|
Vom Publisher angegebener Klick-/View-Identifier/Referenz. Siehe Klick-Referenzen | LINKCMP2013-06 |
!!!clickRef3!!!
|
Vom Publisher angegebener Klick-/View-Identifier/Referenz. Siehe Klick-Referenzen | LINKCMP2013-06 |
!!!clickRef4!!!
|
Vom Publisher angegebener Klick-/View-Identifier/Referenz. Siehe Klick-Referenzen | LINKCMP2013-06 |
!!!clickRef5!!!
|
Vom Publisher angegebener Klick-/View-Identifier/Referenz. Siehe Klick-Referenzen | LINKCMP2013-06 |
!!!clickRef6!!!
|
Vom Publisher angegebener Klick-/View-Identifier/Referenz. Siehe Klick-Referenzen | LINKCMP2013-06 |
!!!clickThroughTime!!!
|
Klick-Datum im Format %Y-%m-%d %H:%i:%s (Zeitzone: UTC)
|
2013-06-13 12:00:00 |
!!!clickTime!!!
|
Klick-Datum im Format %Y-%m-%d %H:%i:%s (Zeitzone: UTC)
|
2013-06-13 12:00:00 |
!!!commission!!!
|
Provisionsbetrag für die Transaktion | 1.64 |
!!!commissionGroups!!!
|
Details in Verbindung mit der Transaktion nach Provisionsgruppe (im JSON-Format) | See below under POST Request (JSON) / Example Data |
!!!groupId!!!
|
Mit dem konvertierenden Klick verknüpfte Werbemittelgruppen-ID | 137726 |
!!!merchantId!!!
|
ID des Advertiser-Programms, zu dem die Transaktion gehört | 3661 |
!!!phrase!!!
|
Suchmaschinenbegriff | Elektronische Musik |
!!!products!!!
|
Details in Verbindung mit der Transaktion nach Produkt (im JSON-Format) | Siehe POST-Anfrage (JSON) / Beispieldaten |
!!!searchEngine!!!
|
Suchmaschinenname | MSN Live Search |
!!!transactionAmount!!!
|
Gesamt-Sale-Betrag in der Währung des Advertiser-Programms (!!!transactionCurrency!!!) | 26.09 |
!!!transactionDate!!!
|
Transaktionsdatum im Format %Y-%m-%d %H:%i:%s (Zeitzone: UTC)
|
2013-06-13 12:05:00 |
!!!transactionId!!!
|
Unsere eindeutige Transaktions-ID | 105956531 |
!!!url!!!
|
Verweis-Klick-URL | http://www.publisher-domain.com/advertiser/product/ |
!!!transactionCurrency!!!
|
Währung des Advertiser-Programms. Das ist die Währung der Affiliate-Transaktion (!!!transactionAmount!!! und !!!commission!!!). Der aus drei Großbuchstaben bestehende Währungscode | GBP |
!!!trackedCurrency!!!
|
Die Originalwährung, in der der Kauf getätigt wurde. Ist nur verfügbar, wenn dies eine andere Währung als die des Advertiser-Programms ist. Der aus drei Großbuchstaben bestehende Währungscode | EUR |
!!!trackedAmount!!!
|
Der Gesamt-Sale-Betrag in der Originalwährung des Kaufs (!!!trackedCurrency!!!) | 20.04 |
URL (Beispiel)
http://www.publisher-domain.com/!!!merchantId!!!/pixel.php?clk=!!!clickRef!!!&cnv=!!!transactionId!!!&com=!!!commission!!!
POST-Anfrage (JSON)
Die Transaktionsdaten werden mithilfe einer POST-Anfrage mit der Bezeichnung AwinTransactionPush als JSON-Paket an die angegebene URL geliefert. Nicht alle Schlüssel sind für alle Transaktionen verfügbar bzw. werden für alle Transaktionen gesendet (z. B. clickRef2 ist nur für eine Transaktion verfügbar, wenn diese im gewinnenden Klick übermittelt wurde).
Beispieldaten
echo $_POST["AwinTransactionPush"];
=
{"transactionId":"105956531","transactionDate":"2013-06-13 12:05:00","transactionCurrency":"GBP","transactionAmount":"26.09","affiliateId":"45628","merchantId":"3661","groupId":"0","bannerId":"0","clickRef":"LINKCMP2013-06","clickThroughTime":"2013-06-13 12:00:00","ip":"127.0.0.1","Provision":"1.64","clickTime":"2013-06-13 12:00:00","url":"http:\/\/www.publisher-domain.com\/advertiser\/product\/","phrase":"Elektronische Musik","searchEngine":"MSN Live Search","commissionGroups":[{"id":"47963","name":"CD","code":"CD","description":"CD"},{"id":"47965","name":"DVD","code":"DVD","description":"DVD"}],"products":[{"productName":"The Knife \u2013 Silent Shout","unitPrice":"5.55","skuType":"","skuCode":"B000EMSUQA","quantity":"2","category":"Elektronische Musik","cgId":"47963"},{"productName":"Sigur Ros - Heima","unitPrice":"14.99","skuType":"","skuCode":"B000EMSUQA","quantity":"1","category":"Music DVD","cgId":"47965"}]}
Beispieldaten – JSON dekodiert
var_dump(json_decode($_POST["AwinTransactionPush"], true));
=
array(17) {
["transactionId"]=>
string(9) "105956531"
["transactionDate"]=>
string(19) "2013-06-13 12:05:00"
["transactionCurrency"]=>
string(3) "GBP"
["transactionAmount"]=>
string(5) "26.09"
["trackedCurrency"]=>
string(3) "EUR"
["trackedAmount"]=>
string(5) "34,04"
["affiliateId"]=>
string(6) "45628"
["merchantId"]=>
string(4) "3661"
["groupId"]=>
string(1) "0"
["bannerId"]=>
string(1) "0"
["clickRef"]=>
string(14) "LINKCMP2013-06"
["clickRef4"]=>
string(12) "User82828211"
["clickThroughTime"]=>
string(19) "2013-06-13 12:00:00"
["commission"]=>
string(4) "1.64"
["clickTime"]=>
string(19) "2013-06-13 12:00:00"
["url"]=>
string(55) "http://www.publisher-domain.com/advertiser/product/"
["phrase"]=>
string(16) "Elektronische Musik"
["searchEngine"]=>
string(15) "MSN Live Search"
["commissionGroups"]=>
array(2) {
[0]=>
array(4) {
["id"]=>
string(5) "47963"
["name"]=>
string(2) "CD"
["code"]=>
string(2) "CD"
["description"]=>
string(2) "CD"
}
[1]=>
array(4) {
["id"]=>
string(5) "47965"
["name"]=>
string(3) "DVD"
["code"]=>
string(3) "DVD"
["description"]=>
string(3) "DVD"
}
}
["products"]=>
array(2) {
[0]=>
array(7) {
["productName"]=>
string(26) "The Knife – Silent Shout"
["unitPrice"]=>
string(4) "5.55"
["skuType"]=>
string(0) ""
["skuCode"]=>
string(10) "B000EMSUQA"
["quantity"]=>
string(1) "2"
["category"]=>
string(16) "Elektronische Musik"
["cgId"]=>
string(5) "47963"
}
[1]=>
array(7) {
["productName"]=>
string(17) "Sigur Ros – Heima"
["unitPrice"]=>
string(5) "14.99"
["skuType"]=>
string(0) ""
["skuCode"]=>
string(10) "B000EMSUQA"
["quantity"]=>
string(1) "1"
["category"]=>
string(9) "Musik-DVD"
["cgId"]=>
string(5) "47965"
}
}
}
Wenn Sie Bedenken bezüglich der Performance dieser Funktion haben, bitten Sie Technical Services, den Status zu aktualisieren.