Journal des modifications

Pour recevoir les annonces officielles relatives à l'API Google Analytics, veuillez vous abonner au groupe de notification de l'API Google Analytics.

25/03/2024 : ajout des dimensions "Groupe de canaux principal", "Source de trafic manuelle" 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 concernant l'audience:

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

Dimensions du groupe de canaux principal:

  • firstUserPrimaryChannelGroup Groupe de canaux principal du premier utilisateur

  • primaryChannelGroup groupe de canaux principal

  • sessionPrimaryChannelGroup groupe de canaux principal de la session

Dimensions "Source de trafic manuelles" :

  • manualCampaignId ID de campagne manuel

  • manualCampaignName Nom de la campagne manuelle

  • manualCreativeFormat Format de création manuel

  • manualMarketingTactic : stratégie marketing manuelle

  • manualMedium Support manuel

  • manualSource source manuelle

  • manualSourceMedium "Source / Support" manuel

  • manualSourcePlatform : plate-forme de la 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 Première stratégie marketing manuelle de l'utilisateur

  • firstUserManualMedium Premier support manuel de l'utilisateur

  • firstUserManualSource Première source manuelle de l'utilisateur

  • firstUserManualSourceMedium Premier support / source manuel de l'utilisateur

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

  • sessionManualCampaignId ID de campagne manuel associé à la session

  • Nom de la campagne manuelle de la session "sessionManualCampaignName"

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

  • Stratégie marketing manuelle de sessionManualMarketingTactic session

  • Support manuel associé à la session "sessionManualMedium"

  • sessionManualSource source manuelle de la session

  • Source / support manuel de la session "sessionManualSourceMedium"

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

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

  • cm360AccountId ID de compte CM360

  • cm360AccountName nom de compte CM360

  • cm360AdvertiserId référence annonceur CM360

  • cm360AdvertiserName nom d'annonceur CM360

  • cm360CampaignId ID de campagne CM360

  • cm360CampaignName nom de campagne CM360

  • cm360CreativeFormat format de 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 d'emplacement CM360

  • cm360PlacementName nom d'emplacement CM360

  • cm360RenderingId ID de rendu CM360

  • cm360SiteId ID du site CM360

  • cm360SiteName nom de 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 Premier format de la 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 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 Premier support CM360 de l'utilisateur

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

  • firstUserCm360PlacementId ID du premier emplacement CM360 de l'utilisateur

  • firstUserCm360PlacementName Nom du premier emplacement CM360 de l'utilisateur

  • firstUserCm360RenderingId ID du premier rendu CM360 de l'utilisateur

  • firstUserCm360SiteId ID du premier site CM360 de l'utilisateur

  • firstUserCm360SiteName Nom du premier site CM360 de l'utilisateur

  • firstUserCm360Source source CM360 du premier utilisateur

  • firstUserCm360SourceMedium Source / support CM360 du premier utilisateur

  • sessionCm360AccountId ID de compte CM360 associé à la session

  • sessionCm360AccountName nom du compte CM360 associé à la session

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

  • sessionCm360AdvertiserName nom d'annonceur CM360 associé à la session

  • sessionCm360CampaignId ID de la campagne CM360 de la session

  • sessionCm360CampaignName nom de la campagne CM360 de 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 de la session

  • sessionCm360PlacementId ID d'emplacement CM360 de la session

  • sessionCm360PlacementName nom d'emplacement CM360 de 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 d'élément de campagne DV360

  • dv360LineItemName nom d'é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 de l'ordre d'insertion DV360 du premier 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 Premier support DV360 de l'utilisateur

  • firstUserDv360PartnerId ID du partenaire DV360 du premier utilisateur

  • firstUserDv360PartnerName Nom du partenaire DV360 du premier utilisateur

  • firstUserDv360Source Source DV360 du premier 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 d'élément de campagne DV360 de la session

  • sessionDv360LineItemName nom d'é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 Google Search Ads 360 (SA360) :

  • firstUserSa360AdGroupId ID du groupe d'annonces SA360 (premier utilisateur)

  • firstUserSa360AdGroupName Nom du groupe d'annonces SA360 (premier 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 premier compte de moteur SA360 de l'utilisateur

  • firstUserSa360EngineAccountType Type de compte de moteur SA360 (premier utilisateur)

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

  • firstUserSa360ManagerAccountId ID du premier compte administrateur SA360 de l'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 Source SA360 du premier utilisateur

  • firstUserSa360SourceMedium Source / Support SA360 (premier utilisateur)

  • sa360AdGroupId ID du 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 de 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 campagne SA360 de la session

  • sessionSa360ManagerAccountId ID de compte administrateur SA360 (session)

  • sessionSa360ManagerAccountName nom de compte administrateur SA360 (session)

  • sessionSa360SourceMedium Source / Support SA360 de la session

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

