Le cycle de vie en événements
| Moment du cycle de vie | Événement | Origine | Propriétés |
|---|---|---|---|
| Compte créé | sign_up | navigateur (hybride) | method |
| Essai démarré | start_trial | serveur (webhook de facturation) | plan, trial_days |
| Premier abonnement payant | subscribe | serveur (webhook de facturation) | plan, interval, value, currency, transaction_id |
| Facture de renouvellement payée | purchase avec props.renewal: true | serveur | value, currency, transaction_id |
| Upgrade / expansion | purchase avec props.expansion: true | serveur | value en delta |
| Résiliation ou remboursement | refund | serveur | transaction_id d'origine, value négative |
| Connexion | login | navigateur | — |
Le système de facturation fait autorité pour tout ce qui touche à l'argent. Le navigateur peut bien afficher une page « abonnement confirmé », mais l'événement qui atteint les plateformes publicitaires provient du webhook, avec les identifiants du système de facturation.
Pourquoi les renouvellements ne doivent pas être des subscribe
Les plateformes publicitaires optimisent vers la conversion que vous leur envoyez. Si chaque renouvellement mensuel leur parvient comme un nouvel abonnement avec une valeur, la plateforme apprend que vos clients existants convertissent bien et enchérit pour les atteindre à nouveau. Gardez l'événement d'acquisition (subscribe, une fois par client) séparé de la rétention (purchase avec l'indicateur de renouvellement) et ne mappez que l'événement d'acquisition vers les actions de conversion publicitaires. Les renouvellements continuent d'alimenter l'analytics et votre propre reporting.
Les valeurs destinées aux plateformes publicitaires
subscribe: le montant de la première facture est défendable et simple. Envoyer une estimation de valeur vie client n'est autorisé que sous la forme d'une constante documentée par offre dans le mapping de la destination, visible dans le journal d'audit ; jamais une estimation par utilisateur.start_trial: pas de valeur, ou une valeur attendue documentée par offre.- Expansion : le delta, pas le nouveau total.
refund: la valeur négative du montant remboursé ; GA4 traite les remboursements via l'identifiant de transaction, Google Ads via les ajustements de conversion, la plupart des autres plateformes les ignorent — le connecteur applique ce que le fournisseur prend en charge.
L'identité d'un appareil à l'autre
Un client SaaS s'inscrit sur ordinateur, paie sur mobile et se connecte partout. Appelez identify avec votre identifiant utilisateur et, sous consentement marketing, l'e-mail haché ; les événements serveur portent le même identifiant utilisateur et le même hachage. C'est ce qui permet aux plateformes de rapprocher un subscribe côté serveur du clic publicitaire survenu des jours plus tôt sur un autre appareil, dans les limites de leurs fenêtres d'attribution.
Essais et consentement
Le webhook de facturation transporte l'état du consentement que votre système a enregistré à l'inscription, avec l'identifiant utilisateur. Le routeur applique cet état : un utilisateur qui a refusé le marketing à l'inscription ne produit que des événements analytics, et un webhook sans aucune information de consentement n'atteint aucune destination publicitaire. Ne déduisez pas le consentement du fait que quelqu'un est devenu client ; être client n'est pas un consentement à la mesure publicitaire.
Déduplication face aux répétitions de facturation
Les systèmes de facturation rejouent leurs webhooks. Utilisez l'identifiant de facture ou d'abonnement comme transaction_id ; l'étape d'ingestion marque un second subscribe ou purchase portant le même identifiant de transaction comme conversion en doublon, et les plateformes qui dédupliquent sur le numéro de commande fusionnent ce qui serait passé au travers.
Un reporting qui reste honnête
- Acquisition : nombre et valeur des
subscribepar campagne, depuis les plateformes publicitaires et depuis vos propres événements. - Conversion des essais :
start_trial→subscribepar offre, uniquement depuis vos propres événements. - Chiffre d'affaires net :
purchase(tous indicateurs confondus) moinsrefund, depuis la facturation, rapproché chaque mois des événements.
Si ces trois chiffres divergent un jour des rapports du système de facturation lui-même, la répartition par source sur la page des événements montre quel chemin laisse échapper quoi.