Skip to main content
La bibliothèque publique analytics.js de Topsort permet aux marketplaces d’envoyer facilement des événements d’interaction Topsort, tels que les clics, les impressions et les achats, avec une intégration low-code. En utilisant une simple balise HTML, la marketplace peut se connecter au serveur publicitaire de Topsort et envoyer tous les événements de suivi liés à une publicité.

Installation

Chargez la bibliothèque avec une balise <script>, en définissant window.TS avant le chargement de la bibliothèque :

Avec npm

Les imports s’exécutent avant le reste d’un module : définissez donc window.TS dans un fichier séparé et importez ce fichier en premier :
Ne remplacez pas window.TS une fois la bibliothèque chargée. Pour définir le token plus tard, affectez plutôt window.TS.token.

Marquage des éléments promus

Pour permettre à Topsort de suivre automatiquement les clics, les impressions et les achats, utilisez l’élément HTML data-ts-* pour marquer les éléments promus dans la page.

Éléments organiques (non promus)

Éléments promus

Suivi des renders

La bibliothèque signale un événement de render dès qu’un élément promu est inséré dans la page, puis une impression, lorsque cet élément devient visible. Les renders utilisent le même attribut data-ts-resolved-bid, aucun balisage supplémentaire n’est donc nécessaire :
Les renders nécessitent un resolvedBidId explicite. Ils ne sont donc pas déclenchés pour les éléments organiques ni pour data-ts-resolved-bid="inherit". Ne signalez pas en plus les renders, les impressions ou les clics de ces éléments avec un SDK Topsort, sinon ils sont comptés deux fois.

Zones cliquables

Utilisez data-ts-clickable pour indiquer quelles zones doivent déclencher un événement de clic :

Attribution de bannière

Sur la page de destination de la bannière, marquez chaque produit mis en avant dans la bannière afin que ses événements soient attribués à la bannière :

Suivi des achats

Utilisez le tableau JSON data-ts-items pour suivre les achats :

Exemple complet

Cet exemple utilise également banners.js pour la balise topsort-banner.