Journal des modifications

Pour consulter les annonces officielles relatives à l'API Google Analytics, inscrivez-vous à Groupe de notifications de l'API Google Analytics.

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

Le nombre d'erreurs de serveur d'API autorisées par projet et par dans un délai de 15 minutes. Cela inclut toutes les requêtes entraînant une avec un code autre que 500 ou 200. Exemples d'erreurs qui ne s'affichent pas dans le cadre de ce quota: si vous utilisez des combinaisons de dimensions et de métriques incompatibles, les erreurs d'authentification.

Si cette limite est dépassée, d'autres appels d'API vers cette propriété temporairement bloquées pour le projet Google Cloud associé jusqu'à la fin du délai de 15 minutes à la fin de la période de suivi.

14/05/2024 Ajout de la fonctionnalité de comparaisons

Grâce aux comparaisons, vous pouvez vous pouvez évaluer des sous-ensembles de vos données côte à côte.

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

Dans une requête, vous pouvez spécifier une comparaison de base en fournissant le dimensionFilter avec une requête, ou utilisez une comparaison enregistrée en indiquant nom de ressource de la comparaison comparison .

La méthode getMetadata est mise à jour vers lister toutes les comparaisons enregistrées disponibles pour une propriété comparisons "Response".

Lorsqu'au moins une comparaison est spécifiée dans une requête, la réponse contiennent la colonne comparison identifiant chaque comparaison.

Actuellement, les comparaisons enregistrées ne peuvent être créées qu'à l'aide de la UI 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 suivantes de manipulation des tâches de rapport ont été ajoutées à l'API Data v1alpha:

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

Les dimensions et les métriques de la clé événements sont désormais disponibles.

Modifiez vos demandes de rapport qui utilisent la dimension isConversionEvent pour : utilisez plutôt la dimension isKeyEvent.

Modifiez les demandes de rapport qui utilisent une métrique obsolète dans le tableau ci-dessous pour utiliser la métrique clé 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

apporter des modifications similaires à toute utilisation des métriques d'événement clé pour une clé donnée ; événement dans vos demandes de rapport.

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

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

25/03/2024 Ajout d'un groupe de canaux principal, d'une source de trafic manuelle des dimensions spécifiques à l'intégration.

Groupe de canaux principal, source de trafic manuelle et intégration CM360, DV360 et SA360 des dimensions spécifiques 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

