Événements et revenus

Un événement est une action de l’utilisateur dans votre app après son installation — inscription, début d’essai, achat. Les événements portent une valeur et une devise optionnelles ; ceux qui ont une valeur sont des revenus. Traqio rattache chaque événement à l’installation qui l’a généré, et c’est ce rattachement qui transforme une campagne en retour sur dépenses publicitaires.

Noms d’événements#

Meta et TikTok optimisent les campagnes sur leurs propres événements standard. Quand Traqio transmet un événement, il traduit les noms ci-dessous en nom standard de chaque réseau ; la correspondance ignore la casse et les espaces en début et fin.

D’où viennent les revenus#

Les apps qui vendent via RevenueCat devraient quand même suivre l’achat depuis le SDK quand c’est possible : sur iOS, c’est ce qui fait évoluer la valeur de conversion SKAdNetwork, qui doit être définie sur l’appareil avant la fermeture de la fenêtre d’Apple — un webhook serveur arrive trop tard pour cela.

Compter un achat une seule fois#

Un achat que votre app remonte et que RevenueCat remonte, c’est le même argent. Pour le compter une seule fois, passez l’identifiant de l’achat attribué par le store — le transactionId de StoreKit, l’orderId de Google Play — en tant que transactionId. Traqio classe alors l’événement sous la même clé que celle que la livraison de RevenueCat dérive pour cette transaction, et c’est le montant vérifié qui l’emporte.

Traqio.track("purchase", {
  value: 9.99,
  currency: "EUR",
  transactionId: purchase.transactionId, // StoreKit transactionId / Play orderId
});

Sans lui, les deux ne peuvent pas être rapprochés et l’achat est compté deux fois ; la console le signale. Le champ transactionId est disponible dans les SDK React Native, Expo et Capacitor ; sur les autres, remontez les achats uniquement via RevenueCat.

Remboursements, sandbox et trafic de test#

• Les remboursements reçus de RevenueCat sont enregistrés comme des revenus négatifs sur la même installation, si bien que chaque total les déduit. Un remboursement n’est pas une conversion et n’est jamais transmis aux réseaux.
• Les achats sandbox et les impressions de test AdMob sont affichés dans la console, pour que vous voyiez que le branchement fonctionne, et ne sont jamais comptés ni transmis.

Comment le ROAS est calculé#

Le ROAS (retour sur dépenses publicitaires) correspond aux revenus attribués divisés par les dépenses publicitaires, pour la même campagne, le même ensemble de publicités ou la même publicité, sur les mêmes jours. Les dépenses sont récupérées chaque jour depuis les comptes publicitaires Meta et TikTok connectés ; les revenus sont ce qu’ont rapporté les installations générées par chaque campagne. Le ROAS est calculé dès la première installation — il n’y a pas de volume minimal.

Jours et devise#

• Chaque produit a un fuseau horaire et une devise de reporting — UTC et dollar américain sauf réglage contraire. Chaque jour de chaque rapport est découpé dans ce fuseau ; le changer redécoupe l’historique à la lecture, rien n’est réécrit.
• Les montants sont convertis dans la devise de reporting au taux de change de leur propre jour. Un montant dont le jour n’a pas de taux est affiché dans sa propre devise et jamais additionné à un autre — un vide se rattrape, un chiffre faux mais plausible, non.
• Les revenus SKAdNetwork sont modélisés à partir d’une valeur de conversion sur six bits et présentés à part ; ils n’entrent jamais dans les revenus mesurés ni dans le ROAS.

Les rapports de cohorte comptent à partir du jour 0, le jour même de l’installation. Certains éditeurs commencent au jour 1 ; Traqio indique la convention qu’il utilise plutôt que de vous laisser comparer deux chiffres construits différemment.

Questions fréquentes#

Puis-je envoyer n’importe quel nom d’événement à Traqio ?

Oui — chaque nom est stocké et présenté dans les rapports. Mais seuls les noms du vocabulaire de Traqio (purchase, signup, subscribe, trial, add_to_cart, checkout et quelques autres) sont traduits en événements standard de Meta et TikTok. Tout autre nom arrive chez les réseaux comme un événement personnalisé, sur lequel aucune campagne ne peut optimiser.

Comment Traqio calcule-t-il le ROAS ?

Le ROAS correspond aux revenus attribués divisés par les dépenses publicitaires, pour la même campagne, le même ensemble de publicités ou la même publicité, et les mêmes jours. Les revenus sont ce qu’ont rapporté les installations générées par une campagne — achats depuis le SDK et depuis RevenueCat, revenus publicitaires AdMob — en brut, dans la devise de reporting de l’app. Les dépenses sont récupérées chaque jour depuis les API marketing de Meta et TikTok.

Les revenus sont-ils bruts ou nets des frais de store ?

Bruts : ce que l’acheteur a payé, avant la commission de l’App Store ou de Google Play et avant taxes. Les pourcentages de commission et de taxes reçus de RevenueCat sont conservés mais jamais appliqués, car les paliers de commission des stores varient selon le programme, la région et l’ancienneté de l’abonnement, et un net estimé serait faux d’une manière que personne ne pourrait voir.