Transaction Notification PT

From Wiki

Jump to: navigation, search

Contents

Notificação de transação

Nós oferecemos aos nossos afiliados um recurso de informação praticamente em tempo real, que garante que toda vez que uma transação é registrada, uma notificação seja enviada ao sistema do afiliado com todos os detalhes relevantes associados à transação.

Para obter acesso a este recurso, primeiro você precisa ativá-lo, o que é feito abrindo um ticket a partir da sua Interface do Afiliado, descrevendo o pedido.


Configuração

  1. Você encontra o link de notificação de transação em Avançado após ativar este recurso

  2. Como descrito abaixo, há quatro configurações que precisam ser consideradas:

    • URL de retorno: este é o caminho para o script para o qual os dados relevantes serão enviados. A partir daqui, o seu arquivo terá que administrar de maneira individualizada os dados e analisá-los em comparação aos componentes do seu sistema que você considera necessários. Isto poderia, por exemplo, ser um arquivo PHP no seu domínio respectivo, mas as nossas notificações de transação não se limitam ao PHP. As portas suportadas são 80 e 443.

    • Método de retorno: aqui você pode escolher como você quer que os dados sejam entregues. Veja abaixo os exemplos de como você pode utilizar cada um.

    • Dados do produto: marque esta caixa se você deseja que os dados sobre os produtos comprados sejam retornados. Isto depende do afiliado implementar o Tracking de Nível de Produto - e além disso, deverá compartilhar ativamente estes dados com os afiliados - o que nem sempre acontece. (Caso tenha dúvidas, entre em contato com a pessoa responsável pela conta do programa do anunciante.)

    • Dados fonte de cliques: estes serão dados relacionados ao link inicial clicado para começar o caminho para a transação que aconteceu.

  3. Após inserir os dados corretamente, clique em Enviar. Você deverá então ver uma mensagem notificando que as Suas alterações foram salvas com êxito.


Tipos de Solicitação

Solicitação GET

Os dados da transação serão enviados como uma solicitação GET para a URL que você especificou e macros podem ser utilizados para modificar o caminho ou para solicitar parte da URL para dinamizar uma solicitação.

Macros

Macro Descrição Exemplo
!!!affiliateId!!! O ID do afiliado associado à transação 45628
!!!bannerId!!! O ID criativo associada ao click de conversão 291555
!!!clickRef!!! Identificador/referência de clique/impressão especificada pelo afiliado. Consulte Referências de Cliques LINKCMP2013-06
!!!clickRef2!!! Identificador/referência de clique/impressão especificada pelo afiliado. Consulte Referências de Cliques LINKCMP2013-06
!!!clickRef3!!! Identificador/referência de clique/impressão especificada pelo afiliado. Consulte Referências de Cliques LINKCMP2013-06
!!!clickRef4!!! Identificador/referência de clique/impressão especificada pelo afiliado. Consulte Referências de Cliques LINKCMP2013-06
!!!clickRef5!!! Identificador/referência de clique/impressão especificada pelo afiliado. Consulte Referências de Cliques LINKCMP2013-06
!!!clickRef6!!! Identificador/referência de clique/impressão especificada pelo afiliado. Consulte Referências de Cliques LINKCMP2013-06
!!!clickThroughTime!!! Clique data no formato %Y-%m-%d %H:%i:%s (fuso horário: UTC) 2013-06-13 12:00:00
!!!clickTime!!! Clique data no formato %Y-%m-%d %H:%i:%s (fuso horário: UTC) 2013-06-13 12:00:00
!!!commission!!! Valor da comissão atribuída à transação 1.64
!!!commissionGroups!!! Detalhamento do grupo de comissão associado à transação (em formato JSON) See below under POST Request (JSON) / Example Data
!!!groupId!!! A ID do grupo de criativos associados ao click de conversão 137726
!!!merchantId!!! O ID do programa do anunciante ao qual a transação pertence 3661
!!!phrase!!! Frase do mecanismo de pesquisa Música eletrônica
!!!products!!! Detalhamento de produto associada à transação (em formato JSON) Ver abaixo em Pedido de POST (JSON)/Exemplo Dados
!!!searchEngine!!! Nome do mecanismo de pesquisa MSN Live Search
!!!transactionAmount!!! Valor total da venda na moeda do programa do anunciante (!!!transactionCurrency!!!) 26.09
!!!transactionDate!!! Data da transação no formato %Y-%m-%d %H:%i:%s (fuso horário: UTC) 2013-06-13 12:05:00
!!!transactionId!!! Nosso ID de transação exclusiva 105956531
!!!url!!! URL do clique relacionado http://www.publisher-domain.com/advertiser/product/
!!!transactionCurrency!!! A moeda do programa do anunciante. Esta é a moeda da transação afiliada (!!!transactionAmount!!! e !!!commission!!!). Este é o código da moeda em caixa alta com 3 dígitos GBP
!!!trackedCurrency!!! A moeda original em que a compra foi feita. Isto só é disponibilizado se for uma moeda diferente comparada à moeda do programa do anunciante. Este é o código da moeda em caixa alta com 3 dígitos EUR
!!!trackedAmount!!! O valor total da venda na moeda original em que a compra foi feita.(!!!trackedCurrency!!!) 20.04


Exemplo de URL

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


Solicitação de POST (JSON)

Os dados da transação serão enviados como pacote JSON usando uma solicitação POST chamada de AwinTransactionPush para a URL que você especificou. Nem todas as chaves são disponíveis e enviadas para todas as transações (exemplo: clickRef2 só está disponível para a transação se ela for passada no clique vencedor).


Exemplo de Dados

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


Dados de exemplo JSON decodificado

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 eletrô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 eletrô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 de Música"
      ["cgId"]=>
      string(5) "47965"
    }
  }
}


Se você tiver perguntas a respeito do funcionamento deste recurso, entre em contato com os Serviços Técnicos para uma atualização de status.

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