Journal des modifications

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

2024-10-20 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

À l'aide du champ samplingLevel de la méthode properties.runReportTask, vous pouvez 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, soit 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 grand nombre d'événements.

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

À l'aide de la méthode properties.getPropertyQuotasSnapshot, vous pouvez 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é"

Une limite de 10 000 erreurs de serveur d'API est désormais autorisée par projet et par propriété, sur une période de 15 minutes. Cela inclut toutes les requêtes qui génèrent une réponse avec un code autre que 500 ou 200. Exemples d'erreurs entrant dans ce quota: utilisation de combinaisons de dimensions et de métriques incompatibles, toutes les erreurs d'authentification.

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

14/05/2024 Ajout de la fonctionnalité Comparaisons

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

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

Dans une requête, vous pouvez spécifier une comparaison de base en fournissant l'expression dimensionFilter avec une requête, ou utiliser une comparaison enregistrée en fournissant le nom de la 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 qui identifie chaque comparaison.

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

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

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

Les méthodes de manipulation des tâches de rapport suivantes ont été ajoutées à la version 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 requêtes de rapport qui utilisent la dimension isConversionEvent pour utiliser la dimension isKeyEvent à la place.

Modifiez toutes les requêtes de rapport qui utilisent une métrique obsolète dans le tableau suivant pour utiliser la métrique "Événements clés" à la place.

Métrique obsolète Métrique des événements clés
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

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

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

  • apiName, uiName et description contiennent le nom de l'API d'événement clé, le nom de l'UI et la description.
  • Le champ répété deprecatedApiNames contient 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 de dimensions spécifiques à l'intégration.

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

Variables concernant l'audience:

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

Dimensions "Groupe de canaux principal" :

  • firstUserPrimaryChannelGroup Groupe de canaux principal du premier utilisateur

  • primaryChannelGroup Groupe de canaux principal

  • sessionPrimaryChannelGroup Groupe de canaux principal de la session

Dimensions "Source de trafic" manuelles:

  • manualCampaignId ID de campagne manuel

  • manualCampaignName Nom de campagne manuel

  • manualCreativeFormat Format de création manuel

  • manualMarketingTactic Stratégie marketing manuelle

  • manualMedium Support manuel

  • manualSource Source manuelle

  • manualSourceMedium Source / Support manuel

  • manualSourcePlatform Plate-forme source manuelle

  • firstUserManualCampaignId Premier ID de campagne manuel de l'utilisateur

  • firstUserManualCampaignName Nom de la première campagne manuelle 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 Première 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 la campagne manuelle associée à 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 de la source manuelle de la session

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

  • cm360AccountId ID du compte CM360

  • cm360AccountName Nom du compte CM360

  • cm360AdvertiserId Référence annonceur CM360

  • cm360AdvertiserName Nom de l'annonceur CM360

  • cm360CampaignId ID de la campagne CM360

  • cm360CampaignName Nom de la campagne CM360

  • cm360CreativeFormat Format de la création CM360

  • cm360CreativeId ID de la création CM360

  • cm360CreativeName Nom de la création CM360

  • cm360CreativeType Type de création CM360

  • cm360CreativeTypeId ID du type de création CM360

  • cm360CreativeVersion Version de la création CM360

  • cm360Medium Support CM360

  • cm360PlacementCostStructure Type de facturation de l'emplacement CM360

  • cm360PlacementId ID de l'emplacement CM360

  • cm360PlacementName Nom de l'emplacement CM360

  • cm360RenderingId ID du rendu CM360

  • cm360SiteId ID du site CM360

  • cm360SiteName Nom du site CM360

  • cm360Source Source CM360

  • cm360SourceMedium Source / support CM360

  • firstUserCm360AccountId ID du 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 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 première création CM360 de l'utilisateur

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

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

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

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

  • firstUserCm360PlacementId ID de l'emplacement CM360 du premier utilisateur

  • firstUserCm360PlacementName Nom du premier emplacement CM360 de l'utilisateur

  • firstUserCm360RenderingId ID de 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 de la session

  • sessionCm360AdvertiserName Nom de l'annonceur CM360 de la session

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

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

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

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

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

  • sessionCm360CreativeType Type de création CM360 de la session

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

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

  • sessionCm360Medium Support CM360 de la session

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

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

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

  • sessionCm360RenderingId ID du rendu CM360 associé à la session

  • sessionCm360SiteId ID du site CM360 associé à la session

  • sessionCm360SiteName Nom du site CM360 associé à la session

  • sessionCm360Source Source CM360 de la session

  • sessionCm360SourceMedium Source / support CM360 de la session

