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 utilisateurprimaryChannelGroup
groupe de canaux principalsessionPrimaryChannelGroup
groupe de canaux principal de la session
Dimensions "Source de trafic manuelles" :
manualCampaignId
ID de campagne manuelmanualCampaignName
Nom de la campagne manuellemanualCreativeFormat
Format de création manuelmanualMarketingTactic
: stratégie marketing manuellemanualMedium
Support manuelmanualSource
source manuellemanualSourceMedium
"Source / Support" manuelmanualSourcePlatform
: plate-forme de la source manuellefirstUserManualCampaignId
Premier ID de campagne manuel de l'utilisateurfirstUserManualCampaignName
Nom de la première campagne manuelle de l'utilisateurfirstUserManualCreativeFormat
Premier format de création manuel de l'utilisateurfirstUserManualMarketingTactic
Première stratégie marketing manuelle de l'utilisateurfirstUserManualMedium
Premier support manuel de l'utilisateurfirstUserManualSource
Première source manuelle de l'utilisateurfirstUserManualSourceMedium
Premier support / source manuel de l'utilisateurfirstUserManualSourcePlatform
Plate-forme de la première source manuelle de l'utilisateursessionManualCampaignId
ID de campagne manuel associé à la sessionNom de la campagne manuelle de la session "
sessionManualCampaignName
"sessionManualCreativeFormat
format de création manuel associé à la sessionStratégie marketing manuelle de
sessionManualMarketingTactic
sessionSupport manuel associé à la session "
sessionManualMedium
"sessionManualSource
source manuelle de la sessionSource / 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 CM360cm360AccountName
nom de compte CM360cm360AdvertiserId
référence annonceur CM360cm360AdvertiserName
nom d'annonceur CM360cm360CampaignId
ID de campagne CM360cm360CampaignName
nom de campagne CM360cm360CreativeFormat
format de création CM360cm360CreativeId
ID de la création CM360cm360CreativeName
nom de la création CM360cm360CreativeType
type de création CM360cm360CreativeTypeId
ID du type de création CM360cm360CreativeVersion
version de la création CM360cm360Medium
support CM360cm360PlacementCostStructure
type de facturation de l'emplacement CM360cm360PlacementId
ID d'emplacement CM360cm360PlacementName
nom d'emplacement CM360cm360RenderingId
ID de rendu CM360cm360SiteId
ID du site CM360cm360SiteName
nom de site CM360cm360Source
source CM360cm360SourceMedium
source / support CM360firstUserCm360AccountId
ID du premier compte CM360 de l'utilisateurfirstUserCm360AccountName
Nom du premier compte CM360 de l'utilisateurfirstUserCm360AdvertiserId
première référence annonceur CM360 de l'utilisateurfirstUserCm360AdvertiserName
Nom du premier annonceur CM360 de l'utilisateurfirstUserCm360CampaignId
ID de la première campagne CM360 de l'utilisateurfirstUserCm360CampaignName
: nom de la première campagne CM360 de l'utilisateurfirstUserCm360CreativeFormat
Premier format de la création CM360 de l'utilisateurfirstUserCm360CreativeId
ID de la création CM360 du premier utilisateurfirstUserCm360CreativeName
Nom de la première création CM360 de l'utilisateurfirstUserCm360CreativeType
type de création CM360 du premier utilisateurfirstUserCm360CreativeTypeId
ID du type de création CM360 du premier utilisateurfirstUserCm360CreativeVersion
version de la première création CM360 de l'utilisateurfirstUserCm360Medium
Premier support CM360 de l'utilisateurfirstUserCm360PlacementCostStructure
type de facturation du premier emplacement CM360 de l'utilisateurfirstUserCm360PlacementId
ID du premier emplacement CM360 de l'utilisateurfirstUserCm360PlacementName
Nom du premier emplacement CM360 de l'utilisateurfirstUserCm360RenderingId
ID du premier rendu CM360 de l'utilisateurfirstUserCm360SiteId
ID du premier site CM360 de l'utilisateurfirstUserCm360SiteName
Nom du premier site CM360 de l'utilisateurfirstUserCm360Source
source CM360 du premier utilisateurfirstUserCm360SourceMedium
Source / support CM360 du premier utilisateursessionCm360AccountId
ID de compte CM360 associé à la sessionsessionCm360AccountName
nom du compte CM360 associé à la sessionsessionCm360AdvertiserId
référence annonceur CM360 de la sessionsessionCm360AdvertiserName
nom d'annonceur CM360 associé à la sessionsessionCm360CampaignId
ID de la campagne CM360 de la sessionsessionCm360CampaignName
nom de la campagne CM360 de la sessionsessionCm360CreativeFormat
format de la création CM360 de la sessionsessionCm360CreativeId
ID de la création CM360 de la sessionsessionCm360CreativeName
nom de la création CM360 de la sessionsessionCm360CreativeType
type de création CM360 de la sessionsessionCm360CreativeTypeId
ID du type de création CM360 de la sessionsessionCm360CreativeVersion
version de la création CM360 de la sessionsessionCm360Medium
support CM360 de la sessionsessionCm360PlacementCostStructure
type de facturation de l'emplacement CM360 de la sessionsessionCm360PlacementId
ID d'emplacement CM360 de la sessionsessionCm360PlacementName
nom d'emplacement CM360 de la sessionsessionCm360RenderingId
ID du rendu CM360 associé à la sessionsessionCm360SiteId
ID du site CM360 associé à la sessionsessionCm360SiteName
Nom du site CM360 associé à la sessionsessionCm360Source
source CM360 de la sessionsessionCm360SourceMedium
source / support CM360 de la session
Dimensions d'intégration de Google Display & Video 360 (DV360) :
dv360AdvertiserId
référence annonceur DV360dv360AdvertiserName
nom de l'annonceur DV360dv360CampaignId
ID de la campagne DV360dv360CampaignName
nom de la campagne DV360dv360CreativeFormat
format de la création DV360dv360CreativeId
ID de la création DV360dv360CreativeName
nom de la création DV360dv360ExchangeId
ID de la place de marché DV360dv360ExchangeName
nom de la place de marché DV360dv360InsertionOrderId
ID de l'ordre d'insertion DV360dv360InsertionOrderName
nom de l'ordre d'insertion DV360dv360LineItemId
ID d'élément de campagne DV360dv360LineItemName
nom d'élément de campagne DV360dv360Medium
support DV360dv360PartnerId
ID du partenaire DV360dv360PartnerName
nom du partenaire DV360dv360Source
source DV360dv360SourceMedium
source / support DV360firstUserDv360AdvertiserId
première référence annonceur DV360 de l'utilisateurfirstUserDv360AdvertiserName
Nom du premier annonceur DV360 de l'utilisateurfirstUserDv360CampaignId
ID de la première campagne DV360 de l'utilisateurfirstUserDv360CampaignName
: nom de la première campagne DV360 de l'utilisateurfirstUserDv360CreativeFormat
format de la première création DV360 de l'utilisateurfirstUserDv360CreativeId
ID de la première création DV360 de l'utilisateurfirstUserDv360CreativeName
Nom de la première création DV360 de l'utilisateurfirstUserDv360ExchangeId
ID de la première place de marché DV360 de l'utilisateurfirstUserDv360ExchangeName
Nom de la première place de marché DV360 de l'utilisateurfirstUserDv360InsertionOrderId
ID de l'ordre d'insertion DV360 du premier utilisateurfirstUserDv360InsertionOrderName
nom du premier ordre d'insertion DV360 de l'utilisateurfirstUserDv360LineItemId
ID du premier élément de campagne DV360 de l'utilisateurfirstUserDv360LinteItemName
Nom du premier élément de campagne DV360 de l'utilisateurfirstUserDv360Medium
Premier support DV360 de l'utilisateurfirstUserDv360PartnerId
ID du partenaire DV360 du premier utilisateurfirstUserDv360PartnerName
Nom du partenaire DV360 du premier utilisateurfirstUserDv360Source
Source DV360 du premier utilisateurfirstUserDv360SourceMedium
Source / Support DV360 du premier utilisateursessionDv360AdvertiserId
référence annonceur DV360 de la sessionsessionDv360AdvertiserName
nom de l'annonceur DV360 de la sessionsessionDv360CampaignId
ID de la campagne DV360 de la sessionsessionDv360CampaignName
nom de la campagne DV360 de la sessionsessionDv360CreativeFormat
format de la création DV360 de la sessionsessionDv360CreativeId
ID de la création DV360 de la sessionsessionDv360CreativeName
Nom de la création DV360 de la sessionsessionDv360ExchangeId
ID de la place de marché DV360 de la sessionsessionDv360ExchangeName
Nom de la place de marché DV360 de la sessionsessionDv360InsertionOrderId
ID de l'ordre d'insertion DV360 de la sessionsessionDv360InsertionOrderName
nom de l'ordre d'insertion DV360 de la sessionsessionDv360LineItemId
ID d'élément de campagne DV360 de la sessionsessionDv360LineItemName
nom d'élément de campagne DV360 de la sessionsessionDv360Medium
Support DV360 de la sessionsessionDv360PartnerId
ID du partenaire DV360 de la sessionsessionDv360PartnerName
Nom du partenaire DV360 de la sessionsessionDv360Source
source DV360 de la sessionsessionDv360SourceMedium
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'utilisateurfirstUserSa360CampaignName
première campagne SA360 de l'utilisateurfirstUserSa360CreativeFormat
Format de la première création SA360 de l'utilisateurfirstUserSa360EngineAccountId
ID du premier compte de moteur SA360 de l'utilisateurfirstUserSa360EngineAccountName
Nom du premier compte de moteur SA360 de l'utilisateurfirstUserSa360EngineAccountType
Type de compte de moteur SA360 (premier utilisateur)firstUserSa360KeywordText
Texte du premier mot clé SA360 de l'utilisateurfirstUserSa360ManagerAccountId
ID du premier compte administrateur SA360 de l'utilisateurfirstUserSa360ManagerAccountName
Nom du compte administrateur SA360 (premier utilisateur)firstUserSa360Medium
Premier support SA360 de l'utilisateurfirstUserSa360Query
première requête SA360 de l'utilisateurfirstUserSa360Source
Source SA360 du premier utilisateurfirstUserSa360SourceMedium
Source / Support SA360 (premier utilisateur)sa360AdGroupId
ID du groupe d'annonces SA360sa360CampaignId
ID de campagne SA360sa360AdGroupName
nom du groupe d'annonces SA360sa360CampaignName
campagne SA360sa360CreativeFormat
format de la création SA360sa360EngineAccountId
ID de compte de moteur SA360sa360EngineAccountName
nom de compte de moteur SA360sa360EngineAccountType
type de compte de moteur SA360sa360KeywordText
texte du mot clé SA360sa360ManagerAccountId
ID de compte administrateur SA360sa360ManagerAccountName
nom de compte administrateur SA360sa360Medium
support SA360sa360Query
requête SA360sa360Source
source SA360sa360SourceMedium
source / support SA360sessionSa360AdGroupId
ID du groupe d'annonces SA360 de la sessionsessionSa360CampaignId
ID de campagne SA360 de la sessionsessionSa360ManagerAccountId
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 sonttrue
,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
renvoietrue
. Si un utilisateur ne peut pas bénéficier de la personnalisation des annonces,isAdsPersonalizationAllowed
renvoiefalse
.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 sontSunday
,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
et53
.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
et2023
.isoYearIsoWeek
Semaine ISO de l'année ISO. Valeurs combinées deisoWeek
etisoYear
. Exemples de valeurs possibles :201652
et201701
.Mois de
yearMonth
an. Valeurs combinées deyear
etmonth
. Voici quelques exemples de valeurs :202212
ou202301
.Semaine de
yearWeek
an. Valeurs combinées deyear
etweek
. Voici quelques exemples de valeurs :202253
ou202301
.
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ètrecreative_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
ouAsia
).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:
Les dimensions de portée article comme
itemName
deviennent incompatibles avec les métriques de portée événement commeeventCount
. Les dimensions de portée article seront toujours compatibles avec les métriques de portée article commeitemRevenue
, les métriques basées sur l'utilisateur commeactiveUsers
et les métriques basées sur les sessions commesessions
.Les dimensions d'attribution telles que
source
deviennent incompatibles avec certaines métriques de portée événement, telles queeventCount
. Les dimensions d'attribution seront toujours compatibles avec les métriques attribuables commeconversions
, les métriques basées sur l'utilisateur commeactiveUsers
et les métriques basées sur les sessions commesessions
.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
etRequests 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 deTokens 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
etsessionCampaignName
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.
La méthode
runFunnelReport
a été ajoutée à la version v1alpha de l'API, qui renvoie un rapport personnalisé sur les entonnoirs de vos données d'événements Google Analytics.Cette méthode est introduite en version alpha afin de recueillir des commentaires sur la syntaxe et les fonctionnalités avant le passage à la version bêta. Veuillez nous envoyer vos commentaires concernant les rapports sur les entonnoirs de conversion de l'API Google Analytics Data.
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ètreutm_content
.firstUserManualTerm
Premier terme manuel de l'utilisateur. Terme qui a initialement acquis l'utilisateur. Valeur insérée par le paramètreutm_term
.manualAdContent
Contenu d'annonce manuel. Contenu de l'annonce attribué à l'événement de conversion. Valeur insérée par le paramètreutm_content
.manualTerm
Terme manuel. Terme attribué à l'événement de conversion. Valeur insérée par le paramètreutm_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ètreutm_content
.sessionManualTerm
session, terme manuel. Terme ayant généré une session. Valeur insérée par le paramètreutm_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 utilisateurfirstTimePurchaserConversionRate
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éthoderunRealtimeReport
. 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
parfirstUserGoogleAdsCreativeId
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
etbatchRunPivotReports
acceptent désormais l'ID d'une propriété Google Analytics 4 dans le paramètreproperty
du chemin de l'URL au lieu du champentity
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 sur100000
. 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.