Eventos de Clique

Cada produto recomendado pela API contém um campo chamado trackingUrl.

Este campo fornece uma url que deverá ser usada para registrar todos os eventos de interações dos usuários da aplicação com os produtos recomendados. É por meio destes registros que geramos métricas de performance das vitrines, além de melhorar as estratégias para acertar em cheio cada recomendação ;)

Para garantir o envio do click, evitando que o browser cancele a requisição caso a página de produto seja carregada antes que o disparo, recomendamos duas implementações:
  • Disparar o evento de click somente depois que o usuário acessar a página do produto
  • Para browsers mais novos, utilizar a Beacon API
ParâmetrosDescrição
apiKeyID interno de identificação da sua loja.
secretKeyChave de acesso para autenticar a requisição. Pode ser substituída pelo parâmetro origin quando a requisição é feita via frontend para não expor a chave.
deviceIdIdentificador único do dispositivo. Todas as requisições feitas a partir do mesmo dispositivo devem possuir o mesmo deviceId.
trackingIdIdentificador único de tracking. Fornecido em cada produto da vitrine.
interactionTypeTipo de interação do clique. Os tipos suportados são: PRODUCT_VIEW e ADD_TO_CART.

Basta disparar uma requisição GET contendo a URL pré montada do atributo trackingUrl correspondente ao produto clicado pelo usuário.

  • Caso a coleta de eventos seja realizada pelos nossos scripts (através do window.linxMeta), é necessário que seja utilizado o mesmo valor correspondente de deviceId. Este campo é disponibilizado pelos scripts de coleta no domínio do lojista, no cookie chaordic_browserId.
  • Se a coleta de eventos for chamada via API, o gerenciamento do deviceId deve ser feito pelo lojista.
CURL
curl -v -G "https://recs.chaordicsystems.com/v0/click" \
  -d trackingId="CghuZXRzaG9lcxIEaG9tZRoJYW5vbi10ZXN0IgR0ZXN0KgdkZXNrdG9wMgN0b3A6JDZmOTg3OGRjLWMwMzAtZGUxNy0zZGE2LTEyMmZhMDExY2U1N0IMRDEyLTIzOTQtMDUwSgEx" \
  -d apiKey="<my-apikey>" \
  -d source="<my-source>" \
  -d deviceId="<my-device-id>" \
  -d userId="<my-user-id>" \
  -d interactionType="<my-interactionType>" \
  -H "Origin: www.meusite.com" \
  -