Essa seção representa o evento de conversão após concluir os pedidos.
Após realizar o clique no produto, o usuário será direcionado para a página de produto ou para o carrinho. Caso o usuário finalize o pedido, torna-se necessário coletar o evento c.gif gerado na página de conclusão do pedido. Através deste evento, será registrado a compra e consequentemente, as métricas de performance de conversão.
Este evento torna-se necessário para todas as compras que acontecerem em sua loja.
Abaixo, está um exemplo do evento de conversão:
Evento de Conversão:
curl -vvv --request GET \
--url 'https://api-ads.percycle.com/c.gif?conv=%7B%22tId%22%3A%22pedidoIdFinalClick%22%2C%22currency%22%3A%22BRL%22%2C%22products%22%3A%5B%7B%22sku%22%3A%22Z410024151VRD_PRD%22%2C%22price%22%3A59%2C%22qty%22%3A1%7D%5D%2C%22total%22%3A59%7D&cUID=userIdHash2' \
-header 'X-Api-Key: 9cd47ce45255e09c1356a8d539f46eb8a23288aa09a9b920242566564bb6e67b'
Nesse evento, são passados 2 parâmetros e 1 header. Veja abaixo seu detalhamento:
- Parâmetro
cUID: É o userID enviado nas chamadas da API de Onsite e Evento de Click do Produto Patrocinado. Ele aparece logo após o conv. - Parâmetro
conv: Esse parâmetro é o json string com as informações do pedido. - Header
X-Api-Key: É o token de autenticação para o envio da conversão. É o mesmo apresentado na chamada da API.
Importante: As request's geradas corretamente, devem retornar como 200. Observe que o response da request virá como um GIF. Não se preocupe, a conversão foi enviada corretamente.
Isso ocorre devido a nossa tecnologia. É chamado um GIF após a request, para ser inserido as informações sem ocorrer uma negativa de extensões de terceiros, como o adblock. Dessa forma, garantimos que a request, se preenchida corretamente, sempre será capturada.
Implementando a Conversão
O processo de implementação será dividido em duas partes. Primeiro, será necessário inserir as informações do pedido. Por fim, realizar o encode para ser utilizado como parâmetro no conv.
1 - Utilize o código abaixo. Copie e altere as informações do pedido.
const conversao =
{
tId: "12345",
currency: "BRL",
products: [
{
sku: "Z410025421",
price: 100,
qty: 1,
sellerId:'Linx'
}
],
total: 100
}
Veja que está sendo passado as seguintes informações referente ao pedido:
tID: Número do pedido. Utilize o mesmo número exibido para o cliente na conclusão da compra.currency: Moeda do país. Exemplo: BRL, USD, EUR.products: Informações dos produtos que foram comprados.sku: ID do produto.price: Valor do produto.qty: Quantidade do produto.sellerId: Seller do produto. (É obrigatório caso o produto seja vendido por outro Seller[3P])
total: Total do pedido.
2 - Após realizar as alterações, será necessário gerar as funções JSON.stringfy e encodeURIComponent para encodar o objeto.
Isso pode ser feito tanto em seu código, quanto através do console.
Para realizar esse procedimento, basta utilizar o código abaixo:
const conv = encodeURIComponent(JSON.stringify(conversao))
Em seguida, copie o que foi gerado e insira logo abaixo no path params conv.