Dimensions d'intégration 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 Première référence annonceur DV360 de l'utilisateur

  • firstUserDv360AdvertiserName Nom du premier annonceur DV360 de l'utilisateur

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

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

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

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

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

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

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

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

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

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

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

  • firstUserDv360Medium Premier support DV360 de l'utilisateur

  • firstUserDv360PartnerId ID du partenaire DV360 du premier 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 première création SA360 de l'utilisateur

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

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

  • firstUserSa360EngineAccountType Type de compte de moteur SA360 du premier utilisateur

  • firstUserSa360KeywordText Texte du mot clé SA360 du premier utilisateur

  • firstUserSa360ManagerAccountId ID du compte administrateur SA360 (premier utilisateur)

  • firstUserSa360ManagerAccountName Nom du compte administrateur SA360 (premier utilisateur)

  • firstUserSa360Medium Premier support SA360 de l'utilisateur

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

  • firstUserSa360Source Première source SA360 de l'utilisateur

  • firstUserSa360SourceMedium Source / support SA360 (premier utilisateur)

  • sa360AdGroupId ID du groupe d'annonces SA360

  • sa360CampaignId ID de la campagne SA360

  • sa360AdGroupName Nom du groupe d'annonces SA360

  • sa360CampaignName Campagne SA360

  • sa360CreativeFormat Format de la création SA360

  • sa360EngineAccountId ID de compte de moteur SA360

  • sa360EngineAccountName Nom du compte de moteur SA360

  • sa360EngineAccountType Type de compte de moteur SA360

  • sa360KeywordText Texte du mot clé SA360

  • sa360ManagerAccountId ID du compte administrateur SA360

  • sa360ManagerAccountName Nom du compte administrateur SA360

  • sa360Medium Support SA360

  • sa360Query Requête SA360

  • sa360Source Source SA360

  • sa360SourceMedium Source / Support SA360

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

  • sessionSa360CampaignId ID de la campagne SA360 de la session

  • sessionSa360ManagerAccountId ID du compte administrateur SA360 (session)

  • sessionSa360ManagerAccountName Nom du compte administrateur SA360 (session)

  • sessionSa360SourceMedium Source / support SA360 (session)

06/03/2024 Compatibilité des audiences d'utilisateurs inactifs avec les exportations d'audiences.

La fonctionnalité d'exportation des audiences permet désormais d'exporter plus facilement les audiences d'utilisateurs inactifs. Les utilisateurs entrent dans ces audiences sans événement éligible. Par exemple, l'utilisateur peut entrer dans l'audience en ne consultant pas votre site Web pendant sept jours. Exemples d'audiences d'utilisateurs inactifs : "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 la section Audiences suggérées.

Les exportations d'audience 2024-02-28 renvoient l'ID utilisateur spécifié dans le taggage.

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

30/01/2024 Compatibilité des notifications Webhook avec les listes d'audience et les listes d'audience récurrentes dans la version alpha de l'API Data V1.

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

Cette fonctionnalité vous permet de recevoir des notifications Webhook de manière asynchrone 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 "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 "minutes" 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:nom_paramètre Dimension personnalisée de portée article pour parameter_name

Pour en savoir plus, consultez la section 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'audiences" a été rebaptisée Exportations d'audiences 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 contient un SampleMetadata pour chaque période de la requête pour laquelle les résultats ont été échantillonnés. Google Analytics n'applique l'échantillonnage que lorsqu'il prévoit que les limites de cardinalité réduiront la qualité des données.

28/11/2023 Ajout de la fonctionnalité d'exportation des listes d'audience récurrentes à l'API Data v1 alpha

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

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

