Données GA4 et Yandex Metrika

Lisez les pages vues et le trafic depuis GA4 et Yandex Metrika, puis croisez-les avec les constats du crawl pour corriger les pages réellement consultées. Les deux connexions sont en lecture seule.

Ce qu'elle fait

Yandex Metrika

metrika-counters trouve l’identifiant du compteur. metrika-setup affiche ses objectifs, ses filtres et ses opérations sur les données, à lire avant de tirer des conclusions. metrika-report récupère ensuite les métriques et dimensions demandées, avec pagination automatique.

  • L’accès passe par un token OAuth Yandex, placé dans YANDEX_METRIKA_TOKEN ou dans son fichier de token.
  • metrika-traffic-pdf produit un rapport de trafic A4 en HTML et en PDF. Le PDF nécessite Chrome, Edge ou Chromium installé en local.
  • Les journaux bruts sont volontairement exclus, car ils contiennent des identifiants de visiteurs.

Google Analytics 4

GA4 n’a pas de commande CLI dédiée. Vous le collectez avec provider-collect, en utilisant l’opération page_views pour les pages visitées ou landing_pages pour les pages d’entrée. page_views compte les screenPageViews par date, hôte et chemin, pour la propriété que vous indiquez.

  • L’accès passe par un token d’accès GA4 (GA4_ACCESS_TOKEN) ou par un compte de service Google avec le périmètre analytics.readonly.
  • Le compte doit disposer d’un accès en lecture à la propriété.
  • Les lignes brutes sont écrites dans un dossier d’artefacts privé, et non dans la réponse de l’outil.

Croisement avec le crawl

crawl-enrich associe un CSV de trafic indexé par URL aux URL crawlées et ajoute des constats analytiques, à partir des colonnes de visites et de taux de rebond que vous indiquez. Avec un projet, sources-sync conserve l’historique quotidien dans un fichier SQLite local, et sf run le croise hors ligne avec les pages de l’audit.

  • Le croisement produit les constats d’orphelines, d’absence de données et de non-indexables avec trafic.
  • Les URL présentes à la fois dans le crawl et dans les données, ou dans un seul des deux, restent des populations distinctes.
  • Les chiffres GA4 et Metrika ne sont jamais additionnés.

Trois étapes, un seul scan enregistré

  1. Vérifiez d’abord la configuration du compteur

    Lancez metrika-counters pour trouver l’identifiant du compteur, puis metrika-setup pour voir ses objectifs, ses filtres et ses opérations sur les données.

  2. Récupérez les visites et les pages vues

    metrika-report lit Yandex Metrika avec les métriques et dimensions voulues. Les pages vues GA4 viennent de provider-collect, avec l’opération page_views de GA4.

  3. Croisez les chiffres avec le crawl

    crawl-enrich associe le CSV de trafic aux URL crawlées, par URL, et ajoute des constats analytiques, dont les colonnes de visites et de taux de rebond.

Contrôles de cette fonctionnalité

ContrôleSignificationGravitéPreuve
GA_ORPHAN_URLLes données analytiques citent une URL de même origine que le crawl n’a pas trouvéeImportantListe d’URL issue du croisement. Masquée si le crawl est partiel
NON_INDEXABLE_WITH_GA_DATAUne page non indexable reçoit encore des visites supérieures à zéroImportantURL et nombre de visites issus de --visits-column
NO_GA_DATAUne page crawlée et indexable n’a aucune ligne analytiqueTipListe d’URL. Vérifiez la période mesurée et le balisage analytique avant d’agir
BOUNCE_RATE_ABOVE_70Le taux de rebond de la page dépasse 70 %TipURL et taux de rebond issus de --bounce-column

Une seule commande

bash
seohead metrika-report --counter 12345678 --date1 2026-09-01 --date2 2026-09-30

Commencez par installer : guide d'installation. Chaque commande fonctionne aussi comme outil MCP pour les agents IA.

Ce qu'il vous faut

  • Yandex Metrika : un identifiant de compteur et un token OAuth
  • GA4 : un identifiant de propriété et un token d’accès, ou un compte de service disposant de analytics.readonly
  • Une plage de dates
  • Un crawl ou un audit, plus un CSV de trafic si vous utilisez crawl-enrich

Limites

  • Les pages vues GA4 ne sont ni des sessions, ni des utilisateurs, ni des sessions d’entrée. Elles ne prouvent pas qu’une modification a causé du trafic.
  • La collecte GA4 renvoie au maximum 100 000 lignes par exécution. Les données seuillées ou échantillonnées sont signalées.
  • Des zéros peuvent venir du balisage ou des filtres : vérifiez d’abord metrika-setup.
  • Une ligne absente n’est pas un zéro mesuré. Un constat négatif exige un crawl complet et une couverture complète du fournisseur.

Questions

Cela modifie-t-il mon site ou mes réglages analytiques ?
Non. Chaque appel est en lecture seule. metrika-setup se contente d’afficher la configuration d’un compteur. Les preuves conservées restent dans un dossier local.
Quels accès faut-il ?
Pour Metrika, un token OAuth Yandex dans le réglage YANDEX_METRIKA_TOKEN ou dans son fichier de token. Pour GA4, un GA4_ACCESS_TOKEN, ou un compte de service avec le périmètre analytics.readonly et un accès en lecture à la propriété.
Pourquoi une page sans visite ne signale-t-elle pas toujours un problème ?
Un zéro peut venir de la configuration. Sans objectifs ni filtres paramétrés, les chiffres peuvent être incomplets. Vérifiez metrika-setup avant de tirer des conclusions du trafic.
L’outil lit-il les journaux bruts des visiteurs ?
Non. Les journaux bruts de Metrika sont exclus par conception, car ils contiennent des identifiants de visiteurs. L’outil n’utilise que des rapports agrégés.
Combien cela coûte-t-il ?
SpiderHead ne facture rien pour ces commandes. Les appels sont comptés dans les quotas d’API Metrika et GA4 de votre propre compte.
Que stocke-t-on sur mon ordinateur ?
Les lignes brutes GA4 sont écrites dans un dossier d’artefacts privé que vous choisissez. sources-sync écrit l’historique quotidien dans un fichier SQLite de projet, sans stocker de tokens. metrika-report affiche son résultat : enregistrez-le vous-même si vous en avez besoin.