Journal des modifications

Pour recevoir les annonces officielles concernant l'API Google Analytics, veuillez vous abonner au groupe Notifier de l'API Google Analytics.

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

Il existe désormais une limite de 10 000 erreurs de serveur d'API autorisées par projet et par propriété sur une période de 15 minutes. Cela inclut toutes les requêtes entraînant 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 autres appels d'API 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 comparaisons

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 v1beta 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 indiquant le nom de ressource de la comparaison dans le champ comparison.

La méthode getMetadata est mise à jour pour répertorier 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, vous ne pouvez créer des comparaisons enregistrées qu'à l'aide de l'interface utilisateur de Google Analytics.

08/05/2024 Ajout des tâches de rapport (une fonctionnalité de création de rapports asynchrone) à la version v1alpha de l'API Data.

À l'aide des tâches de rapport, vous pouvez 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 version v1alpha de l'API Data:

06/05/2024 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 rapport qui utilisent la dimension isConversionEvent pour utiliser à la place la dimension isKeyEvent.

Modifiez les demandes de rapport qui utilisent une métrique obsolète dans le tableau suivant pour qu'elles utilisent la métrique d'événement clé à la place.

Métrique obsolète Métrique de l'é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énement clé 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 métriques d'événement clé dans les objets DimensionMetadata et MetricMetadata comme suit:

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

25/03/2024 Ajout de dimensions "Groupe de canaux principal", "Source de trafic manuel" et "Intégration".

Groupe de canaux principal, source de trafic manuelle et dimensions spécifiques à l'intégration CM360, DV360 et SA360 ajoutées 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 pour le premier utilisateur

  • primaryChannelGroup groupe de canaux principal

  • sessionPrimaryChannelGroup groupe de canaux principal de la session

Dimensions "Source de trafic manuelle" :

  • manualCampaignId ID de campagne manuel

  • manualCampaignName Nom de campagne manuel

  • manualCreativeFormat Format manuel de la création

  • 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 Première plate-forme source manuelle de l'utilisateur

  • ID de campagne manuel associé à la session sessionManualCampaignId

  • 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" pour la session

  • sessionManualSourcePlatform Plate-forme source manuelle de la session

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

  • cm360AccountId ID de compte CM360

  • cm360AccountName nom du compte CM360

  • cm360AdvertiserId référence annonceur CM360

  • cm360AdvertiserName nom d'annonceur CM360

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

  • Support CM360 cm360Medium

  • Type de facturation de l'emplacement CM360 : cm360PlacementCostStructure

  • cm360PlacementId ID d'emplacement CM360

  • cm360PlacementName nom d'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 ID du premier 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 création CM360 du premier utilisateur

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

  • firstUserCm360CreativeType Type de la 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 Support CM360 du premier 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 rendu CM360 du premier 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 associée à 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 de la session

  • sessionCm360CreativeId ID de la création CM360 associée à 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 associé à la session

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

  • sessionCm360Medium Support CM360 associé à 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

  • Source / support CM360 sessionCm360SourceMedium de la session

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

  • dv360AdvertiserId référence annonceur DV360

  • dv360AdvertiserName nom d'annonceur DV360

  • dv360CampaignId ID de 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 d'ordre d'insertion DV360

  • dv360InsertionOrderName nom de l'ordre d'insertion DV360

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

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

  • Support DV360 dv360Medium

  • dv360PartnerId ID de partenaire DV360

  • dv360PartnerName Nom du partenaire DV360

  • dv360Source source 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 ID du premier élément de campagne DV360 de l'utilisateur

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

  • firstUserDv360Medium Support DV360 du premier utilisateur

  • firstUserDv360PartnerId ID du 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 d'ordre d'insertion DV360 de la session

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

  • sessionDv360LineItemId ID d'é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 première création SA360 de l'utilisateur

  • firstUserSa360EngineAccountId ID du premier compte de moteur SA360 de l'utilisateur

  • firstUserSa360EngineAccountName Nom du compte de moteur SA360 du premier utilisateur

  • firstUserSa360EngineAccountType Type de compte de moteur SA360 du premier 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 du premier utilisateur

  • sa360AdGroupId ID de groupe d'annonces SA360

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

  • Support SA360 sa360Medium

  • sa360Query requête SA360

  • sa360Source source SA360

  • sa360SourceMedium source / support SA360

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

  • sessionSa360CampaignId ID de campagne SA360 de la session

  • sessionSa360ManagerAccountId ID du compte administrateur SA360 (session)

  • sessionSa360ManagerAccountName Nom du compte administrateur SA360 (session)

  • Source / Support SA360 (sessionSa360SourceMedium) de la session

