Essa seção representa a ação de clique nos produtos apresentados na vitrine.
Após visualização, o usuário deve interagir com a vitrine. Para registrar essa interação, utilizamos a rota de click. Cada produto do resultado da interação do clique na vitrine, contém o campo link.
Este campo fornece a URL de destino do click no retorno da API. Através dela, será registrado todos os eventos de click dos usuários da aplicação com os produtos. É por meio destes registros que geramos métricas de performance da vitrine, além de melhorar as estratégias para acertar de forma precisa, cada resultado.
Veja um exemplo do campo link, conforme mencionado:
"link": "https://api-ads.percycle.com/click/?hash=CLICK_LONG_STRING"
Abaixo, é possível localizar o campo link no exemplo de resposta da API. Está inserido no atributo data.
{
"v": 2,
"data": [
{
"widget": "native",
"px": "https://api-ads.percycle.com/v.gif?hash=WIDGET_LONG_STRING",
"data": [
{
"link": "https://api-ads.percycle.com/click/?hash=CLICK_LONG_STRING",
"px": "https://api-ads.percycle.com/v.gif?hash=PRODUCT_LONG_STRING",
"installment": {
"months": 2,
"amount": {
"formattedValue": "R$39,95",
"value": "39.95",
"integerPart": 39,
"decimalPart": 95,
"currencySymbol": "R$",
"currencyCode": "BRL",
"thousandSeparator": ".",
"decimalSeparator": ","
}
},
"hasSuperAds": "0",
"hasRetarget": "1",
"price": {
"formattedValue": "R$99,90",
"value": "99.90",
"integerPart": 99,
"decimalPart": 9,
"currencySymbol": "R$",
"currencyCode": "BRL",
"thousandSeparator": ".",
"decimalSeparator": ","
},
"imageLink": "http://example.product.com.br/1.jpg",
"salePrice": {
"formattedValue": "R$79,90",
"value": "79.90",
"integerPart": 79,
"decimalPart": 9,
"currencySymbol": "R$",
"currencyCode": "BRL",
"thousandSeparator": ".",
"decimalSeparator": ","
},
"customFields": {},
"discount": {
"value": "20",
"symbol": "%",
"formattedValue": "20%"
},
"title": "Título do produto",
"description": "Descrição longa do produto",
"categories": [
"informatica",
"notebooks"
],
"brand": "Marca do produto",
"id": "ID-DO-PRODUTO",
"seller": "publisher"
}
]
}
]
}
Implementando Via FrontEnd
Para realizar um clique no frontend basta chamar o link disponível na API quando o usuário clicar no card de produto. Após o clique, o evento será lançado e o usuário será redirecionado para a página de produto.
Exemplo em HTML:
<a href="https://api-ads.percycle.com/click/?hash=CLICK_LONG_STRING"> </a>
Implementando Via BackEnd
Em caso de desenvolvimento via backend, precisamos que a chamada seja feita nos enviando o header X-User-Id. Ao clicar no produto patrocinado, é atribuído a URL conforme exemplo abaixo.
curl 'https://api-ads.percycle.com/click/?hash=CLICK_LONG_STRING' \
-H 'Accept: application/json, text/plain, */*' \
-H 'Referer: dominio.com.br' \
-H 'User-Agent: axios/1.3.5 ou http/456' \
-H 'X-User-Id: userID' \
O parâmetro redirect=0 é opcional. Com ele a request retorna o status code 200 e não o 302 (redirect para a página do produto).
Após atribuição, será computado o clique na vitrine.
Agora que você aprendeu como funciona o click, vamos entender como funciona o evento da página de conclusão de pedido.