Connecter Google Analytics 4 à Elido

Elido envoie à GA4 un événement pour chaque clic sur un lien, côté serveur, via le Measurement Protocol. Les événements parviennent à GA4 que l'utilisateur ait ou non un bloqueur de publicité, sans aucun 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. Allez sur Google Analytics.
2. Cliquez sur Admin (icône d'engrenage en bas à gauche).
3. Sous Property, cliquez sur Data streams → Web.
4. Cliquez sur votre flux de données web.
5. Copiez le Measurement ID - il commence par G-, p. ex. G-XXXXXXXXXX.

Étape 2 - Créer un secret d'API du Measurement Protocol

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

1. Faites défiler jusqu'à Measurement Protocol API secrets.
2. Cliquez sur Create.
3. Donnez-lui un nom (« Elido ») et cliquez sur Create.
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 de fonctionner jusqu'à ce que vous les supprimiez.

Étape 3 - Configurer dans Elido

1. Allez dans Dashboard → Integrations → Google Analytics 4.
2. Collez le Measurement ID et le secret d'API.
3. Cliquez sur Save, puis sur Test connection. Elido envoie un événement de test link_click marqué elido_test et debug_mode.

Comment Elido définit le client_id

GA4 exige un client_id pour attribuer les événements à un utilisateur. Elido le définit à elido-<workspace_id>-<link_id> ; tous les clics sur un même lien apparaissent donc sous un seul « utilisateur » synthétique dans GA4. Ces événements ne se rattachent pas à vos sessions web GA4 existantes, et le nombre d'utilisateurs uniques dans GA4 reflète les liens, pas les personnes.

Événement envoyé à GA4

Événement Elido	Nom de l'événement GA4
Clic sur un lien	link_click

Paramètres de l'événement : workspace_id, link_id, slug, country, device, destination.

Dépannage

Aucun événement dans Realtime - Vérifiez le Measurement ID et le secret d'API. Un mauvais secret d'API renvoie HTTP 204 (pas de contenu), mais GA4 abandonne silencieusement le payload. Vérifiez en appelant directement le point de terminaison du 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 dans Realtime mais pas dans les rapports habituels - Les événements du Measurement Protocol peuvent mettre 24 à 48 heures à apparaître dans les rapports GA4 hors temps réel. C'est une limitation de GA4, pas un problème d'Elido.