Changelog

Pour recevoir les annonces officielles concernant les API Google Analytics, veuillez vous abonner au groupe de notification des API Google Analytics.

20/10/2024 : ajout du type de filtre de dimension EmptyFilter

Le filtre de dimension EmptyFilter vous permet de créer des conditions de filtrage à comparer à une valeur vide.

15/10/2024 : ajout de la fonctionnalité de niveau d'échantillonnage à la méthode reportTasks

Vous pouvez contrôler le niveau d'échantillonnage du rapport à l'aide du champ samplingLevel de la méthode properties.runReportTask.

Cette fonctionnalité permet aux propriétés Google Analytics 360 d'accéder à des limites d'échantillonnage plus élevées (1 milliard d'événements). De plus, les limites d'échantillonnage peuvent être définies sur UNSAMPLED pour les résultats non échantillonnés avec un grand nombre d'événements.

18/09/2024 : ajout de la fonctionnalité d'instantané des quotas de propriétés

La méthode properties.getPropertyQuotasSnapshot vous permet d'obtenir un instantané actuel de tous les quotas de propriété, organisés par catégorie de quota pour une propriété donnée.

2024-06-28 : ajout du quota "Erreurs client par projet et par propriété"

Le nombre d'erreurs de serveur d'API est désormais limité à 10 000 par projet et par propriété, sur une période de 15 minutes. Cela inclut toutes les requêtes qui génèrent une réponse avec un code autre que 500 ou 200. Voici quelques exemples d'erreurs relevant de ce quota : utilisation de combinaisons de dimensions et de métriques incompatibles, toutes les erreurs d'authentification.

Si cette limite est dépassée, les appels d'API supplémentaires à cette propriété seront temporairement bloqués pour le projet Google Cloud associé jusqu'à la fin de la période de 15 minutes.

14/05/2024 : ajout de la fonctionnalité de comparaison

Les comparaisons vous permettent d'évaluer des sous-ensembles de données côte à côte.

Les principales méthodes de création de rapports de l'API Data v1bêta sont mises à jour pour prendre en charge le champ comparisons qui, lorsqu'il est inclus, spécifie la configuration des comparaisons demandées.

Dans une requête, vous pouvez spécifier une comparaison de base en fournissant l'expression dimensionFilter avec une requête, ou utiliser une comparaison enregistrée en fournissant le nom de ressource de la comparaison dans le champ comparison.

La méthode getMetadata est mise à jour pour lister toutes les comparaisons enregistrées disponibles pour une propriété dans le champ de réponse comparisons.

Lorsqu'au moins une comparaison est spécifiée dans une demande, la réponse contient la colonne comparison qui identifie chaque comparaison.

Actuellement, les comparaisons enregistrées ne peuvent être créées qu'à l'aide de l'interface utilisateur de Google Analytics.

08/05/2024 : ajout de tâches de rapport, une fonctionnalité de création de rapports asynchrones, à l'API Data v1alpha.

Les tâches de rapport vous permettent de lancer une requête asynchrone de longue durée pour créer un rapport personnalisé de vos données d'événements Google Analytics.

Les méthodes de manipulation des tâches de rapport suivantes ont été ajoutées à l'API Data v1alpha :

2024-05-06 : nouvelles dimensions pour les événements clés

Les dimensions et les métriques pour les événements clés sont désormais disponibles.

Modifiez vos demandes de rapports qui utilisent la dimension isConversionEvent pour qu'elles utilisent plutôt la dimension isKeyEvent.

Modifiez toutes les demandes de rapport qui utilisent une métrique obsolète dans le tableau ci-dessous pour utiliser la métrique d'événement clé à la place.

Métrique obsolète Métrique d'événement clé
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

Apportez des modifications similaires à toute utilisation de métriques d'événements clés pour un événement clé dans vos demandes de rapports.

La réponse de la méthode properties/getMetadata reflète l'introduction des dimensions et des métriques d'événements clés dans les objets DimensionMetadata et MetricMetadata comme suit :

  • apiName, uiName et description contiennent le nom de l'API d'événement clé, le nom de l'UI et la description.
  • Le champ répété deprecatedApiNames comporte une entrée avec le nom de l'API de conversion obsolète.

25/03/2024 : ajout du groupe de canaux principal, de la source de trafic manuelle et des dimensions spécifiques à l'intégration.

Ajout de dimensions spécifiques au groupe de canaux principal, à la source de trafic manuel et à l'intégration CM360, DV360 et SA360 au schéma de l'API Data.

Dimensions d'audience :

  • audienceId ID de l'audience. Identifiant numérique d'une audience.

Dimensions du groupe de canaux principal :

  • firstUserPrimaryChannelGroup Groupe de canaux principal du premier utilisateur

  • primaryChannelGroup Groupe de canaux principal

  • sessionPrimaryChannelGroup Groupe de canaux principal de la session

Dimensions "Source de trafic" manuelles :

  • manualCampaignId ID de campagne manuel

  • manualCampaignName Nom de campagne manuel

  • manualCreativeFormat Format de création manuel

  • manualMarketingTactic Stratégie marketing manuelle

  • manualMedium Support manuel

  • Source manuelle manualSource

  • manualSourceMedium Source / Support manuel

  • manualSourcePlatform Plate-forme source manuelle

  • firstUserManualCampaignId Premier ID de campagne manuel de l'utilisateur

  • firstUserManualCampaignName Premier nom de campagne manuel de l'utilisateur

  • firstUserManualCreativeFormat Premier format de création manuel de l'utilisateur

  • firstUserManualMarketingTactic Stratégie marketing manuelle pour le premier utilisateur

  • firstUserManualMedium Première méthode manuelle de l'utilisateur

  • firstUserManualSource Première source manuelle de l'utilisateur

  • firstUserManualSourceMedium Première source / support manuels de l'utilisateur

  • firstUserManualSourcePlatform Plate-forme de la première source manuelle de l'utilisateur

  • sessionManualCampaignId ID de campagne manuel associé à la session

  • sessionManualCampaignName Nom de campagne manuel associé à la session

  • sessionManualCreativeFormat Format de création manuel associé à la session

  • sessionManualMarketingTactic Stratégie marketing manuelle pour la session

  • sessionManualMedium Support manuel associé à la session

  • sessionManualSource Source manuelle de la session

  • sessionManualSourceMedium Source / Support manuel de la session

  • sessionManualSourcePlatform Plate-forme de la source manuelle de la session

Dimensions de l'intégration Campaign Manager 360 (CM360) :

  • cm360AccountId ID du compte CM360

  • cm360AccountName Nom du compte CM360

  • cm360AdvertiserId Référence annonceur CM360

  • cm360AdvertiserName Nom de l'annonceur CM360

  • cm360CampaignId ID de la campagne CM360

  • cm360CampaignName Nom de la campagne CM360

  • cm360CreativeFormat Format de la création CM360

  • cm360CreativeId ID de la création CM360

  • cm360CreativeName Nom de la création CM360

  • cm360CreativeType Type de création CM360

  • cm360CreativeTypeId ID du type de création CM360

  • cm360CreativeVersion Version de la création CM360

  • cm360Medium Support CM360

  • cm360PlacementCostStructure Type de facturation de l'emplacement CM360

  • cm360PlacementId ID de l'emplacement CM360

  • cm360PlacementName Nom de l'emplacement CM360

  • cm360RenderingId ID du rendu CM360

  • cm360SiteId ID du site CM360

  • cm360SiteName Nom du site CM360

  • cm360Source Source CM360

  • cm360SourceMedium Source / support CM360

  • firstUserCm360AccountId Premier ID de compte CM360 de l'utilisateur

  • firstUserCm360AccountName Nom du premier compte CM360 de l'utilisateur

  • firstUserCm360AdvertiserId Première référence annonceur CM360 de l'utilisateur

  • firstUserCm360AdvertiserName Nom du premier annonceur CM360 de l'utilisateur

  • firstUserCm360CampaignId ID de la première campagne CM360 de l'utilisateur

  • firstUserCm360CampaignName Nom de la première campagne CM360 de l'utilisateur

  • firstUserCm360CreativeFormat Format de la première création CM360 de l'utilisateur

  • firstUserCm360CreativeId ID de la première création CM360 de l'utilisateur

  • firstUserCm360CreativeName Nom de la première création CM360 de l'utilisateur

  • firstUserCm360CreativeType Type de la première création CM360 de l'utilisateur

  • firstUserCm360CreativeTypeId ID du type de création CM360 du premier utilisateur

  • firstUserCm360CreativeVersion Version de la première création CM360 de l'utilisateur

  • firstUserCm360Medium Première méthode CM360 de l'utilisateur

  • firstUserCm360PlacementCostStructure Type de facturation du premier emplacement CM360 de l'utilisateur

  • firstUserCm360PlacementId ID du premier emplacement CM360 de l'utilisateur

  • firstUserCm360PlacementName Nom du premier emplacement CM360 de l'utilisateur

  • firstUserCm360RenderingId ID du premier rendu CM360 de l'utilisateur

  • firstUserCm360SiteId ID du premier site CM360 de l'utilisateur

  • firstUserCm360SiteName Nom du premier site CM360 de l'utilisateur

  • firstUserCm360Source Première source CM360 de l'utilisateur

  • firstUserCm360SourceMedium Source / support CM360 du premier utilisateur

  • sessionCm360AccountId ID du compte CM360 associé à la session

  • sessionCm360AccountName Nom du compte CM360 associé à la session

  • sessionCm360AdvertiserId Référence annonceur CM360 de la session

  • sessionCm360AdvertiserName Nom de l'annonceur CM360 de la session

  • sessionCm360CampaignId ID de la campagne CM360 associée à la session

  • sessionCm360CampaignName Nom de la campagne CM360 associée à la session

  • sessionCm360CreativeFormat Format de la création CM360 de la session

  • sessionCm360CreativeId ID de la création CM360 de la session

  • sessionCm360CreativeName Nom de la création CM360 de la session

  • sessionCm360CreativeType Type de création CM360 de la session

  • sessionCm360CreativeTypeId ID du type de création CM360 de la session

  • sessionCm360CreativeVersion Version de la création CM360 de la session

  • sessionCm360Medium Support CM360 de la session

  • sessionCm360PlacementCostStructure Type de facturation de l'emplacement CM360 associé à la session

  • sessionCm360PlacementId ID de l'emplacement CM360 associé à la session

  • sessionCm360PlacementName Nom de l'emplacement CM360 associé à la session

  • sessionCm360RenderingId ID du rendu CM360 associé à la session

  • sessionCm360SiteId ID du site CM360 associé à la session

  • sessionCm360SiteName Nom du site CM360 associé à la session

  • sessionCm360Source Source CM360 de la session

  • sessionCm360SourceMedium Source / support CM360 de la session

Dimensions d'intégration Google Display & Video 360 (DV360) :

  • dv360AdvertiserId Référence annonceur DV360

  • dv360AdvertiserName Nom de l'annonceur DV360

  • dv360CampaignId ID de la campagne DV360

  • dv360CampaignName Nom de la campagne DV360

  • dv360CreativeFormat Format de la création DV360

  • dv360CreativeId ID de la création DV360

  • dv360CreativeName Nom de la création DV360

  • dv360ExchangeId ID de la place de marché DV360

  • dv360ExchangeName Nom de la place de marché DV360

  • dv360InsertionOrderId ID de l'ordre d'insertion DV360

  • dv360InsertionOrderName Nom de l'ordre d'insertion DV360

  • dv360LineItemId ID de l'élément de campagne DV360

  • dv360LineItemName Nom de l'élément de campagne DV360

  • dv360Medium Support DV360

  • dv360PartnerId ID du partenaire DV360

  • dv360PartnerName Nom du partenaire DV360

  • Source dv360Source DV360

  • dv360SourceMedium Source / support DV360

  • firstUserDv360AdvertiserId Première référence annonceur DV360 de l'utilisateur

  • firstUserDv360AdvertiserName Nom du premier annonceur DV360 de l'utilisateur

  • firstUserDv360CampaignId ID de la première campagne DV360 de l'utilisateur

  • firstUserDv360CampaignName Nom de la première campagne DV360 de l'utilisateur

  • firstUserDv360CreativeFormat Format de la première création DV360 de l'utilisateur

  • firstUserDv360CreativeId ID de la première création DV360 de l'utilisateur

  • firstUserDv360CreativeName Nom de la première création DV360 de l'utilisateur

  • firstUserDv360ExchangeId ID de la première place de marché DV360 de l'utilisateur

  • firstUserDv360ExchangeName Nom de la première place de marché DV360 de l'utilisateur

  • firstUserDv360InsertionOrderId ID du premier ordre d'insertion DV360 de l'utilisateur

  • firstUserDv360InsertionOrderName Nom du premier ordre d'insertion DV360 de l'utilisateur

  • firstUserDv360LineItemId Identifiant du premier élément de campagne DV360 de l'utilisateur

  • firstUserDv360LinteItemName Nom du premier élément de campagne DV360 de l'utilisateur

  • firstUserDv360Medium Première méthode DV360 de l'utilisateur

  • firstUserDv360PartnerId ID du premier partenaire DV360 de l'utilisateur

  • firstUserDv360PartnerName Nom du partenaire DV360 du premier utilisateur

  • firstUserDv360Source Première source DV360 de l'utilisateur

  • firstUserDv360SourceMedium Source / support DV360 du premier utilisateur

  • sessionDv360AdvertiserId Référence annonceur DV360 de la session

  • sessionDv360AdvertiserName Nom de l'annonceur DV360 de la session

  • sessionDv360CampaignId ID de la campagne DV360 de la session

  • sessionDv360CampaignName Nom de la campagne DV360 de la session

  • sessionDv360CreativeFormat Format de la création DV360 de la session

  • sessionDv360CreativeId ID de la création DV360 de la session

  • sessionDv360CreativeName Nom de la création DV360 de la session

  • sessionDv360ExchangeId ID de la place de marché DV360 de la session

  • sessionDv360ExchangeName Nom de la place de marché DV360 de la session

  • sessionDv360InsertionOrderId ID de l'ordre d'insertion DV360 de la session

  • sessionDv360InsertionOrderName Nom de l'ordre d'insertion DV360 de la session

  • sessionDv360LineItemId ID de l'élément de campagne DV360 de la session

  • sessionDv360LineItemName Nom de l'élément de campagne DV360 de la session

  • sessionDv360Medium Support DV360 de la session

  • sessionDv360PartnerId ID du partenaire DV360 de la session

  • sessionDv360PartnerName Nom du partenaire DV360 de la session

  • sessionDv360Source Source DV360 de la session

  • sessionDv360SourceMedium Source / support DV360 de la session

Dimensions de l'intégration Google Search Ads 360 (SA360) :

  • firstUserSa360AdGroupId ID du premier groupe d'annonces SA360 de l'utilisateur

  • firstUserSa360AdGroupName Nom du premier groupe d'annonces SA360 de l'utilisateur

  • firstUserSa360CampaignId ID de la première campagne SA360 de l'utilisateur

  • firstUserSa360CampaignName Première campagne SA360 de l'utilisateur

  • firstUserSa360CreativeFormat Format de la première création SA360 de l'utilisateur

  • firstUserSa360EngineAccountId Numéro du premier compte de moteur SA360 de l'utilisateur

  • firstUserSa360EngineAccountName Nom du premier compte de moteur SA360 de l'utilisateur

  • firstUserSa360EngineAccountType Type du premier compte de moteur SA360 de l'utilisateur

  • firstUserSa360KeywordText Texte du premier mot clé SA360 de l'utilisateur

  • firstUserSa360ManagerAccountId ID du compte administrateur SA360 (premier utilisateur)

  • firstUserSa360ManagerAccountName Nom du compte administrateur SA360 (premier utilisateur)

  • firstUserSa360Medium Premier support SA360 de l'utilisateur

  • firstUserSa360Query Première requête SA360 de l'utilisateur

  • firstUserSa360Source Première source SA360 de l'utilisateur

  • firstUserSa360SourceMedium Source / Support SA360 (premier utilisateur)

  • sa360AdGroupId ID du groupe d'annonces SA360

  • sa360CampaignId ID de la campagne SA360

  • sa360AdGroupName Nom du groupe d'annonces SA360

  • sa360CampaignName Campagne SA360

  • sa360CreativeFormat Format de la création SA360

  • sa360EngineAccountId ID de compte de moteur SA360

  • sa360EngineAccountName Nom du compte de moteur SA360

  • sa360EngineAccountType Type de compte de moteur SA360

  • sa360KeywordText Texte du mot clé SA360

  • sa360ManagerAccountId ID du compte administrateur SA360

  • sa360ManagerAccountName Nom du compte administrateur SA360

  • sa360Medium Support SA360

  • sa360Query Requête SA360

  • sa360Source Source SA360

  • sa360SourceMedium Source / Support SA360

  • sessionSa360AdGroupId ID du groupe d'annonces SA360 de la session

  • sessionSa360CampaignId ID de la campagne SA360 de la session

  • sessionSa360ManagerAccountId ID du compte administrateur SA360 (session)

  • sessionSa360ManagerAccountName Nom du compte administrateur SA360 (session)

  • sessionSa360SourceMedium Source / Support SA360 (session)

06/03/2024 : les audiences d'utilisateurs inactifs sont désormais compatibles avec l'exportation d'audiences.

La fonctionnalité d'exportation d'audience permet de mieux exporter les audiences d'utilisateurs inactifs. Les utilisateurs sont ajoutés à ces audiences sans événement éligible. Par exemple, un utilisateur peut être ajouté à l'audience s'il ne visite pas votre site Web pendant sept jours. Par exemple, les audiences d'utilisateurs inactifs incluent"Acheteurs inactifs pendant sept jours", "Utilisateurs inactifs pendant sept jours" et "Utilisateurs non avertis pendant sept jours". Pour en savoir plus sur ces audiences suggérées, consultez Audiences suggérées.

28/02/2024 : les exportations d'audience renvoient l'ID utilisateur spécifié dans le taggage.

Les exportations d'audience renvoient désormais l'ID utilisateur spécifié dans le taggage, même si les données fournies par l'utilisateur sont activées pour votre propriété. Si la collecte des données fournies par l'utilisateur est activée, ces données peuvent être envoyées à Google Analytics avec le User-ID dans le taggage pour améliorer la mesure. Pour en savoir plus, consultez Collecte des données fournies par les utilisateurs.

30/01/2024 : prise en charge des notifications Webhook pour les listes d'audience et les listes d'audience récurrentes dans la version alpha de l'API Data v1.

Les champs AudienceList.webhookNotification et RecurringAudienceList.webhookNotification peuvent être spécifiés lors de la création d'une liste d'audience (à l'aide de properties.audienceLists.create) ou d'une liste d'audience récurrente (à l'aide de properties.recurringAudienceLists.create).

Cette fonctionnalité vous permet de recevoir de manière asynchrone des notifications Webhook lorsqu'une liste d'audience devient disponible.

18/01/2024 : amélioration de la compatibilité pour les dimensions qui incluent la chaîne de requête ou le composant minute.

Les dimensions qui incluent la chaîne de requête sont désormais compatibles avec la plupart des champs. Les dimensions telles que pagePathPlusQueryString, unifiedPageScreen, pageLocation et fullPageUrl sont désormais compatibles avec de nombreux champs supplémentaires, y compris sessionSource, browser, city et landingPage.

Les dimensions qui incluent le composant minute sont désormais compatibles avec la plupart des champs. Les dimensions telles que minute, nthMinute et dateHourMinute sont désormais compatibles avec un ensemble similaire de champs supplémentaires.

Pour obtenir des informations complètes sur la compatibilité, consultez l'explorateur de dimensions et de métriques GA4.

13/12/2023 : paramètres personnalisés de portée article

Les dimensions personnalisées de portée article peuvent désormais être incluses dans les requêtes de l'API Data Analytics à l'aide de la syntaxe suivante :

Nom générique de l'API Description
customItem:parameter_name Dimension personnalisée de portée article pour parameter_name

Pour en savoir plus, consultez Dimensions et métriques de l'API.

05/12/2023 : les listes d'audience sont disponibles dans la version bêta de l'API Data v1 en tant qu'exportations d'audience.

La fonctionnalité "Listes d'audience" a été renommée Exportations d'audience et ajoutée à la version bêta de l'API Data v1.

Ajout des méthodes suivantes à la version bêta de l'API Data v1 :

28/11/2023 : ajout de samplingMetadatas à la réponse du rapport

Ajout de samplingMetadatas à ResponseMetaData. Cette collection contiendra un SampleMetadata pour chaque période de la requête pour laquelle les résultats ont été échantillonnés. Google Analytics n'appliquera l'échantillonnage que lorsqu'il prévoit que les limites de cardinalité réduiront la qualité des données.

28/11/2023 : ajout de la fonctionnalité d'exportation récurrente de listes d'audience à la version alpha de l'API Data v1

Ajout des méthodes properties.recurringAudienceLists.create, properties.recurringAudienceLists.create, properties.recurringAudienceLists.list à l'API Data v1 alpha.

Cette fonctionnalité vous permet de générer des listes d'audience quotidiennement à mesure que les membres de l'audience changent. Les listes d'audience récurrentes vous permettent de travailler avec les résultats d'adhésion à l'audience les plus récents.

13/10/2023 : ajout de la compatibilité avec les audiences dont la durée d'appartenance est d'un jour

Les audiences dont la durée d'appartenance est d'un jour sont désormais compatibles avec la fonctionnalité d'exportation des listes d'audience.

12/09/2023 : règles de tri par défaut pour AudienceList

Par défaut, les rapports créés à l'aide de la fonctionnalité d'exportation des listes d'audience suivent les mêmes règles de tri que les autres méthodes de reporting de l'API Data : le tri est effectué par ordre décroissant selon la première colonne, puis par ordre décroissant selon la deuxième colonne, etc.

Avant ce changement, vous avez peut-être reçu le rapport suivant :

deviceId isAdsPersonalizationAllowed
ABC true
DAC faux
ABC faux
AAA true

Après ce changement, vous recevrez le rapport suivant :

deviceId isAdsPersonalizationAllowed
AAA true
ABC faux
ABC true
DAC faux

15/08/2023 : ajout de la dimension isLimitedAdTracking au schéma d'exportation des listes d'audience

  • isLimitedAdTracking Il s'agit du paramètre "Limiter le suivi des annonces" de l'appareil. Les valeurs possibles sont true, false et (not set).

    Pour en savoir plus, consultez Dimensions des listes d'audience.

15/08/2023 : ajout de la dimension currencyCode et de la métrique itemDiscountAmount

  • currencyCode Code de devise locale (basé sur la norme ISO 4217) de l'événement e-commerce. Par exemple, "USD" ou "GBP".

  • itemDiscountAmount Valeur monétaire des remises sur les articles dans les événements d'e-commerce. Cette métrique est renseignée dans le taggage par le paramètre d'article "discount".

Pour en savoir plus, consultez Schéma de reporting de l'API Data.

10/08/2023 : ajout de la dimension isAdsPersonalizationAllowed au schéma d'exportation des listes d'audience

  • isAdsPersonalizationAllowed Indique si la personnalisation des annonces est autorisée. Si un utilisateur peut bénéficier de la personnalisation des annonces, isAdsPersonalizationAllowed renvoie true. Si un utilisateur ne peut pas bénéficier de la personnalisation des annonces, isAdsPersonalizationAllowed renvoie false.

    Pour en savoir plus, consultez Dimensions des listes d'audience.

2023-07-10 : listes d'audience

Ajout de la compatibilité avec les listes d'audience à l'API Data v1 alpha. Les listes d'audience incluent un instantané des utilisateurs de l'audience au moment de la création de la liste d'audience.

Les méthodes suivantes ont été ajoutées à l'API Data v1 alpha :

2023-05-19 : groupes de canaux personnalisés

Ajout de la compatibilité avec les groupes de canaux personnalisés dans la Data API.

11/05/2023 : modifications du quota de jetons.

Le système de quotas de l'API Data a été mis à jour pour permettre des frais plus précis.

Le nombre de jetons facturés pour chaque requête a été mis à jour en fonction de la modification du quota et rééquilibré de manière à permettre un plus grand nombre de requêtes de création de rapports simples, tout en facturant beaucoup plus de jetons de quota pour les rapports sur de grandes plages de dates.

Après ce changement, le coût de certaines requêtes restera le même, mais celui des requêtes plus complexes augmentera de manière significative. Par exemple, les requêtes portant sur plus de six mois de données peuvent facturer 1 000 jetons de quota ou plus.

Propriétés standards

Nom du quota Ancienne limite Nouvelle limite
Jetons Core par propriété et par jour 25 000 200 000
Jetons principaux par propriété et par heure 5 000 40 000
Jetons principaux par projet, par propriété et par heure 1 750 14 000
Jetons en temps réel par propriété et par jour 25 000 200 000
Jetons en temps réel par propriété et par heure 5 000 40 000
Jetons en temps réel par projet, par propriété et par heure 1 750 14 000
Jetons d'entonnoir par propriété et par jour 25 000 200 000
Jetons d'entonnoir par propriété et par heure 5 000 40 000
Jetons d'entonnoir par projet, par propriété et par heure 1 750 14 000

Propriétés Analytics 360

Nom du quota Ancienne limite Nouvelle limite
Jetons Core par propriété et par jour 250 000 2 000 000
Jetons principaux par propriété et par heure 50 000 400 000
Jetons principaux par projet, par propriété et par heure 17 500 140 000
Jetons en temps réel par propriété et par jour 250 000 2 000 000
Jetons en temps réel par propriété et par heure 50 000 400 000
Jetons en temps réel par projet, par propriété et par heure 17 500 140 000
Jetons d'entonnoir par propriété et par jour 250 000 2 000 000
Jetons d'entonnoir par propriété et par heure 50 000 400 000
Jetons d'entonnoir par projet, par propriété et par heure 17 500 140 000

02/03/2023 : ajout de dimensions de date.

  • dayOfWeekName Nom du jour de la semaine. Jour de la semaine en anglais. Cette dimension comporte les valeurs Sunday, Monday, etc.

  • isoWeek Semaine ISO de l'année. Numéro de la semaine ISO, où chaque semaine commence le lundi. Pour en savoir plus, consultez https://en.wikipedia.org/wiki/ISO_week_date. Exemples de valeurs : 01, 02 et 53.

  • Année ISO isoYear. Année ISO de l'événement. Pour en savoir plus, consultez https://en.wikipedia.org/wiki/ISO_week_date. Les valeurs possibles sont 2022 et 2023.

  • isoYearIsoWeek Semaine ISO de l'année ISO. Valeurs combinées de isoWeek et isoYear. Les valeurs possibles sont 201652 et 201701.

  • yearMonth Mois et année. Valeurs combinées de year et month. Exemples de valeurs : 202212 ou 202301.

  • yearWeek Semaine de l'année Valeurs combinées de year et week. Exemples de valeurs : 202253 ou 202301.

27/02/2023 : ajout de dimensions e-commerce.

  • itemListPosition Position dans la liste d'articles. Position d'un article (par exemple, un produit que vous vendez) dans une liste. Cette dimension est renseignée dans le taggage par le paramètre "index" du tableau "items".

  • itemLocationID ID de zone géographique de l'article. Lieu physique associé à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID Google Place qui correspond à l'élément associé. Vous pouvez également utiliser un ID de lieu personnalisé. Ce champ est renseigné dans le taggage par le paramètre "location_id" du tableau "items".

  • itemPromotionCreativeSlot Emplacement de la création pour la promotion sur l'article. Nom de l'emplacement de la création promotionnelle associée à l'article. Cette dimension peut être spécifiée dans le taggage par le paramètre creative_slot au niveau de l'événement ou de l'article. Si le paramètre est spécifié à la fois au niveau de l'événement et de l'article, le paramètre au niveau de l'article est utilisé.

21/02/2023 : ajout de la dimension "Page de destination + chaîne de requête".

  • landingPagePlusQueryString Page de destination + chaîne de requête Chemin de la page et chaîne de requête associés à la première page vue au cours d'une session.

Ce champ remplace la dimension landingPage, qui est obsolète et ne renverra plus de chaîne de requête à partir du 14 mai 2023.

28/01/2023 : ajout des métriques "Vues par utilisateur" et "Utilisateurs ayant fait défiler la page".

  • screenPageViewsPerUser vues par utilisateur. Nombre d'écrans d'application ou de pages Web vus par les utilisateurs actifs. Les vues répétées d'une même page ou d'un même écran sont comptabilisées. (screen_view + page_view events) / active users.

  • scrolledUsers Utilisateurs ayant fait défiler la page Nombre d'utilisateurs uniques qui ont fait défiler au moins 90 % de la page vers le bas.

23/01/2023 : ajout des dimensions "Continent" et "ID du continent".

  • continent Continent. Continent sur lequel l'activité de l'utilisateur a été enregistrée. (par exemple, Americas ou Asia).

  • continentId Identifiant du continent. ID géographique du continent sur lequel l'activité de l'utilisateur a été enregistrée, déterminé par son adresse IP.

23/01/2023 : ajout de la dimension "ID du filtre de données test".

  • testDataFilterId ID du filtre de données test. Identifiant numérique d'un filtre de données en état de test. Les filtres de données vous permettent d'inclure ou d'exclure des données d'événements de vos rapports en fonction des valeurs des paramètres d'événement. Pour en savoir plus, consultez https://support.google.com/analytics/answer/10108813.

18/10/2022 : ajout de métriques sur les annonces.

  • advertiserAdClicks Clics sur les annonces Nombre total de fois où les utilisateurs ont cliqué sur une annonce pour accéder à la propriété.
  • advertiserAdCost Coût des annonces. Montant total que vous avez payé pour vos annonces.
  • advertiserAdCostPerClick Coût par clic sur vos annonces. Le coût par clic (CPC) correspond au coût de l'annonce divisé par le nombre de clics qu'elle a générés.
  • advertiserAdCostPerConversion Coût par conversion. Le coût par conversion correspond au coût des annonces divisé par le nombre de conversions.
  • advertiserAdImpressions Impressions d'annonces. Nombre total d'impressions.
  • returnOnAdSpend Retour sur les dépenses publicitaires. Le retour sur les dépenses publicitaires (ROAS) correspond au revenu total divisé par le coût publicitaire de l'annonceur.

2022-10-17 : ajout de métriques de portée article.

  • itemsAddedToCart Articles ajoutés au panier. Nombre d'unités ajoutées au panier pour un même article.
  • itemsCheckedOut articles payés. Nombre d'unités d'un même article pour lesquelles le paiement a été effectué.
  • itemsClickedInList Articles sur lesquels des utilisateurs ont cliqué dans la liste. Nombre d'unités sur lesquelles les utilisateurs ont cliqué dans une liste pour un seul article.
  • itemsClickedInPromotion Articles sur lesquels des utilisateurs ont cliqué dans la promotion. Nombre d'unités sur lesquelles les utilisateurs ont cliqué dans une promotion pour un seul article.
  • itemsViewed articles consultés. Nombre d'unités consultées pour un même article.
  • itemsViewedInList Articles consultés dans la liste. Nombre d'unités d'un même article consultées dans une liste.
  • itemsViewedInPromotion Articles consultés dans la promotion. Nombre d'unités consultées dans une promotion pour un seul article.

13/09/2022 : annonce des modifications apportées à la compatibilité du schéma.

Les modifications incompatibles suivantes prendront effet le 1er décembre 2022 :

  1. Les dimensions de portée article telles que itemName deviennent incompatibles avec les métriques de portée événement telles que eventCount. Les dimensions de portée "Article" resteront compatibles avec les métriques de portée "Article" comme itemRevenue, les métriques basées sur les utilisateurs comme activeUsers et les métriques basées sur les sessions comme sessions.

  2. Les dimensions d'attribution telles que source deviennent incompatibles avec certaines métriques de portée événement, comme eventCount. Les dimensions d'attribution resteront compatibles avec les métriques attribuables telles que conversions, les métriques basées sur les utilisateurs telles que activeUsers et les métriques basées sur les sessions telles que sessions.

  3. Les dimensions qui incluent la chaîne de requête, comme pagePathPlusQueryString, ne seront compatibles qu'avec un ensemble limité de dimensions et de métriques.

01/09/2022 : modifications des quotas.

  • Les quotas Requests per day, Requests Per Minute et Requests Per Minute Per User sont supprimés de l'API Data.

  • Le quota Tokens Per Project Per Property Per Hour a été ajouté à l'API.

  • Chaque requête consomme du quota pour Tokens Per Property Per Hour et Tokens Per Project Per Property Per Hour.

    Pour en savoir plus sur les nouveaux quotas, consultez la documentation sur les quotas.

03/08/2022 : ajout de dimensions SA360 de portée session.

  • sessionSa360AdGroupName Nom du groupe d'annonces SA360 de la session. Nom du groupe d'annonces Search Ads 360 ayant généré cette session.

  • sessionSa360CampaignName Campagne SA360 de la session. Nom de la campagne Search Ads 360 ayant généré cette session.

  • sessionSa360CreativeFormat Format de la création SA360 de la session. Type de création dans Search Ads 360 ayant généré cette session. Par exemple, "Annonce responsive sur le Réseau de Recherche" ou "Annonce textuelle agrandie".

  • sessionSa360EngineAccountId ID du compte de moteur SA360 de la session. ID du compte de moteur dans SA360 ayant généré cette session.

  • sessionSa360EngineAccountName Nom du compte de moteur SA360 de la session. Nom du compte de moteur dans SA360 ayant généré cette session.

  • sessionSa360EngineAccountType Type de compte de moteur SA360 de la session. Type du compte de moteur dans Search Ads 360 qui a généré cette session. Par exemple, "google ads", "bing" ou "baidu".

  • sessionSa360Keyword Texte du mot clé SA360 de la session. Mot clé du moteur de recherche provenant de Search Ads 360 ayant généré cette session.

  • sessionSa360Medium Support SA360 de la session. Mot clé du moteur de recherche provenant de Search Ads 360 ayant généré cette session. (par exemple, "cpc").

  • sessionSa360Query Requête SA360 de la session. Requête de recherche Search Ads 360 ayant généré cette session.

  • sessionSa360Source Source SA360 de la session. Source du trafic provenant de Search Ads 360 ayant généré cette session. Par exemple, "example.com" ou "google".

  • Les dimensions sessionCampaignId et sessionCampaignName sont désormais compatibles avec les campagnes Search Ads 360.

11/07/2022 : ajout de métriques sur le taux de conversion.

Taux de conversion

  • sessionConversionRate Pourcentage de sessions au cours desquelles un événement de conversion a été déclenché.

  • userConversionRate Pourcentage d'utilisateurs ayant déclenché un événement de conversion.

Métriques sur le taux de conversion pour une conversion

  • sessionConversionRate:event_name Pourcentage de sessions au cours desquelles un événement de conversion spécifique a été déclenché.

  • userConversionRate:event_name Pourcentage d'utilisateurs ayant déclenché un événement de conversion spécifique.

05/05/2022 : ajout de la fonctionnalité de création de rapports sur les entonnoirs au canal alpha.

16/02/2022 : ajout de dimensions.

Termes et contenu manuels

  • firstUserManualAdContent Premier contenu d'annonce manuel de l'utilisateur. Contenu d'annonce qui a permis d'acquérir l'utilisateur pour la première fois. Valeur renseignée par le paramètre utm_content.

  • firstUserManualTerm Premier terme manuel de l'utilisateur. Terme qui a permis d'acquérir l'utilisateur pour la première fois. Valeur renseignée par le paramètre utm_term.

  • manualAdContent Contenu d'annonce manuel. Contenu de l'annonce attribué à l'événement de conversion. Valeur renseignée par le paramètre utm_content.

  • manualTerm Terme manuel. Terme attribué à l'événement de conversion. Valeur renseignée par le paramètre utm_term.

  • sessionManualAdContent Contenu d'annonce manuel associé à la session. Contenu de l'annonce qui a généré une session. Valeur renseignée par le paramètre utm_content.

  • sessionManualTerm Terme manuel associé à la session. Terme ayant généré une session. Valeur renseignée par le paramètre utm_term.

Analyse des plantages

  • crashAffectedUsers Utilisateurs concernés par un plantage. Nombre d'utilisateurs ayant enregistré un plantage dans cette ligne du rapport.

  • crashFreeUsersRate Taux d'utilisateurs n'ayant pas subi de plantage.

Application/Web

  • averageSessionDuration Durée moyenne (en secondes) des sessions des utilisateurs.

  • newVsReturning Nouveaux utilisateurs / utilisateurs connus

  • screenPageViewsPerSession Vues par session.

  • landingPage Page de destination. Chemin de la page et chaîne de requête associés à la première page vue au cours d'une session.

  • platformDeviceCategory Plate-forme et type d'appareil sur lesquels votre site Web ou votre application mobile ont été exécutés.

Application mobile

  • averagePurchaseRevenuePerUser Revenus moyens des achats par utilisateur.

  • firstTimePurchaserConversionRate Pourcentage d'utilisateurs actifs ayant effectué leur premier achat.

  • firstTimePurchasersPerNewUser Nombre moyen de nouveaux acheteurs par nouvel utilisateur.

  • dauPerMau UAJ / UAM. Pourcentage (réinitialisé quotidiennement) des utilisateurs actifs sur 30 jours qui sont aussi actifs sur une journée.

  • dauPerWau UAJ / UAS. Pourcentage (réinitialisé quotidiennement) des utilisateurs actifs sur sept jours qui sont aussi actifs sur une journée.

  • wauPerMau UAS / UAM. Pourcentage (réinitialisé quotidiennement) des utilisateurs actifs sur 30 jours qui sont aussi actifs sur sept jours.

  • purchaserConversionRate Pourcentage d'utilisateurs actifs ayant effectué au moins une transaction d'achat.

  • transactionsPerPurchaser Transactions par acheteur.

Campagne Google Ads

  • firstUserGoogleAdsCampaignType Type de campagne Google Ads qui a touché l'utilisateur en premier.

  • googleAdsCampaignType Type de campagne Google Ads attribuée à l'événement de conversion.

  • sessionGoogleAdsCampaignType Type de campagne Google Ads ayant généré cette session.

07/09/2021 : ajout de dimensions de date et d'heure.

  • dateHourMinute Valeurs combinées de la date, de l'heure et des minutes au format AAAAMMJJHHMM.

  • minute : minute à deux chiffres de l'heure à laquelle l'événement a été consigné.

  • nthMinute Nombre de minutes écoulées depuis le début de la période.

07/09/2021 : ajout de dimensions renseignées par des paramètres d'événement.

  • achievementId Identifiant d'un succès dans un jeu pour un événement.

  • character Personnage du joueur dans un jeu pour un événement.

  • fileExtension Extension du fichier téléchargé.

  • fileName Chemin de la page du fichier téléchargé.

  • groupId Identifiant du groupe de joueurs dans un jeu pour un événement.

  • linkClasses Attribut class HTML pour un lien sortant.

  • linkDomain Domaine de destination du lien sortant.

  • linkId Attribut id HTML pour un lien sortant ou un téléchargement de fichier.

  • linkText Texte du lien pour un téléchargement de fichier.

  • linkUrl URL complète d'un lien sortant ou d'un téléchargement de fichier.

  • method Méthode de déclenchement d'un événement.

  • outbound renvoie "true" si le lien renvoie vers un site qui ne fait pas partie du domaine de la propriété.

  • pageLocation Protocole, nom d'hôte, chemin de page et chaîne de requête des pages Web visitées.

  • pageReferrer URL de provenance complète, y compris le nom d'hôte et le chemin d'accès.

  • percentScrolled Pourcentage de la page que l'utilisateur a fait défiler vers le bas (par exemple, "90").

  • searchTerm Terme recherché par l'utilisateur.

  • videoProvider Source de la vidéo (par exemple, "youtube").

  • videoTitle Titre de la vidéo.

  • videoUrl URL de la vidéo.

  • visible renvoie "true" si le contenu est visible.

  • unifiedPagePathScreen Chemin de la page (Web) ou classe de l'écran (application) sur lesquels l'événement a été enregistré.

07/09/2021 : modifications apportées au schéma de l'API.

Modifications apportées aux dimensions existantes :

  • unifiedPageScreen Pour les événements générés sur le Web, cette dimension renvoie désormais le chemin de page et la chaîne de requête sur lesquels l'événement a été enregistré.

Annonce des modifications à venir :

  • firstUserTrafficOrigin Origine du trafic qui a touché l'utilisateur en premier. Veuillez ne pas vous fier à ce champ qui renvoie "Manuel" pour le trafic qui utilise des UTM. Ce champ passera de "Manuel" à "(not set)" lors du lancement d'une prochaine fonctionnalité.

  • sessionTrafficOrigin Origine du trafic de la campagne associée à la session. Veuillez ne pas vous fier à ce champ qui renvoie "Manuel" pour le trafic qui utilise des UTM. Ce champ passera de "Manuel" à "(not set)" lors du lancement d'une prochaine fonctionnalité.

  • trafficOrigin Origine du trafic de la campagne associée à l'événement de conversion. Veuillez ne pas vous fier à ce champ qui renvoie "Manuel" pour le trafic qui utilise des UTM. Ce champ passera de "Manuel" à "(not set)" lors du lancement d'une prochaine fonctionnalité.

7 septembre 2021 : la méthode checkCompatibility a été ajoutée à l'API.

La méthode checkCompatibility liste les dimensions et les métriques qui peuvent être ajoutées à une demande de rapport tout en conservant la compatibilité.

21/07/2021 : modifications apportées aux rapports en temps réel.

Il est désormais possible de spécifier les plages de minutes des données d'événement à lire à l'aide du paramètre minuteRanges de la méthode runRealtimeReport.

2021-07-21 : ajout de dimensions de regroupement de canaux.

De nouvelles dimensions de regroupement de canaux ont été ajoutées au schéma de création de rapports de l'API Data :

  • firstUserDefaultChannelGrouping Premier regroupement de canaux par défaut de l'utilisateur.

  • defaultChannelGrouping Regroupement de canaux par défaut.

10/06/2021 : modifications apportées au schéma de l'API.

  • La dimension minutesAgo a été ajoutée au schéma en temps réel de l'API Data. Elle peut être utilisée dans les requêtes à la méthode runRealtimeReport. Cette dimension indique le nombre de minutes écoulées depuis la collecte d'un événement. 00 correspond à la minute actuelle et 01 à la minute précédente.

  • Ajout de la dimension googleAdsCreativeId au schéma de l'API Data. Cette dimension contient l'ID de la création Google Ads attribuée à l'événement de conversion.

  • Ajout de la dimension sessionGoogleAdsCreativeId au schéma de l'API Data. Cette dimension contient l'ID de la création Google Ads qui a généré une session sur votre site Web ou dans votre application.

  • La dimension firstUserCreativeId a été renommée firstUserGoogleAdsCreativeId dans le schéma de l'API Data. Cette dimension contient l'ID de la création Google Ads qui a permis d'acquérir l'utilisateur pour la première fois.

09/04/2021 : la version bêta de l'API Google Analytics Data v1 est disponible.

  • Le point de terminaison de l'API a été mis à jour et est désormais https://analyticsdata.googleapis.com/v1beta.

  • Les méthodes runReport, runPivotReport, batchRunReports et batchRunPivotReports acceptent désormais l'ID d'une propriété Google Analytics 4 dans le paramètre property du chemin d'URL au lieu du champ entity d'un corps de requête :

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • Les bibliothèques clientes de l'API ont été mises à jour pour utiliser le nouveau point de terminaison de l'API.

19/02/2021 : modifications apportées à la pagination.

  • La taille de réponse par défaut des rapports est passée de 10 à 10 000 lignes de données d'événement.

  • La valeur "limit" : -1 qui était utilisée pour indiquer une tentative de récupération de toutes les lignes n'est plus acceptée dans RunReportRequest.

  • La valeur maximale du champ limit est définie sur 100000. Utilisez la pagination pour récupérer les rapports contenant plus de 100 000 lignes.

08/02/2021 : nouvelles dimensions et métriques d'e-commerce.

De nouvelles dimensions et métriques d'e-commerce ont été ajoutées au schéma de l'API :

Dimensions : adFormat, adSourceName, adUnitName, itemBrand, itemCategory, itemCategory2, itemCategory3, itemCategory4, itemCategory5 itemId, itemListId, itemListName, itemName, itemPromotionCreativeName, itemPromotionId, itemPromotionName, orderCoupon, transactionId.

Métriques : adUnitExposure, addToCarts, cartToViewRate, checkouts, ecommercePurchases, firstTimePurchasers, itemListClickThroughRate, itemListClicks, itemListViews, itemPromotionClickThroughRate, itemPromotionClicks, itemPromotionViews, itemPurchaseQuantity, itemRevenue, itemViews, publisherAdClicks, publisherAdImpressions, totalPurchasers.

08/02/2021 : ajout de dimensions de campagne.

De nouvelles dimensions de campagne ont été ajoutées au schéma de l'API : campaignId, campaignName, googleAdsAccountName, googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType, source, trafficOrigin

08/02/2021 : modifications apportées aux dimensions dayOfWeek et week.

  • La valeur de la dimension dayOfWeek commence désormais par 0 au lieu de 1.

  • La valeur de la dimension week commence désormais par "01" et renvoie un nombre à deux chiffres compris entre 01 et 53. Chaque semaine commence le dimanche. Le 1er janvier correspond toujours à la semaine 01.

28/01/2021 : ajout de variantes d'agrégation pour les métriques personnalisées.

Chaque métrique personnalisée qu'une propriété enregistre crée trois variantes de métriques d'API : une somme, une moyenne et un nombre.

28/01/2021 : ajout de dimensions Date/heure.

Les nouvelles dimensions suivantes ont été ajoutées au schéma de l'API : hour, nthHour, nthYear et dateHour.

28/01/2021 : l'API Data a réduit le nombre de jetons de quota facturés par requête.

L'API Data a réduit le nombre de jetons de quota facturés par requête. Les limites de quota pour les jetons de quota de propriété par heure et par jour n'ont pas été modifiées.

09/11/2020 : la méthode getUniversalMetadata a été supprimée.

La méthode getUniversalMetadata a été supprimée. Veuillez utiliser getMetadata. La plage de dates maximale d'un an par requête API a été supprimée.

02/11/2020 : ajout d'une méthode de reporting en temps réel.

Pour obtenir des exemples, consultez Créer un rapport en temps réel. Pour la documentation de référence REST, consultez runRealtimeReport.

2020-10-19 : mise à jour des artefacts de la bibliothèque cliente.

Mise à jour des artefacts de la bibliothèque cliente, ainsi que des instructions d'utilisation et des exemples de code.

13/10/2020 : les propriétés Application + Web ont été renommées "Google Analytics 4" (GA4).

08/10/2020 : la méthode getMetadata a été ajoutée à l'API.

La méthode getMetadata renvoie les dimensions et métriques personnalisées disponibles pour l'ID de propriété GA4 spécifié, ainsi que les métadonnées universelles.

08/10/2020 : les dimensions et métriques personnalisées sont disponibles dans les rapports.

Pour en savoir plus sur les dimensions et les métriques personnalisées, consultez la documentation sur le schéma de l'API. Cette mise à jour inclut les dimensions et métriques personnalisées de portée événement, ainsi que les dimensions personnalisées de portée utilisateur.