Changelog

Pour recevoir les annonces officielles concernant l'API Google Analytics, abonnez-vous au groupe de notification de l'API Google Analytics.

14/09/2026 Ajout de la compatibilité avec les requêtes conversationnelles dans la version v1 alpha

Ajout de la méthode properties.chat pour interagir avec les données Google Analytics à l'aide de requêtes en langage naturel.

14/09/2026 : ajout des raisons de la troncature des données aux réponses des rapports

Ajout du champ dataTruncationReasons à ResponseMetaData dans les versions v1 beta et v1 alpha. Lorsque les données d'un rapport sont tronquées, ce champ inclut une liste d'objets DataTruncationReason qui incluent le type de troncature, un message descriptif et les dates concernées.

23/04/2026 : ajout de la prise en charge du reporting des conversions dans la version 1 alpha

Ajout de la possibilité de récupérer des données du rapport sur les performances des conversions à l'aide de la méthode runReport dans la version alpha de l'API Data v1. Vous pouvez ainsi accéder aux mêmes données de conversion que celles disponibles dans l'interface utilisateur de Google Analytics sous Publicité > Performances des conversions.

  • Ajout du champ ConversionSpec à RunReportRequest, qui permet de filtrer les conversions à l'aide de conversionActions (ID d'action de conversion) et de sélectionner un AttributionModel (DATA_DRIVEN ou LAST_CLICK).
  • Ajout du champ Section à ResponseMetaData pour identifier si les données du rapport proviennent d'un reporting standard (SECTION_REPORT) ou d'un reporting des conversions (SECTION_ADVERTISING).

Mise à jour de la méthode getMetadata dans l'API Data v1 alpha pour fournir des informations sur le reporting des conversions :

  • Ajout du champ conversions à la réponse, qui renvoie une liste d'objets ConversionMetadata mappant les ID d'action de conversion aux noms à afficher.
  • Ajout du champ sections à DimensionMetadata et MetricMetadata pour identifier si un champ spécifique est compatible avec le reporting standard, le reporting des conversions ou les deux.

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

Le champ samplingLevel de la méthode properties.runReportTask vous permet de contrôler le niveau d'échantillonnage du rapport.

