Transaction Notification PT
From Wiki
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
- Você encontra o link de notificação de transação em Avançado após ativar este recurso
- 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.
- 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.