Referência do SDK para navegador
O script tem uma superfície deliberadamente pequena: uma tag, um tipo de elemento, uma função.
Tag de script
| Atributo | Significado |
|---|---|
| src | O endereço do script exibido na sua página Integrações. |
| data-loop | A sua chave pública. Pública; funciona somente no seu domínio verificado. |
| async | Obrigatório. O script não pode bloquear a sua página. |
Elemento de espaço
| Atributo | Significado |
|---|---|
| data-loop-slot | Um nome para a posição, de até 64 caracteres. Aparece no seu relatório de posicionamentos. |
| data-loop-size | Opcional. Um entre 300x250, 320x50, 320x100, 728x90, 970x250, 160x600. Transforma o espaço em um banner. |
| data-loop-type | Opcional. recommendation (padrão sem tamanho), feed ou banner. |
Rastreando uma conversão
name é uma string de até 40 caracteres. props é um objeto plano opcional de strings, números e booleanos. A chamada é ignorada, a menos que o carregamento de página atual tenha chegado por meio de uma unidade.
loop('track', name, props?)Comportamento com o qual você pode contar
- Executa uma vez por página, não importa quantas vezes a tag seja incluída.
- Encontra espaços adicionados depois por navegação no lado do cliente.
- Renderiza cada unidade em um shadow root fechado: o seu CSS não pode afetá-la e ela não pode afetar a sua página.
- Nunca lança erros na sua página. Qualquer falha termina com o espaço vazio e recolhido.
- Reporta por sendBeacon com corpos text/plain, então nenhuma requisição preflight é feita.
Depuração
Adicione data-loop-debug a um espaço para abrir o shadow root dele para inspeção nas ferramentas de desenvolvedor. Na aba de rede, a primeira requisição é para /v1/config; um 200 significa que a chave e o domínio correspondem.