La fonctionnalité d'exportation de l'audience permet de mieux exporter des audiences d'utilisateurs inactifs. Les utilisateurs accèdent à ces audiences sans événement éligible. Par exemple, ils peuvent saisir l'audience en s'abstenant de consulter 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 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 le taggage, même si les données fournies par l'utilisateur sont activées pour votre propriété. Si la collecte des données fournies par l'utilisateur est activée, ces données et le User-ID peuvent être envoyés à Google Analytics dans le taggage pour améliorer les mesures. Pour en savoir plus, consultez Collecte des données fournies par les utilisateurs.

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

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

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

Les dimensions qui incluent la chaîne de requête sont désormais compatibles avec la plupart des champs. Des 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. Des 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 les dimensions et métriques de l'API.

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

La fonctionnalité des listes d'audience a été renommée Exportations d'audiences et a été 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'applique 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 v1

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 des listes d'audience quotidiennement à mesure que les membres de l'audience changent. Les listes d'audience récurrentes vous permettent de travailler avec les résultats d'audience les plus récents.

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

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 d'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 de 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 de listes d'audience suivent les mêmes règles d'ordre que les autres méthodes de création de rapports de l'API Data : le tri s'effectue dans l'ordre décroissant de la première colonne, puis de la deuxième colonne dans l'ordre décroissant, etc.

Avant ce changement, vous avez 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 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 Variables des listes d'audience.

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

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

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

Pour en savoir plus, consultez Schéma de rapport de l'API de données.

10/08/2023 Ajout de la dimension isAdsPersonalizationAllowed au schéma d'exportation des listes 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 ne peut pas bénéficier de la personnalisation des annonces, isAdsPersonalizationAllowed renvoie false.

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

10/07/2023 Listes d'audience

Prise en charge des listes d'audience ajoutée à la version alpha de l'API Data v1. Les listes d'audience incluent un instantané des utilisateurs de l'audience au moment de leur création.

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

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

Compatibilité avec les groupes de canaux personnalisés ajoutée à l'API Data.

2023-05-11 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 rapport simples, tout en facturant beaucoup plus de jetons de quota pour les rapports volumineux.

Après ce changement, bien que les frais facturés pour certaines requêtes restent inchangés, les frais liés aux requêtes plus complexes vont augmenter sensiblement. Par exemple, les requêtes portant sur plus de six mois de données peuvent facturer 1 000 jetons de quota ou plus.

Propriétés standards

Nom du quota Ancienne limite Nouvelle limite
Jetons de cœur par propriété et par jour 25 000 200 000
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 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 cœur par propriété et par jour 250 000 2 000 000
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 d'entonnoir par projet, par propriété et par heure 17 500 140 000

