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âmetros | Descrição |
|---|---|
apiKey | ID interno de identificação da sua loja. |
secretKey | Chave 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. |
deviceId | Identificador único do dispositivo. Todas as requisições feitas a partir do mesmo dispositivo devem possuir o mesmo deviceId. |
trackingId | Identificador único de tracking. Fornecido em cada produto da vitrine. |
interactionType | Tipo 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 dedeviceId. Este campo é disponibilizado pelos scripts de coleta no domínio do lojista, no cookiechaordic_browserId. - Se a coleta de eventos for chamada via API, o gerenciamento do
deviceIddeve 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" \
-