Eventos de Clique

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 API contém o campo link, pré computado com a URL de destino do click. Através dela, serão registrados todos os eventos de clique dos usuários da aplicação nos respectivos produtos apresentados. É 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.

JSON

 "link": "https://api-ads.percycle.com/click/?hash=CLICK_LONG_STRING"

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, utilizando a própria tag <a> do produto, por exemplo. Após o clique, o evento será lançado e o usuário será redirecionado para a página de produto.

HTML

<a href="https://api-ads.percycle.com/click/?hash=CLICK_LONG_STRING"> </a>

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

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: <user-id>' \

Você pode modificar o comportamento do retorno do clique, utilizando o parâmetro redirect=0. Com ele a request retorna o status code 200 e não o 302 (redirect para a página do produto).

Edit this page on GitHub

Ads/v.gif

Ads/c.gif

link attribute location

{
  "v": 2,
  "data": [
    {
      //widget info...
      "data": [
        {
          //trigger on product click
          "link": "https://api-ads.percycle.com/click/?hash=CLICK_LONG_STRING",
          //product info...
        },
        {
          //trigger on product click
          "link": "https://api-ads.percycle.com/click/?hash=CLICK_LONG_STRING",
          //product info...
        },
        {
          //trigger on product click
          "link": "https://api-ads.percycle.com/click/?hash=CLICK_LONG_STRING",
          //product info...
        }
      ]
    }
  ]
}