Skip to main content
La bibliothèque Swift de Topsort permet à nos clients d’envoyer facilement des requêtes d’enchères et de suivre les événements au sein des applications iOS.
Configuration minimale requise : chaîne d’outils Swift 6 (Xcode 16) et iOS 15.

Installation

Installez en utilisant package.swift :

Configuration

Appelez Topsort.shared.set(opaqueUserId:) après la configuration chaque fois que vous disposez de votre propre identifiant pour l’utilisateur, qu’il soit connecté ou non. Sans identifiant, le SDK en génère un et le conserve d’un lancement à l’autre.

Requêtes d’enchères

Signalement des événements

Renders

Un render enregistre qu’une publicité sponsorisée a été insérée dans la hiérarchie de vues, indépendamment de l’impression, qui enregistre le moment où elle devient visible. Signalez-le dès que la publicité est placée à l’écran, avant l’impression. Les renders concernent uniquement les publicités sponsorisées, c’est pourquoi resolvedBidId est obligatoire. winner est l’un des gagnants de la réponse d’enchère (result.results[i].winners).
Topsort.shared n’envoie que le premier render et la première impression de chaque resolvedBidId pour un utilisateur et ignore toute répétition. Il est donc sans risque de signaler depuis onAppear lorsqu’une vue réapparaît, par exemple lors du défilement d’une liste lazy.

Impressions

Une impression enregistre qu’une publicité ou un produit est devenu visible pour l’acheteur.
Pour les résultats organiques, construisez plutôt l’événement avec Event(entity: Entity(type: .product, id: product.id), occurredAt: Date.now).

Clics

Un clic enregistre que l’acheteur a cliqué sur une publicité ou un produit.
Les clics organiques utilisent le même initialiseur Event(entity:occurredAt:) que les impressions.

Achats

Un achat enregistre les produits achetés par l’acheteur. Topsort l’attribue aux publicités avec lesquelles l’acheteur a interagi.

Affichage des bannières

TopsortBanner signale le render lorsque l’enchère renvoie un gagnant, l’impression lorsque l’image se charge et le clic lorsque l’utilisateur appuie dessus. Ne signalez pas vous-même ces événements pour les bannières qu’il affiche. Pour la documentation complète, consultez le dépôt GitHub.