Comment attribuer les installations d'une app React Native

Pourquoi l'attribution React Native demande-t-elle un module natif ?

Les deux signaux qui attribuent une installation d'app sont des API natives : une app React Native ne peut pas les lire depuis le seul JavaScript. Sur Android, le signal est le Google Play Install Referrer ; sur iOS, c'est SKAdNetwork, le framework d'attribution d'Apple.

L'API Google Play Install Referrer renvoie la chaîne de referrer attachée à une visite de la fiche Play Store, avec les horodatages du clic et de l'installation, ce qui permet à une app de lire à son premier lancement quel clic publicitaire a précédé sa propre installation. La documentation de Google indique que l'information de referrer reste disponible 90 jours.

SKAdNetwork (SKAN) est le framework d'attribution d'Apple : au lieu de données par utilisateur, Apple envoie au réseau publicitaire un postback signé, différé et agrégé indiquant qu'une campagne a produit une installation, avec une petite conversion value décrivant le comportement in-app initial. Le rôle de l'app est d'enregistrer l'installation et de mettre à jour cette conversion value, deux appels StoreKit.

Le SDK React Native de Traqio, @traqio/react-native, est un seul paquet : un module natif autolinké écrit en Kotlin et en Swift, plus le moteur JavaScript qui met les événements en file et les envoie. L'app importe tout depuis ce paquet unique.

Comment une installation React Native est-elle attribuée sur Android ?

Une installation Android d'une app React Native est attribuée de façon déterministe : un identifiant de clic voyage du lien de tracking de la pub jusqu'au Play Store, et le SDK le relit au premier lancement. L'attribution déterministe relie un clic à une conversion grâce à un identifiant présent des deux côtés, si bien que la correspondance est exacte plutôt que déduite.

Aucune permission Android n'est requise et aucun identifiant publicitaire (GAID) n'est lu, à aucune étape. Le module déclare l'entrée de manifeste qui lui permet de voir Google Play à partir d'Android 11 : le manifeste de l'app n'a besoin d'aucune modification pour l'attribution.

• Un lien de tracking Traqio enregistre le clic et son identifiant avant d'envoyer l'utilisateur sur Google Play.
• Google Play conserve l'identifiant de clic dans la chaîne de referrer d'installation.
• Au premier lancement, le module natif du SDK lit le referrer et le serveur Traqio relie l'identifiant de clic à exactement un clic enregistré.
• Si Google Play ne répond pas au premier lancement, le SDK garde l'installation en attente et réessaie aux lancements suivants, jusqu'à trois, plutôt que de la déclarer organique.

Comment une installation React Native est-elle attribuée sur iOS ?

Une installation iOS d'une app React Native est attribuée via les postbacks SKAdNetwork, qu'Apple envoie au niveau de la campagne et non par utilisateur. L'app déclare Traqio comme endpoint de reporting SKAdNetwork dans son Info.plist, et iOS envoie alors à Traqio une copie de chaque postback de cette app.

Le SDK enregistre l'installation auprès de SKAdNetwork et met à jour la conversion value à partir du mapping publié pour l'app dans la console Traqio. Une app qui gère déjà son propre schéma de conversion values peut désactiver cette gestion dans le SDK, car deux écrivains écraseraient la même valeur.

L'attribution SKAN se fait au niveau de la campagne, pas de l'utilisateur : la documentation d'Apple indique que le premier postback arrive après un délai aléatoire de 24 à 48 heures une fois sa fenêtre de conversion close. Un ROAS iOS par utilisateur n'existe donc pas avec SKAN, et Traqio n'en modélise pas.

L'App Tracking Transparency (ATT) est le framework iOS, obligatoire depuis iOS 14.5, qui impose à une app de demander la permission de l'utilisateur avant d'accéder à l'IDFA ou de le suivre à travers les apps et sites d'autres entreprises. Le SDK n'affiche pas ce prompt et n'en a pas besoin, car l'attribution SKAN n'en dépend pas.

À quoi ressemble l'installation dans une app React Native ?

Mettre en place l'attribution Traqio dans une app React Native prend cinq étapes, toutes dans le code et la configuration de l'app.

