Transaction Notification FR
From Wiki
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
- Une fois la fonctionnalité activée, vous trouverez le lien de notification de transactions sous l’onglet « Avancé ».
- 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.
- 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.