Transaction Notification NL
From Wiki
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
- Wanneer u deze mogelijkheid hebt geactiveerd, staat de link "Transactienotificatie" onder het tabblad Geavanceerd
- 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.
- 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.