Journal des modifications de l'API Core Reporting de Google Analytics

Nous mettons régulièrement à jour l'API Core Reporting de Google Analytics afin de proposer de nouvelles fonctionnalités et de réparer les défauts détectés dans les versions précédentes. Dans la plupart des cas, ces modifications seront transparentes pour les développeurs d'API. Cependant, nous devons parfois apporter des modifications qui obligent les développeurs à modifier leurs applications existantes.

Cette page liste toutes les modifications apportées à l'API Core Reporting de Google Analytics susceptibles d'affecter votre application. Nous recommandons aux développeurs d'API de consulter régulièrement cette liste pour prendre connaissance des nouvelles annonces. Vous pouvez également vous abonner aux modifications via les flux listés dans la section S'abonner ci-dessous.

S'abonner aux journaux de modifications associés

Inclut toutes les API de collecte, de configuration et de reporting.

Inclut l'API de création de rapports principale, l'API de création de rapports sur les entonnoirs multicanaux et l'API de création de rapports en temps réel.

Version initiale de l'API User Activity

  • L'API User Activity vous permet de récupérer toutes les données associées à un Client-ID ou User-ID unique sur une période donnée. Elle s'adresse principalement aux propriétaires qui souhaitent permettre à un utilisateur de bénéficier d'un accès automatisé aux données. Pour en savoir plus, consultez le guide de l'API User Activity.

Cette version augmente le nombre maximal de lignes renvoyées dans l'ensemble de résultats de la version 4 de l'API Analytics Reporting.

Le nombre maximal de lignes renvoyées dans l'objet ReportData de l'API Analytics Reporting v4 passe de 10 000 à 100 000.

Cette version inclut un aperçu du système de quotas basés sur les ressources de la version 4 de l'API Reporting de Google Analytics, qui permet d'utiliser des seuils d'échantillonnage plus élevés pour les clients Analytics 360 (Premium).

Cette version abandonne la fonctionnalité Produits associés, ainsi que les dimensions et métriques associées. Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions. Pour en savoir plus sur la suppression de données, consultez le Règlement relatif aux abandons de données:

Dans cette version, les dimensions et métriques suivantes sont obsolètes:

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

Cette version ajoute une nouvelle dimension à l'API. Consultez l'article de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions. Cette version supprime également plusieurs dimensions et métriques obsolètes. Consultez le Règlement relatif aux abandons de données pour les API Google Analytics afin de comprendre le processus complet de suppression de données.

Heure

  • Nouvelle dimension ga:dateHourMinute, qui combine ga:date, ga:hour et ga:minute.

Suppression des données

Cette version supprime les dimensions et métriques obsolètes suivantes:

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

Cette version met à jour les métriques et dimensions existantes dans l'API. Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

Métriques utilisateur

Le calcul des métriques Utilisateurs et Utilisateurs actifs a été mis à jour afin de comptabiliser plus efficacement les utilisateurs. Vous constaterez peut-être une légère variation dans vos métriques. Pour en savoir plus, consultez Comment les utilisateurs sont identifiés pour les métriques utilisateur.

Métriques utilisateur concernées par la mise à jour du calcul:

  • ga:users : nombre total d'utilisateurs pour la période demandée.
  • ga:1dayusers : nombre total d'utilisateurs actifs sur 1 jour pour chaque jour de la période demandée.
  • ga:7dayusers : nombre total d'utilisateurs actifs sur 7 jours pour chaque jour de la période demandée.
  • ga:14dayusers : nombre total d'utilisateurs actifs sur 14 jours pour chaque jour de la période demandée.
  • ga:30dayusers : nombre total d'utilisateurs actifs sur 30 jours par jour de la période demandée.

Événements uniques

La période d'abandon de ga:uniqueEvents approche à grands pas. Après le 26 mars 2017, la définition de ga:uniqueEvents sera mise à jour, et la métrique privée ga:uniqueEventsTemporary sera supprimée de l'API. Pour en savoir plus, consultez les documents d'aide sur les événements uniques.

Cette version ajoute une nouvelle dimension à l'API, améliore les messages d'erreur et commence à appliquer les modifications annoncées précédemment pour les dimensions et métriques AdSense.

Dimensions utilisateur

  • Dimension ga:userBucket : pour un utilisateur donné, la dimension "Segment d'utilisateurs" (valeurs 1 à 100) indique l'ensemble auquel l'utilisateur a été attribué. Pour en savoir plus, consultez l'article Tester les campagnes de remarketing.

Messages d'erreur

Alors qu'auparavant l'API renvoyait un message d'erreur erroné Unknown dimension(s): ou Unknown metric(s): lors d'une requête de données dont les conditions n'étaient pas remplies, l'API renvoie désormais le message: Restricted metric(s): ... can only be queried under certain conditions.

Dimensions et métriques AdSense

Les vues non associées à AdSense ne pourront plus interroger les dimensions et les métriques AdSense. Si vous interrogez ces dimensions et métriques avec des vues associées non AdSense, vous obtiendrez une erreur.

Cette version corrige un bug. Elle corrige un problème concernant les dimensions et métriques AdSense, et annonce une modification à venir de ces dimensions et métriques.

Dimensions et métriques AdSense

Cette version corrige un problème qui a débuté le 07/01/2017 : les requêtes portant sur les dimensions et métriques AdSense renvoyaient une erreur "Métrique inconnue" pour les vues non associées à AdSense.

Modifications à venir

À compter du 31 janvier 2017, les vues associées non AdSense ne pourront plus interroger les dimensions et les métriques AdSense. Si vous interrogez ces dimensions et métriques avec des vues associées non AdSense, vous obtiendrez une erreur.

Cette version ajoute la nouvelle métrique suivante à l'API. Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

Statistiques calculées

Cette version est compatible avec les métriques calculées.

  • Métrique – ga:calcMetric_ : valeur de la métrique calculée demandée, où fait référence au nom défini par l'utilisateur de la métrique calculée. Notez que le type de données de ga:calcMetric_ peut être FLOAT, INTEGER, CURRENCY, TIME ou PERCENT. Pour en savoir plus, consultez À propos des métriques calculées.

Cette version ajoute une nouvelle métrique à l'API. De plus, il abandonne une métrique existante. Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

Suivi des événements

La définition de l'élément ga:uniqueEvents sera modifiée pour refléter plus précisément le nombre d'événements uniques. Pour affecter ce changement, nous abandonnerons techniquement la métrique ga:uniqueEvents actuelle, conformément à notre Règlement relatif à l'abandon des données. Si vous souhaitez essayer la nouvelle définition, vous pouvez référencer la métrique privée ga:uniqueEventsTemporary, qui calcule plus précisément le nombre d'événements uniques. Nous introduirons également une nouvelle métrique ga:uniqueDimensionCombinations qui conserve la définition actuelle de ga:uniqueEvents. Une fois le délai d'abandon approprié (environ six mois), la métrique privée ga:uniqueEventsTemporary sera supprimée, et la métrique d'origine ga:uniqueEvents représentera correctement le nombre d'événements uniques. Pour en savoir plus, consultez les documents d'aide sur les événements uniques.

Événements uniques

  • Métrique – ga:uniqueEvents : la définition de ga:uniqueEvents sera bientôt modifiée afin de refléter plus précisément le nombre d'événements uniques. Veuillez plutôt utiliser ga:uniqueDimensionCombinations si vous souhaitez conserver la définition existante. Pour en savoir plus, consultez les documents d'aide sur les événements uniques.
  • Métrique – ga:uniqueDimensionCombinations – Combinaisons de dimensions uniques comptabilisent le nombre de combinaisons uniques de dimension/valeur pour chaque dimension d'un rapport. Cela vous permet de générer des dimensions combinées (concaténées) post-traitement, et donc des rapports plus flexibles, sans avoir à mettre à jour la configuration du suivi ni à utiliser des emplacements de dimensions personnalisées supplémentaires. Pour en savoir plus, consultez les documents d'aide sur les événements uniques.

Tests de transition – Privé

  • Métrique – ga:uniqueEventsTemporary : nombre d'événements uniques. Il s'agit de la nouvelle définition de ga:uniqueEvents. Vous pouvez utiliser cette métrique pour comprendre la nouvelle définition avant la modification. Notez que cette métrique est privée et n'apparaîtra pas dans l'outil de référence sur les dimensions et métriques.

Cette version ajoute de nouvelles dimensions et métriques à l'API. Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