Cette fonctionnalité permet aux propriétés Google Analytics 360 d'accéder à des limites d'échantillonnage plus élevées (un 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 nombre d'événements élevé.

18/09/2024 Ajout de la fonctionnalité d'instantané des quotas de propriété

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.

28/06/2024 Ajout du quota "erreurs client par projet et par propriété"

Le nombre d'erreurs du serveur d'API autorisées par projet et par propriété est désormais limité à 10 000 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. 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 vers 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 reporting de l'API Data v1beta ont été mises à jour pour accepter 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 requête, la réponse contient la colonne comparison identifiant chaque comparaison.

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

08/05/2024 : ajout des tâches de rapport, une fonctionnalité de reporting asynchrone, à la version v1alpha de l'API Data.

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

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

06/05/2024 : Nouvelles dimensions pour les événements clés

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

Modifiez vos demandes de rapport qui utilisent la dimension isConversionEvent pour utiliser la dimension isKeyEvent à la place.

Modifiez toutes les demandes de rapport qui utilisent une métrique obsolète dans le tableau suivant 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 des métriques d'événements clés pour un événement clé dans vos demandes de rapport.

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, le nom de l'UI et la description de l'événement clé.
  • 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 du groupe de canaux principal, de la source de trafic manuel et des dimensions spécifiques à l'intégration CM360, DV360 et SA360 au schéma de l'API Data.

Dimensions d'audience :

  • audienceId ID d'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 manuel" :

  • manualCampaignId ID de campagne manuel

  • manualCampaignName Nom de campagne manuel

  • manualCreativeFormat Format de création manuel

  • manualMarketingTactic Stratégie marketing manuelle

  • manualMedium Support manuel

  • manualSource source manuelle

  • 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 Premier support manuel de l'utilisateur

  • firstUserManualSource Première source manuelle de l'utilisateur

  • firstUserManualSourceMedium Premier "Source/Support" manuel 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 associé à la session

  • sessionManualSourcePlatform Plate-forme source du manuel de session

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

  • cm360AccountId ID de 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

  • Type de facturation de l'emplacement CM360 (cm360PlacementCostStructure)

  • 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 du premier 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 création CM360 du premier utilisateur

  • firstUserCm360CreativeId ID de la création CM360 du premier utilisateur

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

  • firstUserCm360CreativeType Type de création CM360 du premier 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 Coût de la structure de placement du premier utilisateur CM360

  • 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 de 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 associé à 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 associée à la session

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

  • sessionCm360CreativeName Nom de la création CM360 associée à 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 de 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

  • dv360Source source DV360

  • dv360SourceMedium Source/support DV360

  • firstUserDv360AdvertiserId Premier utilisateur DV360 (référence annonceur)

  • 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 création DV360 du premier 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 place de marché DV360 du premier 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 de l'ordre d'insertion DV360 du premier 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 Premier support 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 d'intégration de Google Search Ads 360 (SA360) :

  • firstUserSa360AdGroupId ID du groupe d'annonces SA360 (premier 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 création SA360 du premier utilisateur

  • firstUserSa360EngineAccountId ID de compte de moteur SA360 du premier utilisateur

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

  • firstUserSa360EngineAccountType Type de compte de moteur SA360 du premier utilisateur

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

  • firstUserSa360ManagerAccountId ID de compte administrateur SA360 (premier utilisateur)

  • firstUserSa360ManagerAccountName Nom du compte administrateur SA360 (premier utilisateur)

  • firstUserSa360Medium Premier utilisateur SA360

  • 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 de 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 Compatibilité avec les audiences d'utilisateurs inactifs dans les exportations d'audiences.

La fonctionnalité d'exportation d'audience est plus adaptée à l'exportation d'audiences d'utilisateurs inactifs. Les utilisateurs entrent dans ces audiences sans événement éligible. Par exemple, l'utilisateur peut entrer dans 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'audiences 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 lors du taggage pour améliorer la mesure. Pour en savoir plus, consultez Collecte des données fournies par l'utilisateur.

30/01/2024 : compatibilité des notifications de webhook avec les listes d'audience et les listes d'audience récurrentes dans la version 1 alpha de l'API Data.

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 de webhook lorsqu'une liste d'audience devient disponible.

18/01/2024 : amélioration de la compatibilité des dimensions qui incluent la chaîne de requête ou le composant de 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 la composante "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 Analytics Data à l'aide de la syntaxe suivante :

Nom d'API générique 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 plage de dates de la requête pour laquelle les résultats ont été échantillonnés. Google Analytics n'appliquera l'échantillonnage que s'il prévoit que les limites de cardinalité réduiront la qualité des données.

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

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

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'appartenance à l'audience les plus récents.

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

Les audiences dont la durée de validité 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 d'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 : l'ordre est décroissant pour la première colonne, puis décroissant pour la deuxième colonne, etc.

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

deviceId isAdsPersonalizationAllowed
ABC true
DAC faux
ABC faux
AAA true

Après cette modification, 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 de la liste d'audience

  • isLimitedAdTracking : paramètre "Limiter le suivi des annonces" de l'appareil. Les valeurs possibles incluent 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 la devise locale (conformément à la norme ISO 4217) de l'événement d'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 de la liste d'audience

  • isAdsPersonalizationAllowed La personnalisation des annonces est-elle autorisée ? Si un utilisateur peut bénéficier de la personnalisation des annonces, isAdsPersonalizationAllowed affichera la valeur true. Si un utilisateur ne peut pas bénéficier de la personnalisation des annonces, isAdsPersonalizationAllowed affichera la valeur false.

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

10/07/2023 : listes d'audience

Listes d'audience ajoutées à la version alpha de l'API Data v1. 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 à la version alpha de l'API Data v1 :

19/05/2023 : Groupes de canaux personnalisés

Groupes de canaux personnalisés compatibles avec l'API Data.

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

Le système de quotas de l'API Data a été mis à jour pour permettre une facturation plus précise.

Le nombre de jetons facturés pour chaque requête a été mis à jour conformément à la modification du quota et rééquilibré de manière à permettre un plus grand nombre de requêtes de reporting simples, tout en facturant beaucoup plus de jetons de quota pour les rapports sur de longues périodes.

Après ce changement, même si les frais pour certaines requêtes resteront les mêmes, vous constaterez une augmentation notable des frais pour les requêtes plus complexes. Par exemple, les requêtes portant sur plus de six mois de données peuvent consommer 1 000 jetons de quota ou plus.

Propriétés standards

Nom du quota Ancienne limite Nouvelle limite
Jetons principaux 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 principaux 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 peut avoir les valeurs Sunday, Monday, etc.

  • isoWeek : semaine ISO de l'année. Numéro de 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.

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

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

  • yearMonth Mois de l'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 d'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 lors du taggage par le paramètre "index" dans le 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 de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Ce champ est renseigné lors du taggage par le paramètre "location_id" dans le 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é 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 + 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 sera mise à jour pour ne pas renvoyer de chaîne de requête le 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 utilisateur actif. 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 ayant fait défiler au moins 90 % de la page.

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 : ID du continent. ID géographique du continent d'où provient l'activité de l'utilisateur, dérivé de 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 des métriques d'annonces.

  • advertiserAdClicks clic 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 sur vos annonces correspond au coût des annonces divisé par le nombre de clics sur les annonces. Il est souvent abrégé en "CPC".
  • 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 des annonces pour l'annonceur.

17/10/2022 : 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 article payé. Nombre d'unités d'un même article qui ont été payées.
  • itemsClickedInList Articles sur lesquels des utilisateurs ont cliqué dans la liste. Nombre d'unités d'un même article sur lesquelles des utilisateurs ont cliqué dans une liste.
  • itemsClickedInPromotion Articles sur lesquels des utilisateurs ont cliqué dans la promotion. Nombre d'unités d'un même article sur lesquelles les utilisateurs ont cliqué dans une promotion.
  • itemsViewed élément consulté. 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 d'un même article vues dans une promotion.

13/09/2022 : annonce des modifications de compatibilité des schémas.

Le 1er décembre 2022, les modifications destructives suivantes seront apportées :

  1. Les dimensions de portée article comme itemName deviennent incompatibles avec les métriques de portée événement comme 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 l'utilisateur comme activeUsers et les métriques basées sur la session 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 l'utilisateur telles que activeUsers et les métriques basées sur la session 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 le 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 des dimensions SA360 au niveau de la 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 de 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 issu de Search Ads 360 ayant généré cette session.

  • sessionSa360Medium Support SA360 de la session. Mot clé du moteur de recherche issu 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".

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

11/07/2022 : ajout des métriques de 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 de 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 de conversion au canal alpha.

16/02/2022 : ajout de nouvelles dimensions.

Terme et contenu manuels

  • firstUserManualAdContent Premier contenu d'annonce manuel de l'utilisateur. Contenu de l'annonce à l'origine de la première acquisition de l'utilisateur. Valeur inséré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 insérée par le paramètre utm_term.

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

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

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

  • sessionManualTerm Terme manuel associé à la session. Terme ayant généré une session. Valeur inséré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.

Appli/Web

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

  • newVsReturning Utilisateurs nouveaux/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 application mobile ou votre site Web 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 la campagne Google Ads à l'origine de la première acquisition de l'utilisateur.

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

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

07/09/2021 : ajout de nouvelles dimensions de date/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 plage de dates.

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

  • achievementId : ID de la réussite 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 Mode de déclenchement d'un événement.

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

  • pageLocation Le protocole, le nom d'hôte, le chemin de la page et la 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 lequel l'événement a été enregistré.

07/09/2021 : modifications du 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 la page et la chaîne de requête sur lesquels l'événement a été enregistré.

Annonce des changements à venir :

  • firstUserTrafficOrigin Origine du trafic qui a permis d'acquérir l'utilisateur pour la première fois. Veuillez ne pas vous fier à ce champ qui renvoie "Manual" pour le trafic qui utilise des UTM. Ce champ ne renverra plus "Manual", mais "(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 "Manual" pour le trafic qui utilise des UTM. Ce champ ne renverra plus "Manual", mais "(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 "Manual" pour le trafic qui utilise des UTM. Ce champ ne renverra plus "Manual", mais "(not set)" lors du lancement d'une prochaine fonctionnalité.

07/09/2021 : méthode checkCompatibility 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 maintenant la compatibilité.

21/07/2021 : Modifications apportées aux rapports 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.

21/07/2021 : nouvelles dimensions de regroupement de canaux.

De nouvelles dimensions de regroupement de canaux ont été ajoutées au schéma de reporting 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 du schéma de l'API.

  • La dimension minutesAgo a été ajoutée au schéma en temps réel de l'API Data et peut être utilisée dans les requêtes adressées à la méthode runRealtimeReport. Cette dimension contient 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.

  • La dimension googleAdsCreativeId a été ajoutée 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.

  • La dimension sessionGoogleAdsCreativeId a été ajoutée 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 à l'origine de la première acquisition de l'utilisateur.

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

  • Le point de terminaison de l'API a été mis à jour vers 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 de la pagination.

  • La taille de réponse par défaut du rapport 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 nouvelles 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 des 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 enregistrée par une propriété crée trois variantes de métriques d'API : une somme, une moyenne et un nombre.

28/01/2021 : ajout de nouvelles dimensions de date/heure.

Les nouvelles dimensions suivantes ont été ajoutées au schéma de l'API : hour, nthHour, nthYear, 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 période maximale d'un an par requête API a été supprimée.

02/11/2020 : ajout d'une méthode de rapport Temps réel.

Pour obtenir des exemples, consultez Créer un rapport Temps réel. Pour accéder à la documentation de référence REST, consultez runRealtimeReport.

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

Artefacts de la bibliothèque cliente mis à jour, ainsi que les instructions d'utilisation et les exemples de code.

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

08/10/2020 : méthode getMetadata 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.

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