Skip to main content
Die öffentliche analytics.js-Bibliothek von Topsort ermöglicht es Marktplätzen, Topsort-Interaktionsereignisse wie Klicks, Impressionen und Käufe mit einer Low-Code-Integration einfach zu senden. Mit einem einfachen HTML-Tag kann sich der Marktplatz mit dem Werbeserver von Topsort verbinden und alle Tracking-Ereignisse im Zusammenhang mit einer Anzeige senden.

Installation

Laden Sie die Bibliothek mit einem <script>-Tag und setzen Sie window.TS, bevor die Bibliothek geladen wird:

Mit npm

Importe werden vor dem restlichen Code eines Moduls ausgeführt. Setzen Sie window.TS daher in einer separaten Datei und importieren Sie diese Datei zuerst:
Ersetzen Sie window.TS nicht, nachdem die Bibliothek geladen wurde. Um den Token später zu setzen, weisen Sie stattdessen window.TS.token zu.

Kennzeichnung beworbener Elemente

Um Topsort die automatische Verfolgung von Klicks, Impressionen und Käufen zu ermöglichen, verwenden Sie das HTML-Element data-ts-*, um beworbene Elemente auf der Seite zu kennzeichnen.

Organische Elemente (nicht beworben)

Beworbene Elemente

Render-Tracking

Die Bibliothek meldet ein Render-Ereignis, sobald ein beworbenes Element in die Seite eingefügt wird, und später eine Impression, wenn dieses Element sichtbar wird. Renders verwenden dasselbe Attribut data-ts-resolved-bid, daher ist kein zusätzliches Markup erforderlich:
Renders erfordern eine explizite resolvedBidId und werden daher weder für organische Elemente noch für data-ts-resolved-bid="inherit" ausgelöst. Melden Sie Renders, Impressionen oder Klicks für diese Elemente nicht zusätzlich mit einem Topsort SDK, da sie sonst doppelt gezählt werden.

Klickbare Bereiche

Verwenden Sie data-ts-clickable, um anzugeben, welche Bereiche ein Klick-Ereignis auslösen sollen:
Markieren Sie auf der Zielseite des Banners jedes im Banner beworbene Produkt, damit dessen Ereignisse dem Banner zugeordnet werden:

Kaufverfolgung

Verwenden Sie das JSON-Array data-ts-items, um Käufe zu verfolgen:

Vollständiges Beispiel

Dieses Beispiel verwendet zusätzlich banners.js für das Tag topsort-banner.