Skip to main content
Die Swift-Bibliothek von Topsort ermöglicht es unseren Kunden, Auktionsanfragen einfach zu senden und Ereignisse innerhalb von iOS-Apps zu verfolgen.
Mindestanforderungen: Swift-6-Toolchain (Xcode 16) und iOS 15.

Installation

Installieren Sie mit package.swift:

Konfiguration

Rufen Sie nach der Konfiguration Topsort.shared.set(opaqueUserId:) auf, sobald Sie eine eigene ID für den Nutzer haben, ob angemeldet oder nicht. Ohne eigene ID erzeugt das SDK eine ID und behält sie über App-Starts hinweg bei.

Auktionsanfragen

Ereignismeldung

Renders

Ein Render erfasst, dass eine gesponserte Anzeige in die View-Hierarchie eingefügt wurde, getrennt von der Impression, die erfasst, wann sie sichtbar wird. Melden Sie ihn, sobald die Anzeige auf dem Bildschirm platziert wird, vor der Impression. Renders gibt es nur für gesponserte Anzeigen, daher ist resolvedBidId erforderlich. winner ist einer der Gewinner in der Auktionsantwort (result.results[i].winners).
Topsort.shared sendet nur den ersten Render und die erste Impression jeder resolvedBidId pro Nutzer und verwirft jede Wiederholung. Daher können Sie sicher aus onAppear melden, wenn eine View wieder erscheint, zum Beispiel beim Scrollen einer Lazy-Liste.

Impressionen

Eine Impression erfasst, dass eine Anzeige oder ein Produkt für den Käufer sichtbar wurde.
Für organische Ergebnisse erstellen Sie das Ereignis stattdessen mit Event(entity: Entity(type: .product, id: product.id), occurredAt: Date.now).

Klicks

Ein Klick erfasst, dass der Käufer auf eine Anzeige oder ein Produkt geklickt hat.
Organische Klicks verwenden denselben Initialisierer Event(entity:occurredAt:) wie Impressionen.

Käufe

Ein Kauf erfasst die Produkte, die der Käufer gekauft hat. Topsort ordnet ihn den Anzeigen zu, mit denen der Käufer interagiert hat.

Anzeige von Bannern

TopsortBanner meldet den Render, wenn die Auktion einen Gewinner zurückgibt, die Impression, wenn das Bild geladen ist, und den Klick, wenn darauf getippt wird. Melden Sie diese Ereignisse für die von ihm angezeigten Banner nicht selbst. Für die vollständige Dokumentation besuchen Sie das GitHub-Repository.