Transaction Notification FR

From Wiki

Jump to: navigation, search

Contents

Notification de transactions

Nous offrons à nos éditeurs une fonctionnalité de rapport en temps quasi-réel qui garantit l'envoi d'une notification au système de l'éditeur avec tous les détails associés à une transaction enregistrée.

Pour avoir accès à cette fonctionnalité, vous devez préalablement demander son activation en rédigeant un ticket sur votre interface éditeur et en indiquant l’objet de votre requête.


Configuration

  1. Une fois la fonctionnalité activée, vous trouverez le lien de notification de transactions sous l’onglet « Avancé ».

  2. Les quatre champs, décrits ci-dessous, doivent être renseignés :

    • URL call-back : URL vers laquelle le script devra envoyer les données. Votre fichier devra adapter les données afin de les intégrer au mieux dans votre système. Cela peut être, par exemple, un fichier PHP de votre nom de domaine mais nos notifications de transactions ne se limitent pas au format PHP. Les ports compatibles sont 80 et 443.

    • Méthode call-back : ici, vous pouvez choisir le mode de réception des données. Voir détails ci-dessous.

    • Données produits : cochez cette case si vous souhaitez recevoir des informations sur les produits achetés. La réception des données produits dépend du paramétrage de l'annonceur. Il est possible que celui-ci ne souhaite pas partager activement les données produits avec les éditeurs. (En cas de doute, contactez le gestionnaire du programme de l'annonceur.)

    • Informations clic-source : il s'agit d’informations relatives au premier lien cliqué à l’origine du parcours de la transaction effectuée.

  3. Après avoir correctement renseigné les champs, cliquez sur Envoyer. Un message doit ensuite s'afficher vous indiquant que ‘Vos modifications ont bien été enregistrées’.


Types de requête

Requête GET

Les données de transaction sont transmises, en tant que requête GET, à l'URL que vous avez spécifiée et des macros peuvent être utilisées pour modifier le chemin ou la partie requête de l'URL pour rendre la requête dynamique.

Macros

Macro Description Exemple
!!!affiliateId!!! ID éditeur associé à la transaction 45628
!!!bannerId!!! ID créatif lié au clic de conversion 291555
!!!clickRef!!! Clic/impression identificateur/référence spécifié par l'éditeur. Voir Références de clic Editeur LINKCMP2013-06
!!!clickRef2!!! Clic/impression identificateur/référence spécifié par l'éditeur. Voir Références de clic Editeur LINKCMP2013-06
!!!clickRef3!!! Clic/impression identificateur/référence spécifié par l'éditeur. Voir Références de clic Editeur LINKCMP2013-06
!!!clickRef4!!! Clic/impression identificateur/référence spécifié par l'éditeur. Voir Références de clic Editeur LINKCMP2013-06
!!!clickRef5!!! Clic/impression identificateur/référence spécifié par l'éditeur. Voir Références de clic Editeur LINKCMP2013-06
!!!clickRef6!!! Clic/impression identificateur/référence spécifié par l'éditeur. Voir Références de clic Editeur LINKCMP2013-06
!!!clickThroughTime!!! Clic date au format %Y-%m-%d %H:%i:%s (fuseau horaire : UTC) 2013-06-13 12:00:00
!!!clickTime!!! Clic date au format %Y-%m-%d %H:%i:%s (fuseau horaire : UTC) 2013-06-13 12:00:00
!!!commission!!! Montant de la commission perçue pour la transaction 1.64
!!!commissionGroups!!! Ventilation des groupes de rémunération associée à la transaction (au format JSON) Voir ci-dessous sous requête POST (JSON)/Exemple de données
!!!groupId!!! ID de groupe créatif lié au clic de conversion 137726
!!!merchantId!!! ID du programme de l'annonceur dont fait partie la transaction 3661
!!!phrase!!! Expression recherchée Musique électronique
!!!products!!! Ventilation des produits associée à la transaction (au format JSON) Voir ci-dessous sous requête POST (JSON)/Exemple de données
!!!searchEngine!!! Nom du moteur de recherche MSN Live Search
!!!transactionAmount!!! Montant total des ventes dans la devise du programme de l'annonceur (!!!transactionCurrency!!!) 26.09
!!!transactionDate!!! Date de la transaction au format %Y-%m-%d %H:%i:%s (fuseau horaire : UTC) 2013-06-13 12:05:00
!!!transactionId!!! Notre ID de transaction unique 105956531
!!!url!!! Clic renvoyant vers l'URL http://www.publisher-domain.com/advertiser/product/
!!!transactionCurrency!!! La devise du programme de l'annonceur. Il s'agit de la devise utilisée par l'affilié pour les transactions (!!!montantTransaction!!!) et !!!commission!!!). Il s'agit du code de la devise à trois caractères en majuscules GBP
!!!trackedCurrency!!! Devise originale dans laquelle l'achat est effectué. Cela n'est disponible que si la devise est différente de celle utilisée dans le programme de l'annonceur. Il s'agit du code de la devise à trois caractères en majuscules EUR
!!!trackedAmount!!! Montant total des ventes dans la devise d'achat originale (!!!trackedCurrency!!!) 20.04


Exemple URL

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


Requête POST (JSON)

Les données de transactions sont délivrées à l'URL que vous avez spécifiée sous la forme d'un package JSON via une requête POST appelée AwinTransactionPush. Les clés ne sont pas toutes disponibles et envoyées pour toutes les transactions (par ex. clickRef2 est disponible uniquement pour les transactions passées dans le clic gagnant).


Exemple données

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


Exemple de données JSON décodées

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


Si vous avez le moindre souci de performance avec cette fonctionnalité, veuillez contacter le Service technique pour obtenir un rapport de situation.

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