2023-03-02 Ajout de dimensions de date.

  • dayOfWeekName Nom du jour de la semaine. Jour de la semaine en anglais. Les valeurs de cette dimension sont Sunday, Monday, etc.

  • isoWeek semaine ISO de l'année. Numéro de semaine ISO, où chaque semaine commence le lundi. Pour en savoir plus, consultez https://en.wikipedia.org/wiki/ISO_week_date. Exemples de valeurs possibles : 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 possibles : 2022 et 2023.

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

  • Mois de yearMonth an. Valeurs combinées de year et month. Voici quelques exemples de valeurs : 202212 ou 202301.

  • Semaine de yearWeek an. Valeurs combinées de year et week. Voici quelques exemples de valeurs : 202253 ou 202301.

27/02/2023 : ajout de dimensions sur 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 lors du 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, magasin physique). Nous vous recommandons d'utiliser l'identifiant de lieu Google correspondant à l'article associé. Vous pouvez également utiliser un ID de zone géographique personnalisé. Ce champ est renseigné lors du taggage par le paramètre "location_id" du tableau "items".

  • itemPromotionCreativeSlot emplacement de la création pour la promotion sur l'article. Nom de l'emplacement de la création promotionnelle associée à l'article. Cette dimension peut être spécifiée dans le taggage à l'aide du paramètre creative_slot au niveau de l'événement ou de l'article. Si le paramètre est spécifié à la fois au niveau de l'événement et de l'article, 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és à la première page vue au cours d'une session.

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

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

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

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

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

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

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

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

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

  • advertiserAdClicks clics sur les annonces. Nombre total de fois où les utilisateurs ont cliqué sur une annonce pour accéder à la propriété.
  • Coût publicitaire : advertiserAdCost. Montant total que vous avez payé pour vos annonces.
  • advertiserAdCostPerClick Coût par clic des annonces. Le coût par clic d'une annonce correspond au coût de l'annonce divisé par le nombre de clics sur l'annonce. Il s'agit souvent d'une version abrégée du CPC.
  • Coût par conversion : advertiserAdCostPerConversion. 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 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 articles payés. Nombre d'unités payées pour un seul article.
  • itemsClickedInList articles sur lesquels des utilisateurs ont cliqué dans la liste. Nombre d'unités sur lesquelles des utilisateurs ont cliqué dans la liste pour un seul article.
  • itemsClickedInPromotion articles sur lesquels des utilisateurs ont cliqué dans la promotion. Nombre d'unités sur lesquelles des utilisateurs ont cliqué dans la promotion pour un seul article.
  • itemsViewed articles consultés. Nombre d'unités vues pour un seul article.
  • itemsViewedInList articles consultés dans la liste. Nombre d'unités affichées dans la liste pour un seul article.
  • itemsViewedInPromotion articles consultés dans la promotion. Nombre d'unités vues dans la promotion pour un seul article.

13/09/2022 Annonce concernant les changements concernant la compatibilité des schémas.

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

  1. Les dimensions de portée article comme itemName deviennent incompatibles avec les métriques de portée événement comme eventCount. Les dimensions de portée article seront toujours compatibles avec les métriques de portée article comme itemRevenue, les métriques basées sur l'utilisateur comme activeUsers et les métriques basées sur les sessions comme sessions.

  2. Les dimensions d'attribution telles que source deviennent incompatibles avec certaines métriques de portée événement, telles que 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 sont compatibles qu'avec un ensemble limité de dimensions et de métriques.

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

01/09/2022 : modifications de 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 de Tokens Per Property Per Hour et de Tokens Per Project Per Property Per Hour.

    Pour obtenir des informations détaillées 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 de compte de moteur SA360 de la session. ID du compte de moteur dans SA360 ayant généré cette session.

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

  • sessionSa360EngineAccountType Type de compte de moteur SA360 de la session. Type de 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 issu 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 dimensions.

Termes et contenus manuels

  • firstUserManualAdContent Premier contenu d'annonce manuel de l'utilisateur. Contenu de l'annonce qui a touché l'utilisateur en premier. Valeur insérée par le paramètre utm_content.

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

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

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

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

  • sessionManualTerm session, terme manuel. Terme ayant généré une session. Valeur insérée par le paramètre utm_term.

