Référence du SDK navigateur
Le script a volontairement une surface réduite : une balise, un type d’élément, une fonction.
Balise script
| Attribut | Signification |
|---|---|
| src | L’adresse du script affichée sur votre page Intégrations. |
| data-loop | Votre clé publiable. Publique ; ne fonctionne que sur votre domaine vérifié. |
| async | Obligatoire. Le script ne doit pas bloquer votre page. |
Élément d’emplacement
| Attribut | Signification |
|---|---|
| data-loop-slot | Un nom pour la position, 64 caractères au maximum. Il apparaît dans votre rapport d’emplacements. |
| data-loop-size | Facultatif. Une valeur parmi 300x250, 320x50, 320x100, 728x90, 970x250, 160x600. Transforme l’emplacement en bannière. |
| data-loop-type | Facultatif. recommendation (par défaut sans taille), feed ou banner. |
Suivre une conversion
name est une chaîne de 40 caractères au maximum. props est un objet plat facultatif de chaînes, de nombres et de booléens. L’appel est ignoré si le chargement de page en cours n’est pas arrivé via une unité.
loop('track', name, props?)Comportement sur lequel vous pouvez compter
- S’exécute une fois par page, quel que soit le nombre d’inclusions de la balise.
- Repère les emplacements ajoutés plus tard par la navigation côté client.
- Affiche chaque unité dans un shadow root fermé : votre CSS ne peut pas l’affecter et elle ne peut pas affecter votre page.
- Ne lève jamais d’exception dans votre page. Toute défaillance se termine par un emplacement vide et replié.
- Rapporte via sendBeacon avec des corps text/plain ; aucune requête de préliminaire n’est donc effectuée.
Débogage
Ajoutez data-loop-debug à un emplacement pour ouvrir son shadow root à l’inspection dans les outils de développement. Dans l’onglet réseau, la première requête va vers /v1/config ; un 200 signifie que la clé et le domaine correspondent.