En bref. Extrayez page_referrer de event_params en recherchant sa clé et en sélectionnant value.string_value.

Définition : Dans un export BigQuery de Google Analytics 4 (GA4), l’URL référente d’une page (page referrer) est un paramètre d’événement dont la clé est page_referrer, au sein de l’enregistrement répété event_params. Cette URL est stockée dans le champ value.string_value du paramètre correspondant.

Points clés

En octobre 2026, le schéma d’export BigQuery de Google présente page_referrer aux côtés de page_location dans un exemple d’événement page_view.
La référence de configuration de Google définit page_referrer comme une URL identifiant la source référente qui a apporté du trafic à une page ; sa valeur par défaut est document.referrer.
La documentation sur les tableaux de BigQuery définit un tableau (array) comme une collection ordonnée de valeurs et explique que UNNEST renvoie une ligne par élément.
La référence des sous-requêtes de BigQuery indique qu’une sous-requête scalaire, une requête imbriquée renvoyant une seule valeur, renvoie NULL lorsqu’elle ne trouve aucune ligne.

Comment extraire l’URL référente de chaque page vue ?

Le recueil d’exemples de requêtes de Google utilise un SELECT imbriqué sur UNNEST(event_params) pour récupérer un paramètre désigné par son nom. La requête GoogleSQL adaptée ci-dessous sélectionne value.string_value pour le paramètre page_referrer de chaque événement page_view :

SELECT
  event_date,
  event_timestamp,
  user_pseudo_id,
  (
    SELECT ep.value.string_value
    FROM UNNEST(event_params) AS ep
    WHERE ep.key = 'page_referrer'
  ) AS page_referrer
FROM `PROJECT_ID.analytics_PROPERTY_ID.events_YYYYMMDD`
WHERE event_name = 'page_view';

L’identifiant de table est un modèle. PROJECT_ID représente le projet BigQuery, PROPERTY_ID l’identifiant de la propriété Analytics et YYYYMMDD la date de la table quotidienne. Le schéma d’export de Google documente le nom de l’ensemble de données analytics_<property_id> et le nom de la table quotidienne events_YYYYMMDD.

Selon les règles des sous-requêtes scalaires de BigQuery, l’absence de paramètre correspondant produit NULL tout en conservant la ligne d’événement de la requête externe. Plusieurs paramètres correspondants provoquent une erreur d’exécution.

Comment examiner les valeurs des paramètres stockés ?

Le guide des tableaux de BigQuery décrit l’utilisation d’un CROSS JOIN corrélé pour déplier le tableau appartenant à chaque ligne source. Cette requête adaptée affiche directement les enregistrements du paramètre d’URL référente :

SELECT
  e.event_timestamp,
  e.event_name,
  ep.key,
  ep.value.string_value AS page_referrer
FROM `PROJECT_ID.analytics_PROPERTY_ID.events_YYYYMMDD` AS e
CROSS JOIN UNNEST(e.event_params) AS ep
WHERE ep.key = 'page_referrer';

Ici, le résultat contient une ligne par paramètre correspondant. Les événements dépourvus de cette clé ne produisent aucune ligne dans le résultat. Cette requête inclut les paramètres correspondants quel que soit le nom de l’événement ; la requête précédente limite la sélection à page_view.

Quel est le lien entre l’URL référente et la source d’acquisition ?

La référence de configuration de Google indique que la valeur de l’URL référente contribue aussi au calcul de la source de trafic. Elle documente un réglage global et un réglage propre à un flux pour page_referrer : la configuration de collecte peut donc fournir explicitement cette valeur.

Le schéma d’export définit séparément traffic_source comme la source d’acquisition initiale de l’utilisateur. Son enregistrement session_traffic_source_last_click contient les données de source de trafic des sessions attribuées au dernier clic, dans les contextes liés aux annonces Google et les contextes manuels, lorsqu’elles sont disponibles. Une requête sélectionnant page_referrer lit l’URL référente stockée pour l’événement ; l’attribution de session possède son propre enregistrement.

Termes associés

Questions fréquentes

Puis-je supposer que chaque événement contient ce paramètre ?

La documentation du schéma de Google indique que l’ensemble des paramètres d’événement est propre à chaque implémentation. Vous pouvez utiliser la requête d’examen pour voir quels événements comportent page_referrer dans la table sélectionnée.

Quel champ dois-je sélectionner pour obtenir l’URL référente ?

Sélectionnez value.string_value dans le paramètre dont la clé est égale à page_referrer. La référence de configuration de Google spécifie une URL sous forme de chaîne de caractères pour ce champ et utilise document.referrer comme valeur par défaut.

Sources

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

Où l’URL référente est-elle stockée dans un export BigQuery de GA4 ?