06/03/2024 Prise en charge des audiences d'utilisateurs inactifs dans les exportations d'audience.

La fonctionnalité d'exportation des audiences est mieux compatible avec l'exportation des audiences d'utilisateurs inactifs. Les utilisateurs accèdent à ces audiences sans événement éligible. Par exemple, ils peuvent y accéder sans visiter votre site Web pendant sept jours. Exemples d'audiences d'utilisateurs inactifs : "Acheteurs inactifs pendant 7 jours", "Utilisateurs inactifs pendant 7 jours" et "Utilisateurs non avertis pendant 7 jours". Pour en savoir plus sur ces suggestions d'audiences, consultez Suggestions d'audiences.

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 les tags, même si les données fournies par les utilisateurs sont activées pour votre propriété. Si la collecte des données fournies par les utilisateurs est activée, ces données et le User-ID peuvent être envoyés à Google Analytics dans le taggage afin d'améliorer les mesures. Pour en savoir plus, consultez Collecte des données fournies par l'utilisateur.

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

Vous pouvez spécifier les champs AudienceList.webhookNotification et RecurringAudienceList.webhookNotification lors de la création d'une liste d'audience (à l'aide de properties.audienceLists.create) ou d'une liste d'audience récurrente (avec properties.recurringAudienceLists.create).

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

18/01/2024 Amélioration de la compatibilité pour les variables 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 Analytics Data à l'aide de la syntaxe suivante:

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

Pour plus d'informations, consultez la page 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é des 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 au 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 des listes d'audience à la version alpha de l'API Data dans la version 1.

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 créer quotidiennement des listes d'audience à mesure que les membres de l'audience évoluent. Les listes d'audience récurrentes vous permettent d'exploiter les résultats d'appartenance d'audience les plus récents.

08/11/2023 Ajout de l'exportation des listes d'audience vers Sheets dans la version alpha de l'API Data

Ajout de la méthode properties.audienceLists.exportSheet à la version alpha de l'API Data v1, qui vous permet d'exporter une liste d'audience vers Google Sheets.

13/10/2023 Ajout de la prise en charge des audiences avec une durée de validité 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 des listes d'audience

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 classement que les autres méthodes de création de rapports de l'API Data : les rapports sont classés par ordre décroissant en fonction de la première colonne, puis de la deuxième colonne, etc.

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

deviceId isAdsPersonalizationAllowed
ABC true
DAC false
ABC false
AAA true

Après cette modification, vous recevrez le rapport suivant:

deviceId isAdsPersonalizationAllowed
AAA true
ABC false
ABC true
DAC false

15/08/2023 Ajout de la dimension isLimitedAdTracking au schéma d'exportation de la liste d'audience

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

    Pour en savoir plus, consultez l'article Variables des listes d'audience.

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

  • currencyCode : code de la devise locale (basé sur 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'élément "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 renvoie true. Si un utilisateur n'est pas éligible pour la personnalisation des annonces, isAdsPersonalizationAllowed renvoie false.

    Pour en savoir plus, consultez l'article Variables des listes d'audience.

10/07/2023 Listes d'audience

La compatibilité avec les listes d'audience a été ajoutée à la version alpha de l'API Data v1. Les listes d'audience incluent un instantané des utilisateurs inclus dans l'audience au moment de leur création.

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

19/05/2023 Groupes de canaux personnalisés

Ajout de la compatibilité avec les groupes de canaux personnalisés à 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 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 rapports simples, tout en facturant beaucoup plus de jetons de quota pour les rapports volumineux.

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

Propriétés standards

Nom du quota Ancienne limite Nouvelle limite
Jetons de base par propriété et par jour 25 000 200 000
Jetons de base par propriété et par heure 5 000 40 000
Jetons de base 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 de conversion 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 de base par propriété et par jour 250 000 2 000 000
Jetons de base par propriété et par heure 50 000 400 000
Jetons de base 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 de conversion 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 "Date".

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

  • isoWeek Semaine de l'année ISO. Numéro ISO de la semaine : 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 Année mois. Valeurs combinées de year et month. Exemples de valeurs : 202212 ou 202301.

  • Semaine de yearWeek an. 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. Emplacement physique associé à l'article (par exemple, l'adresse du magasin physique). Nous vous recommandons d'utiliser l'ID de lieu Google correspondant à l'élément associé. Vous pouvez également utiliser un ID de zone géographique 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é à 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, il 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é à la première page vue au cours d'une session.

Ce champ remplace la dimension landingPage, qui est obsolète et sera mise à jour de manière à ne renvoyer aucune 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 l'écran".

  • screenPageViewsPerUser vues par utilisateur. Nombre d'écrans d'application ou de pages Web vus par vos utilisateurs 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 l'écran. Nombre d'utilisateurs uniques ayant fait défiler au moins 90% de la page

23/01/2023 Ajout de dimensions "Continent", "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 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 la page https://support.google.com/analytics/answer/10108813.

18/10/2022 : ajout de métriques Ads.

  • advertiserAdClicks clics sur des annonces. Nombre total de fois où les utilisateurs ont cliqué sur une annonce pour accéder à la propriété.
  • Coût Ads : advertiserAdCost. Montant total que vous avez payé pour vos annonces.
  • advertiserAdCostPerClick Coût par clic Ads. Le coût par clic des annonces correspond au coût de l'annonce divisé par le nombre de clics sur l'annonce. Il correspond souvent à une version abrégée du CPC.
  • advertiserAdCostPerConversion Coût par conversion. Le coût par conversion correspond au coût de l'annonce divisé par le nombre de conversions.
  • advertiserAdImpressions impressions Ads. 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.

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 seul article.
  • itemsCheckedOut article payé. Nombre d'unités payées pour un même article.
  • itemsClickedInList articles sur lesquels des utilisateurs ont cliqué dans la liste. Nombre d'unités cliquées dans la liste pour un seul article.
  • itemsClickedInPromotion articles sur lesquels des utilisateurs ont cliqué dans la promotion. Nombre d'unités ayant enregistré des clics dans la 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 affichées dans la liste pour un même article.
  • itemsViewedInPromotion articles consultés dans la promotion. Nombre d'unités consultées dans le cadre d'une promotion pour un seul article.

13/09/2022 Annonce des modifications apportées à la compatibilité des schémas.

Le 1er décembre 2022, les modifications importantes 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 telles que itemRevenue, les métriques basées sur l'utilisateur comme activeUsers, et avec 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 seront toujours compatibles avec les métriques attribuables comme conversions, les métriques basées sur l'utilisateur comme activeUsers et les métriques basées sur les sessions comme 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.

Pour en savoir plus, consultez l'explication détaillée des changements de compatibilité.

2022-09-01 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 est décomptée 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 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 qui a généré cette session dans SA360.

  • sessionSa360EngineAccountName Nom du compte de moteur SA360 de la session. Nom du compte de moteur dans SA360 qui a entraîné cette session.

  • sessionSa360EngineAccountType Type de compte de moteur SA360 de la session. Type de compte de moteur dans Search Ads 360 ayant entraîné 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 à l'origine de cette session.

  • sessionSa360Medium Support SA360 de la session. Mot clé du moteur de recherche provenant de Search Ads 360 à l'origine de 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 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 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 seule 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 à la version alpha.

16/02/2022 : ajout de nouvelles dimensions.

Terme manuel et contenu

  • firstUserManualAdContent Premier contenu d'annonce manuel de l'utilisateur. Contenu de l'annonce ayant initialement acquis l'utilisateur. Valeur insérée par le paramètre utm_content.

  • firstUserManualTerm Premier terme manuel de l'utilisateur. Terme qui a acquis l'utilisateur en premier. Valeur insérée par le paramètre utm_term.

  • manualAdContent Contenu d'annonce manuel. Contenu d'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 d'annonce manuel associé à la session. Il s'agit du 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 qui a mené à une session. Valeur insérée par le paramètre utm_term.

Analyse des plantages

  • crashAffectedUsers utilisateurs concernés par un plantage. Le nombre d'utilisateurs ayant enregistré un plantage sur 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 Utilisateurs nouveaux / connus.

  • screenPageViewsPerSession vues par session.

  • landingPage Page de destination. Chemin de la page + chaîne de requête associée à 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 glissant d'utilisateurs actifs sur 30 jours qui sont également actifs sur une journée.

  • dauPerWau UAJ / UAS. Pourcentage glissant d'utilisateurs actifs sur sept jours qui sont également des utilisateurs actifs sur une journée.

  • wauPerMau UAS / UAM. Pourcentage glissant d'utilisateurs actifs sur 30 jours qui sont également des utilisateurs actifs sur 7 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 ayant initialement acquis l'utilisateur.

  • googleAdsCampaignType : type de la campagne Google Ads attribué à l'événement de conversion.

  • sessionGoogleAdsCampaignType : type de la campagne Google Ads ayant généré cette session.

07/09/2021 Ajout de dimensions "Date/Heure".

  • dateHourMinute : valeurs combinées de date, d'heure et de minute 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 des 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 : ID du groupe de joueurs dans un jeu pour un événement.

  • linkClasses : attribut de classe HTML d'un lien sortant.

  • linkDomain : domaine de destination du lien sortant.

  • linkId : attribut d'ID HTML d'un lien sortant ou d'un téléchargement de fichier.

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

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

  • method Méthode par laquelle un événement a été déclenché.

  • outbound Affiche la valeur "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 la page et chaîne de requête des pages Web consulté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 Affiche la valeur "true" si le contenu est visible.

  • unifiedPagePathScreen : Chemin de la page (Web) ou classe de l'écran (application) où l'événement a été consigné.

Modifications du schéma de l'API du 07/09/2021.

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é consigné.

Annonce des changements à venir:

  • firstUserTrafficOrigin : origine du trafic qui a touché l'utilisateur en premier. Ne vous attendez pas à ce que ce champ renvoie la valeur "Manuel" pour le trafic utilisant des UTM. Ce champ passera de "Manuel" à "(non défini)" pour le lancement d'une fonctionnalité à venir.

  • sessionTrafficOrigin : origine du trafic de la campagne de la session. Ne vous attendez pas à ce que ce champ renvoie la valeur "Manuel" pour le trafic utilisant des UTM. Ce champ passera de "Manuel" à "(non défini)" pour le lancement d'une fonctionnalité à venir.

  • trafficOrigin Origine du trafic de la campagne associée à l'événement de conversion. Ne vous attendez pas à ce que ce champ renvoie la valeur "Manuel" pour le trafic utilisant des UTM. Ce champ passera de "Manuel" à "(non défini)" pour le lancement d'une fonctionnalité à venir.

07/09/2021 Ajout de la méthode checkCompatibility à l'API.

La méthode checkCompatibility répertorie les dimensions et les métriques qui peuvent être ajoutées à une demande de rapport et maintenir la compatibilité.

21/07/2021 Modifications apportées aux rapports "Temps réel".

Il est désormais possible de spécifier des plages de minutes pour les 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.

Nouvelles dimensions de regroupement de canaux 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 d'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 envoyé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 conduit à 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 touché l'utilisateur en premier.

09/04/2021 La version bêta de l'API Data Google Analytics v1 a été publiée.

  • 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 de l'URL au lieu du champ entity du corps de la 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 par défaut des réponses aux rapports est passée de 10 à 10 000 lignes de données d'événement.

  • La valeur "limit" : -1 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 des 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 dayOfWeek, week modifications apportées aux dimensions.

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

  • La valeur de la dimension week commence maintenant par 01 et renvoie un nombre à deux chiffres compris entre 01 et 53. Chaque semaine commence le dimanche. Le 1er janvier est 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étrique 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 d'API : hour, nthHour, nthYear, dateHour.

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

L'API Data a réduit le quota de jetons 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 création de rapports en temps réel.

Consultez la page Créer un rapport en temps réel pour obtenir des exemples et la page runRealtimeReport pour la documentation de référence REST.

19/10/2020 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 Ajout de la méthode getMetadata à l'API.

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 les schémas d'API pour en savoir plus sur les dimensions et les métriques personnalisées. 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.