Concepts
Comment Traqio attribue une installation
Les preuves de chaque installation attribuée — Install Referrer de Google Play, SKAdNetwork, Apple Ads —, les règles qui la refusent et ce qu’est l’organique.
L’attribution d’installation consiste à déterminer quelle publicité, s’il y en a une, a provoqué l’installation d’une app. Traqio n’attribue une installation que sur une preuve qu’il peut montrer, et enregistre de quel type de preuve il s’agit. Faute de preuve, l’installation est organique — pas devinée.
Android : l’Install Referrer de Google Play#
L’Install Referrer de Google Play est une chaîne que Google Play transmet à une app après son installation, via l’API Install Referrer : le contenu du paramètre referrer de l’URL Play Store d’où venait l’utilisateur. Traqio s’en sert pour faire traverser le store à son identifiant de clic :
- L’utilisateur touche un lien de tracking Traqio (
https://<host>/c/<code>). Traqio enregistre un clic avec un nouvel identifiant de clic, ainsi que le réseau, la campagne, l’ensemble de publicités et la publicité du lien. - Traqio redirige vers la page Play Store de l’app avec
referrer=traq_click=<click id>(plus la source et les identifiants de campagne). - Au premier lancement, le SDK lit le referrer et l’envoie avec l’installation. Le serveur en extrait l’identifiant de clic et retrouve le clic — la correspondance est exacte.
Le résultat est une installation déterministe, marquée avec le réseau et la hiérarchie de campagne du clic, à condition que le clic se trouve dans la fenêtre d’attribution de l’app (7 jours par défaut). Seules les installations faites par Google Play portent un referrer : une installation via adb, un APK installé à la main ou un build venant d’un autre store est organique.
iOS : SKAdNetwork et Apple Ads#
iOS n’a pas d’install referrer, et Traqio ne lit pas l’IDFA par défaut : un clic Traqio ne peut donc pas traverser l’App Store. L’attribution iOS passe à la place par les deux canaux d’Apple :
| Source | De quoi il s’agit | Granularité |
|---|---|---|
| SKAdNetwork | Apple envoie, pour chaque installation, un postback signé cryptographiquement au réseau publicitaire et — quand votre app déclare l’endpoint de Traqio — à Traqio, avec la campagne et une valeur de conversion sur six bits. | par campagne, avec 24 h de retard ou plus |
| Apple Ads | Le SDK lit le jeton d’attribution AdServices ; Traqio le résout auprès d’Apple, qui répond pour ses propres publicités. | par installation |
Les installations SKAdNetwork ne sont comptées qu’à partir des postbacks gagnants de la première fenêtre de conversion — Apple envoie jusqu’à trois postbacks par installation, et les compter tous triplerait les installations iOS. Leurs revenus, modélisés à partir de la valeur de conversion, sont présentés à part et jamais mélangés aux revenus mesurés ni au ROAS. Détails dans Attribution iOS.
Les types d’attribution que vous verrez#
| Libellé | Preuve | Facturé |
|---|---|---|
| Déterministe | un identifiant de clic Traqio dans l’Install Referrer de Google Play, dans la fenêtre d’attribution | oui |
| SKAN | un postback SKAdNetwork gagnant, première fenêtre de conversion | oui |
| Auto-attribué | Apple Ads, via le jeton AdServices | oui |
| View-through | une impression de la même app depuis la même adresse, dans la fenêtre view-through — désactivé tant que vous ne l’activez pas | oui |
| Probabiliste | aucun click id ; un clic sur votre lien depuis la même adresse hachée, dans la fenêtre probabiliste, pour un utilisateur qui a consenti — désactivé tant que vous ne l’activez pas | oui |
| Organique | aucune preuve, ou une attribution refusée par une règle antifraude | non |
Attribution view-through#
Un lien de tracking a une seconde URL, /i/<code>, qui enregistre une impression au lieu d’un clic. Quand une app active une fenêtre view-through (attribution post-impression), une installation qui ne correspond à aucun clic peut être attribuée à une impression de la même app enregistrée depuis la même adresse dans cette fenêtre. Une vue ne laisse pas de referrer : cette correspondance repose donc uniquement sur l’adresse IP hachée — une preuve plus faible qu’un clic, c’est pourquoi elle est désactivée par défaut et passe toujours après un clic. Voir Fenêtres d’attribution.
Rapprochement probabiliste web vers app#
L’attribution est déterministe par défaut. Un cas n’a aucun porteur pour le clic : un clic sur votre lien dans un navigateur, puis une installation sur iOS. Pour ce cas, une app peut activer le rapprochement probabiliste dans ses Réglages. Une installation qui ne porte aucun click id est alors rattachée à un clic sur votre lien venu de la même adresse IP hachée dans une courte fenêtre (2 heures sauf autre choix, 24 heures au plus), et seulement si tous ces clics créditent la même publicité. Il ne s’applique qu’aux utilisateurs dont l’app a remonté leur consentement avec Traqio.setConsent(true) — sur iOS, ne le remontez qu’après que l’utilisateur a aussi autorisé App Tracking Transparency. Il ne passe jamais devant un click id, et chaque installation qu’il attribue est marquée Probabiliste. Les consignes d’Apple comptent la connexion réseau parmi les signaux d’appareil interdits pour l’identification, et les apps dont un SDK les utilise peuvent être refusées : la console affiche ce risque avant de pouvoir l’activer. Les adresses IP hachées sont supprimées après 30 jours.
Réinstallations et réattribution#
Avant de chercher une correspondance, Traqio se demande si l’installation correspond à un nouvel utilisateur. Un appareil ou un utilisateur qu’il connaît déjà, actif récemment, est une réinstallation et garde l’attribution qu’il avait. Un utilisateur inactif depuis plus longtemps que la période d’inactivité de l’app, et qui a cliqué sur une publicité depuis, peut être réattribué à ce clic. Reconnaître un utilisateur qui revient dépend des identifiants first-party décrits dans Identité.
Les attributions que Traqio refuse#
Quatre règles peuvent refuser une attribution. Elles s’appuient sur des données que Traqio détient déjà, et une règle qui se déclenche retire l’attribution, jamais l’installation : l’installation est quand même enregistrée — comme organique, avec le motif — pour que votre nombre d’installations continue de correspondre à celui du store, et une règle ne peut jamais que réduire une facture.
| Motif | Se déclenche quand |
|---|---|
click_injection | le clic retenu a moins de 10 secondes au moment de l’installation — la signature d’un malware qui simule un clic pendant qu’une installation est en cours |
duplicate_device | le même appareil a déjà produit une installation attribuée de l’app au cours des dernières 24 heures |
referrer_malformed | une installation Android revendique un identifiant de clic qu’aucun referrer Play valide ne porte |
anonymous_ip | le clic est arrivé sans adresse client exploitable |
Chaque refus est compté et consultable — dans la console, et via le rapport des refus de l’API. Traqio ne note pas le trafic avec un modèle statistique.
Plafonds sur les endpoints publics
Voir aussi#
- Liens de tracking — d’où vient l’identifiant de clic.
- Fenêtres d’attribution — combien de temps un clic peut revendiquer une installation.
Questions fréquentes#
- Qu’est-ce que l’attribution déterministe ?
- Une attribution fondée sur un identifiant exact transmis de la publicité jusqu’à l’installation — sur Android, l’identifiant de clic de Traqio dans l’Install Referrer de Google Play — par opposition à l’attribution probabiliste, qui devine une correspondance à partir de signaux partagés comme une adresse IP. L’attribution des clics Android de Traqio est déterministe.
- Pourquoi certaines installations sont-elles organiques alors qu’elles viennent d’une publicité ?
- Une installation n’est attribuée que s’il y a une preuve : un identifiant de clic Traqio dans l’Install Referrer de Google Play, dans la fenêtre d’attribution, un postback SKAdNetwork ou un jeton Apple Ads. Une publicité dont la destination n’est pas un lien de tracking Traqio, une installation hors Google Play, un clic plus ancien que la fenêtre ou une installation refusée par une règle antifraude ne laissent aucune preuve exploitable, et l’installation est organique.
- Une installation organique est-elle facturée ?
- Non. Une conversion est une installation attribuée, rien d’autre ; les installations que Traqio n’a pas pu attribuer à une publicité ne sont pas facturées, et les événements que vous suivez sont rapportés mais jamais facturés.