Advertiser Offline Tracking PT

From Wiki

Jump to: navigation, search

Contents

Introdução

O processamento de transações offline é um sistema da Awin para processar transações de afiliados sem o uso de cookies ou código de tracking na página de confirmação.

Captura dos dados da jornada

Este sistema requer que o anunciante capture diversos valores relacionados ao clique do usuário, e os armazene até o ponto em que a venda seja concluída. Os detalhes são encaminhados à Awin com todos os dados da transação por um arquivo CSV.

O anunciante precisa capturar os seguintes valores no momento do clique:

  • Affiliate id (Capturado de parâmetros da URL como utm_medium, utm_campaign ou qualquer outro, alinhar com seu contato técnico). OBRIGATÓRIO
  • Click date (Formato (BST): dd/mm/aaaa hh:mm:ss) OBRIGATÓRIO
  • Group id (Capturado da URL de reencaminhamento do clique) | OPCIONAL
  • Banner id (Capturado da URL de reencaminhamento do clique) | OPCIONAL
  • Product id (Capturado da URL de reencaminhamento do clique) | OPCIONAL
  • Click ref (Capturado da URL de reencaminhamento do clique) | OPCIONAL

Relatorios

Quando a transação é concluída, os valores que foram armazenados no momento do click precisam ser resgatados e direcionados para um arquivo único que também irá conter informações sobre as transações.

Quando o anunciante encaminha a transação para a Awin, as informações de cada transação precisam ser adicionadas a um arquivo CSV. Cada linha do arquivo contém detalhes de uma única transação.

O arquivo CSV precisa ser formatado no formato abaixo, usando vírgula como delimitador:

COL 1:  com_date (Esta é a data da transação (BST) e deve seguir o formato: dd/mm/aaaa hh:mm:ss)
COL 2:  order_ref (Este é o ID do pedido)
COL 3:  sale_amount (Este é o total pago pelo usuário, desconsiderando frete ou taxas adicionais)
COL 4:  type (Deve ser deixado em branco)
COL 5:  parts (Deve receber o grupo de comissão e o total gasto neste grupo no seguinte formato: commission_group_code:sale_amount, um exemplo é dado no próximo tópico deste guia)
COL 6:  merchant_customer_id (Deve ser deixado em brando)
COL 7:  affiliate_id (ID do afiliado resgatado da URL no momento do clique)
COL 8:  click_date (Data do clique resgatada no momento do clique, deve seguir o seguinte formato (BST): dd/mm/aaaa hh:mm:ss)
COL 9:  group_id (Pode ser deixado em branco se não for usado) OPCIONAL
COL 10: banner_id (Pode ser deixado em branco se não for usado) OPCIONAL
COL 11: product_id (Pode ser deixado em branco se não for usado) OPCIONAL
COL 12: click_ref (Pode ser deixado em branco se não for usado) OPCIONAL
COL 13: status (Informar o status do pedido, utilizar "pending" para pedidos pendentes e "confirmed" para pedidos confirmados)
COL 14: voucher_code (Cupom de desconto utilizado na transação ou deixe em branco caso não tenha sido utilizado) OPCIONAL
COL 15: user agent (Deixar em branco)
COL 16: awc (Deixar em branco)

Abaixo está um exemplo de como o arquivo CSV deve ficar:

com_date,order_ref,sale_amount,type,parts,merchant_customer_id,affiliate_id,click_date,group_id,banner_id,product_id,click_ref,status,voucher_code
05/07/2007 19:25:55,124749,89.99,,default:89.99,,45628,03/07/2007 19:25:55,12345,47895,12547895,abc123,pending,
06/07/2007 15:45:52,124851,50,,default:50,,45628,02/07/2007 15:45:52,12348,58745,45782698,def345,confirmed,FREEDELIVERY
07/07/2007 11:15:23,124967,48.79,,default:48.79,,45628,05/07/2007 11:15:23,15489,68954,58314967,ghi678,confirmed,10OFFGADGETS
11/11/2015 12:34:56,124967,48.79,,default:48.79,,45628,10/11/2015 09:30:00,15489,68954,58314967,ghi678,confirmed,10OFFGADGETS,"Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2228.0 Safari/537.36",1001_1447147800_2aeff1ef22119c6dbc699bcc174ec544


Grupos de Comissão, Coluna 5 "parts"

Se você utiliza somente uma estrutura de comissionamento, utilize o seguinte formato para a coluna parts:

DEFAULT:sale_amount


Caso você conte com múltiplas estruturas de comissão na plataforma Awin, por exemplo, comissões diferentes por categoria de produtos, então, você precisará separar os valores da coluna "parts" por um delimitador de tubo |, por exemplo:

Se um usuário faz uma compra com dois produtos, um produto de R$ 25.00 na categoria "Sapatos", e outro produto de R$ 30.00 na categoria "Camisas", a coluna parts deve receber os seguintes valores:

SAPATOS:25.00|CAMISAS:30.00


E neste caso, a coluna 3 "sale_amount", deve receber o valor 55.00. Pois a soma dos valores dos grupos de comissão precisa corresponder ao total dentro da coluna "sale_amount".

Exemplo

Aqui você pode encontrar um arquivo de exemplo

Frequencia atualização

O arquivo de transação offline pode ser extraído de um local online em intervalos definidos (Diariamente, Duas vezes por dia, Semanalmente). Quando definido como 'Diário', o Sistema Awin extrai do local fornecido às 4:00 GMT / UTC. Quando definido como 'Duas vezes por dia', o arquivo é extraído às 04:30 e 16:30 GMT / UTC) e, quando definido como 'Semanalmente', é extraído às quartas-feiras às 05:00 GMT / UTC.

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