Transaction Notification ES

From Wiki

Jump to: navigation, search

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

  1. Encontrarás el link para las notificaciones de transacciónes en Avanzado una vez hayas activado esta característica


  2. 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.

  3. 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.

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