08/11/2023 Ajout de la fonctionnalité d'exportation de la liste d'audience vers Sheets à l'API Data v1 alpha

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 Compatibilité avec les audiences dont la durée d'abonnement est de 1 jour

La fonctionnalité d'exportation des listes d'audiences est désormais compatible avec les audiences dont la durée d'adhésion est de 1 jour.

12/09/2023 Règles d'ordre par défaut pour AudienceList

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

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

deviceId isAdsPersonalizationAllowed
ABC true
DAC faux
ABC faux
AAA true

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

deviceId isAdsPersonalizationAllowed
AAA true
ABC faux
ABC true
DAC faux

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

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

    Pour en savoir plus, consultez la section Dimensions de liste 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 le schéma de création de rapports 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 autorisée. Si un utilisateur peut bénéficier de la personnalisation des annonces, isAdsPersonalizationAllowed renvoie true. Si un utilisateur ne peut pas bénéficier de la personnalisation des annonces, isAdsPersonalizationAllowed renvoie false.

    Pour en savoir plus, consultez la section Dimensions de liste d'audience.

2023-07-10 Listes d'audience

Prise en charge des listes d'audiences ajoutée à l'API Data v1alpha. Les listes d'audiences incluent un instantané des utilisateurs de l'audience au moment de la création de la liste.

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

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 Modification du quota de jetons.

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

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 création de rapports simples, tout en facturant beaucoup plus de jetons de quota pour les rapports de dates volumineux.

Après ce changement, les frais de certaines requêtes resteront les mêmes, mais les frais des requêtes plus complexes augmenteront de manière notable. Par exemple, les requêtes de données de plus de six mois peuvent consommer 1 000 jetons de quota ou plus.

Propriétés standards

Nom du quota Ancienne limite Nouvelle limite
Nombre de jetons de cœur par propriété et par jour 25 000 200 000
Nombre de jetons de cœur par propriété et par heure 5 000 40 000
Jetons de cœur 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 de l'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
Nombre de jetons de cœur par propriété et par jour 250 000 2 000 000
Nombre de jetons de cœur par propriété et par heure 50 000 400 000
Jetons de cœur 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 de l'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 a les valeurs Sunday, Monday, etc.

  • isoWeek Semaine ISO de l'année. Numéro de semaine ISO, chaque semaine commençant le lundi. Pour en savoir plus, consultez https://en.wikipedia.org/wiki/ISO_week_date. Par exemple, 01, 02 et 53.

  • Année ISO isoYear. Année ISO de l'événement. Pour en savoir plus, consultez https://en.wikipedia.org/wiki/ISO_week_date. 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 pour l'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'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de lieu 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é à l'article. Cette dimension peut être spécifiée dans le taggage à l'aide du 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. Il sera mis à jour pour ne plus 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 chaque 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 "Identifiant du continent".

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

  • continentId Identifiant du continent. ID géographique du continent sur lequel l'activité de l'utilisateur a été enregistrée, déterminé à partir 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 Ads.

  • advertiserAdClicks Clics sur les annonces Nombre total de fois où les utilisateurs ont cliqué sur une annonce pour accéder à la propriété.
  • advertiserAdCost Coût des annonces. Montant total que vous avez payé pour vos annonces.
  • advertiserAdCostPerClick Coût par clic sur vos annonces. Le coût par clic sur vos annonces correspond au coût de l'annonce divisé par le nombre de clics sur l'annonce. Il est souvent abrégé en "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 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 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 même article.
  • itemsCheckedOut Articles payés. Nombre d'unités empruntées pour un même article.
  • itemsClickedInList Articles sur lesquels des utilisateurs ont cliqué dans la liste. Nombre d'unités sur lesquelles des utilisateurs ont cliqué dans une liste pour un même article.
  • itemsClickedInPromotion Articles sur lesquels des utilisateurs ont cliqué dans la promotion. Nombre d'unités sur lesquelles les utilisateurs ont cliqué dans une promotion pour un même 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 consultées dans la liste pour un même article.
  • itemsViewedInPromotion Articles consultés dans la promotion. Nombre d'unités consultées dans une promotion pour un même 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 telles que activeUsers et les métriques basées sur les sessions telles que 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 les sessions telles que sessions.

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

