Activer le retour de conversion Meta (CAPI)

Objectif

Activer le retour de conversion serveur-à-serveur (CAPI) entre Metrikia et Meta. Quand un Lead est créé ou qu'un Deal est gagné dans Metrikia, l'événement est aussi poussé directement dans le compte publicitaire Meta sans passer par le navigateur.

Pourquoi c'est nécessaire : depuis iOS 17 + les AdBlockers + Brave, environ 30 à 50% des conversions ne sont jamais vues par le pixel Meta côté browser. Sans CAPI, Meta optimise vos campagnes sur des données partielles. Avec CAPI activé, Meta reçoit le signal complet côté serveur et le score qualité event match passe de ~5/10 à ~8-9/10.

Prérequis

• Une intégration Meta active dans Metrikia (Settings > Mes connexions)
• Accès admin au Business Manager Meta de votre marque
• Un Pixel Meta déjà actif sur votre site (visible dans Events Manager)
• Domaine vérifié dans Business Settings > Brand Safety > Domains
• Aggregated Event Measurement (AEM) configuré avec Purchase en rang 1

Étape 1 : Récupérer le Pixel ID

1. Ouvrez Meta Business Manager
2. Allez dans Business Settings > Data Sources > Pixels
3. Sélectionnez votre Pixel actif
4. Copiez l'identifiant numérique en haut du panneau (15 ou 16 chiffres)

Étape 2 : Générer un Conversions API Access Token

1. Toujours dans Business Settings, allez dans Users > System Users
2. Cliquez sur "Add" et créez un System User dédié, par exemple "Metrikia CAPI"
3. Donnez-lui le rôle Admin
4. Cliquez sur le System User créé puis sur "Generate New Token"
5. Dans "Assigned Asset", sélectionnez votre Pixel (scope obligatoire : ads_management)
6. Dans "Token Expiry", choisissez "Never expires" (sinon vous devrez régénérer le token tous les 60 jours)
7. Cliquez sur Generate Token et copiez immédiatement la valeur. Le token n'apparaîtra plus jamais après cette page.

Étape 3 : Coller dans Metrikia

1. Allez sur /app/settings et ouvrez l'onglet "Mes connexions"
2. Faites défiler jusqu'à la carte "Retour de conversion Meta (CAPI)" (visible si une source de données Meta est connectée)
3. Cliquez sur "Configurer le retour CAPI"
4. Collez le Pixel ID dans le premier champ
5. Collez le Conversions API Access Token dans le deuxième champ
6. (Optionnel) Renseignez un Test Event Code pour vérifier la connexion sans polluer les données réelles
7. Cliquez sur "Activer la connexion"

Étape 4 : Vérifier dans Meta Events Manager

1. Ouvrez Meta Events Manager > Data Sources > votre Pixel
2. Onglet "Test Events"
3. Renseignez le Test Event Code que vous avez fourni à Metrikia
4. Créez un lead ou validez un deal de test dans Metrikia
5. Vérifiez que l'événement "Lead" ou "Purchase" apparaît dans Test Events sous moins de 5 secondes
6. Une fois validé, retirez le Test Event Code dans Metrikia pour que les vrais événements remontent en production

Étape 5 : Suivi du score qualité event match

Sous quelques jours, vérifiez le score Meta dans Events Manager > Diagnostics. La cible est supérieure à 7/10. Si le score reste bas, vérifiez que les leads créés dans Metrikia possèdent bien email et téléphone (les hash SHA-256 enrichissent l'event match Meta).

Désactiver le retour CAPI

Pour interrompre l'envoi sans casser la sync entrante :

1. Settings > Mes connexions > carte CAPI Meta
2. Cliquez sur "Désactiver"

Le pixel ID et le token sont conservés. Vous pouvez réactiver plus tard sans tout ressaisir.

Problèmes fréquents

• "Le token est révoqué après quelques jours" : Meta révoque les tokens System User si le System User n'a plus accès au Pixel. Vérifiez les autorisations dans Business Settings.
• "Score qualité event match faible" : il manque l'email ou le téléphone sur vos Leads. Vérifiez le mapping des sources d'import (Meta Lead Ads, formulaire, HubSpot).
• "Pas d'événements en production" : vérifiez que la carte indique bien "Activé" et que la source de données Meta est elle-même active. Les événements arrivent ~30 secondes après le déclenchement Metrikia.
• "Backfill des conversions passées" : Meta dédupique les événements sur 7 jours. Au-delà, les events historiques sont ignorés silencieusement. Le support peut lancer un backfill 7j sur demande.

Conformité RGPD

Les événements transmis contiennent des hash SHA-256 d'email et de téléphone (PII pseudonymisée selon Art. 4(5) RGPD). Si votre site utilise un bandeau de consentement, vérifiez qu'il bloque le pixel et le CAPI tant que la catégorie "marketing" n'est pas acceptée. Les mentions légales doivent indiquer l'usage de la Conversions API Meta.