Transaction Notification DE

From Wiki

Jump to: navigation, search

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

  1. Wurde die Funktion für Sie aktiviert, finden Sie den Link zur Transaktionsbenachrichtigung unter Erweitert.

  2. 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.

    • 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.

  3. 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.

Privacy

Due to new European legislation regarding how websites store information about you, AWIN is updating its privacy policy. You can see the new version of our policy here. If you would like to see the information we capture on this website, please click here for further details. In order to accept cookies on this site please click the 'I ACCEPT' button