Traqio.

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 / ExpoAndroidiOSFlutterCapacitorKMPMAUIUnity
Android : Install Referrer de Google PlayOuiOui—Une foisUne foisUne foisUne foisUne fois
iOS : enregistrement SKAdNetworkOui—OuiOuiOuiOuiOuiOui
iOS : valeurs de conversion issues de votre mappingOui—OuiNonOuiNonNonNon
iOS : attribution Apple AdsOui—OuiNonOuiNonNonNon
Événements avec valeur et deviseOuiOuiOuiOuiOuiOuiOuiOui
Identifiant de transaction du store sur les achatsOuiNonNonNonOuiNonNonNon
Revenus publicitaires AdMobOuiNonNonNonOuiNonNonNon
Deep links, directs et différésOuiOuiHôteOuiHôteHôteOuiOui
Ouvertures de l’app (rétention)OuiOuiOuiOuiHôteHôteHôteOui
Consentement au partage publicitaireOuiOuiOuiOuiOuiOuiOuiOui
Effacement depuis l’app (forgetMe)OuiNonNonNonOuiNonNonNon
File hors ligne et nouvelles tentativesOuiOuiOuiOuiOuiOuiOuiOui

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 :

SDKPaquetRegistreÉprouvé
React Native / Expo@traqio/react-nativenpmVérifié sur un appareil
Androidio.khufu.traqio:traqio-androidMaven CentralCompilé en CI
iOSTraqioSDKSPM / CocoaPodsCompilé en CI
Fluttertraqiopub.devVérifié au typecheck en CI
Capacitor@traqio/capacitornpmVérifié au typecheck en CI
Kotlin Multiplatformio.khufu.traqio:traqio-kmpMaven CentralCompilé en CI
.NET MAUITraqio.MauiNuGetCompilé en CI
Unityapp.traqio.sdkUPMPas 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é

Les paquets npm — React Native, Expo, Capacitor, le cœur JavaScript, web et Node.js — sont publiés. Les autres ne sont pas encore sur leur registre public : chacune de leurs pages indique la commande de registre qu’elle utilisera, et comment ajouter le build que nous vous envoyons d’ici là — écrivez à hello@traqio.app.

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.

Mis à jour le 22 octobre 2026