Advertiser Offline Tracking PT
From Wiki
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.