En bref. Pour exporter un rapport de trafic référent IA, filtrez sessionSource dans une requête runReport, sélectionnez des métriques de session et récupérez toutes les pages de résultats.

Définition : Un rapport de trafic référent IA produit avec l’API Data de Google Analytics est un tableau de l’activité d’un site web, filtré sur une sélection de sources correspondant à des assistants. Une requête runReport précise la propriété Analytics, la période du rapport, les dimensions qui regroupent les lignes, les métriques qui mesurent l’activité et le filtre sur les sources.

Points clés

Au 17 octobre 2026, le guide de création de rapports de Google recommande runReport pour les requêtes de rapports de base.
Le schéma de l’API de Google définit sessionSource comme la source à l’origine d’une session et sessionMedium comme son support.
La documentation des filtres de Google propose inListFilter pour rechercher les correspondances dans une liste de chaînes de caractères, avec un paramètre caseSensitive.
La documentation des requêtes fixe une valeur par défaut de 10 000 lignes et un maximum de 250 000 lignes par requête.

Quelles dimensions et métriques inclure dans le rapport ?

Le schéma de l’API de Google distingue l’attribution des sessions de l’acquisition d’utilisateurs : firstUserSource identifie la source de la première acquisition d’un utilisateur, tandis que sessionSource identifie la source à l’origine d’une session. Un rapport sur les sessions provenant d’assistants utilise sessionSource, éventuellement associé à sessionMedium pour distinguer les valeurs de support au sein de chaque source.

La métrique sessions compte les sessions démarrées sur le site ou dans l’application. La métrique keyEvents compte les événements marqués comme événements clés, qui représentent les résultats sélectionnés ; le marquage d’un événement comme événement clé s’applique aux rapports à partir de ce moment. Pour connaître la part des sessions ayant abouti à un résultat, sessionKeyEventRate mesure le pourcentage de sessions au cours desquelles un événement clé, quel qu’il soit, se produit.

Pour une ventilation par page d’entrée, landingPagePlusQueryString ajoute le chemin de la page et la chaîne de requête associés à la page vue initiale de la session.

À quoi ressemble la requête filtrée par source ?

Le guide de démarrage rapide de Google explique comment activer l’API Data, accorder au compte authentifié l’accès à la propriété et obtenir des identifiants. Le champ d’application de l’autorisation en lecture seule est https://www.googleapis.com/auth/analytics.readonly.

La requête ci-dessous est un exemple qui sélectionne la valeur de source littérale chatgpt.com. La liste des sources est un choix éditorial pour ce rapport ; les valeurs supplémentaires doivent provenir des données de source enregistrées dans la propriété. Dans la documentation des filtres de Google, inListFilter accepte une liste non vide et caseSensitive: false rend la recherche de correspondances insensible à la casse.

Enregistrer ce corps de requête dans request.json :

{
  "dateRanges": [{"startDate": "7daysAgo", "endDate": "yesterday"}],
  "dimensions": [
    {"name": "sessionSource"},
    {"name": "sessionMedium"}
  ],
  "metrics": [
    {"name": "sessions"},
    {"name": "keyEvents"}
  ],
  "dimensionFilter": {
    "filter": {
      "fieldName": "sessionSource",
      "inListFilter": {
        "values": ["chatgpt.com"],
        "caseSensitive": false
      }
    }
  },
  "limit": "10000"
}

Avec l’identifiant de propriété dans PROPERTY_ID, l’identifiant du projet Cloud dans PROJECT_ID et un jeton d’accès autorisé dans ACCESS_TOKEN, cette requête enregistre la réponse au format JSON :

curl --fail-with-body -sS -X POST \
  "https://analyticsdata.googleapis.com/v1beta/properties/${PROPERTY_ID}:runReport" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -H "x-goog-user-project: ${PROJECT_ID}" \
  -H "Content-Type: application/json" \
  --data-binary @request.json \
  -o ai-referrals.json

La documentation des requêtes de Google place les conditions portant sur les sources dans dimensionFilter. Un metricFilter s’applique après l’agrégation des lignes et accepte des conditions portant sur les métriques. Cet exemple ne restreint pas sessionMedium et renvoie ses valeurs enregistrées dans des lignes distinctes.

Comment obtenir un export complet à partir de la réponse ?

La documentation de la réponse de Google définit dimensionHeaders et metricHeaders dans le même ordre que les valeurs correspondantes de chaque ligne. Une conversion en CSV peut utiliser ces en-têtes comme noms de colonnes et concaténer les valeurs de dimensions et de métriques de chaque ligne.

Le champ rowCount de la réponse indique le nombre total de lignes du résultat, indépendamment de la taille de page demandée. Les instructions de pagination de Google utilisent limit et offset pour récupérer les pages successives. S’il reste des lignes, répéter la même requête avec un décalage égal au nombre de lignes déjà récupérées et ajouter les lignes renvoyées à la suite.

Termes associés

Questions fréquentes

Peut-on combiner plusieurs sources d’assistants ?

Oui. Vous pouvez ajouter leurs chaînes de source enregistrées à inListFilter.values. Le guide de création de rapports de Google précise que ce filtre recherche une correspondance avec n’importe quelle valeur de la liste.

Comment vérifier une autre combinaison de champs ?

Vous pouvez soumettre les champs envisagés à la méthode checkCompatibility de Google. Elle vérifie leur compatibilité pour les rapports de base ; des dimensions et des métriques incompatibles provoquent l’échec des rapports.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Comment exporter un rapport de trafic référent IA avec l’API Data de GA4 ?