Analyse des plantages

  • crashAffectedUsers utilisateur concerné par le plantage. Il s'agit du 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é) des utilisateurs actifs sur 30 jours qui sont aussi actifs sur une journée.

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

  • wauPerMau UAS / UAM. Pourcentage mobile d'utilisateurs actifs sur 30 jours qui sont également des utilisateurs actifs sur 7 jours.

  • purchaserConversionRate Pourcentage d'utilisateurs actifs ayant effectué une ou plusieurs transactions d'achat.

  • transactionsPerPurchaser transactions par acheteur.

Campagne Google Ads

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

  • googleAdsCampaignType : type de 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 nouvelles dimensions "Date/Heure".

  • dateHourMinute : valeurs combinées de date, heure et minute au format AAAAMMJJHHMM.

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

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

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

  • achievementId : 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 pour un lien sortant.

  • linkDomain Domaine de destination du lien sortant.

  • linkId : attribut d'ID HTML pour un lien sortant ou 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 de déclenchement d'un événement.

  • outbound Renvoie la valeur "true" si le lien redirige 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 visitées.

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

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

  • searchTerm Terme recherché par l'utilisateur.

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

  • videoTitle : titre de la vidéo.

  • videoUrl : URL de la vidéo.

  • visible Renvoie 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é enregistré.

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

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 pour lesquels l'événement a été enregistré.

Annonce concernant les changements à venir:

  • firstUserTrafficOrigin Origine du trafic qui a touché l'utilisateur en premier. Ne comptez pas sur le renvoi de la valeur "Manuel" pour le trafic utilisant des UTM, ce champ sera mis à jour en renvoyant "Manuel" à "(not set)" pour le lancement d'une fonctionnalité à venir.

  • sessionTrafficOrigin : origine du trafic de la campagne de la session. Ne comptez pas sur le renvoi de la valeur "Manuel" pour le trafic utilisant des UTM, ce champ sera mis à jour en renvoyant "Manuel" à "(not set)" pour le lancement d'une fonctionnalité à venir.

  • trafficOrigin : origine du trafic de la campagne associée à l'événement de conversion. Ne comptez pas sur le renvoi de la valeur "Manuel" pour le trafic utilisant des UTM, ce champ sera mis à jour en renvoyant "Manuel" à "(not set)" 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 requête de rapport, et permettent de maintenir la compatibilité.

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

Il est maintenant possible de spécifier les plages de minutes de 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 rapport de l'API Data:

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

  • defaultChannelGrouping Regroupement de canaux par défaut.

10/06/2021 : modifications du schéma de l'API.

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

  • 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 qui conduit à une session sur votre site Web ou dans votre application.

  • Remplacement du nom de la dimension firstUserCreativeId par 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 la version 1 de l'API Google Analytics Data 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 de l'URL au lieu du champ entity du corps d'une requête:

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

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

2021-02-19 (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 qui était utilisée pour indiquer une tentative de récupération de toutes les lignes n'est plus acceptée dans RunReportRequest.

  • La valeur maximale du champ limit est définie sur 100000. Utilisez la pagination pour récupérer 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 concernant les campagnes.

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 des dimensions.

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

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

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

Chaque métrique personnalisée enregistrée par une propriété crée trois variantes de métrique 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 d'API : hour, nthHour, nthYear, dateHour.

28/01/2021 : Data API 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 de jetons par heure et par jour pour les propriétés 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 "Temps réel".

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

19/10/2020 Artefacts de la bibliothèque cliente mis à jour.

Artefacts de la bibliothèque cliente mis à jour avec les 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).

2020-10-08 Ajout de la méthode getMetadata à 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.

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 métriques et dimensions personnalisées de portée événement, ainsi que les dimensions personnalisées de portée utilisateur.