Réseau Display de Google et Dimensions d'intégration de 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, l'utilisateur peuvent entrer dans le public en ne visitant pas votre site Web pendant sept jours. Exemples de les audiences d'utilisateurs inactifs incluent "Acheteurs inactifs pendant 7 jours", "Acheteurs inactifs pendant 7 jours" utilisateurs", & "Utilisateurs non avertis sur 7 jours". Pour en savoir plus sur les suggestions des 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 les utilisateurs sont activées pour votre propriété. Si les données fournies par l'utilisateur est activée, les données fournies par les utilisateurs et le User-ID peuvent être envoyés Google Analytics pour l'ajout de balises 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.

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 "Liste d'audience récurrente" (à l'aide de properties.recurringAudienceLists.create).

Cette fonctionnalité vous permet de recevoir des notifications de webhook de manière asynchrone dès qu'une liste d'audience est 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. Dimensions telles que pagePathPlusQueryString, unifiedPageScreen et pageLocation et fullPageUrl sont désormais compatibles avec de nombreux champs supplémentaires, y compris sessionSource, browser, city et landingPage.

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

Consultez les dimensions et dimensions GA4 Explorateur de métriques pour obtenir des informations complètes sur la compatibilité.

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 en utilisant la syntaxe suivante:

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

Reportez-vous aux dimensions et dimensions de l'API des métriques pour obtenir d'autres des informations.

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'audiences et ajoutées à Data API v1 bêta.

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 contiennent un élément SampleMetadata ; pour chaque plage de dates de la demande pour laquelle les résultats ont été échantillonné. Google Analytics n'appliquera l'échantillonnage que s'il prévoit que les limites de cardinalité réduire 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 de properties.recurringAudienceLists.create, properties.recurringAudienceLists.create, properties.recurringAudienceLists.list à la version alpha de l'API Data v1.

Cette fonctionnalité vous permet de créer quotidiennement des listes d'audience les adhésions changent. Les listes d'audience récurrentes permettent avec les résultats les plus récents sur les membres de l'audience.

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

Le properties.audienceLists.exportSheet a été ajouté à l'API Data version 1 (alpha) qui vous permet d'exporter une liste d'audience 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 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 d'ordre que les autres méthodes de création de rapports de l'API Data: le tri se fera par ordre décroissant en fonction de la première colonne, puis de la deuxième colonne dans l'ordre décroissant. une colonne, etc.

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

deviceId isAdsPersonalizationAllowed
ABC true
DAC faux
ABC faux
AAA true

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

deviceId isAdsPersonalizationAllowed
AAA true
ABC faux
ABC true
DAC faux

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

  • isLimitedAdTracking Le paramètre "Limiter le suivi des annonces" de l'appareil. Valeurs possibles incluent: 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 la événement d'e-commerce. Exemple : "EUR" 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 la valeur "item".

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 à 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

Ajout de la compatibilité avec les listes d'audience dans la version 1 de l'API Data Alpha. Les listes d'audience incluent un instantané des utilisateurs inclus dans l'audience lors de la création de la liste d'audience.

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

19/05/2023 Groupes de canaux personnalisés

Groupes de canaux personnalisés pour 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 frais.

Le nombre de jetons facturés pour chaque requête a été mis à jour en fonction des changements de quota et rééquilibré afin de permettre de requêtes de rapport simples, tout en facturant beaucoup plus des 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 notable des frais pour les requêtes plus complexes. Par exemple, les requêtes portant sur plus de six mois de données peuvent coûter 1 000 ou plus de jetons.

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 & 2023

  • isoYearIsoWeek semaine ISO de l'année ISO. Valeurs combinées de isoWeek et isoYear. Exemples de valeurs : 201652 & 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 balisage par l'attribut "index" dans le 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 "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 par le paramètre creative_slot au niveau de l'événement ou de l'article. Si le paramètre est spécifié à la fois au niveau de l'événement le paramètre "Au niveau de l'article" est utilisé.

21/02/2023 Ajout de "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 options "Vues par utilisateur" et "Utilisateurs défilants". métriques.

  • 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 des colonnes "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 "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 telles que itemName ne sont plus compatibles avec avec des métriques de portée événement telles que eventCount. Les dimensions de portée article compatible avec les métriques de portée article comme itemRevenue, les métriques basées sur l'utilisateur comme activeUsers, et des métriques basées sur les sessions comme sessions.

  2. Les dimensions d'attribution telles que source ne sont plus compatibles avec certaines avec des métriques de portée événement telles que eventCount. Les dimensions d'attribution compatibles avec les métriques attribuables, comme les conversions, les métriques basées sur l'utilisateur comme activeUsers, et des métriques basées sur les sessions comme sessions.

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

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

2022-09-01 Modifications des 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

    Consultez la documentation sur les quotas. pour obtenir des informations détaillées sur les nouveaux 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. 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 contenus

  • firstUserManualAdContent Premier contenu d'annonce manuel de l'utilisateur. Le 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 été acquis en premier l'utilisateur. Valeur insérée par le paramètre utm_term.

  • manualAdContent Contenu d'annonce manuel. Le 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. Le contenu d'annonce qui a conduit à 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 qui se sont connectés 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 impressions sessions.

  • 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 La plate-forme et le type d'appareil sur lesquels votre de votre site Web ou application mobile.

Application mobile

  • averagePurchaseRevenuePerUser : revenus moyens des achats par utilisateur.

  • firstTimePurchaserConversionRate : pourcentage d'utilisateurs actifs ayant généré 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 aussi des utilisateurs actifs sur 1 jour.

  • dauPerWau UAJ / UAS. Pourcentage glissant d'utilisateurs actifs sur 7 jours qui sont aussi des utilisateurs actifs sur 1 jour.

  • wauPerMau UAS / UAM. Pourcentage glissant d'utilisateurs actifs sur 30 jours qui sont et les utilisateurs actifs sur 7 jours.

  • purchaserConversionRate : pourcentage d'utilisateurs actifs ayant généré 1 ou plus les transactions d'achat.

  • transactionsPerPurchaser transactions par acheteur.

Campagne Google Ads

  • firstUserGoogleAdsCampaignType Type de campagne Google Ads la première campagne qui a touché l'utilisateur.

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

  • sessionGoogleAdsCampaignType : type de la campagne Google Ads qui ont mené à 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 renvoie 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 pour le Web. pages 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 renvoie la valeur "true". si le contenu est visible.

  • unifiedPagePathScreen : chemin de la page (Web) ou classe de l'écran (application) sur lesquels l'événement a été 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 affiche désormais la chemin de la page et chaîne de requête sur lesquelles 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 "Manuelle" pour le trafic qui utilise UTM La valeur "Manuel" n'est plus affichée dans ce champ. au retour "(not set)" (non défini) pour le lancement prochain d'une fonctionnalité.

  • sessionTrafficOrigin : origine du trafic de la campagne de la session. Ne vous attendez pas à ce que ce champ renvoie "Manuelle" pour le trafic qui utilise UTM La valeur "Manuel" n'est plus affichée dans ce champ. au retour "(not set)" (non défini) pour le lancement prochain d'une fonctionnalité.

  • trafficOrigin Origine du trafic de la campagne associée à l'événement de conversion. Ne vous attendez pas à ce que ce champ renvoie "Manuelle" pour le trafic qui utilise UTM La valeur "Manuel" n'est plus affichée dans ce champ. au retour "(not set)" (non défini) pour le lancement prochain d'une fonctionnalité.

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

checkCompatibility répertorie les dimensions et les métriques pouvant être ajoutées à une demande de rapport. La méthode à 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 de le minuteRanges du 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 avant qu'un événement collectées. 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. Ce 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. Ce contient l'ID de la création Google Ads qui génère une session. sur votre site Web ou dans votre application.

  • Dimension "firstUserCreativeId" renommée "firstUserGoogleAdsCreativeId" dans le schéma de l'API Data. Cette dimension contient l'ID de l'interface Google Ads la création ayant initialement acquis l'utilisateur.

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.

  • runReport, runPivotReport, batchRunReports et batchRunPivotReports acceptent désormais l'ID d'une propriété Google Analytics 4 dans 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 d'événements données.

  • Valeur "limit" : -1 utilisée pour indiquer une tentative de tout récupérer lignes ne sont plus acceptées dans RunReportRequest.

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

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

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

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

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

08/02/2021 Ajout de nouvelles dimensions de campagne.

De nouvelles dimensions de campagne ont été ajoutées au schéma d'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 sur 1.

  • La valeur de la dimension week commence maintenant par 01 et renvoie une valeur de 01 à 53. Chaque semaine commence le dimanche. Le 1er janvier est toujours dans la semaine 01.

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

Chaque métrique personnalisée enregistrée par une propriété crée trois Variantes de métriques de l'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 et 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és.

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

La méthode getUniversalMetadata a été supprimée. Veuillez utiliser getMetadata. La limite d'un an la plage de dates 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 l'article Créer un rapport "Temps réel" pour obtenir des exemples et runRealtimeReport pour Documentation de référence sur REST.

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

Artefacts de la bibliothèque cliente mis à jour avec l'utilisation instructions et 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.

La méthode getMetadata renvoie des de dimensions et de métriques disponibles pour l'ID de propriété GA4 spécifié, 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 personnalisées et les métriques. Cette mise à jour inclut les dimensions et métriques personnalisées de portée événement et les dimensions personnalisées de portée utilisateur.