Antes de rastrear quaisquer eventos Javascript, você precisa incluir nosso snippet global.
Isso pode ser encontrado em Settings > Tracking Codes
na navegação.
Ele pode ser colocado em qualquer lugar da sua página e deve ser incluído apenas uma vez por página.
Rastreando Eventos de Conversão
Primeiramente, observe que nosso snippet global fornecido nas seções de origem e oferta já inclui um código de evento de conversão.
Se sua página é uma página de agradecimento onde você não se importa em rastrear uma visualização, apenas uma conversão, você pode usar este snippet para fazê-lo.
Este código contém espaços reservados para receita de conversão e ID de transação.
Ambos são opcionais -- se você não passar um valor de receita, ele usará o padrão da oferta. Se estiver usando uma rede de afiliados, você normalmente teria a origem da oferta injetando IDs de pagamento/transação dinâmicos no código (embora preferencialmente você usaria uma URL de postback).
Nota: no snippet que você recupera, dependendo da origem da oferta, haverá valores em MAIÚSCULAS que devem ser substituídos por valores reais, ou omitidos completamente se não forem conhecidos, por exemplo, CONVERSION_VALUE e assim por diante.
Código de Evento Javascript
Um evento de conversão básico pode ser acionado com:
flux.track("conversion", { rev:'REVENUE' })
Isso dependerá de cookies e da URL da página atual para determinar quem é o usuário -- ou seja, seu ID de visitante. Para esse visitante, a oferta mais recentemente criada é a que será convertida.
Este evento só pode ter sucesso se nosso snippet JS universal já tiver sido incluído anteriormente.
Você pode usar este código para acionar eventos manualmente, por exemplo, a partir de um clique em botão, envio de formulário, etc. Se você quiser disparar uma conversão no carregamento da página, inclua este código como está, mas depois do nosso snippet universal.
Se você quiser acionar eventos de conversão após algum clique, envio, etc., veja este documento que detalha o uso de alguns ouvintes de eventos básicos.
Parâmetros Adicionais
Dados adicionais, se disponíveis, podem ser injetados no evento de conversão. Todos os atributos devem ser passados como strings.
Os seguintes parâmetros estão disponíveis em eventos de conversão:
rev
-- receita, opcional, em dólares e centavos, por exemplo, 12.99. Se omitido, o padrão para a oferta em conversão é usado. Isso deve ser passado como uma string, então deve estar entre aspas.tx
-- ID da transação, opcionalp
-- ID da página, opcional, o ID da oferta (página) a que a conversão deve ser atribuída. Muitas vezes, não é a página atual, mas uma página anterior. Se omitido, a visualização de página de oferta mais recente para a sessão do usuário será convertidavid
-- o ID do visitante. Isso geralmente está presente na URL ou cookies, mas também pode ser injetado diretamentehit
-- o ID do hit da visualização da oferta a ser convertida. Geralmente não será a página atual, mas uma anterior. Se isso for conhecido, você provavelmente tem todas as informações necessárias para fazer uma chamada de postback servidor-a-servidor mais confiável. Se você está enviando hit, não deve enviar vid e vice-versa, pois são identificadores de usuário que competem entre si (hit é mais específico e será usado).
Por exemplo, um ID de transação e um ID de página conhecido (da oferta associada à conversão):
flux.track("conversion", { rev:'REVENUE', tx:'OPTIONAL_TRANSACTION_ID' p:'PAGE_ID' })
Se um sistema puder injetar hit ou ID do visitante diretamente, isso também pode ser feito para tornar o rastreamento mais confiável:
flux.track("conversion", { rev:'REVENUE', tx:'OPTIONAL_TRANSACTION_ID', vid:'VID', p:'PAGE_ID' })
O atributo hit também pode ser enviado, embora geralmente, se você conhece o ID do hit, pode simplesmente chamar uma URL de postback.
Se o ID do hit e o VID forem conhecidos, você pode escolher enviar um em vez de ambos.
É raro substituir o tempo de conversão em uma solicitação JS, mas é possível como abaixo:
flux.track("conversion", { rev:'REVENUE', conversion_time: "unix_timestamp" })
Recomendamos usar timestamps unix sempre que possível, embora alguns outros sejam analisáveis.
A Solicitação e Resposta da API
A solicitação da API enviada será semelhante à dos eventos de visualização, por exemplo:
Se bem-sucedido, a resposta conterá um ID de conversão, timestamp e mostrará o ID do hit que foi convertido, junto com algum contexto do evento: