Transaction Notification NL

From Wiki

Jump to: navigation, search

Contents

Transactienotificatie

Wij bieden onze publishers een vrijwel real-time rapportagefunctie die ervoor zorgt dat bij elke transactieregistratie een notificatie met alle relevante informatie over de transactie naar het aangesloten publisher-systeem wordt verzonden.

Om toegang tot deze functie te verkrijgen, dient u deze eerst in te schakelen. Maak hiervoor een ticket aan vanuit uw publisher interface met daarin een omschrijving van het verzoek.


Instellen

  1. Wanneer u deze mogelijkheid hebt geactiveerd, staat de link "Transactienotificatie" onder het tabblad Geavanceerd


  2. Zoals hieronder is aangegeven, heeft u vier instellingen waarmee rekening moet worden gehouden:

    • Call-back URL: dit is het pad naar het script waar de relevante data naartoe wordt gestuurd. Van hier moet uw bestand de data aanpassen en deze in de componenten, die u hebt aangewezen, in uw systeem ontleden. Dit kan bijvoorbeeld een PHP-bestand op uw eigen domein zijn, maar onze transactienotificatie is niet alleen beperkt tot PHP. De ondersteunde poorten zijn 80 en 443.

    • Call-back methode: hier kunt u kiezen hoe u de data aangeleverd wilt hebben. Hieronder vindt u voorbeelden hoe u deze kunt gebruiken.

    • Product Data: vink deze optie aan wanneer u wilt dat de data over de daadwerkelijk gekochte producten wordt teruggegeven. Hierbij is het van belang dat de adverteerder Product Level Tracking geïmplementeerd heeft - en deze data bovendien actief met publishers deelt - hetgeen niet altijd het geval hoeft te zijn. (Neem bij twijfel a.u.b. contact op met de contactpersoon van het adverteerdersprogramma.)

    • Click Source Data: dit is data gerelateerd aan de eerste klik op de link aan het begin van het pad waarna de transactie heeft plaatsgevonden.

  3. Wanneer u de juiste data hebt ingevoerd, klik dan a.u.b. op de button Verzenden. U behoort dan de melding te zien dat Het opslaan van uw wijzigingen is geslaagd.


Soorten verzoeken

GET request

De transactiedata wordt als "GET request" aan de opgegeven URL geleverd en er kunnen macro's worden aangemaakt om het pad of het verzoekgedeelte van de URL aan te passen. Dit om het verzoek dynamischer te maken.

Macro's

Macro Omschrijving Voorbeeld
!!!affiliateId!!! De publisher-ID die bij de transactie hoort 45628
!!!bannerId!!! De ID van het promotiemateriaal dat aan de conversielink is gekoppeld 291555
!!!clickRef!!! Klikcode-/weergave referentie die door de publisher is gespecificeerd. Zie publisher click ref LINKCMP2013-06
!!!clickRef2!!! Klikcode-/weergave referentie die door de publisher is gespecificeerd. Zie publisher click ref LINKCMP2013-06
!!!clickRef3!!! Klikcode-/weergave referentie die door de publisher is gespecificeerd. Zie publisher click ref LINKCMP2013-06
!!!clickRef4!!! Klikcode-/weergave referentie die door de publisher is gespecificeerd. Zie publisher click ref LINKCMP2013-06
!!!clickRef5!!! Klikcode-/weergave referentie die door de publisher is gespecificeerd. Zie publisher click ref LINKCMP2013-06
!!!clickRef6!!! Klikcode-/weergave referentie die door de publisher is gespecificeerd. Zie publisher click ref LINKCMP2013-06
!!!clickThroughTime!!! Klik op de datum in het formaat %Y-%m-%d %H:%i:%s (tijdzone: UTC) 2013-06-13 12:00:00
!!!clickTime!!! Klik op de datum in het formaat %Y-%m-%d %H:%i:%s (tijdzone: UTC) 2013-06-13 12:00:00
!!!commission!!! Commissiebedrag dat bij de transactie hoort 1.64
!!!commissionGroups!!! Uitsplitsing van de commissiegroep die bij de transactie hoort (in JSON-formaat) See below under POST Request (JSON) / Example Data
!!!groupId!!! De groeps-ID van het promotiemateriaal dat aan de conversieklik is gekoppeld 137726
!!!merchantId!!! De ID van het adverteerdersprogramma waartoe de transactie behoort 3661
!!!phrase!!! Zoekwoord voor zoekmachine Elektronische muziek
!!!products!!! Productuitsplitsing die bij de transactie hoort (in JSON-formaat) Zie hieronder onder POST Request (JSON)/voorbeeld van data
!!!searchEngine!!! Naam van zoekmachine Zoek met MSN Live
!!!transactionAmount!!! Totaal verkoopbedrag in de valuta van het adverteerdersprogramma (!!!transactionCurrency!!!) 26.09
!!!transactionDate!!! Transactiedatum in formaat %Y-%m-%d %H:%i:%s (tijdzone: UTC) 2013-06-13 12:05:00
!!!transactionId!!! Onze unieke transactie-ID 105956531
!!!url!!! Verwijzende klik-URL http://www.publisher-domain.com/advertiser/product/
!!!transactionCurrency!!! Valuta van het adverteerdersprogramma. Dit is de valuta van de affiliate-transactie (!!!transactionAmount!!! en !!!commission!!!). Dit is de valutacode in drie hoofdletters GBP
!!!trackedCurrency!!! De originele valuta waarin de koop werd voldaan. Dit is alleen beschikbaar als het een andere valuta betreft dan de valuta van het adverteerdersprogramma. Dit is de valutacode in drie hoofdletters EUR
!!!trackedAmount!!! De totale verkoopwaarde in de originele aankoopvaluta (!!!trackedCurrency!!!) 20.04


Voorbeeld URL

http://www.publisher-domain.com/!!!merchantId!!!/pixel.php?clk=!!!clickRef!!!&cnv=!!!transactionId!!!&com=!!!commission!!!


POST Request (JSON)

De transactiegegevens worden als een JSON-pakket naar de door u opgegeven URL aangeleverd, waarbij gebruik wordt gemaakt van een POST request genaamd AwinTransactionPush. Niet alle sleutels zijn voor alle transacties beschikbaar en verstuurd (clickRef2 is bijv. alleen beschikbaar voor de transactie indien deze in de winnende klik is doorgegeven).


Voorbeeld van data

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","commissie":"1.64","clickTime":"2013-06-13 12:00:00","url":"http:\/\/www.publisher-domain.com\/advertiser\/product\/","phrase":"Electronische muziek","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":"Electronische muziek","cgId":"47963"},{"productName":"Sigur Ros - Heima","unitPrice":"14.99","skuType":"","skuCode":"B000EMSUQA","quantity":"1","category":"Music DVD","cgId":"47965"}]}


JSON-gedecodeerde voorbeelddata

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 muziek"
  ["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 muziek"
      ["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) "Muziek-DVD"
      ["cgId"]=>
      string(5) "47965"
    }
  }
}


Indien u vragen heeft over de performance van deze feature, verzoeken wij u contact op te nemen met ons Technische team voor een status-update.

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