Attribution des revenus

Fonctionnalité Pro

Connectez le comportement des visiteurs aux revenus réels. Identifiez les pages, campagnes et sources de trafic qui génèrent des ventes en intégrant avec votre prestataire de paiement.

---

Aperçu

L'attribution des revenus ferme la boucle entre le marketing et les ventes. Au lieu de deviner quelles activités génèrent des revenus, voyez les chiffres réels :

• Revenus par source : Quels canaux génèrent le plus de revenus
• Revenus par page : Quel contenu mène à des achats
• Revenus par campagne : Quelles campagnes ont un ROI positif
• Parcours client : Quel chemin mène à la conversion

---

Intégrations prises en charge

Stripe

Intégration native avec Stripe pour le suivi automatique des revenus.

Configuration :

1. Ouvrez Domaines → votre site → onglet Revenus → Intégrations → Stripe
2. Cliquez sur Connecter le compte Stripe
3. Autorisez la connexion
4. Les données de revenus se synchronisent automatiquement

Données capturées :

• Montants des transactions
• E-mails des clients (pour l'appariement de parcours)
• Événements d'abonnement (nouveau, renouvellement, résiliation)
• Statut du paiement (réussi, échoué, remboursé)

Lemon Squeezy

Intégration native avec Lemon Squeezy pour les entreprises indépendantes et SaaS.

Configuration :

1. Ouvrez Domaines → votre site → onglet Revenus → Intégrations → Lemon Squeezy
2. Entrez votre clé API Lemon Squeezy
3. Configurez le secret de signature du webhook
4. Les données de revenus se synchronisent automatiquement

Polar

Intégration native avec Polar pour la monétisation des projets open-source et des créateurs.

Configuration :

1. Ouvrez Domaines → votre site → onglet Revenus → Intégrations → Polar
2. Entrez votre clé API Polar
3. Configurez le secret de signature du webhook
4. Les données de revenus se synchronisent automatiquement

PayPal

Intégration native avec PayPal Checkout pour les paiements uniques. Les modes Sandbox et Live sont tous deux pris en charge.

Configuration :

1. Créez une application REST API dans PayPal Developer
2. Créez un webhook dans PayPal pointant vers https://api.zenovay.com/webhooks/paypal/YOUR_WEBSITE_ID
3. Abonnez-vous à PAYMENT.CAPTURE.COMPLETED et PAYMENT.CAPTURE.REFUNDED
4. Dans Zenovay, ouvrez Domaines → votre site → onglet Revenus → Intégrations → PayPal et collez :
   • Client ID, Client Secret (de votre application PayPal)
   • Webhook ID (du webhook que vous venez de créer)
   • Choisissez Sandbox ou Live pour correspondre à votre application PayPal
5. Enregistrez — Zenovay valide les identifiants en récupérant un jeton d'accès OAuth2

Pour une meilleure précision d'attribution, définissez purchase_units[0].custom_id = visitor_id lors de la création de la commande PayPal sur votre serveur. Consultez le guide d'intégration PayPal pour les instructions complètes.

Le support des abonnements n'est pas encore disponible — seules les captures uniques sont suivies en V1.

Paddle

Intégration native avec Paddle Billing (v2) pour les entreprises SaaS qui utilisent Paddle en tant que commerçant tiers (gère la TVA EU et la taxe de vente mondiale). Les modes Sandbox et Live sont tous deux pris en charge.

Vous n'avez besoin que d'UNE SEULE chose : une clé API Paddle avec permission Écriture. Zenovay crée la destination webhook en votre nom via l'API Paddle, capture le secret de signature automatiquement, et les stocke tous deux chiffrés. Vous ne touchez jamais au tableau de bord Notifications de Paddle.

Configuration (2 minutes) :

1. Dans Paddle → Developer tools → Authentication → New API key → permission Write → copiez la clé (commence par pdl_live_apikey_ ou pdl_sdbx_apikey_).
2. Dans Zenovay, ouvrez Domaines → votre site → onglet Revenus → Intégrations → Paddle → collez la clé. Sandbox vs Live est auto-détecté à partir du préfixe.
3. Cliquez sur Connecter. Terminé.

Ce qui se passe en arrière-plan :

• Zenovay valide la clé contre /event-types.
• Appelle POST /notification-settings en votre nom — URL https://api.zenovay.com/api/webhooks/paddle/<your-website-id>, abonnée à transaction.completed + 3 événements d'abonnement.
• Capture endpoint_secret_key de la réponse de Paddle et la stocke chiffrée.

Pourquoi vous ne voyez jamais de champ "signing secret" sur le chemin heureux : Paddle cache délibérément le secret de signature dans son tableau de bord après la création (pas de bouton "reveal", seulement "Rotate Secret"). Zenovay utilise l'API Paddle pour récupérer le secret directement — le seul chemin programmatique documenté. Consultez l'article du centre d'aide pour l'explication complète.

Données capturées :

• Montants des transactions (devises incluant JPY/KRW à zéro décimale gérées correctement selon ISO 4217)
• E-mails des clients lorsqu'ils sont présents sur l'événement (pour l'appariement visiteur → revenu)
• Cycle de vie de l'abonnement : créé, mis à jour, annulé (correspond au subscription_status de Zenovay)
• Statut du paiement

Les événements de remboursement (adjustment.*) et les branches d'abonnement en pause / arriéré ne sont pas encore rendus en V1 — Zenovay les ignore silencieusement.

Consultez le guide d'intégration Paddle pour la résolution de problèmes et l'option de secours de configuration manuelle (rarement nécessaire).

Webhooks personnalisés

Pour tout autre prestataire de paiement, utilisez les webhooks :

Point de terminaison du webhook :

POST https://api.zenovay.com/webhooks/revenue

Charge utile :

{
  "api_key": "YOUR_API_KEY",
  "website_id": "YOUR_WEBSITE_ID",
  "event": "purchase",
  "data": {
    "transaction_id": "txn_123",
    "amount": 99.00,
    "currency": "USD",
    "customer_email": "[email protected]",
    "product_name": "Pro Plan",
    "metadata": {
      "plan": "annual",
      "coupon": "LAUNCH20"
    }
  }
}

---

Tableau de bord des revenus

Métriques d'aperçu

Revenus par source

Identifiez les sources de trafic qui génèrent le plus de revenus :

• Trafic direct
• Recherche organique
• Recherche payante
• Réseaux sociaux
• Références
• Campagnes e-mail
• Campagnes étiquetées UTM

Revenus par page

Identifiez le contenu à haut taux de conversion :

• Pages de destination qui mènent à des achats
• Articles de blog qui influencent les décisions d'achat
• Performance de la page tarifaire
• Pages de fonctionnalités qui convertissent

---

Modèles d'attribution

Dernier clic (Par défaut)

Attribue 100 % des revenus à la dernière page/source avant la conversion.

Idéal pour : Comprendre les déclencheurs de conversion finaux

Premier clic

Attribue 100 % des revenus à la première page/source du parcours client.

Idéal pour : Comprendre les canaux d'acquisition

Linéaire

Attribue les revenus équitablement entre tous les points de contact du parcours.

Idéal pour : Comprendre la contribution du parcours complet

Décroissance temporelle

Attribue plus de revenus aux points de contact plus proches de la conversion.

Idéal pour : Vue équilibrée avec orientation vers la conversion

---

Suivi du parcours client

Connectez les sessions de visiteurs anonymes aux clients payants :

Comment ça fonctionne

1. Suivi anonyme : Le visiteur parcourt votre site
2. Révélation d'identité : Le visiteur fournit son e-mail (inscription, paiement, formulaire)
3. Événement d'achat : Paiement reçu via webhook
4. Connexion au parcours : Toutes les sessions antérieures liées au client

Affichage du parcours

Pour chaque client, voyez :

• Date et source de la première visite
• Toutes les pages consultées entre les sessions
• Temps écoulé de la première visite à l'achat
• Nombre total de sessions avant la conversion
• Contenu qui a influencé l'achat

---

Configuration du suivi des revenus

Étape 1 : Connecter le prestataire de paiement

Consultez Intégrations prises en charge ci-dessus.

Étape 2 : Activer le suivi d'identité

Assurez-vous que l'identification des visiteurs est configurée :

// Lorsque l'utilisateur fournit son e-mail (formulaire, inscription, paiement)
window.zenovay('identify', 'user_123', {
  email: '[email protected]'
});

Étape 3 : Vérifier le flux de données

1. Effectuez un achat de test
2. Vérifiez le tableau de bord Revenus
3. Vérifiez que la transaction apparaît avec le montant correct
4. Confirmez que le parcours client est lié

---

Alertes de revenus

Soyez averti des événements de revenus :

Résumé quotidien des revenus

{
  "alert": "daily_revenue_summary",
  "schedule": "0 9 * * *",
  "channel": "email",
  "recipients": ["[email protected]"]
}

Jalons de revenus

{
  "alert": "revenue_milestone",
  "threshold": 10000,
  "period": "month",
  "channel": "slack"
}

Paiements échoués

{
  "alert": "payment_failed",
  "notify_immediately": true,
  "channel": "email"
}

---

Accès API

Accédez aux données de revenus par programmation :

Résumé des revenus

GET /api/websites/:websiteId/revenue/summary
  ?start_date=2025-01-01
  &end_date=2025-12-31
Authorization: Bearer YOUR_API_KEY

Revenus par source

GET /api/websites/:websiteId/revenue/by-source
  ?period=last_30_days
Authorization: Bearer YOUR_API_KEY

Parcours client

GET /api/websites/:websiteId/revenue/journeys
  ?limit=100
Authorization: Bearer YOUR_API_KEY

---

Confidentialité et sécurité

Gestion des données

• Données de transaction chiffrées au repos
• E-mails des clients hachés pour l'appariement
• Aucun numéro de carte de crédit stocké
• Les données de carte sont gérées entièrement par votre prestataire de paiement — Zenovay ne reçoit jamais les numéros de carte (périmètre PCI géré par Stripe, Paddle, PayPal, etc.)

Contrôle d'accès

• Données de revenus visibles pour les rôles Admin et Owner
• Le rôle Viewer ne voit que les données agrégées
• L'accès API nécessite les champs d'application appropriés

---

Bonnes pratiques

1. Connectez d'abord le prestataire de paiement : Les données de revenus sont fondamentales
2. Implémentez le suivi d'identité : Lie les clients anonymes aux clients payants
3. Étiquetez les campagnes de manière cohérente : Utilisez les paramètres UTM pour l'attribution
4. Examinez le modèle d'attribution : Choisissez le modèle qui convient à votre cycle de vente
5. Configurez les alertes : Soyez averti lorsque les jalons de revenus sont atteints

---

Étapes suivantes

• Événements personnalisés - Suivez les actions liées aux revenus
• Objectifs - Configurez les objectifs de conversion
• Intelligence B2B - Connectez les visites d'entreprises aux revenus

---

Outils gratuits associés

Des balises UTM cohérentes sont la base d'une bonne attribution de campagne. Créez-les avec notre Générateur UTM gratuit, puis suivez ces campagnes dans votre tableau de bord Zenovay.