Pour en savoir plus, consultez la présentation détaillée des modifications de compatibilité.

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 un quota pour Tokens Per Property Per Hour et Tokens Per Project Per Property Per Hour.

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

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

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

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

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

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

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

  • sessionSa360EngineAccountType Type de compte de moteur SA360 de la session. Type du compte de moteur dans Search Ads 360 ayant 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 Search Ads 360 ayant généré cette session.

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

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

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

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

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

Taux de conversion

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

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

Métriques 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 à la version alpha.

16/02/2022 : ajout de nouvelles dimensions.

Termes et contenus manuels

  • firstUserManualAdContent Premier contenu d'annonce manuel de l'utilisateur. Contenu de l'annonce ayant permis d'acquérir l'utilisateur pour la première fois. Renseigné 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. Renseigné par le paramètre utm_term.

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

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

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

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

Analyse des plantages

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

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

Application/Web

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

  • newVsReturning Utilisateurs nouveaux / connus

  • screenPageViewsPerSession Vues par session.

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

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

Application mobile

  • averagePurchaseRevenuePerUser Revenus moyens des achats par utilisateur

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

  • firstTimePurchasersPerNewUser Nombre moyen de nouveaux acheteurs par nouvel utilisateur.

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

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

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

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

  • transactionsPerPurchaser Transactions par acheteur

Campagne Google Ads

  • firstUserGoogleAdsCampaignType Type de campagne Google Ads ayant permis d'acquérir l'utilisateur pour la première fois.

  • 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 et d'heure.

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

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

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

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

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

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

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

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

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

  • linkClasses Attribut class HTML pour un lien sortant.

  • linkDomain Domaine de destination du lien sortant.

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

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

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

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

  • outbound Renvoie "true" si le lien mène à 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 référence 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 laquelle l'événement a été enregistré.

Modification du schéma de l'API le 7 septembre 2021.

Modifications des 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 de modifications à venir :

  • firstUserTrafficOrigin Origine du trafic ayant permis d'acquérir l'utilisateur pour la première fois. Veuillez ne pas vous attendre à ce que ce champ renvoie "Manuel" pour le trafic qui utilise des UTM. Pour une prochaine fonctionnalité, ce champ passera de "Manuel" à "(not set)".

  • sessionTrafficOrigin Origine du trafic de la campagne de la session. Veuillez ne pas vous attendre à ce que ce champ renvoie "Manuel" pour le trafic qui utilise des UTM. Pour une prochaine fonctionnalité, ce champ passera de "Manuel" à "(not set)".

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

07/09/2021 : méthode checkCompatibility ajoutée à l'API.

La méthode checkCompatibility liste les dimensions et les métriques pouvant être ajoutées à une requête de rapport et assure la compatibilité.

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

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

21/07/2021 Nouvelles dimensions de regroupement de canaux.

Nouvelles dimensions de regroupement de canaux ajoutées au schéma de création de rapports de la Google Data API:

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

  • defaultChannelGrouping Regroupement de canaux par défaut.

Modifications apportées au schéma de l'API le 10 juin 2021.

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

  • Dimension googleAdsCreativeId 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.

  • Dimension sessionGoogleAdsCreativeId ajoutée au schéma de l'API Data. Cette dimension contient l'ID de la création Google Ads ayant 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 ayant permis d'acquérir l'utilisateur pour la première fois.

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

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

2021-02-19 Modifications apportées à la pagination.

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

  • La valeur "limit" : -1 utilisée pour indiquer une tentative de récupération de toutes les lignes n'est plus prise en charge 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 et trafficOrigin.

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

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

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

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

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

28/01/2021 Ajout de nouvelles dimensions Date/Heure.

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

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

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

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

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

02/11/2020 Ajout d'une méthode de création de rapports en temps réel.

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

19/10/2020 : Mise à jour des artefacts de la bibliothèque cliente.

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

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

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

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

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

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