DoubleClick Bid Manager

  • Dimension – ga:dbmClickAdvertiser : nom de l'annonceur DBM associé au clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension – ga:dbmClickAdvertiserId : référence annonceur DBM du clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration à DBM).
  • Dimension – ga:dbmClickCreativeId : ID de la création DBM du clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension – ga:dbmClickExchange : nom de la place de marché DBM du clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension – ga:dbmClickExchangeId : ID de la place de marché DBM du clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension – ga:dbmClickInsertionOrder : nom de l'ordre d'insertion DBM du clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension – ga:dbmClickInsertionOrderId : ID de l'ordre d'insertion DBM du clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension – ga:dbmClickLineItem : nom de l'élément de campagne DBM du clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension – ga:dbmClickLineItemId : ID de l'élément de campagne DBM du clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension ga:dbmClickSite : nom du site DBM sur lequel la création DBM a été diffusée et a enregistré un clic pour le clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension ga:dbmClickSiteId : ID du site DBM sur lequel la création DBM a été diffusée et a enregistré un clic pour le clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension ga:dbmLastEventAdvertiser : nom de l'annonceur DBM associé au dernier événement DBM (impression ou clic au cours de la période d'analyse DBM) associé à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension ga:dbmLastEventAdvertiserId : référence annonceur DBM du dernier événement DBM (impression ou clic au cours de la période d'analyse DBM) associé à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension ga:dbmLastEventCreativeId : ID de la création DBM du dernier événement DBM (impression ou clic au cours de la période d'analyse DBM) associé à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension ga:dbmLastEventExchange : nom de la place de marché DBM du dernier événement DBM (impression ou clic au cours de la période d'analyse DBM) associé à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension ga:dbmLastEventExchangeId : ID de la place de marché DBM du dernier événement DBM (impression ou clic au cours de la période d'analyse DBM) associé à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension ga:dbmLastEventInsertionOrder : nom de l'ordre d'insertion DBM du dernier événement DBM (impression ou clic au cours de la période d'analyse DBM) associé à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension ga:dbmLastEventInsertionOrderId : ID de l'ordre d'insertion DBM du dernier événement DBM (impression ou clic au cours de la période d'analyse DBM) associé à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension ga:dbmLastEventLineItem : nom de l'élément de campagne DBM du dernier événement DBM (impression ou clic au cours de la période d'analyse DBM) associé à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration à DBM).
  • Dimension ga:dbmLastEventLineItemId : ID de l'élément de campagne DBM du dernier événement DBM (impression ou clic au cours de la période d'analyse DBM) associé à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension ga:dbmLastEventSite : nom du site DBM sur lequel la création DBM a été diffusée et sur laquelle l'utilisateur a cliqué pour le dernier événement DBM (impression ou clic au cours de la période d'analyse DBM) associé à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Dimension ga:dbmLastEventSiteId : ID du site DBM sur lequel la création DBM a été diffusée et a été utilisée pour le dernier événement DBM (impression ou clic au cours de la période d'analyse DBM) associé à la session Google Analytics (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Métrique – ga:dbmCPA – eCPA en fonction des revenus DBM (Analytics 360 uniquement, nécessite une intégration à DBM).
  • Métrique – ga:dbmCPC – eCPC en fonction des revenus (Analytics 360 uniquement, nécessite une intégration à DBM).
  • Métrique – ga:dbmCPM – eCPM en fonction des revenus DBM (Analytics 360 uniquement, nécessite une intégration à DBM).
  • Métrique – ga:dbmCTR – CTR DBM (Analytics 360 uniquement, nécessite une intégration avec DBM).
  • Métrique – ga:dbmClicks – Nombre total de clics DBM (Analytics 360 uniquement, nécessite une intégration à DBM).
  • Métrique – ga:dbmConversions – Nombre total de conversions DBM (Analytics 360 uniquement, nécessite une intégration à DBM).
  • Métrique – ga:dbmCost – Coût DBM (Analytics 360 uniquement, nécessite une intégration à DBM).
  • Métrique – ga:dbmImpressions – Nombre total d'impressions DBM (Analytics 360 uniquement, nécessite une intégration à DBM).
  • Métrique – ga:dbmROAS – ROAS DBM (Analytics 360 uniquement, nécessite une intégration à DBM).
  • Dimension - ga:dsAdGroup - Groupe d'annonces DS (Analytics 360 uniquement, doit être intégré à DS).
  • Dimension - ga:dsAdGroupId - ID du groupe d'annonces DS (Analytics 360 uniquement, nécessite une intégration avec DS).
  • Dimension – ga:dsAdvertiser – Annonceur DS (Analytics 360 uniquement, nécessite une intégration avec DS)
  • Dimension – ga:dsAdvertiserId : référence annonceur DS (Analytics 360 uniquement, nécessite une intégration avec DS)
  • Dimension – ga:dsAgency – Agence DS (Analytics 360 uniquement, nécessite une intégration avec DS)
  • Dimension – ga:dsAgencyId : ID d'agence DS (Analytics 360 uniquement, nécessite une intégration dans DS)
  • Dimension – ga:dsCampaign – Campagne DS (Analytics 360 uniquement, nécessite une intégration avec DS)
  • Dimension – ga:dsCampaignId : ID de campagne DS (Analytics 360 uniquement, nécessite une intégration avec DS)
  • Dimension – ga:dsEngineAccount – Compte de moteur DS (Analytics 360 uniquement, nécessite une intégration à DS)
  • Dimension – ga:dsEngineAccountId : ID du compte de moteur DS (Analytics 360 uniquement, nécessite une intégration à DS)
  • Dimension – ga:dsKeyword – Mot clé DS (Analytics 360 uniquement, nécessite une intégration dans DS).
  • Dimension – ga:dsKeywordId : ID du mot clé DS (Analytics 360 uniquement, nécessite une intégration à DS).
  • ga:dsCPC : coût DS pour l'annonceur par clic (Analytics 360 uniquement, nécessite une intégration à DS).
  • ga:dsCTR : taux de clics DS (Analytics 360 uniquement, nécessite une intégration avec DS).
  • ga:dsClicks – Clics DS (Analytics 360 uniquement, doit être intégré à DS)
  • ga:dsCost : coût DS (Analytics 360 uniquement, nécessite une intégration dans DS).
  • ga:dsImpressions : impressions DS (Analytics 360 uniquement, doit être intégré à DS).
  • ga:dsProfit : Profil DS (Analytics 360 uniquement, nécessite une intégration avec DS)
  • ga:dsReturnOnAdSpend : retour sur les dépenses publicitaires DS (Analytics 360 uniquement, nécessite une intégration dans DS).
  • ga:dsRevenuePerClick – Revenu par clic DS (Analytics 360 uniquement, nécessite une intégration avec DS).

Cette version ajoute une nouvelle dimension à l'API. Cette version ajoute également certaines restrictions sur la combinaison de dimensions pouvant être interrogées ensemble. Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

Réseau géographique

  • Dimension ga:continentId : ID de continent de l'utilisateur, déterminé par l'adresse IP ou l'ID géographique de l'utilisateur.

Restrictions

Les dimensions suivantes des groupes suivants ne peuvent pas être interrogées avec les dimensions des autres groupes:

  • Accéder au groupe d'informations Shopping
    • ga:checkoutOptions
    • ga:shoppingStage
  • Groupe de test GWO
    • ga:experimentVariant
    • ga:experimentId
  • Groupe d'intérêt
    • ga:interestOtherCategory
  • Groupe d'intérêt sur le marché
    • ga:interestInMarketCategory
  • Groupe de promotion interne :
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • Groupe d'intérêt pour la marque :
    • ga:interestAffinityCategory

Cette version introduit de nouvelles limites et quotas. Pour en savoir plus, consultez la documentation sur les limites et quotas.

Signaler des erreurs

Cette version commence à appliquer des limites aux demandes de rapport ayant échoué (5XX).

  • 10 requêtes ayant échoué par projet, par profil et par heure
  • 50 requêtes ayant échoué par projet, par profil et par jour

Limites des tableaux croisés dynamiques

Cette version commence à appliquer des limites aux demandes de tableaux croisés dynamiques:

  • Une demande de rapport peut désormais comporter jusqu'à deux tableaux croisés dynamiques.
  • Un tableau croisé dynamique peut comporter jusqu'à quatre dimensions.
  • Les dimensions des tableaux croisés dynamiques font partie de la restriction concernant le nombre total de dimensions autorisées dans la demande.
  • Les metrics de tableau croisé dynamique font partie de la restriction sur le nombre total de métriques autorisées dans la requête.

Cette version ajoute de nouvelles dimensions et métriques à l'API. Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

Réseau géographique

  • Dimension ga:metroId : code à trois chiffres de la zone de marché désignée d'où est arrivé le trafic, déterminé par l'adresse IP ou l'ID géographique des utilisateurs.

DoubleClick for Publishers

  • Métrique – ga:dfpImpressions : une impression d'annonce Ad Manager est enregistrée chaque fois qu'une annonce individuelle est diffusée sur le site Web. Par exemple, lorsqu'un internaute consulte une page contenant deux blocs d'annonces, nous affichons deux impressions (l'association à DS est activée et l'option "Masquer les revenus Google" n'est pas activée).
  • Métrique – ga:dfpCoverage – La couverture correspond au pourcentage de demandes d'annonces ayant renvoyé au moins une annonce. Généralement, la couverture peut aider à identifier les sites pour lesquels le compte Ad Manager n'est pas en mesure de fournir des annonces ciblées. (Impressions d'annonces / Nombre total de demandes d'annonces) x 100 (l'association à Ad Manager est activée, et le paramètre "Masquer le revenu Ad Manager" n'est pas activé)."
  • Métrique ga:dfpMonetizedPageviews : mesure le nombre total de pages vues sur la propriété, s'affichant avec une annonce provenant du compte AdMob associé. Notez qu'une même page peut comporter plusieurs blocs d'annonces (l'association avec Ad Manager est activée et l'option "Masquer le chiffre d'affaires Ad Manager" n'est pas activée)."
  • Métrique – ga:dfpImpressionsPerSession : le rapport entre le nombre d'impressions d'annonces Fitbit et le nombre de sessions Analytics (Impressions d'annonces / Sessions Analytics) (l'association à DS est activée et l'option "Masquer le chiffre d'affaires Fitbit" n'est pas activée).
  • Métrique – ga:dfpViewableImpressionsPercent : pourcentage d'impressions d'annonces visibles. Une impression est considérée comme visible lorsqu'elle s'est affichée dans le navigateur des utilisateurs et qu'elle a l'occasion d'être vue (l'association à DS est activée et l'option "Masquer les revenus " est désactivée)."
  • Métrique – ga:dfpClicks : nombre de fois où les utilisateurs ont cliqué sur des annonces AdMob sur le site (l'association à Ad Manager est activée et l'option "Masquer le revenu Google Ads" n'est pas activée).
  • Métrique – ga:dfpCTR : le pourcentage de pages vues ayant généré un clic sur une annonce Ad Manager (l'association à Ad Manager est activée et l'option "Masquer les revenus Fitbit" n'est pas activée).
  • Métrique – ga:dfpRevenue – Les revenus Ad Manager correspondent à une estimation des revenus publicitaires totaux en fonction des impressions diffusées (l'association avec Ad Manager est activée et l'option "Masquer les revenus Ad Manager" n'est pas activée).
  • Métrique – ga:dfpRevenuePer1000Sessions : total des revenus estimés des annonces Ad Manager pour 1 000 sessions Analytics. Notez que cette métrique est basée sur les sessions sur le site, et non sur les impressions d'annonces (l'association à DS est activée et l'option "Masquer les revenus " est désactivée).
  • Métrique – ga:dfpECPM : coût effectif pour mille pages vues. Il s'agit des revenus Ad Manager pour 1 000 pages vues (l'association avec Ad Manager est activée,et l'option "Masquer les revenus :" n'est pas activée).
  • Métrique ga:backfillImpressions - Impressions d'annonces de remplissage correspond à la somme de toutes les impressions d'annonces AdSense ou Ad Exchance diffusées en tant qu'annonces de remplissage via Ad Manager. Une impression d'annonce est enregistrée chaque fois qu'une annonce individuelle est diffusée sur le site Web. Par exemple, lorsqu'un internaute consulte une page contenant deux blocs d'annonces, nous affichons deux impressions (l'association à DS est activée et l'option "Masquer les revenus Google" n'est pas activée).
  • Métrique – ga:backfillCoverage – La couverture des annonces de remplissage correspond au pourcentage de demandes d'annonces de remplissage ayant renvoyé au moins une annonce. Généralement, elle permet d'identifier les sites pour lesquels le compte d'éditeur n'est pas en mesure de fournir des annonces ciblées. (Impressions d'annonces / nombre total de demandes d'annonces) x 100. Si AdSense et Ad Exchange diffusent des annonces de remplissage, cette métrique correspond à la moyenne pondérée des deux comptes d'annonces de remplissage (l'association à Ad Manager est activée et l'option "Masquer les revenus publicitaires dans Ad Exchange" n'est pas activée).
  • Métrique ga:backfillMonetizedPageviews : mesure le nombre total de pages vues sur la propriété, s'affichant avec au moins une annonce provenant du ou des comptes de remplissage associés. Veuillez noter qu'une seule page vue monétisée peut inclure plusieurs impressions d'annonces (l'association avec Ad Manager est activée et l'option "Masquer les revenus Ad Manager" n'est pas activée).
  • Métrique – ga:backfillImpressionsPerSession : le ratio entre le nombre d'impressions d'annonces de remplissage et le nombre de sessions Analytics (impressions d'annonces / sessions Analytics). Si AdSense et Ad Exchange fournissent des annonces de remplissage, cette métrique correspond à la somme des deux comptes d'annonces de remplissage (l'association à Ad Manager est activée et l'option "Masquer les revenus publicitaires dans Google Ads" n'est pas activée).
  • Métrique ga:backfillViewableImpressionsPercent : pourcentage d'impressions d'annonces de remplissage qui étaient visibles. Une impression est considérée comme visible lorsqu'elle s'est affichée dans le navigateur des utilisateurs et qu'elle a eu l'occasion d'être vue. Si AdSense et Ad Exchange fournissent tous les deux des annonces de remplissage, cette métrique correspond à la moyenne pondérée des deux comptes d'annonces de remplissage (l'association à Ad Manager est activée et l'option "Masquer les revenus publicitaires dans Ad Exchange" n'est pas activée).
  • Métrique ga:backfillClicks : nombre de fois où les utilisateurs ont cliqué sur des annonces de remplissage sur le site. Si AdSense et Ad Exchange fournissent tous les deux des annonces de remplissage, cette métrique correspond à la somme des deux comptes d'annonces de remplissage (l'association à Ad Manager est activée et l'option "Masquer les revenus : désactivée" est désactivée).
  • Métrique – ga:backfillCTR : pourcentage d'impressions de remplissage ayant généré un clic sur une annonce. Si AdSense et Ad Exchange fournissent tous les deux des annonces de remplissage, cette métrique correspond à la moyenne pondérée des deux comptes d'annonces de remplissage (l'association à Ad Manager est activée et l'option "Masquer les revenus publicitaires dans Ad Exchange" n'est pas activée).
  • Métrique ga:backfillRevenue : total des revenus estimés des annonces de remplissage. Si AdSense et Ad Exchange fournissent tous les deux des annonces de remplissage, cette métrique correspond à la somme des deux comptes d'annonces de remplissage (l'association à Ad Manager est activée et l'option "Masquer les revenus : désactivée" est désactivée).
  • Métrique – ga:backfillRevenuePer1000Sessions : total des revenus estimés des annonces de remplissage pour 1 000 sessions Analytics. Notez que cette métrique est basée sur les sessions sur le site et non sur les impressions d'annonces. Si AdSense et Ad Exchange fournissent des annonces de remplissage, cette métrique correspond à la somme des deux comptes d'annonces de remplissage (l'association à Ad Manager est activée et l'option "Masquer les revenus publicitaires dans Google Ads" n'est pas activée).
  • Métrique – ga:backfillECPM : coût effectif pour mille pages vues. Il s'agit du revenu pour 1 000 pages vues. Si AdSense et Ad Exchange fournissent des annonces de remplissage, cette métrique correspond à la somme des deux comptes d'annonces de remplissage (l'association à Ad Manager est activée et l'option "Masquer les revenus publicitaires dans Google Ads" n'est pas activée).

Cette version corrige un bug qui permet de résoudre un problème lié aux segments et à l'échantillonnage.

Segments

Cette version résout un problème qui causait une sous-évaluation d'un sous-ensemble de requêtes comportant le segment Tous les utilisateurs (gaid::-1) dans la API Core Reporting V3 et était divisé en deux segments dans la API Analytics Reporting V4.

Sampling

Dans cette version, un sous-ensemble de demandes provenant de tableaux personnalisés renvoyait des données échantillonnées.

Cette version annonce le lancement d'une nouvelle version de l'API : la version 4 de l'API Reporting Analytics. Cette nouvelle API constitue la méthode programmatique la plus avancée pour accéder aux données des rapports dans Google Analytics.

Principales fonctionnalités

Google Analytics s'appuie sur une infrastructure de création de rapports de données performante. L'API permet aux développeurs d'accéder à toute la puissance de la plate-forme Google Analytics. Voici quelques-unes des principales fonctionnalités de la version 4 de l'API Analytics Reporting:

  • Expressions de métriques - L'API vous permet de demander non seulement les métriques intégrées, mais également les expressions de métriques mathématiques. Par exemple, les objectifs réalisés par nombre de sessions peuvent être exprimés dans la requête sous la forme ga:goal1completions/ga:sessions.
  • Plages de dates multiples : vous pouvez demander deux plages de dates, ce qui vous permet de comparer les données de deux périodes dans une seule requête.
  • Cohortes et valeur vie : l'API dispose d'un vocabulaire riche pour demander des rapports sur les cohortes et sur la valeur vie.
  • Segments multiples : vous pouvez désormais demander plusieurs segments dans une seule demande.

Getting Started

Pour savoir comment commencer à utiliser l'API, consultez la documentation destinée aux développeurs.

Règles pour les quotas

La version 4 de l'API Analytics Reporting dispose de ses propres quotas et limites. Comme il s'agit d'une nouvelle API, ces limites et quotas sont susceptibles d'être modifiés.

Migration

En plus du guide de migration, nous mettons également à disposition une bibliothèque de compatibilité Python sur GitHub.

Dimensions et statistiques

Cette version ajoute également un ensemble de dimensions et de métriques spécialement pour l'API Analytics Reporting V4. Pour consulter la liste complète des définitions, reportez-vous à l'Explorateur de dimensions et de métriques.

  • Dimension ga:cohort : nom de la cohorte à laquelle appartient un utilisateur, d'après sa définition. Selon la façon dont les cohortes sont définies, un utilisateur peut appartenir à plusieurs cohortes, de la même manière qu'un utilisateur peut appartenir à plusieurs segments.

  • Dimension – ga:cohortNthDay : décalage du jour basé sur 0 par rapport à la date de définition de la cohorte. Par exemple, si une cohorte est définie dont la date de la première visite correspond au 01/09/2015, alors pour la date 04/09/2015, ga:cohortNthDay est défini sur 3.

  • ga:cohortNthMonth : décalage mensuel basé sur 0 par rapport à la date de définition de la cohorte.

  • Dimension – ga:cohortNthWeek : décalage de semaine basé sur 0 par rapport à la date de définition de la cohorte.

  • Dimension – ga:acquisitionTrafficChannel : canal de trafic via lequel l'utilisateur a été acquis. Il est extrait de la première session de l'utilisateur. Le canal de trafic est calculé en fonction des règles de regroupement de canaux par défaut (au niveau de la vue, si elles sont disponibles) au moment de l'acquisition d'utilisateurs.

  • Dimension – ga:acquisitionSource : source via laquelle l'utilisateur a été acquis. Issu de la première session de l'utilisateur.

  • Dimension – ga:acquisitionMedium : support via lequel l'utilisateur a été acquis. Issu de la première session de l'utilisateur.

  • Dimension – ga:acquisitionSourceMedium : valeur combinée de ga:userAcquisitionSource et de ga:acquisitionMedium.

  • Dimension : ga:acquisitionCampaign : campagne via laquelle l'utilisateur a été acquis. Issu de la première session de l'utilisateur.

  • Métrique ga:cohortActiveUsers : cette métrique est pertinente pour les dimensions de décalage basées sur 0 (ga:cohortNthDay, ga:cohortNthWeek ou ga:cohortNthMonth). Elle indique le nombre d'utilisateurs dans la cohorte actifs au cours de la période correspondant à la cohorte nième jour/semaine/mois. Par exemple, pour ga:cohortNthWeek = 1, le nombre d'utilisateurs (dans la cohorte) actifs au cours de la deuxième semaine. Si une requête ne contient aucun des éléments ga:cohortNthDay, ga:cohortNthWeek ou ga:cohortNthMonth, cette métrique aura la même valeur que ga:cohortTotalUsers.

  • Métrique – ga:cohortTotalUsers : nombre d'utilisateurs appartenant à la cohorte (également appelé "taille de la cohorte").

  • Métrique – ga:cohortAppviewsPerUser : vues d'application par utilisateur pour une cohorte.

  • Métrique – ga:cohortGoalCompletionsPerUser : objectifs réalisés par utilisateur pour une cohorte.

  • Métrique – ga:cohortPageviewsPerUser : pages vues par utilisateur pour une cohorte.

  • Métrique – ga:cohortRetentionRate : taux de rétention de la cohorte.

  • Métrique – ga:cohortRevenuePerUser : revenu par utilisateur pour une cohorte.

  • Métrique – ga:cohortVisitDurationPerUser : durée de session par utilisateur pour une cohorte.

  • Métrique – ga:cohortSessionsPerUser : sessions par utilisateur pour une cohorte.

  • Métrique – ga:cohortTotalUsersWithLifetimeCriteria : pertinente dans le contexte d'une requête comportant les dimensions ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium ou ga:acquisitionCampaign. Il représente le nombre d'utilisateurs au sein des cohortes qui ont été acquis via le canal, la source, le support ou la campagne actuels. Par exemple, pour ga:acquisitionTrafficChannel=Direct, il s'agit du nombre d'utilisateurs qui ont été acquis directement au sein de la cohorte. Si aucune des dimensions mentionnées n'est présente, sa valeur est égale à ga:cohortTotalUsers.

  • Métrique – ga:cohortAppviewsPerUserWithLifetimeCriteria : vues d'application par utilisateur pour la dimension "Acquisition" d'une cohorte.

  • Métrique – ga:cohortGoalCompletionsPerUserWithLifetimeCriteria : objectifs réalisés par utilisateur pour la dimension "Acquisition" au niveau d'une cohorte.

  • Métrique – ga:cohortPageviewsPerUserWithLifetimeCriteria : pages vues par utilisateur pour la dimension "Acquisition" d'une cohorte.

  • Métrique – ga:cohortRevenuePerUserWithLifetimeCriteria : revenus par utilisateur pour la dimension "Acquisition" pour une cohorte.

  • Métrique – ga:cohortSessionsPerUserWithLifetimeCriteria : durée de session par utilisateur pour la dimension "Acquisition" d'une cohorte.

Les dimensions et métriques du Centre des données sur les réseaux sociaux ont été abandonnées et ne généreront des rapports sur les données historiques qu'à partir du 30 avril 2016. Après cette date, aucune nouvelle donnée ne s'affichera. Conformément au Règlement relatif aux abandons de données, ces dimensions et métriques seront supprimées après le 30 septembre 2016.

Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

Activités sur les réseaux sociaux

Ces dimensions et métriques ont été abandonnées et seront supprimées après le 30 septembre 2016. Pour en savoir plus sur la suppression de données, consultez le Règlement relatif aux abandons de données:

  • Dimension – ga:socialActivityEndorsingUrl : pour une activité du centre de données sur les réseaux sociaux, il s'agit de l'URL de l'activité (par exemple, l'URL du post Google+, celle du commentaire du blog, etc.).
  • Dimension – ga:socialActivityDisplayName : pour une activité de centre de données sur les réseaux sociaux, il s'agit du titre de l'activité publiée par les utilisateurs du réseau social.
  • Dimension – ga:socialActivityPost : pour une activité de centre de données sur les réseaux sociaux, il s'agit du contenu de l'activité (par exemple, le contenu d'un message publié dans Google+) publiée par les utilisateurs de réseaux sociaux.
  • Dimension – ga:socialActivityTimestamp : pour une activité de centre de données sur les réseaux sociaux, il s'agit de l'heure à laquelle l'activité a eu lieu sur le réseau social.
  • Dimension ga:socialActivityUserHandle : pour une activité de centre de données sur les réseaux sociaux, il s'agit de l'identifiant du réseau social (nom ou ID, par exemple) des utilisateurs qui sont à l'origine de l'activité sur les réseaux sociaux."
  • Dimension ga:socialActivityUserPhotoUrl : pour une activité de centre de données sur les réseaux sociaux, il s'agit de l'URL de la photo associée aux profils de l'utilisateur sur les réseaux sociaux.
  • Dimension ga:socialActivityUserProfileUrl : pour une activité de centre de données sur les réseaux sociaux, il s'agit de l'URL des profils de réseaux sociaux des utilisateurs associés.
  • Dimension "ga:socialActivityTagsSummary" : pour une activité du centre de données sur les réseaux sociaux, il s'agit d'un ensemble de tags séparés par une virgule qui sont associés à l'activité sur les réseaux sociaux.
  • Dimension ga:socialActivityAction : pour une activité de centre de données sur les réseaux sociaux, cette métrique représente le type d'action sur les réseaux sociaux (vote, commentaire, +1, etc.) associé à l'activité.
  • Dimension – ga:socialActivityNetworkAction : pour une activité de centre de données sur les réseaux sociaux, il s'agit du type d'action sur un réseau social et du réseau social d'où provient l'activité.
  • Dimension ga:socialActivityContentUrl : pour une activité de centre de données sur les réseaux sociaux, il s'agit de l'URL partagée par les utilisateurs des réseaux sociaux associés.
  • Métrique – ga:socialActivities : nombre total d'activités pour lesquelles une URL de contenu a été partagée ou mentionnée sur un réseau partenaire du Centre des données sur les réseaux sociaux.

Cette version ajoute une nouvelle dimension à l'API. Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

Plate-forme ou appareil

  • Dimension – ga:browserSize : taille de la fenêtre d'affichage des navigateurs des utilisateurs. La taille du navigateur est une dimension de portée session qui capture les dimensions initiales de la fenêtre d'affichage en pixels et qui est mise en forme en tant que largeur x hauteur. Par exemple, 1 920 x 960.

Cette version ajoute un nouveau paramètre à l'API.

Inclure les lignes vides

  • Cette version ajoute le nouveau paramètre facultatif include-empty-rows, qui est omis de la réponse lorsqu'il est défini sur false lignes sans données. La valeur par défaut est true, ce qui est une modification non destructive. Elle ne devrait donc pas nécessiter de mise à jour du code. Pour en savoir plus, consultez la documentation de référence de l'API Core Reporting.

Cette version ajoute de nouvelles métriques à l'API. Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

Utilisateur

  • Métrique – ga:1dayUsers : nombre total d'utilisateurs actifs sur 1 jour pour chaque jour de la période demandée. Vous devez spécifier au moins ga:nthDay, ga:date ou ga:day en tant que dimension pour interroger cette métrique. Pour la date indiquée, la valeur renvoyée correspondra au nombre total d'utilisateurs uniques pour la période d'un jour se terminant à la date indiquée.
  • Métrique – ga:7dayUsers : nombre total d'utilisateurs actifs sur 7 jours pour chaque jour de la période demandée. Vous devez spécifier au moins ga:nthDay, ga:date ou ga:day en tant que dimension pour interroger cette métrique. Pour la date indiquée, la valeur renvoyée correspondra au nombre total d'utilisateurs uniques pour la période de sept jours se terminant à la date donnée.
  • Métrique – ga:14dayUsers : nombre total d'utilisateurs actifs sur 14 jours pour chaque jour de la période demandée. Vous devez spécifier au moins ga:nthDay, ga:date ou ga:day en tant que dimension pour interroger cette métrique. Pour la date indiquée, la valeur renvoyée correspondra au nombre total d'utilisateurs uniques pour la période de 14 jours se terminant à la date indiquée.
  • Métrique – ga:30dayUsers : nombre total d'utilisateurs actifs sur 30 jours pour chaque jour de la période demandée. Vous devez spécifier au moins ga:nthDay, ga:date ou ga:day en tant que dimension pour interroger cette métrique. Pour la date indiquée, la valeur renvoyée correspondra au nombre total d'utilisateurs uniques pour la période de 30 jours se terminant à cette date.

Cette version ajoute de nouvelles métriques à l'API. Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

DoubleClick Ad Exchange (AdX)

  • Métrique – ga:adxCTR : pourcentage de pages vues ayant généré un clic sur une annonce AdX.
  • Métrique – ga:adxClicks : nombre de fois où les utilisateurs ont cliqué sur des annonces AdX sur votre site.
  • Métrique – ga:adxCoverage – La couverture correspond au pourcentage de demandes d'annonces ayant renvoyé au moins une annonce. Généralement, elle peut vous aider à identifier les sites pour lesquels votre compte AdX n'est pas en mesure de fournir des annonces ciblées. (Impressions d'annonces / Nombre total de demandes d'annonces) x 100
  • Métrique – ga:adxECPM : coût effectif pour mille pages vues. Il s'agit de vos revenus AdX pour 1 000 pages vues.
  • Statistique ga:adxImpressions : une impression d'annonce AdX est enregistrée chaque fois qu'une annonce individuelle est diffusée sur votre site Web. Par exemple, lorsqu'un internaute consulte une page contenant deux blocs d'annonces, nous comptabilisons deux impressions.
  • Métrique – ga:adxImpressionsPerSession : le ratio entre le nombre d'impressions d'annonces AdX et le nombre de sessions Analytics (Impressions d'annonces / Sessions Analytics).
  • Métrique – ga:adxMonetizedPageviews – Pages vues monétisées mesure le nombre total de pages vues sur votre propriété, s'affichant avec une annonce provenant de votre compte AdX associé. Remarque: Une même page peut comporter plusieurs blocs d'annonces.
  • Métrique – ga:adxRevenue : estimation du total des revenus générés par les annonces AdX.
  • Métrique – ga:adxRevenuePer1000Sessions : total des revenus estimés des annonces AdX pour 1 000 sessions Analytics. Notez que cette statistique est basée sur le nombre de sessions sur votre site et pas sur le nombre d'impressions d'annonces.
  • Métrique – ga:adxViewableImpressionsPercent : pourcentage d'impressions d'annonces qui étaient visibles. Une impression est considérée comme visible si elle s'est affichée dans le navigateur d'un internaute et si elle a eu l'occasion d'être vue.

Dans cette version, les dimensions ou métriques existantes sont abandonnées. Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

Dimensions obsolètes

Ces dimensions ont été abandonnées. Pour en savoir plus sur la suppression de données, consultez le Règlement relatif aux abandons de données:

  • Dimension – ga:adSlotPosition : utilisez ga:adSlot à la place.
  • Dimension – ga:nextPagePath : utilisez ga:pagePath à la place.
  • Dimension – ga:nextContentGroupXX : utilisez ga:contentGroupXX à la place.

Cette version ajoute de nouvelles dimensions à l'API. Consultez la page Documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des dimensions et des métriques.

Plate-forme ou appareil

  • Dimension – ga:dataSource – source de données d'un appel. Les appels envoyés à partir de ga.js et analytics.js sont signalés par la mention "Web", tandis que ceux envoyés par les SDK pour mobile sont enregistrés comme "Application". Ces valeurs peuvent être remplacées.
  • Dimension ga:searchAfterDestinationPage : page que l'utilisateur a consultée après avoir effectué une recherche interne sur votre site.

Cette version ajoute de nouvelles dimensions et métriques à l'API et abandonne deux métriques existantes. Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

ECommerce

  • Métrique – ga:transactionsPerUser : nombre total de transactions divisé par le nombre total d'utilisateurs.
  • Métrique – ga:revenuePerUser : total des revenus des ventes fournis dans la transaction, hors taxes et frais de port, divisé par le nombre total d'utilisateurs.

Utilisateur

  • Métrique – ga:sessionsPerUser : nombre total de sessions divisé par le nombre total d'utilisateurs.

Réseau géographique

  • Dimension ga:cityId : ID de ville des utilisateurs, déterminé par l'adresse IP ou l'ID géographique.
  • Dimension ga:countryIsoCode : code ISO du pays des utilisateurs, déterminé par l'adresse IP ou les ID géographiques. Les valeurs sont fournies sous la forme d'un code alpha-2 ISO-3166-1.
  • Dimension ga:regionId : ID de la région des utilisateurs, déterminé par l'adresse IP ou l'ID géographique. Aux États-Unis, une région correspond à un État (celui de New York, par exemple).
  • Dimension ga:regionIsoCode : code ISO de la région des utilisateurs, déterminé par l'adresse IP ou les ID géographiques. Les valeurs sont exprimées sous la forme d'un code ISO-3166-2.
  • Dimension ga:subContinentCode : code de sous-continent des utilisateurs, déterminé par l'adresse IP ou les ID géographiques. (par exemple, la Polynésie ou l'Europe du Nord). Les valeurs sont exprimées sous la forme d'un code UN M.49.

DoubleClick Campaign Manager

  • Statistique – ga:dcmROAS : retour sur les dépenses publicitaires (ROAS) DCM (Premium uniquement)

Métriques obsolètes

Ces métriques ont été abandonnées. Consultez le Règlement relatif aux abandons de données pour en savoir plus sur la suppression de données: + Métrique - ga:dcmROI - Utilisez ga:dcmROAS à la place. + Métrique – ga:dcmMargen – Utilisez plutôt ga:dcmROAS.

Cette version ajoute une nouvelle métrique à l'API et abandonne deux métriques existantes. Consultez l'article de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

AdWords

  • Métrique – ga:ROAS : le retour sur les dépenses publicitaires (ROAS) correspond au total des revenus des transactions et à la valeur de l'objectif divisé par les frais publicitaires dérivés.

Dimensions et métriques obsolètes

Ces dimensions et métriques ont été abandonnées. Consultez le Règlement relatif aux abandons de données pour en savoir plus sur la suppression de données: + Métrique - ga:ROI - Utilisez ga:ROAS à la place. + Métrique – ga:margin – Utilisez plutôt ga:ROAS.

Cette version ajoute de nouvelles métriques à l'API. Consultez l'article de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

AdSense

  • Métrique – ga:adsenseCoverage : pourcentage de demandes d'annonces ayant renvoyé au moins une annonce.
  • Métrique – ga:adsenseViewableImpressionPercent : pourcentage d'impressions qui étaient visibles.

Cette version inclut l'ajout d'une nouvelle statistique de session, d'une nouvelle dimension "Sources de trafic", ainsi que de nouvelles dimensions et statistiques DoubleClick Campaign Manager.

Dimensions et statistiques

Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

Session

  • Métrique – ga:hits : nombre total d'appels envoyés à Google Analytics. Cette métrique additionne tous les types d'appels (par exemple, les pages vues, les événements, les codes temporels, etc.)

Sources de trafic

  • Dimension ga:campaignCode : lorsque vous utilisez le suivi manuel de campagne, il s'agit de la valeur du paramètre utm_id de suivi de campagne.

DoubleClick Campaign Manager

  • Dimension - ga:dcmClickAd : nom de l'annonce DCM associée au clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension - ga:dcmClickAdId : ID de l'annonce DCM du clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension - ga:dcmClickAdType : nom du type d'annonce DCM associé au clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension - ga:dcmClickAdTypeId : ID du type d'annonce DCM associé au clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension - ga:dcmClickAdvertiser : nom de l'annonceur DCM associé au clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension - ga:dcmClickAdvertiserId : référence annonceur DCM associée au clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension - ga:dcmClickCampaign : nom de la campagne DCM associée au clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension - ga:dcmClickCampaignId : ID de la campagne DCM du clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension - ga:dcmClickCreative : nom de la création DCM associée au clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension – ga:dcmClickCreativeId : ID de la création DCM du clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension - ga:dcmClickCreativeType : nom du type de création DCM associé au clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension – ga:dcmClickCreativeTypeId : ID du type de création DCM associé au clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension – ga:dcmClickCreativeVersion – Version de la création DCM associée au clic DCM correspondant à la session Google Analytics (premium uniquement).
  • Dimension – ga:dcmClickRenderingId : ID de rendu DCM du clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmClickSite - Nom du site sur lequel la création DCM a été diffusée et sur laquelle l'utilisateur a cliqué lors du clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmClickSiteId : ID du site DCM sur lequel la création DCM a été diffusée et a enregistré un clic pour le clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension – ga:dcmClickSitePlacement : nom de l'emplacement de site DCM associé au clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension – ga:dcmClickSitePlacementId : ID de l'emplacement de site DCM associé au clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension – ga:dcmClickSpotId – ID de la configuration Floodlight DCM du clic DCM correspondant à la session Google Analytics (Premium uniquement).
  • Dimension – ga:dcmFloodlightActivity : nom de l'activité Floodlight DCM associée à la conversion Floodlight (Premium uniquement).
  • Dimension – ga:dcmFloodlightActivityAndGroup : nom de l'activité Floodlight DCM et nom du groupe associés à la conversion Floodlight (Premium uniquement).
  • Dimension – ga:dcmFloodlightActivityGroup : nom du groupe d'activité Floodlight DCM associé à la conversion Floodlight (Premium uniquement).
  • Dimension – ga:dcmFloodlightActivityGroupId : ID du groupe d'activités Floodlight DCM associé à la conversion Floodlight (Premium uniquement).
  • Dimension – ga:dcmFloodlightActivityId : ID de l'activité Floodlight DCM associée à la conversion Floodlight (Premium uniquement).
  • Dimension – ga:dcmFloodlightAdvertiserId : référence annonceur Floodlight DCM associée à la conversion Floodlight (Premium uniquement).
  • Dimension – ga:dcmFloodlightSpotId : ID de configuration Floodlight DCM associé à la conversion Floodlight (Premium uniquement).
  • Dimension ga:dcmLastEventAd : nom de l'annonce DCM du dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmLastEventAdId : ID de l'annonce DCM du dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmLastEventAdType : nom du type d'annonce DCM du dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmLastEventAdTypeId : ID du type d'annonce DCM du dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmLastEventAdvertiser : nom de l'annonceur DCM associé au dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmLastEventAdvertiserId : référence annonceur DCM du dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension – ga:dcmLastEventAttributionType : deux valeurs sont possibles (ClickThrough et ViewThrough). Si le dernier événement DCM associé à la session Google Analytics était un clic, la valeur sera "ClickThrough". Si le dernier événement DCM associé à la session Google Analytics était une impression d'annonce, la valeur sera "Viewthrough (Premium uniquement)".
  • Dimension ga:dcmLastEventCampaign : nom de la campagne DCM associée au dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmLastEventCampaignId : ID de la campagne DCM du dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmLastEventCreative : nom de la création DCM correspondant au dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension – ga:dcmLastEventCreativeId : ID de la création DCM du dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension – ga:dcmLastEventCreativeType – Nom du type de création DCM du dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmLastEventCreativeTypeId : ID du type de création DCM du dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension – ga:dcmLastEventCreativeVersion – Version de la création DCM associée au dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmLastEventRenderingId : ID de rendu DCM du dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmLastEventSite : nom du site sur lequel la création DCM a été diffusée et a enregistré un clic pour le dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmLastEventSiteId : ID du site DCM sur lequel la création DCM a été diffusée et a enregistré un clic pour le dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmLastEventSitePlacement : nom de l'emplacement de site DCM associé au dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmLastEventSitePlacementId : ID de l'emplacement de site DCM du dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Dimension ga:dcmLastEventSpotId : ID de configuration Floodlight DCM du dernier événement DCM (impression ou clic au cours de la période d'analyse DCM) associé à la session Google Analytics (Premium uniquement).
  • Métrique – ga:dcmFloodlightQuantity : nombre de conversions Floodlight DCM (Premium uniquement).
  • Métrique – dcmFloodlightRevenue – Revenus Floodlight DCM (Premium uniquement).

Cette version inclut l'ajout de nouvelles dimensions et métriques de regroupement de contenu.

Dimensions et statistiques

Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

Regroupement de contenu

  • Dimension – ga:landingContentGroupXX : premier groupe de contenu correspondant dans la session d'un utilisateur.
  • Dimension ga:nextContentGroupXX : fait référence au groupe de contenu visité après un autre.
  • Dimension – ga:contentGroupXX : groupe de contenu sur une propriété. Un groupe de contenu est un ensemble de contenu offrant une structure logique qui peut être déterminée par le code de suivi, la correspondance entre le titre de la page et l'expression régulière de l'URL, ou des règles prédéfinies.
  • Dimension ga:previousContentGroupXX : fait référence au groupe de contenu visité avant un autre.
  • Métrique – ga:contentGroupUniqueViewsXX : nombre de pages différentes (uniques) au cours d'une session pour le groupe de contenu spécifié. pagePath et pageTitle sont pris en compte pour déterminer l'unicité.

Cette version inclut une nouvelle condition dateOfSession pour les segments, et l'ajout de nouvelles dimensions et métriques d'e-commerce amélioré.

Segments

Les segments acceptent désormais une nouvelle condition dateOfSession, qui permet de limiter un segment à un groupe d'utilisateurs ayant démarré une session au cours d'une certaine période. Pour en savoir plus, consultez le Guide du développeur de segments.

Dimensions et statistiques

Consultez l'article de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions de l'e-commerce amélioré.

E-commerce amélioré

  • Dimension – ga:internalPromotionCreative : contenu de la création conçu pour une promotion.
  • Dimension ga:internalPromotionId : identifiant que vous utilisez pour la promotion.
  • Dimension ga:internalPromotionName : nom de la promotion.
  • Dimension ga:internalPromotionPosition : position de la promotion sur la page Web ou l'écran de l'application.
  • Dimension – ga:orderCouponCode : code du bon de réduction appliqué au niveau de la commande.
  • Dimension ga:productBrand : nom de la marque sous laquelle le produit est vendu.
  • Dimension – ga:productCategoryHierarchy : catégorie hiérarchique dans laquelle le produit est classé (e-commerce amélioré).
  • Dimension – ga:productCategoryLevelXX : niveau (1-5) de la hiérarchie des catégories de produits, en partant du haut.
  • Dimension – ga:productCouponCode : code du bon de réduction au niveau du produit.
  • Dimension ga:productListName : nom de la liste de produits dans laquelle le produit apparaît.
  • Dimension – ga:productListPosition : position du produit dans la liste de produits.
  • Dimension – ga:productVariant : variante spécifique d'un produit, par exemple XS, S, M, L pour la taille ou rouge, bleu, vert, noir pour la couleur.
  • Dimension ga:checkoutOptions : options utilisateur spécifiées lors du processus de règlement, par exemple FedEx, DHL, UPS pour les options de livraison ou Visa, MasterCard ou American Express pour les modes de paiement. Cette variable doit être utilisée avec l'étape d'achat.
  • Dimension – ga:shoppingStage : différentes étapes de l'expérience d'achat des utilisateurs au cours d'une session, par exemple PRODUCT_VIEW, ADD_TO_CART, CHECKOUT, etc.
  • Métrique – ga:internalPromotionCTR : taux de clics des utilisateurs pour afficher la promotion interne (nombre de clics / nombre de fois où la promotion a été diffusée).
  • Métrique – ga:internalPromotionClicks : nombre de clics sur une promotion interne.
  • Métrique – ga:internalPromotionViews : nombre de vues d'une promotion interne.
  • Métrique – ga:localProductRefundAmount : montant du remboursement d'un produit donné dans la devise locale.
  • Métrique – ga:localRefundAmount : montant total du remboursement de la transaction dans la devise locale.
  • Métrique – ga:productAddsToCart : nombre de fois où le produit a été ajouté au panier.
  • Métrique – ga:productCheckouts : nombre de fois où le produit a été inclus lors du processus de paiement.
  • Métrique – ga:productDetailViews – Nombre de fois où les utilisateurs ont consulté la page d'informations détaillées sur le produit.
  • Métrique – ga:productListClicks – Nombre de fois où les utilisateurs ont cliqué sur le produit lorsqu'il est apparu dans la liste de produits.
  • Métrique – ga:productListViews : nombre de fois où le produit est apparu dans une liste de produits.
  • Métrique – ga:productListCTR : taux de clics des utilisateurs sur le produit figurant dans une liste de produits.
  • Métrique – ga:productRefunds : nombre de fois où un remboursement a été émis pour le produit.
  • Métrique – ga:productRefundAmount : montant total du remboursement associé au produit.
  • Métrique – ga:productRemovesFromCart : nombre de fois où le produit a été supprimé du panier.
  • Métrique – ga:productRevenuePerPurchase : revenu moyen généré par le produit par achat (généralement utilisé avec le code promotionnel du produit).
  • Métrique – ga:buyToDetailRate : nombre d'achats uniques divisé par le nombre de vues des pages d'informations détaillées sur les produits.
  • Métrique – ga:cartToDetailRate : nombre de produits ajoutés divisé par le nombre de vues des informations détaillées sur le produit.
  • Métrique – ga:quantityAddedToCart : nombre d'unités de produit ajoutées au panier.
  • Métrique – ga:quantityCheckedOut : nombre d'unités de produits incluses lors du règlement.
  • Métrique – ga:quantityRefunded : nombre d'unités de produits remboursées.
  • Métrique – ga:quantityRemovedFromCart : nombre d'unités de produit supprimées du panier.
  • Métrique – ga:refundAmount : montant remboursé dans la devise d'une transaction.
  • Métrique – ga:totalRefunds : nombre de remboursements émis.

Cette version inclut une correction de bug pour les noms des en-têtes de colonne, et l'ajout de nouvelles dimensions et métriques.

Dimensions et statistiques

Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

Système

  • Dimension – ga:sourcePropertyDisplayName : nom à afficher de la propriété source pour les propriétés de consolidation. Ceci n'est valide que pour les propriétés de consolidation.
  • Dimension – ga:sourcePropertyTrackingId : ID de suivi de la propriété source des propriétés de consolidation. Ceci n'est valide que pour les propriétés de consolidation.

Regroupement de canaux

  • Dimension ga:channelGrouping : regroupement de canaux par défaut partagé dans la vue (profil).
  • Dimension – ga:correlationModelId : ID du modèle de corrélation des produits associés.
  • Dimension ga:queryProductId : ID du produit concerné par la requête.
  • Dimension – ga:queryProductName : nom du produit concerné par la requête.
  • Dimension – ga:queryProductVariation : variante du produit concerné par la requête.
  • Dimension – ga:relatedProductId : identifiant du produit associé.
  • Dimension – ga:relatedProductName : nom du produit associé.
  • Dimension – ga:relatedProductVariation : variante du produit associé.
  • Métrique – ga:correlationScore : score de corrélation pour les produits associés.
  • Métrique – ga:queryProductQuantity : quantité du produit concerné par la requête.
  • Métrique – ga:relatedProductQuantity : quantité du produit associé.

Correction du nom de la colonne d'en-tête

  • La version du 16 avril 2014 présentait un bug. Si vous interrogeiez une dimension ou une métrique obsolète, l'API renvoyait des en-têtes de colonne avec la dimension ou la métrique de remplacement. Désormais, il renvoie correctement le même nom de dimension ou de métrique que celui utilisé dans la requête.

Cette version inclut l'ajout et le changement de nom des dimensions et des métriques. Consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

Nouvelles dimensions et métriques

Les dimensions suivantes ont été ajoutées à l'API Core Reporting:

AdWords

  • Dimension : ga:isTrueViewVideoAd - Yes ou No : indique si l'annonce est une annonce vidéo TrueView AdWords.

Heure

  • Dimension – ga:nthHour : indice de chaque heure de la plage de dates spécifiée. L'indice de la première heure du premier jour (date de début) dans la plage de dates est 0, 1 pour l'heure suivante, etc.

Changement de nom des dimensions et des métriques

Toutes les dimensions et métriques basées sur visiteur et visite ont été renommées pour utiliser à la place utilisateur et session, respectivement.

Les dimensions et métriques suivantes ont été renommées. Consultez le Règlement relatif aux abandons de données pour en savoir plus sur le changement de nom des données:

Audience

  • Dimension – ga:visitorAgeBracket : utilisez ga:userAgeBracket à la place.
  • Dimension – ga:visitorGender : utilisez ga:userGender à la place.

E-commerce

  • Métrique – ga:transactionRevenuePerVisit – Utilisez ga:transactionRevenuePerSession à la place.
  • Métrique – ga:transactionsPerVisit – Utilisez ga:transactionsPerSession à la place.

Suivi des événements

  • Métrique – ga:eventsPerVisitWithEvent – Utilisez ga:eventsPerSessionWithEvent à la place.
  • Métrique – ga:visitsWithEvent – Utilisez ga:sessionsWithEvent à la place.

Conversions par objectif

  • Métrique – ga:goalValuePerVisit – Utilisez ga:goalValuePerSession à la place.
  • Métrique – ga:percentVisitsWithSearch – Utilisez ga:percentSessionsWithSearch à la place.
  • Métrique – ga:searchVisits – Utilisez ga:searchSessions à la place.

Suivi des pages

  • Métrique – ga:pageviewsPerVisit – Utilisez ga:pageviewsPerSession à la place.

Session

  • Dimension – ga:visitLength : utilisez ga:sessionDurationBucket à la place.
  • Métrique – ga:avgTimeOnSite – Utilisez ga:avgSessionDuration à la place.
  • Métrique – ga:timeOnSite – Utilisez ga:sessionDuration à la place.
  • Métrique – ga:visitBounceRate – Utilisez ga:bounceRate à la place.
  • Métrique – ga:visits – Utilisez ga:sessions à la place.

Interactions associées aux réseaux sociaux

  • Dimension – ga:socialInteractionNetworkActionVisit : utilisez ga:socialInteractionNetworkActionSession à la place.
  • Métrique – ga:socialInteractionsPerVisit – Utilisez ga:socialInteractionsPerSession à la place.

Utilisateur

  • Dimension – ga:daysSinceLastVisit : utilisez ga:daysSinceLastSession à la place.
  • Dimension – ga:visitCount : utilisez ga:sessionCount à la place.
  • Dimension – ga:visitorType : utilisez ga:userType à la place.
  • Dimension – ga:visitsToTransaction : utilisez ga:sessionsToTransaction à la place.
  • Métrique – ga:newVisits – Utilisez ga:newUsers à la place.
  • Métrique – ga:percentNewVisits – Utilisez ga:percentNewSessions à la place.
  • Métrique – ga:visitors – Utilisez ga:users à la place.

Segments: API Core Reporting v2.4 et v3.0

Nouveaux segments compatibles avec l'API Core Reporting.

  • Le paramètre segment est désormais compatible avec les segments d'utilisateur et de séquence. Le paramètre segment permet d'interroger les segments de niveau utilisateur et niveau de session créés dans l'interface Web.
  • Une nouvelle syntaxe est disponible pour les segments dynamiques avec le paramètre segment. Pour en savoir plus, consultez le Guide de développement des segments.
  • Le préfixe dynamic:: a été abandonné. Nous vous recommandons de migrate vers la nouvelle syntaxe dès que possible.

Cette version inclut un nouveau format de réponse Tableau de données, ainsi que l'ajout et l'abandon de dimensions et de métriques (consultez la documentation de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions).

Sortie de la table de données

Pour faciliter le rendu de vos données Google Analytics à l'aide des visualisations Google Charts, l'API peut éventuellement renvoyer un objet Data Table dans la réponse.

  • Un paramètre de requête output facultatif a été ajouté à l'API. Elle permet de sélectionner le format de sortie des données Analytics dans la réponse (JSON par défaut). Si la valeur est datatable, une propriété dataTable contenant un objet Table de données est incluse dans la réponse. Cet objet peut être utilisé directement avec Google Charts. Pour en savoir plus, consultez la documentation de référence de l'API Core Reporting.

Nouvelles dimensions et métriques

Les dimensions et métriques suivantes ont été ajoutées à l'API Core Reporting:

Heure

  • Dimension - ga:minute - Renvoie la minute dans l'heure. Les valeurs possibles sont comprises entre 00 et 59.
  • Dimension – ga:nthMinute : indice de chaque minute de la plage de dates spécifiée. L'index de la première minute du premier jour (date de début) dans la plage de dates est 0, 1 pour la minute suivante, etc.

Audience

  • Dimension – ga:visitorAgeBracket : tranche d'âge du visiteur.
  • Dimension – ga:visitorGender : genre du visiteur.
  • Dimension ga:interestAffinityCategory : indique que les utilisateurs sont plus susceptibles de vouloir en savoir plus sur la catégorie spécifiée.
  • Dimension ga:interestInMarketCategory : indique que les utilisateurs sont plus susceptibles d'acheter des produits ou services de la catégorie spécifiée.
  • Dimension "ga:interestOtherCategory" : indique que les utilisateurs sont plus susceptibles de vouloir en savoir plus sur la catégorie spécifiée et d'être plus enclins à acheter.

Dimensions et métriques autorisées dans les segments

Ces dimensions et métriques peuvent désormais être utilisées dans les segments:

  • Dimension - ga:sourceMedium : valeurs combinées de ga:source et ga:medium.
  • Métrique – ga:localItemRevenue : revenu généré par le produit en devise locale.

Dimensions et métriques obsolètes

Ces dimensions et métriques ont été abandonnées. Pour en savoir plus sur la suppression de données, consultez le Règlement relatif aux abandons de données:

  • Dimension – ga:isMobile : utilisez plutôt ga:deviceCategory (par exemple, ga:deviceCategory==mobile).
  • Dimension – ga:isTablet : utilisez plutôt ga:deviceCategory (par exemple, ga:deviceCategory==tablet).
  • Métrique – ga:entranceBounceRate – Utilisez ga:visitBounceRate à la place.

Cette version ajoute de nouvelles dimensions et métriques à l'API. Consultez l'article de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

AdSense

  • L'accès aux données AdSense a été ajouté:

    • Réalisé – ga:adsenseRevenue : revenu total généré par les annonces AdSense.
    • Met en œuvre – ga:adsenseAdUnitsViewed : nombre de blocs d'annonces AdSense affichés. Un bloc d'annonces est un ensemble d'annonces affichées en réponse à une portion de code d'annonce AdSense. En savoir plus: https://support.google.com/adsense/answer/32715
    • Met en œuvre – ga:adsenseAdsViewed : nombre d'annonces AdSense vues. Un bloc d'annonces peut contenir plusieurs annonces.
    • Met en ligne - ga:adsenseAdsClicks : nombre de fois où les utilisateurs ont cliqué sur les annonces AdSense de votre site.
    • Réuni – ga:adsensePageImpressions : nombre de pages vues pendant lesquelles une annonce AdSense a été diffusée. Une impression de page peut comporter plusieurs blocs d'annonces.
    • Réunies – ga:adsenseCTR : pourcentage d'impressions de page ayant généré un clic sur une annonce AdSense. (ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • Met en œuvre - ga:adsenseECPM : coût estimé pour mille impressions de page. autrement dit de vos revenus AdSense pour 1 000 impressions de page. (ga:adsenseRevenue/(ga:adsensePageImpressions/1000).
    • Réunies – ga:adsenseExits : nombre de sessions qui se sont terminées après qu'un utilisateur a cliqué sur une annonce AdSense.

Heure

  • Dim : ga:isoYear : année ISO de la visite. Informations détaillées: http://en.wikipedia.org/wiki/ISO_week_date ga:isoYear doit uniquement être utilisé avec ga:isoWeek, car ga:week représente un calendrier grégorien.
  • Dim - ga:isoYearIsoWeek : valeurs combinées de ga:isoYear et ga:isoWeek.

AdWords

Nouvelles fonctionnalités de contrôle de la taille d'échantillon et de dates relatives

Dates relatives
  • La compatibilité avec les dates relatives a été ajoutée à l'API Core Reporting. today, yesterday et NdaysAgo sont désormais des valeurs valides pour les paramètres de requête start-date et end-date.
  • L'utilisation de ces valeurs détermine automatiquement la plage de dates en fonction de la date du jour au moment de la requête et du fuseau horaire de la vue (profil) spécifiée dans la requête. Pour en savoir plus, consultez la documentation de référence de l'API.
Niveau d'échantillonnage
  • Nous avons ajouté un nouveau paramètre, samplingLevel, qui vous permet de définir le niveau d'échantillonnage (c'est-à-dire le nombre de visites utilisé pour calculer le résultat) pour une requête de rapport. Les valeurs autorisées sont DEFAULT, FASTER et HIGHER_PRECISION.
  • Deux champs ont été ajoutés à la réponse de l'API: sampleSize et sampleSpace. Vous pouvez utiliser ces valeurs pour calculer le pourcentage de visites utilisées pour un échantillon de réponse.
  • Pour en savoir plus, consultez la documentation de référence de l'API et l'échantillonnage.

Correction de bugs

  • Le ga:adwordsCustomerID renvoie désormais correctement le numéro client AdWords à 10 chiffres correspondant à l'API AdWords AccountInfo.customerId. Ce correctif permet d'associer des données Analytics à plusieurs comptes AdWords.

Dans le cadre du lancement des nouveaux segments, nous allons apporter les modifications suivantes à l'API Core Reporting.

  • Le paramètre segment est désormais compatible avec le nouvel ID alphanumérique pour les segments avancés personnalisés, qui est renvoyé dans la collection de segments de l'API de gestion.
  • Les ID numériques actuels des segments personnalisés sont en cours d'abandon. Ces anciens ID continueront de fonctionner pendant six mois. Nous vous recommandons d'utiliser les applications qui enregistrent les ID de segment d'utilisateurs pour passer aux nouveaux ID alphanumériques. Une fois la période d'abandon terminée, toutes les requêtes avec les anciens ID numériques renverront une erreur.
  • Actuellement, seuls les segments au niveau de la visite créés dans l'interface Web peuvent être interrogés via le paramètre segment.
  • Les segments par défaut existants associés à des ID numériques négatifs ne seront pas affectés. Toutefois, les nouveaux segments par défaut ne sont actuellement pas compatibles.

Cette version ajoute de nouvelles dimensions et métriques à l'API. Consultez l'article de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions.

Suivi des applications

  • Ces données figurent dans les rapports sur les profils d'application :
    • Dim : ga:appId : identifiant de l'application.
    • Dim - ga:appInstallerId : ID du programme d'installation (par exemple, Google Play Store) à partir duquel l'application a été téléchargée. Par défaut, l'ID du programme d'installation d'applications est défini en fonction de la méthode PackageManager#getInstallerPackageName.
    • Dim : ga:appName : nom de l'application.
    • Dim : ga:appVersion : version de l'application.
    • Faible - ga:exitScreenName : nom de l'écran lorsque l'utilisateur a quitté l'application.
    • Faible - ga:landingScreenName : nom du premier écran affiché.
    • Faible éclairage : ga:screenDepth : nombre de visionnages de l'écran par session indiqués sous forme de chaîne. Peut s'avérer utile pour les histogrammes.
    • Faible - ga:screenName : nom de l'écran.
    • Réuni - ga:avgScreenviewDuration : temps moyen passé par les utilisateurs sur un écran, en secondes.
    • Réuni - ga:timeOnScreen : temps passé à afficher l'écran actuel.
    • Met en œuvre - ga:screenviews : nombre total de visionnages de l'écran. Utilisez cette méthode à la place de ga:appviews.
    • Met en œuvre - ga:uniqueScreenviews : nombre de ga:screenviews différents (uniques) au cours d'une session. Utilisez cette méthode à la place de ga:uniqueAppviews.
    • Réunies - ga:screenviewsPerSession : nombre moyen de ga:screenviews par session. Utilisez cette méthode à la place de ga:appviewsPerVisit.

Obsolète

Les métriques suivantes ont été abandonnées. Utilisez plutôt le nouveau nom de la métrique.

  • Met - ga:appviews - Utilisez ga:screenviews à la place.
  • Met - ga:uniqueAppviews - Utilisez ga:uniqueScreenviews à la place.
  • Met - ga:appviewsPerVisit - Utilisez ga:screenviewsPerSession à la place.

Colonnes ou variables personnalisées

  • Accès aux dimensions et aux métriques personnalisées:

    • Faible - ga:dimensionXX : nom de la dimension personnalisée demandée, où XX fait référence au numéro/index de la dimension personnalisée.
    • Met - ga:metricXX - Nom de la métrique personnalisée demandée, où XX fait référence au numéro/index de la métrique personnalisée.

Changements dans la documentation

La dimension et la métrique "Variable personnalisée" suivantes ont été renommées. Il s'agit uniquement d'une modification de la documentation. Vous n'aurez pas besoin de mettre à jour vos requêtes.

  • ga:customVarName(n)ga:customVarNameXX
  • ga:customVarValue(n)ga:customVarValueXX

E-commerce

  • Dim : ga:currencyCode : code de la devise locale de la transaction, conforme à la norme ISO 4217.
  • Réalisé - ga:localItemRevenue : revenus générés par le produit en devise locale.
  • Réunies – ga:localTransactionRevenue : revenus des transactions en devise locale.
  • Résilié - ga:localTransactionShipping - Frais de port associés à la transaction dans la devise locale.
  • Réunies – ga:localTransactionTax : taxe sur les transactions dans la devise locale.

Exceptions

  • Ces données proviennent du suivi des exceptions.
    • Faible - ga:exceptionDescription : description de l'exception.
    • Met en œuvre - ga:exceptionsPerScreenview : nombre d'exceptions générées divisé par le nombre de visionnages de l'écran.
    • Met en œuvre - ga:fatalExceptionsPerScreenview : nombre d'exceptions fatales générées divisé par le nombre de visionnages de l'écran.

Conversions par objectif

  • Faible éclairage : ga:goalCompletionLocation : chemin de la page ou nom de l'écran correspondant à n'importe quel objectif du type de destination atteint.
  • Faible éclairage : ga:goalPreviousStep1 : chemin de la page ou nom de l'écran correspondant à n'importe quel objectif de type de destination, une étape avant l'emplacement de l'objectif réalisé.
  • Faible affichage ga:goalPreviousStep2 : chemin de la page ou nom de l'écran correspondant à n'importe quel objectif de type de destination, deux étapes avant l'emplacement de l'objectif atteint.
  • Faible - ga:goalPreviousStep3 : chemin de la page ou nom de l'écran correspondant à n'importe quel objectif de type de destination, trois étapes avant l'emplacement de l'objectif atteint.

Changements dans la documentation

La dimension et les métriques "Conversions par objectif" suivantes ont été renommées. Il s'agit uniquement d'une modification de la documentation. Vous n'aurez pas besoin de mettre à jour vos requêtes.

  • ga:goal(n)AbandonRatega:goalXXAbandonRate
  • ga:goal(n)Abandonsga:goalXXAbandons
  • ga:goal(n)Completionsga:goalXXCompletions
  • ga:goal(n)ConversionRatega:goalXXConversionRate
  • ga:goal(n)Startsga:goalXXStarts
  • ga:goal(n)Valuega:goalXXValue
  • ga:searchGoal(n)ConversionRatega:searchGoalXXConversionRate
  • Mettons (ga:percentSearchRefinements) : pourcentage de fois qu'un affinement (c'est-à-dire une transition) est effectué entre des mots clés de recherche internes au cours d'une session.

Suivi des pages

  • Résolu - ga:pageValue : valeur moyenne de cette page ou d'un ensemble de pages. La valeur de la page correspond à ((Chiffre d'affaires des transactions + Valeur totale de l'objectif) divisé par le nombre de pages vues uniques pour la page ou le groupe de pages).

Plate-forme ou appareil

  • Ces données sont issues de la chaîne user-agent HTTP.

    • Faible - ga:deviceCategory: type d'appareil (ordinateur, tablette ou mobile).
    • Faible (ga:isTablet) : indique les visiteurs de la tablette. Les valeurs possibles sont Yes ou No.
    • Dim - ga:mobileDeviceMarketingName : nom marketing utilisé pour l'appareil mobile.

Interactions associées aux réseaux sociaux

  • Ces données proviennent du suivi des interactions sur les réseaux sociaux sur site.

    • Dim - ga:socialEngagementType : type d'engagement. Les valeurs possibles sont Socially Engaged ou Not Socially Engaged.

Heure

  • Dim - ga:dateHour : valeurs combinées de ga:date et ga:hour.
  • Dim : ga:dayOfWeekName : nom du jour de la semaine (en anglais).
  • Dim : ga:isoWeek : numéro ISO de la semaine, où chaque semaine commence par un lundi. Informations détaillées: http://en.wikipedia.org/wiki/ISO_week_date
  • Dim - ga:yearMonth : valeurs combinées de ga:year et ga:month.
  • Dim - ga:yearWeek : valeurs combinées de ga:year et ga:week.

Sources de trafic

  • Dim : ga:fullReferrer : URL de provenance complète, y compris le nom d'hôte et le chemin d'accès.
  • Dim : ga:sourceMedium : valeurs combinées de ga:source et ga:medium.
  • Cette version ajoute deux nouvelles métriques de test: - ga:experimentId - ga:experimentVariant
  • Cette version ajoute cinq nouvelles métriques de vitesse du site :
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • Cette version ajoute un nouveau segment par défaut pour le trafic sur tablette : gaid::-13.

Cette version ajoute de nouvelles dimensions et métriques à l'API. Consultez la documentation de référence sur les dimensions et les métriques pour obtenir des définitions.

Suivi des applications

  • Ces données figurent dans les rapports du SDK de suivi des applications mobiles :
    • Met en œuvre - ga:uniqueAppviews : nombre de vues d'application par session.
    • Met en œuvre - 'ga:appviews : nombre total de vues de l'application.
    • Réunies - ga:appviewsPerVisit : nombre moyen de vues d'application par session.

Sources de trafic

  • Dim - ga:socialNetwork : chaîne représentant le nom du réseau social. Cela peut être lié au réseau social référent pour les sources de trafic ou au réseau social pour les activités de la plate-forme de données sur les réseaux sociaux. Exemples : Google+, Blogger, Reddit, etc.
  • Faible (ga:hasSocialSourceReferral) : indique les visites qui ont accédé au site à partir d'une source de réseau social (par exemple, un réseau social tel que Google+, Facebook, Twitter, etc.). Les valeurs possibles sont "Yes" ou "No", où la première lettre doit être en majuscule.

Activités sur les réseaux sociaux

  • Ces données proviennent des activités hors site importées par des partenaires du Centre des données sur les réseaux sociaux.
    • Faible - ga:socialActivityDisplayName : pour une activité de centre de données sur les réseaux sociaux, cette chaîne représente le titre de l'activité publiée par l'utilisateur du réseau social.
    • Faible - ga:socialActivityEndorsingUrl : pour une activité du centre de données sur les réseaux sociaux, cette chaîne représente l'URL de l'activité (par exemple, l'URL du post Google+, celle du commentaire du blog, etc.).
    • Faible - ga:socialActivityPost : pour une activité de centre de données sur les réseaux sociaux, cette chaîne représente le contenu de l'activité publiée par l'utilisateur du réseau social (par exemple, le contenu du message d'un post Google+).
    • Faible - ga:socialActivityTimestamp : pour une activité de centre de données sur les réseaux sociaux, cette chaîne représente le moment où l'activité a eu lieu sur le réseau social.
    • Faible - ga:socialActivityUserPhotoUrl : pour une activité du centre de données sur les réseaux sociaux, cette chaîne représente l'URL de la photo associée au profil de l'utilisateur sur le réseau social.
    • Faible (ga:socialActivityUserProfileUrl) : pour une activité de centre de données sur les réseaux sociaux, cette chaîne représente l'URL du profil de l'utilisateur associé sur le réseau social.
    • Faible - ga:socialActivityContentUrl : pour une activité de centre de données sur les réseaux sociaux, cette chaîne représente l'URL partagée par l'utilisateur du réseau social associé.
    • Faible - ga:socialActivityTagsSummary : pour une activité du centre de données sur les réseaux sociaux, il s'agit d'un ensemble de tags séparés par une virgule qui sont associés à l'activité sur les réseaux sociaux.
    • Faible - ga:socialActivityUserHandle : pour une activité de centre de données sur les réseaux sociaux, cette chaîne représente l'identifiant (c'est-à-dire le nom) de l'utilisateur qui est à l'origine de l'activité sur le réseau social.
    • Faible - ga:socialActivityAction : pour une activité de centre de données sur les réseaux sociaux, cette chaîne représente le type d'action sur un réseau associé à l'activité (vote, commentaire, +1, etc.).
    • Faible - ga:socialActivityNetworkAction : pour une activité de centre de données sur les réseaux sociaux, cette chaîne représente le type d'action sur un réseau social et le réseau social d'où provient l'activité.
    • Réunies – ga:socialActivities : nombre d'activités pour lesquelles une URL de contenu a été partagée/mentionnée sur un réseau partenaire de plates-formes de données sur les réseaux sociaux

Interactions associées aux réseaux sociaux

  • Ces données proviennent du suivi des interactions sur les réseaux sociaux sur site.
    • Faible (ga:socialInteractionAction) : pour les interactions sur les réseaux sociaux, il s'agit d'une chaîne représentant l'action sur un réseau social suivie (par exemple, +1, "J'aime" ou ajouté aux favoris).
    • Faible - ga:socialInteractionNetwork : pour les interactions sur les réseaux sociaux, il s'agit d'une chaîne représentant le réseau social suivi (par exemple, Google, Facebook, Twitter, LinkedIn).
    • Dim - ga:socialInteractionNetworkAction - pour les interactions sur les réseaux sociaux, une chaîne représentant la concaténation des ga:socialInteractionNetwork et ga:socialInteractionAction suivis (par exemple, Google: +1, Facebook: J'aime)
    • Dim : ga:socialInteractionTarget : pour les interactions sur les réseaux sociaux, il s'agit d'une chaîne représentant l'URL (ou la ressource) qui reçoit l'action sur le réseau social.
    • Réunies – ga:socialInteractions : nombre total d'interactions avec les réseaux sociaux sur votre site
    • Réunies – ga:uniqueSocialInteractions : nombre total d'interactions uniques sur les réseaux sociaux sur votre site Basée sur la paire de valeurs ga:socialInteractionNetwork et ga:socialInteractionAction
    • Atteint - ga:socialInteractionsPerVisit - ga:socialInteractions / ga:uniqueSocialInteractions. Nombre moyen d'interactions sur les réseaux sociaux par visite sur votre site

Zone géographique / Réseau

  • Faible : ga:metro : zone de marché désignée d'où provient le trafic.

Suivi des pages

  • Dim - ga:pagePathLevel1 : cette dimension regroupe tous les "pagePaths" du premier niveau hiérarchique dans "pagePath".
  • Dim - ga:pagePathLevel2 : cette dimension regroupe tous les "pagePaths" du deuxième niveau hiérarchique dans "pagePath".
  • Dim - ga:pagePathLevel3 : cette dimension regroupe tous les "pagePaths" du troisième niveau hiérarchique dans "pagePath".
  • Dim - ga:pagePathLevel4 : cette dimension regroupe tous les "pagePaths" du quatrième niveau hiérarchique dans "pagePath". Tous les niveaux supplémentaires de la hiérarchie "pagePath" sont également regroupés dans cette dimension.

Suivi des exceptions

  • Ces données proviennent des données de suivi des exceptions.

    • Réunies - ga:exceptions : nombre d'exceptions envoyées à Google Analytics.
    • Met - ga:fatalExceptions : nombre d'exceptions pour lesquelles isFatal est défini sur "true".

Temps utilisateur

  • Ces données proviennent des données de temps utilisateur.

    • Dim : ga:userTimingCategory : chaîne permettant de classer toutes les variables de temps utilisateur en groupes logiques pour faciliter la création de rapports.
    • Dim : ga:userTimingLabel : chaîne indiquant le nom de l'action de la ressource suivie.
    • Faible - ga:userTimingVariable : chaîne permettant de visualiser plus facilement le temps utilisateur dans les rapports.
    • Faible intensité : ga:userTimingValue. Il s'agit du nombre de millisecondes de temps écoulé envoyé à Google Analytics.
    • Met - ga:userTimingSample - Le nombre d'échantillons qui ont été envoyés.
    • Met en œuvre - ga:avgUserTimingValue : valeur moyenne du temps utilisateur. ga:userTimiingValue / ga:userTimiingSample.

Appareil / Plate-forme

  • Ces données proviennent du user-agent des données collectées.
    • Faible – ga:mobileDeviceBranding: nom du fabricant du mobile ou de la marque (par exemple, Samsung, HTC, Verizon ou T-Mobile).
    • Faible - ga:mobileDeviceModel - Modèle de l'appareil mobile (par exemple, Nexus S)
    • Faible intensité : ga:mobileInputSelector : sélecteur utilisé sur l'appareil mobile (par exemple, écran tactile, joystick, molette cliquable ou stylet).
    • Dim - ga:mobileDeviceInfo : branding, modèle et nom marketing permettant d'identifier l'appareil mobile.

Correction de bugs

  • L'API gère désormais correctement les caractères UTF-8 dans un filtre ou un segment dynamique.

Cette version permet aux comptes Google Analytics Premium d'accéder à 50 variables personnalisées au maximum.

Cette version corrige 2 bugs:

Correction de bugs

  • Les filtres de requête qui contiennent des caractères spéciaux dans des expressions régulières ne renvoient plus d'erreurs de serveur.

  • La combinaison d'un filtre de métrique avec un segment avancé ne renvoie plus d'erreur.

Cette version ajoute de nouvelles métriques de vitesse du site à l'API.

Nouvelles métriques

  • Les métriques suivantes concernant la vitesse du site ont été ajoutées :
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

Consultez la documentation de référence sur les dimensions et les métriques pour obtenir des définitions.

Rappel d'abandon de la version 2.3 de l'API

  • La version 2.3 de l'API d'exportation de données est obsolète depuis deux mois. Dans environ quatre mois supplémentaires, nous mettrons fin à ce service et n'accepterons que les nouvelles versions 3.0 et 2.4 de l'API Core Reporting.

  • Nous vous recommandons vivement de migrer vos applications vers la version 3.0.

  • Dans quatre mois, les demandes envoyées au flux de données XML version 2.3 seront transmises à la version 2.4 et renverront une réponse XML version 2.4. À ce stade, toutes les règles de quota de la version 2.4 s'appliqueront aux requêtes de la version 2.3.

  • Toutes les requêtes pour JSON version 2.3 ou pour la bibliothèque cliente Google Data JavaScript qui utilise une sortie JSON version 2.3 renverront des codes d'état 404.

  • Pour obtenir l'intégralité du quota, les versions 3.0 et 2.4 nécessitent d'enregistrer votre application dans la console Google APIs, et d'utiliser une clé API (ou un jeton OAuth 2.0) dans chaque requête.

Nous avons corrigé un petit bug affectant ga:visitLength. Cette dimension renvoie désormais des données correctes.

Cette version concerne tous les développeurs d'API Google Analytics. Elle annonce deux nouvelles versions de l'API, nécessite l'enregistrement des applications, introduit de nouvelles règles en matière de quotas et remplace le nom de l'API par "Core Reporting API". Enfin, elle abandonne la version 2.3 de l'API d'exportation de données existante.

Version 3.0

  • La version 3.0 de l'API Core Reporting est la version majeure la plus récente de notre API. Elle n'est pas rétrocompatible. Tout le développement futur de l'API s'effectuera sur cette version.

  • Nouvelles fonctionnalités

    • La nouvelle sortie basée sur JSON réduit la taille de la réponse à environ 10 fois par rapport à la sortie XML précédente.
    • Nouvelles bibliothèques clientes des API Google compatibles avec Java, JavaScript, Python, PHP, Ruby et .Net.
    • Compatibilité avec l' API Google Discovery.
    • Compatibilité avec OAuth 2.0 en tant que nouvelle méthode recommandée pour autoriser les utilisateurs.
  • Mises à jour

    • Nouvelle URL pour effectuer les requêtes: https://www.googleapis.com/analytics/v3/data/ga….
    • Inscription et jetons de développeur requis.
    • Toutes les requêtes de données de configuration doivent être effectuées via l' API Management.

Version 2.4

  • La version 2.4 de l'API Core Reporting est une mise à niveau mineure principalement rétrocompatible avec la version 2.3 de l'API d'exportation de données existante.

  • Mises à jour

    • Nouvelle URL pour l'envoi des requêtes: https://www.googleapis.com/analytics/v2.4/data…
    • Inscription et jetons de développeur requis.
    • La sortie XML est cohérente avec la version 2.3. Les autres bibliothèques clientes Google Data existantes continueront donc de fonctionner.
    • Le code d'erreur pour les erreurs de quota est passé de 503 à 403
    • Les réponses JSON ne sont pas compatibles.
    • La bibliothèque cliente Google Data JavaScript n'est pas compatible.
    • Aucun flux de compte. Toutes les requêtes de données de configuration doivent être effectuées via l' API Management.

Inscription

  • Toutes les applications créées à l'aide de l'API Google Analytics doivent être enregistrées en tant que projet dans la console des API Google.

  • Chaque requête envoyée à l'API doit inclure une clé API ou, pour OAuth 2.0, un ID et un code secret de client.

Règles pour les quotas

  • Le quota suivant s'applique aux deux API Analytics (API Management et API Data Export).

    • 50 000 requêtes par projet et par jour
    • 10 requêtes par seconde (RPS) par adresse IP
  • Le quota suivant s'applique à l'API d'exportation de données

    • 10 000 requêtes par profil et par jour
    • 10 requêtes simultanées par profil
  • Pour les applications non enregistrées, nous accordons un quota de grâce très faible afin de permettre une petite quantité de tests.

Abandons

  • Cette version annonce également l'abandon de la version 2.3 et l'abandon imminent du flux de compte dans l'API d'exportation de données. Dans 6 mois:

    • Les requêtes envoyées au flux de données XML version 2.3 sont transmises à la version 2.4 et renvoient une réponse version 2.4. À ce stade, toutes les règles de quota de la version 2.4 s'appliqueront aux requêtes de la version 2.3.

    • Les requêtes envoyées à la sortie JSON de la version 2.3 ne seront pas compatibles avec la réponse de la version 2.4 et renverront des codes d'état 404 Not Found. Si vous avez besoin d'une réponse JSON, passez à la version 3.0.

    • Les requêtes envoyées au flux de compte dans l'API d'exportation de données renverront les codes d'état 404 Not Found. Toutes les requêtes de données de configuration doivent être effectuées via l' API Management.

Cette version propose des données AdWords plus récentes et davantage de combinaisons de dimensions et de statistiques AdWords.

  • Les données AdWords sont désormais mises à jour dans un délai d'une heure. Avant la mise à jour quotidienne des données.

  • Nous avons assoupli un certain nombre de restrictions applicables aux combinaisons valides pour les données AdWords.

Il y a quelques semaines, nous avons effectué une modification pour interdire les requêtes API qui demandaient ga:adGroup ou ga:adContent avec ga:impressions, car cette combinaison renvoyait 0. Avec ce changement, cette combinaison est de nouveau rétablie et a été corrigée afin de renvoyer des données correctes.

Cette version corrige certaines combinaisons de dimensions et de métriques non valides

Correction des combinaisons métriques/dimensions non valides

  • Le mois dernier, nous avons annoncé des modifications à venir concernant l'API. L'objectif est d'interdire certaines requêtes incorrectes dans le flux de données qui ne renvoient aucune donnée. Nous avons apporté ces modifications à l'API, et les combinaisons suivantes ne sont plus valides:

    • Les dimensions de produit ne peuvent pas être associées aux métriques de transaction.
    • ga:adContent ou ga:adGroup ne peuvent pas être combinés avec ga:impressions.

    Au lieu de renvoyer une réponse avec 0 résultat, l'API renvoie désormais un code d'erreur 400 pour toutes les requêtes qui demandent ces combinaisons.

Cette version abandonne la valeur de l'intervalle de confiance dans les métriques.

Abandon de l'intervalle de confiance

  • Si vous ne l'avez pas déjà fait, veuillez cesser d'utiliser les valeurs de l'intervalle de confiance pour les métriques. Avec cette version, le flux de données de l'API d'exportation des données renvoie 0.0 pour toutes les valeurs de l'intervalle de confiance. D'ici environ un mois, nous supprimerons complètement cet attribut de tous les éléments des métriques.

    Pour déterminer si une réponse a été échantillonnée, veuillez utiliser le champ "containsSampledData" de la réponse.

Cette version ajoute trois nouvelles métriques et met à jour la valeur renvoyée pour deux nouvelles.

Nouvelles mises à jour des données

  • Nous avons ajouté à l'API trois nouvelles métriques concernant la vitesse du site :
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

Mises à jour des métriques

  • Pour spécifier des valeurs en devise dans les filtres, vous devez indiquer la valeur réelle transmise à partir du code de suivi (par exemple, une unité sera désormais spécifiée comme une seule).

  • ga:CTR renvoie désormais le pourcentage réel (par exemple, une valeur de 2% est renvoyée avec la valeur 2).

Cette version améliore les performances du flux de données et ajoute de nouvelles données:

Amélioration des performances

  • Cette version réduit la latence du flux de données de 30 à 35%.

Nouvelles mises à jour des données

  • Nous avons mis à jour la liste des dimensions et des statistiques autorisées dans les segments avancés. Veuillez consulter la liste mise à jour pour vérifier la validité de vos demandes.

Changements à venir

  • Actuellement, vous devez spécifier une valeur de filtre de devise en micro-unités (par exemple, 1 unité de devise est 1000000). Prochainement, vous devrez indiquer la valeur réelle transmise à partir du code de suivi (par exemple, une unité sera désormais spécifiée par 1).

  • Actuellement, ga:CTR est un percent et renvoie la valeur 0,02. Prochainement, cette valeur sera modifiée et affichera le pourcentage réel (par exemple, 2).

Cette version ajoute des données au flux de données:

Nouvelles mises à jour des données

  • La dimension temporelle suivante a été ajoutée: ga:dayOfWeek

  • La métrique de recherche interne suivante a été ajoutée: ga:percentVisitsWithSearch

  • Les métriques de suivi des événements suivantes ont été ajoutées:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

Changements à venir

Actuellement, l'API renvoie des codes d'état 401 pour différents problèmes d'autorisation. Au cours des deux prochaines semaines, l'état 401 sera utilisé exclusivement pour les jetons non valides, ce qui permettra aux développeurs de gérer les erreurs liées à cette exception particulière.

Cette version permet d'ajouter beaucoup plus de données au flux de données:

Nouvelles mises à jour des données

  • Le calcul de ga:visitors a été modifié afin d'afficher le nombre de visiteurs uniques au cours de la période. Il est désormais compatible avec un plus grand nombre de combinaisons de dimensions et de métriques.

  • 10 dimensions AdWords ont été ajoutées: ga:adDistributionNetwork, ga:adMatchType, ga:adMatchedQuery, ga:adPlacementDomain, ga:adPlacementUrl, ga:adFormat, ga:adTargetingType, ga:adTargetingOption, ga:adDisplayUrl et ga:adDestinationUrl.

  • La métrique ga:organicSearches a été ajoutée au groupe de campagnes.

  • La métrique ga:searchResultViews a été ajoutée au groupe interne de recherche sur site.

  • Trois nouvelles dimensions temporelles ont été ajoutées: ga:nthDay, ga:nthWeek et ga:nthMonth.

  • Les regroupements de dimensions et de métriques ont été modifiés pour mieux refléter les caractéristiques qu'elles représentent.

Nouvelles métriques calculées

Les métriques calculées suivantes sont dérivées de calculs utilisant les métriques de base. Remarque: Chaque nom contenant (n) accepte les valeurs de 1 à 20.

  • Basée sur les objectifs: ga:costPerConversion, ga:costPerGoalConversion, ga:costPerTransaction, ga:goal(n)AbandonRate, ga:goal(n)Abandons, ga:goal(n)ConversionRate, ga:goalAbandonRateAll, ga:goalAbandonsAll, ga:goalConversionRateAll, ga:goalValueAllPerSearch, ga:goalValuePerVisit.

  • Basée sur le contenu: ga:entranceBounceRate, ga:visitBounceRate, ga:entranceRate, ga:exitRate, ga:pageviewsPerVisit, ga:avgTimeOnPage, ga:avgTimeOnSite, ga:avgEventValue.

  • Basé sur la recherche sur site interne: ga:avgSearchDepth, ga:avgSearchDuration, ga:avgSearchResultViews, ga:searchGoalConversionRateAll, ga:searchGoal(n)ConversionRate, ga:searchExitRate.

  • Basé sur l'e-commerce: ga:itemsPerPurchase, ga:margin, ga:percentNewVisits, ga:revenuePerItem, ga:revenuePerTransaction, ga:ROI, ga:RPC, ga:totalValue, ga:transactionRevenuePerVisit, ga:transactionsPerVisit.

Cette version ajoute une nouvelle fonctionnalité au flux de données:

Nouvelles fonctionnalités

  • Un nouvel élément XML a été ajouté pour indiquer aux utilisateurs si les données ont été échantillonnées. true. Cet élément indique toujours si les données ont été échantillonnées ou non avec true ou false. Les bibliothèques Java et JavaScript ont également été mises à jour avec des méthodes d'assistance permettant d'accéder à cet élément.

Cette version corrige 2 bugs:

Correction de bugs

  • Auparavant, l'ajout d'un opérateur OU à une expression de filtre avec une dimension (par exemple, ga:keyword==store,ga:keyword==bar) pourraient donner lieu à des valeurs différentes que si chaque filtre était appliqué individuellement pour plusieurs requêtes. Ce problème a été corrigé et l'utilisation de l'opérateur OR renvoie désormais des valeurs cohérentes.

  • Certains messages d'erreur de l'API pour les filtres non valides ont été mis à jour de manière à NE PAS indiquer s'il s'agissait d'un filtre de dimension ou de métrique à l'origine de l'erreur (bien que l'expression de filtre incriminée continue d'être renvoyée).

Cette version corrige trois bugs:

Correction de bugs

  • Un problème d'encodage a été résolu dans la bibliothèque cliente JavaScript. Outil de suivi des problèmes Analytics

  • Nous avons corrigé un bug qui empêchait l'affichage du flux de compte lorsqu'un nom d'objectif, un chemin vers l'objectif, une valeur de comparaison d'objectif ou un type de comparaison d'objectif n'étaient pas correctement définis. Il a été corrigé.

  • L'opérateur OU une dimension et une métrique ne sont pas valides dans le paramètre de filtre de requête du flux de données. Exemple : ga:source==google,ga:visits>5. Le message d'erreur pour cette requête non valide a été mis à jour pour indiquer: Cannot OR dimension filter(s) with metric filter.

Cette version ajoute de nouvelles données et corrige un bug:

Nouvelles fonctionnalités

  • Les cinq dimensions suivantes ont été ajoutées dans la nouvelle catégorie D8. Adwords:

    • ga:adwordsAdGroupId: correspond à l'API AdWords AdGroup.id
    • ga:adwordsCampaignId: correspond à l'élément Campaign.id de l'API AdWords
    • ga:adwordsCreativeId: correspond à la valeur Ad.id de l'API AdWords
    • ga:adwordsCriteriaId: correspond à l'élément Criterion.id de l'API AdWords.
    • ga:adwordsCustomerId: correspond à l'API AdWords AccountInfo.customerId.

Correction de bugs

  • Nous avons corrigé le problème qui empêchait l'affichage de données dans le flux du compte si l'objectif ou l'étape de l'un des profils était mal configuré.

Cette version ajoute un certain nombre de nouvelles fonctionnalités et corrige un bug:

Nouvelles fonctionnalités

  • Le segment par défaut de l'iPhone (gaid::-11) a été amélioré pour générer des rapports sur tous les appareils mobiles. L'ID reste le même qu'auparavant (-11), mais le nom du segment est désormais Mobile Traffic.

  • Le taux d'échantillonnage utilisé par l'API est désormais le même que celui de l'interface Web. Les données des rapports échantillonnés sont ainsi intégrées à l'interface Web, ce qui permet d'améliorer la cohérence entre les deux.

  • Les règles relatives aux quotas ont été mises à jour afin que tous les utilisateurs bénéficient d'un accès équitable aux ressources. Pour en savoir plus, consultez notre documentation sur les règles relatives aux quotas. La nouvelle règle est la suivante:

    • Un même site Web peut effectuer jusqu'à 10 000 requêtes par 24 heures.
    • Une application ne peut envoyer que 10 requêtes au cours d'une période d'une seconde donnée.
    • Une application ne peut avoir que quatre demandes en attente à la fois.
  • Certaines restrictions sur les combinaisons de dimensions et de métriques ont été assouplies. ga:nextPagePath et ga:previousPagePath font désormais partie du groupe D3. Content. Le groupe D8. Custom Variable s'appelle désormais le groupe D6. Custom Variable. Pour en savoir plus sur ces nouvelles combinaisons, consultez le guide de référence mis à jour.

Correction de bugs

  • Nous avons corrigé un bug dans la façon dont l'API signale la valeur confidenceInterval pour les métriques. Auparavant, les intervalles de confiance pouvaient avoir la valeur INF ou un nombre compris entre 0 et 1. Désormais, tous les intervalles de confiance auront une valeur de INF ou un nombre supérieur ou égal à 0.

  • ga:itemQuantity et ga:uniquePurchases ont déjà été échangés et ont renvoyé la valeur de l'autre. Elles sont maintenant corrigées pour renvoyer les données correctes.

Rappel sur l'abandon des dimensions et des métriques

  • Si vous ne l'avez pas déjà fait, veuillez cesser d'utiliser les dimensions et métriques obsolètes

Cette version ajoute un certain nombre de nouvelles fonctionnalités:

Dans cette version, le numéro de version majeure passe à 2

  • Certaines fonctionnalités nécessitent l'utilisation des bibliothèques clientes les plus récentes. Nous acceptons officiellement Java et JavaScript. Il est possible que les bibliothèques tierces ne soient pas encore mises à jour.

    • Vous pouvez demander la version 2 en ajoutant l'en-tête GData-Version: 2 à chaque requête de compte ou de flux de données. Pour en savoir plus, consultez la documentation.
    • Un nouvel espace de noms XML a été ajouté aux flux de compte et de données:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • L'API est désormais compatible avec la version 2 du protocole Google Data.

Prise en charge de la segmentation avancée

  • Paramètre de requête des segments dynamiques:

    • ...&segment=dynamic::expression
    • permet de créer des segments avancés "à la volée".
    • peut correspondre à n'importe quelle dimension ou métrique, et doit suivre la même syntaxe que les filtres.
  • Paramètre de requête pour les segments par défaut et personnalisés:

    • ...&segment=gaid::numéro
    • où "number" correspond à un ID qui fait référence à un segment avancé défini dans l'interface Web de Google Analytics.
    • ID figurant dans le flux du compte.
  • Le flux du compte décrit les données sur les segments à l'aide des éléments et attributs XML suivants:

    • ga:visitorType==Returning Visitor
  • Le flux de données fournit également un élément XML indiquant si un segment a été appliqué dans la requête API.

  • Pour en savoir plus sur les segments avancés, consultez notre documentation.

Nouvelles données d'objectif disponibles

  • Objectifs de destination et de type d'engagement disponibles dans le flux du compte:

  • 48 nouvelles métriques ont été ajoutées pour les objectifs 5 à 20. Elles respectent tous la convention goal(n)Completions, où (n) correspond à un chiffre compris entre 1 et 20.

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value
  • GoalCompletionAll, GoalStartsAll et GoalValueAll ont été mis à jour pour tenir compte des nouvelles données d'objectif.

Nouvelles données de variables personnalisées

  • Toutes les variables personnalisées collectées par chaque profil ont été ajoutées en tant que nouvel élément XML au flux du compte:

  • 10 nouvelles dimensions ont été ajoutées pour les variables personnalisées. Ils suivent la convention customVar(n), où (n) peut être un chiffre compris entre 1 et 5.

    • ga:customVarName(n)
    • ga:customVarValue(n)

Les dimensions et métriques obsolètes doivent être supprimées.

  • Si vous ne l'avez pas déjà fait, veuillez cesser d'utiliser les dimensions et métriques obsolètes. Ils seront bientôt supprimés et renverront des erreurs depuis notre API si nécessaire.

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Les dimensions suivantes ont été renommées:

    • ga:countOfVisits est désormais ga:visitCount.
    • ga:countOfVisitsToATransaction est désormais ga:visitsToTransaction.

Cette version ajoute de nouvelles fonctionnalités et supprime d'anciennes fonctionnalités:

  • Les dimensions et métriques suivantes sont désormais obsolètes. Ils seront définitivement supprimés de notre API dans un mois. Veillez à mettre à jour votre code afin que vos applications restent opérationnelles:

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Les dimensions suivantes ont été renommées:

    • ga:countOfVisits est désormais ga:visitCount
    • ga:countOfVisitsToATransaction est désormais ga:visitsToTransaction.
  • Toutes les données de suivi des événements sont maintenant présentées sous la forme de deux nouveaux groupes:

    D7. Événements (dimensions) * ga:eventCategory * ga:eventAction * ga:eventLabel

    M7. Événements (métriques) * ga:eventValue * ga:totalEvents * ga:uniqueEvents

  • Les données générales de navigation sur le site sont désormais présentées selon les dimensions suivantes:

    D6. Navigation * ga:previousPagePath * ga:nextPagePath

  • La navigation sur les pages de destination est désormais exposée via les dimensions suivantes:

    D3. Contenu * ga:landingPagePath * ga:secondPagePath

  • La longueur maximale des expressions régulières dans le paramètre de requête de filtre du flux de données est passée de 32 à 128 caractères.

  • Le rapport "Durée de la visite" (accessible via l'interface utilisateur, sous Visiteurs -> Fidélité des visiteurs) est maintenant accessible via la nouvelle dimension:

    • ga:visitLength

Cette version met à jour l'API d'exportation de données Google Analytics comme suit:

  • Certaines restrictions sur les combinaisons de dimensions et de métriques ont été assouplies. Vous pouvez désormais interroger simultanément la plupart des dimensions de contenu et de visiteur. Par exemple, ga:pagePath et ga:source constituent désormais une combinaison valide. Consultez le guide de référence mis à jour pour ces nouvelles combinaisons: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html.

  • Le nombre total de lignes pouvant être demandées dans une demande a été augmenté à 10 000. Le nombre de lignes renvoyées par défaut est toujours de 1 000, mais vous pouvez désormais l'augmenter en définissant le paramètre de requête max-results.

  • Le flux de compte affiche désormais deux nouveaux éléments de données pour chaque ID de tableau (devise et fuseau horaire).

  • Nous veillons désormais à ce que les requêtes de données incluent au moins une métrique valide.

  • Toutes les modifications précédemment apportées à l'abandon sont effectives.

Cette version supprime les fonctionnalités obsolètes de notre bêta privée:

  • Il n'est plus possible d'utiliser un nom d'utilisateur pour les demandes de flux. Il n'acceptera donc que les requêtes au format suivant:
    https://www.google.com/analytics/feeds/accounts/default

  • Les métriques suivantes sont en cours de suppression et ne fonctionneront plus. Pour savoir comment calculer ces valeurs, consultez la page http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html.

    • ga:avgPageDuration
    • ga:avgPageviews
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenuePerVisit
    • ga:abandonedFunnels1
    • ga:abandonedFunnels2
    • ga:abandonedFunnels3
    • ga:abandonedFunnels4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit
  • Les dimensions et métriques suivantes ont été renommées. Les anciens noms ne fonctionneront plus. Veuillez vérifier que vous utilisez les noms officiels figurant dans notre documentation: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html.

    Taille de recherche :

    Objectif :