Connecter Google Analytics 4 à Elido

Elido envoie des événements de conversion à GA4 côté serveur via le Measurement Protocol. Cela signifie que les conversions apparaissent dans GA4 qu'importe si l'utilisateur utilise un bloqueur de publicités, sans JavaScript sur votre page.

Ce dont vous avez besoin#

• Une propriété GA4 (pas Universal Analytics).
• L'accès au panneau Admin de la propriété.
• Environ 5 minutes.

Étape 1 — Trouver votre Measurement ID#

1. Accédez à Google Analytics.
2. Cliquez sur Admin (icône d'engrenage en bas à gauche).
3. Sous Propriété, cliquez sur Flux de données → Web.
4. Cliquez sur votre flux de données web.
5. Copiez le Measurement ID — il commence par G-, ex. G-XXXXXXXXXX.

Étape 2 — Créer un secret API Measurement Protocol#

Sur la même page de flux de données :

1. Faites défiler jusqu'à Secrets API Measurement Protocol.
2. Cliquez sur Créer.
3. Donnez-lui un nom ("Elido") et cliquez sur Créer.
4. Copiez la valeur du secret. Elle n'est affichée qu'une seule fois. Si vous la perdez, créez-en un nouveau — les anciens secrets continuent à fonctionner jusqu'à ce que vous les supprimiez.

Étape 3 — Configurer dans Elido#

1. Allez dans Dashboard → Conversions → GA4 → Configurer le transfert.
2. Collez le Measurement ID et le secret API.
3. Cliquez sur Enregistrer. Elido envoie immédiatement un événement test (elido_test) à GA4.

Comment Elido mappe client_id#

GA4 requiert un client_id pour attribuer des événements à un utilisateur. Elido le dérive comme suit :

1. Si la page de destination de votre lien court définit un cookie _ga et que la valeur est renvoyée via votre pixel de conversion — Elido le lit directement.
2. Sinon, Elido hache le click_id d'Elido (ex. clk_abc123) en une chaîne de forme UUID stable et l'utilise comme client_id.

Cela signifie que GA4 affichera ces événements sous un "utilisateur" qui peut ne pas correspondre à vos sessions GA4 web existantes — ils ne seront pas assemblés. Pour un assemblage complet des sessions, transmettez la valeur du cookie _ga à votre serveur et incluez-la dans l'appel API Conversions d'Elido.

Noms d'événements dans GA4#

Elido transfère ces événements :

Événement Elido	Nom d'événement GA4
conversion.recorded	purchase (avec valeur + devise)
link.clicked (si activé)	elido_click
threshold.exceeded	elido_threshold

L'événement purchase est utilisé car GA4 dispose de rapports intégrés pour lui dans la section Monétisation. Tous les événements incluent utm_source, utm_medium, utm_campaign comme paramètres d'événement.

Résolution des problèmes#

Aucun événement en temps réel — Vérifiez le Measurement ID et le secret API. Un mauvais secret API renvoie HTTP 204 (pas de contenu) mais GA4 rejette silencieusement la charge utile. Vérifiez en appelant directement l'endpoint Measurement Protocol :

curl -X POST \
  "https://www.google-analytics.com/debug/mp/collect?measurement_id=G-XXXX&api_secret=YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"test","events":[{"name":"elido_test","params":{}}]}'

Un appel de débogage réussi renvoie {"validationMessages":[]}.

Les événements apparaissent en temps réel mais pas dans les rapports réguliers — Les événements Measurement Protocol peuvent mettre 24–48 heures à apparaître dans les rapports GA4 non temps réel. C'est une limitation de GA4, pas un problème Elido.

Mauvaise devise dans les événements d'achat — Elido lit la devise depuis le champ currency de l'événement de conversion. La valeur par défaut est EUR. Définissez-la explicitement dans votre appel API d'enregistrement de conversion.

Événements en double — Si votre site déclenche également un événement GA4 purchase côté client, vous verrez des doublons. Désactivez l'événement côté client ou utilisez un nom d'événement différent dans les paramètres de correspondance Elido.