Attribution : d'où viennent vos installs

Connectez vos comptes publicitaires, lisez votre spend et votre ROAS à côté de vos revenus, recevez les postbacks SKAdNetwork d'Apple sur votre propre endpoint, et renvoyez vos événements de conversion aux régies pour que leurs algorithmes de diffusion apprennent. Appwin n'est pas un MMP certifié : le produit s'appuie sur les rails ouverts auxquels tout développeur a droit, et il est honnête sur ce que chacun peut - et ne peut pas - dire.

L'escalier compte : chaque marche apporte sa valeur seule, et aucune n'oblige à refaire la précédente.

Étape 1 - sans SDK : spend, campagnes et ROAS

Connectez vos comptes TikTok et Meta dans Attribution → Intégrations (OAuth, lecture seule - appwin n'écrit jamais sur un compte publicitaire). Vous obtenez :

  • le spend quotidien par régie, campagne, ad group et annonce, vignettes de créas comprises ;
  • la table des campagnes, une vue ads-manager toutes régies confondues ;
  • le ROAS, croisé avec vos revenus du produit Finance.

Les chiffres affichés ici sont du Reported by network - ce que les plateformes revendiquent. Appwin ne les mélange jamais silencieusement avec ce qu'il observe lui-même.

Étape 2 - une ligne dans votre Info.plist : les postbacks SKAN

Apple envoie une copie de chaque postback SKAdNetwork gagnant à l'endpoint que l'app déclare. Une clé, pas de SDK :

xml
<key>NSAdvertisingAttributionReportEndpoint</key>
<string>https://appwin.io</string>

La page Campagnes affiche alors le SKAN observé par appwin - les installs qu'Apple a attribués à vos pubs, indépendamment des chiffres des régies, avec la répartition par jalon dès que l'étape 3 gère vos conversion values. Les postbacks arrivent 24 à 144 heures après l'install, par design : ne les comparez jamais jour à jour avec les chiffres des régies.

Étape 3 - avec le SDK : conversion values, sources, activation

Avec le SDK installé et l'Analytics initialisé, trois choses se mettent à fonctionner toutes seules :

  • Conversion values (iOS) : appwin devient l'unique gestionnaire de la conversion value SKAdNetwork. Le schéma vit dans votre dashboard (par défaut : essai démarré = 32, achat = 63) et vos appels track() le pilotent
    • rien à coder.
  • Sources d'installation (Android) : le référent Play de chaque install est capturé une fois et remonte dans la vue d'ensemble - quelles campagnes, quelles sources UTM, quelle part d'organique.
  • Activation des signaux : vos événements de conversion repartent vers les régies (côté serveur pour Meta, adapter embarqué pour TikTok) pour que leurs algorithmes optimisent sur de vraies conversions. Cette étape est gatée par le consentement - voir ci-dessous.

Le consentement : un interrupteur, une popup

L'activation publicitaire est en opt-in. Votre app relaie le choix de l'utilisateur par un seul appel - typiquement branché sur la popup ATT côté iOS :

swift
let authorized = await AppwinCore.requestTrackingAuthorization()
AppwinCore.setAdvertisingConsent(authorized ? .granted : .denied)

Déclarez la raison ATT dans votre Info.plist (NSUserTrackingUsageDescription). Si vous avez déjà un CMP, gardez-le : relayez simplement son verdict publicitaire dans setAdvertisingConsent.

:::tabs-end

La règle à retenir : le consentement décide si les événements partent vers les régies ; ATT décide seulement si l'identifiant publicitaire les enrichit. Une ATT refusée active quand même, avec un matching de moindre qualité.

Brancher Meta (Conversions API)

Dans le Gestionnaire d'événements Meta : créez (ou choisissez) un dataset pour votre app, puis générez un token d'utilisateur système depuis les réglages du dataset, section Conversions API. Collez les deux dans Attribution → Intégrations → Activation des signaux → Connecter Meta. La connexion est vérifiée immédiatement ; les événements partent en quelques minutes et apparaissent dans l'outil Test Events de Meta.

Brancher TikTok (App Events)

Ajoutez le paquet optionnel AppwinTikTokEvents (iOS) / le module io.appwin:appwin-tiktok-events (Android) à votre app - aucun code, sa présence est l'intégration. Puis, dans le Gestionnaire d'événements TikTok, copiez le TikTok App ID et le token d'accès de votre app, et collez-les dans Attribution → Intégrations → Activation des signaux → Connecter TikTok. L'adapter ne tourne que pour les utilisateurs consentants, et sa gestion SKAN est désactivée - appwin reste l'unique gestionnaire de la conversion value.

Répliquer le schéma de conversion values

La conversion value n'est qu'un nombre : chaque régie décode ses postbacks avec le mapping déclaré chez elle. Recopiez votre schéma (dashboard, Attribution → SKAN) dans le Gestionnaire d'événements Meta et l'équivalent TikTok - avec le schéma par défaut, ce sont deux lignes : 32 = essai démarré (coarse : medium), 63 = achat (coarse : high).

Limites honnêtes

  • La source par install n'existe pas sur iOS, pour personne, hors des rails de consentement d'Apple : SKAN répond en agrégat, et c'est son principe.
  • Le référent Play dit ce que l'annonceur a mis dans le lien du store. Les campagnes non taguées apparaissent en « autre ».
  • La qualité du matching chez les régies dépend des identifiants que les utilisateurs consentent à partager. Le dashboard sépare toujours Reported by network et Observed by appwin ; le MMM est l'étage de vérité au-dessus des deux.