@traqio/react-native est publié sur npm ; le guide d'installation de la documentation donne chaque commande et chaque fichier en entier.

• Activer Expo Modules une fois avec npx install-expo-modules@latest, car la moitié native du SDK est un module Expo ; cela ajoute le runtime Expo Modules, pas un workflow Expo managé ni un service Expo.
• Installer @traqio/react-native avec @react-native-async-storage/async-storage, puis lancer pod install pour iOS. AsyncStorage permet au SDK de déclarer l'installation une seule fois et de garder les événements en file entre deux redémarrages.
• Appeler Traqio.init dans index.js, avant AppRegistry.registerComponent, avec la clé SDK de l'app, l'endpoint https://api.traqio.app et le bridge natif.
• Ajouter NSAdvertisingAttributionReportEndpoint avec la valeur https://api.traqio.app dans l'Info.plist iOS.
• Appeler Traqio.setUserId avec l'identifiant que l'app donne à RevenueCat, et Traqio.track pour les achats, avec un identifiant de transaction pour que chaque paiement ne compte qu'une fois.

Quelles versions et quels builds React Native sont pris en charge ?

Le SDK React Native de Traqio demande React Native 0.74 ou plus avec Expo Modules installé, et iOS 15.1 ou plus ; Android ne demande aucune permission. Le SDK tourne dans un development build ou un build de release, pas dans Expo Go.

Expo Go est une app précompilée avec un jeu fixe de bibliothèques natives : elle ne peut pas charger un module natif qu'elle ne contient pas déjà. Un development build est l'app compilée avec son propre code natif, ce qu'exigent le lecteur d'Install Referrer et les appels SKAdNetwork.

Une app Expo utilise @traqio/expo, un alias qui réexporte le même module sous un nom que cherchent les utilisateurs d'Expo. Une app installe l'un des deux paquets, jamais les deux.

Le SDK React Native est le SDK Traqio vérifié de bout en bout sur un appareil : un clic, une installation depuis Google Play, le referrer lu au premier lancement, et une installation attribuée de façon déterministe.

Après l'installation : événements, revenu et deep links

Après l'installation, le SDK rattache les événements in-app et le revenu à la campagne créditée de l'installation, ce qui rend le ROAS par campagne calculable une fois les comptes publicitaires Meta et TikTok connectés pour la dépense.

Le deferred deep linking est la technique qui conserve la destination d'un lien touché avant l'installation, afin qu'un utilisateur qui installe l'app arrive sur cet écran précis au premier lancement au lieu de l'écran d'accueil.

• Les événements sont mis en file hors ligne et envoyés quand l'app passe en arrière-plan ; une ouverture d'app est enregistrée quand l'app revient après 30 minutes ou plus. Aucun flush manuel n'est nécessaire sur React Native.
• Le revenu d'abonnement remonté par RevenueCat rejoint le même utilisateur quand l'app passe l'app_user_id de RevenueCat à Traqio.setUserId.
• Le SDK écoute le module Linking de React Native et transmet les liens Traqio à un callback onDeepLink, y compris le lien différé d'une installation fraîche.

Ce que Traqio ne fait pas dans une app React Native

Le SDK de Traqio ne collecte ni l'IDFA ni le GAID, ne lit jamais le presse-papiers et ne fait aucun fingerprinting de l'appareil, sur iOS comme sur Android. Les installations par clic ne sont reliées que par un identifiant de clic.

La seule correspondance probabiliste que fait Traqio est l'attribution view-through, désactivée par défaut et activée app par app : quand aucun clic ne correspond, une impression publicitaire peut être reliée à l'installation sur l'adresse IP hachée, dans la fenêtre view-through. View-through désactivé, une installation qu'aucun identifiant de clic ne relie à un clic est comptée comme organique plutôt que devinée.

L'attribution des clics et des vues à l'intérieur de l'inventaire d'installation d'apps de Meta et de TikTok exige d'être partenaire de mesure référencé de chaque réseau, et Traqio ne l'est pas encore. Les équipes qui ont besoin de cette couverture, de bien plus de réseaux publicitaires ou d'un scoring anti-fraude la trouveront chez les MMP établis.