SDK
SDK Traqio : lequel choisir, et ce que fait chacun
Neuf SDK pour apps iOS et Android, et pour les sites un SDK navigateur et des SDK serveur Node.js, PHP et Python — et ce que chacun fait aujourd’hui.
Un SDK Traqio est la bibliothèque que votre app embarque pour que Traqio puisse attribuer ses installations et mesurer ce qui se passe ensuite. Chaque SDK fait les trois mêmes tâches : il signale l’installation une seule fois avec la preuve que sa plateforme fournit (l’Install Referrer de Google Play sur Android, SKAdNetwork sur iOS), il met en file d’attente les événements que vous suivez et les envoie par lots qui survivent aux redémarrages et aux réseaux instables, et il résout les deep links issus des liens de tracking Traqio. Aucun ne fait de fingerprinting de l’appareil, et aucun ne lit d’identifiant publicitaire sauf si vous l’activez (iOS, Android et React Native pour l’instant).
Choisir selon la façon dont votre app est construite#
Utilisez un seul SDK Traqio par app : deux signaleraient chacun l’installation et compteraient chaque événement deux fois.
Pour un site web#
Un site web prend deux SDK, un par moitié : le SDK navigateur garde le click id de la pub de la page d’arrivée jusqu’au formulaire d’inscription, et un SDK serveur sur votre backend signale l’inscription avec lui — l’attribution web explique la chaîne, et le démarrage rapide web la met en place.
Chaque moitié prend sa propre clé, jamais celle de l’app : une clé web publique pour le navigateur, une clé serveur secrète pour le backend. Les événements web et les conversions serveur ne sont jamais rattachés à une installation d’app.
Ce que chaque SDK prend en charge aujourd’hui#
Mesuré dans le code de chaque SDK, pas promis. Une fois : l’Install Referrer est lu au premier lancement sans la nouvelle tentative du SDK React Native quand Google Play est momentanément indisponible — une telle installation est alors signalée comme organique. Hôte : pris en charge, votre app transmettant l’événement de cycle de vie ou l’URL au SDK (chaque page SDK montre la ligne à ajouter). — : sans objet sur cette plateforme.
| RN / Expo | Android | iOS | Flutter | Capacitor | KMP | MAUI | Unity | |
|---|---|---|---|---|---|---|---|---|
| Android : Install Referrer de Google Play | Oui | Oui | — | Une fois | Une fois | Une fois | Une fois | Une fois |
| iOS : enregistrement SKAdNetwork | Oui | — | Oui | Oui | Oui | Oui | Oui | Oui |
| iOS : valeurs de conversion issues de votre mapping | Oui | — | Oui | Non | Oui | Non | Non | Non |
| iOS : attribution Apple Ads | Oui | — | Oui | Non | Oui | Non | Non | Non |
| Événements avec valeur et devise | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui |
| Identifiant de transaction du store sur les achats | Oui | Non | Non | Non | Oui | Non | Non | Non |
| Revenus publicitaires AdMob | Oui | Non | Non | Non | Oui | Non | Non | Non |
| Deep links, directs et différés | Oui | Oui | Hôte | Oui | Hôte | Hôte | Oui | Oui |
| Ouvertures de l’app (rétention) | Oui | Oui | Oui | Oui | Hôte | Hôte | Hôte | Oui |
| Consentement au partage publicitaire | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui |
| Effacement depuis l’app (forgetMe) | Oui | Non | Non | Non | Oui | Non | Non | Non |
| File hors ligne et nouvelles tentatives | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui |
Le SDK React Native / Expo est le plus complet parce qu’il fait tourner le moteur JavaScript partagé, @traqio/core, qui équipe aussi Capacitor. Sur les autres SDK, ce qui manque manque dans l’app, pas sur le serveur : l’effacement depuis l’app a un équivalent côté serveur, et les revenus peuvent toujours arriver via RevenueCat.
Jusqu’où chaque SDK est éprouvé#
Une capacité présente dans le code n’est pas une capacité vue en fonctionnement. Voici la preuve la plus solide dont chaque SDK dispose aujourd’hui :
| SDK | Paquet | Registre | Éprouvé |
|---|---|---|---|
| React Native / Expo | @traqio/react-native | npm | Vérifié sur un appareil |
| Android | io.khufu.traqio:traqio-android | Maven Central | Compilé en CI |
| iOS | TraqioSDK | SPM / CocoaPods | Compilé en CI |
| Flutter | traqio | pub.dev | Vérifié au typecheck en CI |
| Capacitor | @traqio/capacitor | npm | Vérifié au typecheck en CI |
| Kotlin Multiplatform | io.khufu.traqio:traqio-kmp | Maven Central | Compilé en CI |
| .NET MAUI | Traqio.Maui | NuGet | Compilé en CI |
| Unity | app.traqio.sdk | UPM | Pas encore de build automatisé |
« Vérifié sur un appareil » signifie que la chaîne complète — un clic sur un lien de tracking, une installation depuis Google Play, l’Install Referrer lu par le SDK, une installation attribuée de façon déterministe — a été exécutée de bout en bout sur un vrai runtime Android. « Compilé en CI » signifie que la chaîne d’outils propre au SDK le compile à chaque modification, mais qu’aucune app ne l’a encore fait tourner en production.
Accès anticipé
Pris en charge aujourd’hui#
Les SDK d’app mesurent les apps iOS et Android. Chacun cible les plateformes mobiles pour lesquelles son framework compile : un projet .NET MAUI ou Kotlin Multiplatform est mesuré sur ses cibles Android et iOS, un jeu Unity sur ses builds Android et iOS. Les SDK web mesurent les sites web : @traqio/web dans n’importe quel navigateur, et les SDK serveur sur Node.js 18+, PHP 8.1+ (Laravel 12 et 13) et Python 3.9+.
Questions fréquentes#
- Quel SDK Traqio dois-je utiliser ?
- Celui qui correspond au langage dans lequel le code de démarrage de votre app est écrit : @traqio/expo pour une app Expo, @traqio/react-native pour une app React Native bare, le SDK Kotlin pour une app Android native, TraqioSDK pour une app iOS native, et le paquet Flutter, Capacitor, Kotlin Multiplatform, .NET MAUI ou Unity pour les apps construites avec ces outils. Utilisez exactement un SDK Traqio par app.
- Tous les SDK font-ils la même chose ?
- Ils partagent le même contrat — signaler l’installation une seule fois, mettre en file d’attente et réessayer les événements, résoudre les deep links, transmettre le consentement de l’utilisateur — mais pas toutes les capacités. Les valeurs de conversion SKAdNetwork, l’attribution Apple Ads, les identifiants de transaction des stores, les revenus publicitaires AdMob et l’effacement depuis l’app sont complets dans les SDK React Native / Expo et Capacitor (et en partie dans le SDK iOS natif) ; la matrice de cette page les détaille un par un.
- Puis-je utiliser deux SDK Traqio dans la même app ?
- Non. Deux SDK signaleraient chacun l’installation et feraient tourner leur propre file d’événements : chaque installation et chaque événement seraient comptés deux fois. @traqio/expo et @traqio/react-native sont le même module sous deux noms : installez-en un seul.