Transaction Notification ES
From Wiki
Contents |
Notificación de la transacción
Ofrecemos a nuestros afiliados un sistema casi en tiempo real que garantiza el envío de una notificación al sistema del afiliado con toda la información relevante cada vez que se registra una transacción junto con los detalles de la misma.
Para tener acceso a esta característica primero debes tenerla activada, lo que se consigues enviando una petición desde la plataforma de Afiliado.
Configuración
- Encontrarás el link para las notificaciones de transacciónes en Avanzado una vez hayas activado esta característica
- Como se indica más abajo, hay cuatro formas de configuración que debes considerar:
Call-back URL: Es la ruta al script donde se enviarán los datos relevantes. Desde aquí, tu archivo tendrá que administrar la data personalizada y analizar los componentes del sistema que consideres necesarios. Por ejemplo, podría ser un archivo PHP en tu dominio, pero nuestras notificaciones de transacciones no está limitada sólo a PHP. Los puertos admitidos son el 80 y 443.
Método call-back: Aquí podrás escoges cómo quieres que se entreguen los datos. A continuación encontrarás ejemplos de cómo puedes usar cada uno.
Product Data: Marca esta casilla si deseas que se envíe información sobre los productos que se han comprados. Esto depende de las implementaciones que haya realizado el anuncinte en el Product Level Tracking - y además comparta de forma activa estos datos con sus afiliados - lo que puede no suceder siempre. (En caso de duda contacta con el account manager del programa.)
Click Source Data: Estos datos estarán relacionados con el link inicial en el que has hecho click, para serán los datos relacionados con el link inicial clicado para seguir el camino de la transacción realizada.
- Cuando hayas metido los datos correctos haz clic en Enviar. Entonces deberás ver una notificación indicando que Tus cambios han sido guardados con éxito.
Tipos de peticiones
Peticiones GET
Los datos de la transacción se entregarán como petición GET a la URL que has especificado y se pueden usar macros para modificar el camino o pedir parte de la URL para hacer una petición dinámica.
Macros
| Macro | Descripción | Ejemplo |
!!!affiliateId!!!
|
ID de afiliado asociado a la transacción | 45628 |
!!!bannerId!!!
|
ID creativo unido al click convertido | 291555 |
!!!clickRef!!!
|
Identificador de clic/impresión/referencia especificada por el afiliado. Consulte Click References | LINKCMP2013-06 |
!!!clickRef2!!!
|
Identificador de clic/impresión/referencia especificada por el afiliado. Consulte Click References | LINKCMP2013-06 |
!!!clickRef3!!!
|
Identificador de clic/impresión/referencia especificada por el afiliado. Consulte Click References | LINKCMP2013-06 |
!!!clickRef4!!!
|
Identificador de clic/impresión/referencia especificada por el afiliado. Consulte Click References | LINKCMP2013-06 |
!!!clickRef5!!!
|
Identificador de clic/impresión/referencia especificada por el afiliado. Consulte Click References | LINKCMP2013-06 |
!!!clickRef6!!!
|
Identificador de clic/impresión/referencia especificada por el afiliado. Consulte Click References | LINKCMP2013-06 |
!!!clickThroughTime!!!
|
Fecha de clic en formato %Y-%m-%d %H:%i:%s (zona horaria: UTC)
|
2013-06-13 12:00:00 |
!!!clickTime!!!
|
Fecha de clic en formato %Y-%m-%d %H:%i:%s (zona horaria: UTC)
|
2013-06-13 12:00:00 |
!!!commission!!!
|
Comisión total conseguida con la transacción | 1.64 |
!!!commissionGroups!!!
|
El desglose de los grupos de comisiones asociados con la transacción (en formato JSON) | See below under POST Request (JSON) / Example Data |
!!!groupId!!!
|
ID creativo unido al clic convertido | 137726 |
!!!merchantId!!!
|
ID de programa del anunciante al que pertenece la transacción | 3661 |
!!!phrase!!!
|
Frase del buscador | Música electrónica |
!!!products!!!
|
Desglose de productos asociado con la transacción (en formato JSON) | Ver a continuación bajo petición POST (JSON) / Datos de ejemplo |
!!!searchEngine!!!
|
Nombre del buscador | buscador MSN Live |
!!!transactionAmount!!!
|
Valor de la venta total en la moneda del programa del anunciante(!!!transactionCurrency!!!) | 26.09 |
!!!transactionDate!!!
|
Fecha de transacción en formato %Y-%m-%d %H:%i:%s (zona horaria: UTC)
|
2013-06-13 12:05:00 |
!!!transactionId!!!
|
Nuestro ID único de transacción | 105956531 |
!!!url!!!
|
URL del clic asistido | http://www.publisher-domain.com/advertiser/product/ |
!!!transactionCurrency!!!
|
Moneda del programa del anunciante. Esta es la moneda de la transacción del afiliado (!!!transactionAmount!!! y !!!commission!!!). Este es el código de la moneda en 3 dígitos en mayúsculas | GBP |
!!!trackedCurrency!!!
|
Moneda original en la que se ha realizado la compra. Esto solo está disponible si es una moneda diferente a la moneda del programa del anunciante. Este es el código de la moneda en 3 dígitos en mayúsculas | EUR |
!!!trackedAmount!!!
|
Cantidad total de venta en la moneda original de la compra (!!!trackedCurrency!!!) | 20.04 |
URL de ejemplo
http://www.publisher-domain.com/!!!merchantId!!!/pixel.php?clk=!!!clickRef!!!&cnv=!!!transactionId!!!&com=!!!commission!!!
Petición de POST (JSON)
Los datos de transacción serán entregados como un paquete JSON usando una petición POST nombrada AwinTransactionPush a la URL que hayas especificado. No todas las claves están disponibles y no se envían para todas las transacciones (p.e. clickRef2 sólo estará disponible para la transacción si ha pasado a ser el click ganador).
Ejemplo con datos
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","commisión":"1.64","clickTime":"2013-06-13 12:00:00","url":"http:\/\/www.publisher-domain.com\/advertiser\/product\/","phrase":"Música electrónica","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":"Música electrónica","cgId":"47963"},{"productName":"Sigur Ros - Heima","unitPrice":"14.99","skuType":"","skuCode":"B000EMSUQA","quantity":"1","category":"Music DVD","cgId":"47965"}]}
Ejemplo con datos JSON Descodificados
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) "Música electrónica"
["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) "Música electrónica"
["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) "DVD Musical"
["cgId"]=>
string(5) "47965"
}
}
}
Si tienes alguna duda con el funcionamiento de esta característica, ponte en contacto con nuestro Servicio Técnico para una actualización del estado.