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 décrit toutes les modifications apportées à l'API principale de création de rapports 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

Tous les journaux de modifications de l'API Google Analytics
–
S'abonner rss

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

Tous les journaux de modifications de l'API Reporting
–
S'abonner rss

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

Journal des modifications de l'API Core Reporting
–
S'abonner rss

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 est principalement destinée aux propriétaires qui souhaitent fournir un accès automatisé aux données d'un utilisateur directement. 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 Reporting version 4 d'Analytics passe de 10 000 à 100 000.

Cette version inclut un aperçu du système de quotas basé sur les ressources pour 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 l'outil de référence sur les dimensions et les métriques pour obtenir la liste complète des définitions. Consultez le Règlement relatif aux abandons de données pour en savoir plus sur la suppression de données:

Cette version abandonne les dimensions et métriques suivantes:

  • 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 la documentation 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 pour comprendre le processus complet de suppression de données.

Temps

  • 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 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 Identification des utilisateurs 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 pour chaque jour de la période demandée.

Événements uniques

La période d'abandon de ga:uniqueEvents approchera. 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 la documentation 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é affecté. 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 incorrect, Unknown dimension(s): ou Unknown metric(s): lors de la requête de données avec des conditions qui 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 associées non AdSense ne peuvent pas demander de dimensions et de métriques AdSense. L'interrogation de ces dimensions et métriques avec des vues associées non AdSense génère une erreur.

Il s'agit d'une version de correction de bug qui résout un problème lié aux dimensions et métriques AdSense, et annonce une modification à venir de ces dimensions et métriques.

Dimensions et métriques AdSense

Dans cette version, le problème a commencé à compter du 07/01/2017 : les requêtes portant sur les dimensions et métriques AdSense renvoyaient une erreur "Métrique inconnue" pour les vues associées non AdSense.

Modifications à venir

À partir du 31 janvier 2017, les vues associées non AdSense ne pourront plus interroger les dimensions et les métriques AdSense. L'interrogation de ces dimensions et métriques avec des vues associées non AdSense génère une erreur.

Cette version ajoute la nouvelle métrique suivante à l'API. Consultez la documentation de référence sur les dimensions et 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ù correspond 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, elle abandonne une métrique existante. Consultez la documentation de référence sur les dimensions et métriques pour obtenir la liste complète des définitions.

Suivi des événements

La définition de ga:uniqueEvents sera modifiée pour refléter plus précisément le nombre d'événements uniques. Pour que cette modification soit appliquée, nous abandonnerons techniquement la métrique ga:uniqueEvents actuelle, conformément à notre Règlement relatif aux abandons de 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 allons également introduire une nouvelle métrique, ga:uniqueDimensionCombinations, qui conserve la définition actuelle de ga:uniqueEvents. Après la période d'abandon prévue (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 la documentation 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 la documentation 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. Cette métrique vous permet de 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 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, doit être intégré à DBM)
  • Dimension : ga:dbmClickAdvertiserId : référence annonceur DBM du clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, doit être intégré à DBM)
  • Dimension : ga:dbmClickCreativeId : ID de la création DBM du clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, doit être intégré à DBM)
  • Dimension : ga:dbmClickExchange : nom de la place de marché DBM associée au clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, doit être intégré à DBM)
  • Dimension : ga:dbmClickExchangeId : ID de la place de marché DBM du clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, doit être intégré à DBM)
  • Dimension : ga:dbmClickInsertionOrder : nom de l'ordre d'insertion DBM du clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, doit être intégré à DBM).
  • Dimension : ga:dbmClickInsertionOrderId : ID de l'ordre d'insertion DBM du clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, doit être intégré à DBM)
  • Dimension : ga:dbmClickLineItem : nom de l'élément de campagne DBM associé au clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, doit être intégré à DBM)
  • Dimension – ga:dbmClickLineItemId – ID de l'élément de campagne DBM du clic DBM correspondant à la session Google Analytics (Analytics 360 uniquement, doit être intégré à DBM)
  • Dimension : ga:dbmClickSite : nom du site DBM sur lequel la création DBM a été diffusée et sur laquelle l'utilisateur a cliqué 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 sur laquelle l'utilisateur a cliqué 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 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, doit être intégré à 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, doit être intégré à 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, doit être intégré à 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, doit être intégré à 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, doit être intégré à 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, doit être intégré à 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, doit être intégré à 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, doit être intégré à 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, doit être intégré à DBM).
  • Dimension : ga:dbmLastEventSite : nom du site DBM sur lequel la création DBM a été diffusée et sur laquelle un clic a été enregistré 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, doit être intégré à DBM).
  • Dimension : ga:dbmLastEventSiteId : ID du site DBM sur lequel la création DBM a été diffusée et a enregistré un clic 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, doit être intégré à DBM).
  • Métrique – ga:dbmCPA – eCPA en fonction des revenus (Analytics 360 uniquement, doit être intégré à DBM)
  • Métrique – ga:dbmCPC – eCPC en fonction des revenus (Analytics 360 uniquement, doit être intégré à DBM).
  • Métrique – ga:dbmCPM – eCPM en fonction des revenus (Analytics 360 uniquement, doit être intégré à 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, nécessite une intégration avec DS).
  • Dimension – ga:dsAdGroupId : ID du groupe d'annonces DS (Analytics 360 uniquement, nécessite une intégration à 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 de l'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 avec DS).
  • Dimension – ga:dsEngineAccountId : ID du compte de moteur DS (Analytics 360 uniquement, nécessite une intégration avec DS)
  • Dimension - ga:dsKeyword - Mot clé DS (Analytics 360 uniquement, nécessite une intégration avec DS).
  • Dimension – ga:dsKeywordId : ID du mot clé DS (Analytics 360 uniquement, nécessite une intégration avec DS)
  • ga:dsCPC : coût DS pour l'annonceur par clic (Analytics 360 uniquement, nécessite une intégration avec DS).
  • ga:dsCTR : taux de clics DS (Analytics 360 uniquement, nécessite une intégration avec DS).
  • ga:dsClicks : clics DS (Analytics 360 uniquement, nécessite une intégration avec DS).
  • ga:dsCost - Coût DS (Analytics 360 uniquement, nécessite une intégration avec DS)
  • ga:dsImpressions : impressions DS (Analytics 360 uniquement, nécessite une intégration avec 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 avec 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 métriques pour obtenir la liste complète des définitions.

Réseau géographique

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

Restrictions

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

  • Consulter le groupe d'informations Shopping
    • ga:checkoutOptions
    • ga:shoppingStage
  • Groupe de test pour l'outil 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 le branding :
    • ga:interestAffinityCategory

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

Signaler des erreurs

Cette version commence à appliquer des limites aux requêtes de création de rapports 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 pivots.
  • Un tableau croisé dynamique ne peut pas comporter plus de 4 dimensions.
  • Les dimensions de tableau croisé dynamique font partie de la restriction sur le nombre total de dimensions autorisées dans la demande.
  • Les metrics de pivot font partie de la restriction sur le nombre total de métriques autorisées dans la demande.

Cette version ajoute de nouvelles dimensions et métriques à l'API. Consultez la documentation de référence sur les dimensions et 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ù provient le trafic, déterminé par l'adresse IP ou l'ID géographique des utilisateurs.

DoubleClick for Publishers

  • Statistique 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 comptabilisons deux impressions (l'option "Association à Ad Manager" et l'option "Masquer les revenus" sont désactivées).
  • Métrique – ga:dfpCoverage – La couverture correspond au pourcentage de demandes d'annonces ayant renvoyé au moins une annonce. Généralement, l'exposition permet d'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 l'option "Masquer les revenus Ad Manager" n'est pas activée).
  • Métrique ga:dfpMonetizedPageviews : mesure le nombre total de pages vues sur la propriété, s'affichant avec une annonce provenant du compte Ad Manager associé. Notez qu'une même page peut avoir plusieurs blocs d'annonces (l'association avec Ad Manager est activée et l'option "Masquer les revenus 2" n'est pas activée).
  • Métrique – ga:dfpImpressionsPerSession : le rapport entre le nombre d'impressions d'annonces AdMob et le nombre de sessions Analytics (Impressions d'annonces / Sessions Google Analytics) (l'association à Ad Manager est activée et l'option "Masquer le revenu Ad Manager" 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 les navigateurs des utilisateurs et qu'elle a l'occasion d'être vue (l'association avec Ad Manager est activée et l'option "Masquer les revenus Google Ads" n'est pas activée).
  • Métrique – ga:dfpClicks : nombre de clics sur les annonces Google Ads sur le site (l'association à Ad Manager est activée et l'option "Masquer les revenus Ad Manager" n'est pas activée).
  • Métrique – ga:dfpCTR : 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 Ad Manager" n'est pas activée).
  • Métrique – ga:dfpRevenue – Estimation des revenus Ad Manager en fonction du total des revenus publicitaires sur la base des impressions diffusées (l'association avec AdMob est activée et l'option "Masquer les revenus 2" n'est pas activée).
  • Statistique ga:dfpRevenuePer1000Sessions : estimation du total des revenus générés par les annonces Ad Manager pour 1 000 sessions Analytics. Notez que cette métrique est basée sur le nombre de sessions sur le site, et non sur les 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:dfpECPM : coût effectif pour mille pages vues. Il s'agit du chiffre d'affaires Ad Manager pour 1 000 pages vues (l'association avec Ad Manager est activée et l'option "Masquer les revenus 2" n'est pas activée).
  • Métrique – ga:backfillImpressions – Les impressions d'annonces de remplissage correspondent à la somme de toutes les impressions d'annonces AdSense ou Ad Exchange 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 comptabilisons deux impressions (l'option "Association à Ad Manager" et l'option "Masquer les revenus" sont désactivées).
  • Métrique – ga:backfillCoverage – La couverture pour les annonces de remplissage correspond au pourcentage de demandes d'annonces de remplissage ayant renvoyé au moins une annonce. Généralement, l'exposition permet d'identifier les sites pour lesquels le compte de l'é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 de remplissage (l'association avec Ad Manager est activée et l'option "Masquer les revenus Ad Manager" 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. Notez 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 les 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 2" 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 si elle s'est affichée dans les navigateurs 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 avec Ad Manager est activée et l'option "Masquer les revenus Ad Manager" 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 2" n'est pas activé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 avec Ad Manager est activée et l'option "Masquer les revenus Ad Manager" n'est pas activée).
  • Métrique ga:backfillRevenue : total des revenus estimés générés par les 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 2" n'est pas activée).
  • Métrique ga:backfillRevenuePer1000Sessions : total des revenus estimés générés par les 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 2" n'est pas activée).
  • Métrique ga:backfillECPM : coût effectif pour mille pages vues. Il correspond au 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 2" n'est pas activée).

Cette version annonce le lancement d'une nouvelle version de l'API : Analytics Reporting API V4. 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'exploiter toute la puissance de la plate-forme Google Analytics. Voici quelques fonctionnalités clé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 des 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 : il est possible de demander deux plages de dates, ce qui vous permet de comparer les données de deux périodes avec 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.
  • Plusieurs segments : vous pouvez désormais demander plusieurs segments dans une même requête.

Premiers pas

Pour en savoir plus sur l'utilisation de l'API, consultez la documentation destinée aux développeurs.

Règles pour les quotas

L'API Analytics Reporting version 4 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écifiquement pour la version 4 de l'API Reporting Analytics. Pour consulter la liste complète, reportez-vous à l'explorateur de dimensions et de métriques.

  • Dimension ga:cohort : nom de la cohorte à laquelle appartient un utilisateur d'après la définition de la cohorte. 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 première visite est le 01/09/2015, alors pour la date 04/09/2015, ga:cohorteNthJour sera "3".

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

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

  • Dimension ga:acquisitionTrafficChannel : canal de trafic à l'origine de l'acquisition de l'utilisateur. Elle est extraite 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, le cas échéant) 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 des champs ga:userAcquisitionSource et 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 dans le contexte des 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 faisant partie de la cohorte (également appelé "taille de la cohorte").

  • Métrique – ga:cohortAppviewsPerUser – Vues de l'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 fidélisation de la cohorte.

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

  • Métrique – ga:cohortVisitDurationPerUser – Durée de la 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 des cohortes 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 de la cohorte qui ont été acquis directement. Si aucune des dimensions mentionnées n'est présente, sa valeur est égale à ga:cohortTotalUsers.

  • Métrique – ga:cohortAppviewsPerUserWithLifetimeCriteria – Applications vues par utilisateur pour la dimension d'acquisition d'une cohorte.

  • Métrique – ga:cohortGoalCompletionsPerUserWithLifetimeCriteria – Objectifs réalisés par utilisateur pour la dimension "Acquisition" 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" d'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, plus 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 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. Consultez le Règlement relatif aux abandons de données pour en savoir plus sur la suppression de données:

  • Dimension ga:socialActivityEndorsingUrl : pour une activité de plate-forme de données sur les réseaux sociaux, il s'agit de l'URL de l'activité sur le réseau social (par exemple, l'URL du post Google+, de l'URL du commentaire sur le blog, etc.).
  • Dimension ga:socialActivityDisplayName : pour une activité de plate-forme 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 plate-forme de données sur les réseaux sociaux, il s'agit du contenu de l'activité sur le réseau social (par exemple, le contenu d'un message publié sur Google+) publié par les utilisateurs de réseaux sociaux.
  • Dimension ga:socialActivityTimestamp : pour une activité de plate-forme de données sur les réseaux sociaux, il s'agit du moment où l'activité a eu lieu sur le réseau social.
  • Dimension : ga:socialActivityUserHandle : pour une activité liée à un centre de données sur les réseaux sociaux, il s'agit de l'identifiant de 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 - S'il s'agit d'une activité de plate-forme de données sur les réseaux sociaux, il s'agit de l'URL de la photo associée aux profils des utilisateurs sur les réseaux sociaux.
  • Dimension ga:socialActivityUserProfileUrl : pour une activité de plate-forme de données sur les réseaux sociaux, il s'agit de l'URL des profils de l'utilisateur associé sur les réseaux sociaux.
  • Dimension ga:socialActivityTagsSummary : pour une activité de plate-forme de données sur les réseaux sociaux, il s'agit d'un ensemble de tags associés à l'activité, séparés par une virgule.
  • Dimension ga:socialActivityAction : 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 (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 à l'origine de l'activité.
  • Dimension ga:socialActivityContentUrl : pour une activité de plate-forme de données sur les réseaux sociaux, il s'agit de l'URL partagée par les utilisateurs du réseau social associé.
  • 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 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 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 lorsqu'il est défini sur false lignes sans données, il est omis de la réponse. La valeur par défaut est true. Il s'agit d'une modification non destructive. Par conséquent, aucune mise à jour du code n'est nécessaire. 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 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. Pour interroger cette métrique, vous devez spécifier au moins ga:nthDay, ga:date ou ga:day en tant que dimension. Pour la date donnée, la valeur renvoyée correspondra au nombre total d'utilisateurs uniques pour la période d'un jour se terminant à cette date.
  • Métrique – ga:7dayUsers : nombre total d'utilisateurs actifs sur 7 jours pour chaque jour de la période demandée. Pour interroger cette métrique, vous devez spécifier au moins ga:nthDay, ga:date ou ga:day en tant que dimension. Pour la date donnée, la valeur renvoyée correspondra au nombre total d'utilisateurs uniques pour la période de sept jours se terminant à cette date.
  • Métrique – ga:14dayUsers : nombre total d'utilisateurs actifs sur 14 jours pour chaque jour de la période demandée. Pour interroger cette métrique, vous devez spécifier au moins ga:nthDay, ga:date ou ga:day en tant que dimension. Pour la date donnée, la valeur renvoyée correspondra au nombre total d'utilisateurs uniques pour la période de 14 jours se terminant à cette date.
  • Métrique – ga:30dayUsers : nombre total d'utilisateurs actifs sur 30 jours pour chaque jour de la période demandée. Pour interroger cette métrique, vous devez spécifier au moins ga:nthDay, ga:date ou ga:day en tant que dimension. Pour la date donné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 métriques pour obtenir la liste complète des définitions.

DoubleClick Ad Exchange (AdX)

  • Statistique ga:adxCTR : pourcentage de pages vues ayant abouti à 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, l'exposition 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.
  • Métrique – ga:adxImpressions – Une impression d'annonce AdX est enregistrée chaque fois qu'une annonce individuelle est affiché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 – Les 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.
  • Statistique 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.

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

Dimensions obsolètes

Ces dimensions ont été abandonnées. Consultez le Règlement relatif aux abandons de données pour en savoir plus sur la suppression 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 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 dimensions et des métriques.

AdWords

  • Dimension ga:adQueryWordCount : nombre de mots dans la requête de recherche.

Cette version ajoute de nouvelles dimensions à l'API. Consultez l'article 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 comme "Web", tandis que ceux envoyés depuis les SDK pour mobile sont signalé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 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 de la transaction, hors taxes et frais de livraison, 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 des villes des utilisateurs, déterminés à partir de l'adresse IP ou de l'ID géographique.
  • Dimension ga:countryIsoCode : code ISO du pays des utilisateurs, déterminé par l'adresse IP ou l'ID géographique. Les valeurs sont fournies sous forme de 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 l'ID géographique. Les valeurs sont fournies sous la forme d'un code ISO-3166-2.
  • Dimension ga:subContinentCode : code du sous-continent des utilisateurs, déterminé par l'adresse IP ou l'ID géographique. Par exemple, la Polynésie ou l'Europe du Nord. Les valeurs sont fournies 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. Pour en savoir plus sur la suppression de données, consultez les Règles relatives aux abandons de données: + Métrique – ga:dcmROI – Utilisez ga:dcmROAS à la place. + Métrique – ga:dcmMargen – Utilisez ga:dcmROAS à la place.

Cette version ajoute une nouvelle métrique à 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.

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. Pour en savoir plus sur la suppression de données, consultez les Règles relatives aux abandons de données: + Métrique – ga:ROI – Utilisez ga:ROAS à la place. + Métrique – ga:margin – Utilisez ga:ROAS à la place.

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.

AdSense

  • Statistique 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 métrique sur les sessions, d'une nouvelle dimension "Sources de trafic", ainsi que de nouvelles dimensions et métriques DoubleClick Campaign Manager.

Dimensions et statistiques

Consultez la documentation de référence sur les dimensions et 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 : valeur du paramètre de suivi de campagne utm_id lorsque vous utilisez le suivi manuel 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 du 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 sur laquelle l'utilisateur a cliqué 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és 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 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: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 "Clic". 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 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: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 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: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 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: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 sur laquelle un clic a été enregistré 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 sur laquelle un clic a été enregistré 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 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:dcmLastEventSitePlacementId : ID de l'emplacement sur le 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 la 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).
  • Statistique : 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 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 qui a été consulté après un autre groupe de contenu.
  • Dimension - ga:contentGroupXX : groupe de contenu sur une propriété. Un groupe de contenu est un ensemble de contenu présentant une structure logique qui peut être déterminée par le code de suivi, la correspondance entre le titre de la page et l'URL avec expression régulière, ou des règles prédéfinies.
  • Dimension ga:previousContentGroupXX : fait référence au groupe de contenu qui a été consulté 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é. Cela prend en compte à la fois pagePath et pageTitle pour déterminer l'unicité.

Cette version inclut une nouvelle condition dateOfSession pour les segments, ainsi que 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é à 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) dans 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 définies par l'utilisateur lors du processus de règlement, par exemple FedEx, DHL, UPS pour les options de livraison ou Visa, MasterCard ou American Express pour les options 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 que les utilisateurs ont réalisées 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 divisé par le 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 auquel les utilisateurs ont cliqué sur le produit 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é des paniers.
  • 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 – Achats uniques divisés par le nombre de vues des pages d'informations détaillées sur les produits.
  • Métrique – ga:cartToDetailRate : nombre d'ajouts de produits divisé par le nombre de vues des informations détaillées sur le produit.
  • Métrique – ga:quantityAddedToCart : nombre d'unités de produits ajoutées au panier.
  • Métrique – ga:quantityCheckedOut : nombre d'unités de produits incluses dans le règlement.
  • Métrique – ga:quantityRefunded : nombre d'unités de produits remboursées.
  • Métrique – ga:quantityRemovedFromCart : nombre d'unités de produits supprimées du panier.
  • Métrique – ga:refundAmount : montant remboursé pour 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, ainsi que l'ajout de nouvelles dimensions et métriques.

Dimensions et statistiques

Consultez la documentation de référence sur les dimensions et 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. Ce champ 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 pour les produits associés.
  • Dimension - ga:queryProductId : ID du produit concerné par la requête.
  • Dimension - ga:queryProductName : nom du produit interrogé.
  • Dimension - ga:queryProductVariation : variante du produit interrogé.
  • Dimension - ga:relatedProductId : ID 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 des colonnes 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.

Dans cette version, nous avons ajouté et renommé des dimensions et des métriques. Consultez la documentation de référence sur les dimensions et métriques pour obtenir la liste complète des définitions.

Nouvelles dimensions et métriques

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

AdWords

  • Dimension ga:isTrueViewVideoAd - Yes ou No : indique s'il s'agit d'une annonce vidéo TrueView AdWords.

Temps

  • Dimension - ga:nthHour : indice par heure au cours de la période spécifiée. L'index 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 visit 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

Prise en charge des nouveaux segments dans l'API Core Reporting.

  • Le paramètre segment est désormais compatible avec les segments d'utilisateurs et de séquence. Vous pouvez interroger les segments de niveau utilisateur et de niveau de session créés dans l'interface Web à l'aide du paramètre segment.
  • Une nouvelle syntaxe pour les segments dynamiques est disponible à utiliser 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 d'migrate 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 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).

Sortie de la table de données

Pour faciliter l'affichage 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. Vous pouvez l'utiliser pour 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 Data Table 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 à Core Reporting API:

Temps

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

Audience

  • Dimension - ga:visitorAgeBracket : tranche d'âge du visiteur.
  • Dimension - ga:visitorGender : sexe du visiteur.
  • Dimension ga:interestAffinityCategory : indique que les utilisateurs sont plus susceptibles d'être intéressés par 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 d'être intéressés par la catégorie spécifiée et d'effectuer un achat.

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 : revenus générés par le produit dans la devise locale.

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:

  • 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 la documentation 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é:

    • Atteint – ga:adsenseRevenue : revenu total généré par les annonces AdSense.
    • Atteint - 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 du code d'annonce AdSense. Plus d'informations: https://support.google.com/adsense/answer/32715
    • Atteint - ga:adsenseAdsViewed : nombre d'annonces AdSense vues. Plusieurs annonces peuvent être diffusées dans un bloc d'annonces.
    • Atteint – ga:adsenseAdsClicks : nombre de clics sur les annonces AdSense de votre site
    • Atteinte – ga:adsensePageImpressions : nombre de pages vues pendant lesquelles une annonce AdSense a été diffusée. Une impression de page peut être associée à plusieurs blocs d'annonces.
    • Réalisé - ga:adsenseCTR : pourcentage d'impressions de page ayant généré un clic sur une annonce AdSense. (ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • Atteint - 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éalisé - ga:adsenseExits : nombre de sessions ayant pris fin parce qu'un utilisateur a cliqué sur une annonce AdSense.

Temps

  • Dim : ga:isoYear : année ISO de la visite. Pour plus d'informations, consultez la page http://en.wikipedia.org/wiki/ISO_week_date. Vous ne devez utiliser ga:isoYear qu'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

  • Les données suivantes figurent dans les rapports AdWords:

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

Dates relatives
  • Les dates relatives ont été ajoutées à 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 basée sur la date actuelle au moment où la requête est effectuée et sur le 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
  • Un nouveau paramètre, samplingLevel, a été introduit. Il vous permet de définir le niveau d'échantillonnage (c'est-à-dire le nombre de visites utilisé pour calculer le résultat) d'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

  • ga:adwordsCustomerID renvoie désormais correctement le numéro client AdWords à 10 chiffres correspondant à l'API AdWords AccountInfo.customerId. Grâce à ce correctif, vous pouvez associer les 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 maintenant en cours d'abandon. Ces anciens ID resteront acceptés pendant six mois. Nous vous recommandons d'utiliser des applications qui enregistrent des 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 utilisant 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 pas acceptés pour le moment.

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.

Suivi des applications

  • Ces données figurent dans les rapports de profil d'application :
    • Dim : ga:appId : identifiant de l'application.
    • Dim : ga:appInstallerId : ID du programme d'installation (par exemple, Google Play Store) à partir de laquelle l'application a été téléchargée. Par défaut, l'ID du programme d'installation de l'application 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.
    • Assombrissement : ga:exitScreenName : nom de l'écran lorsque l'utilisateur a quitté l'application.
    • Assombrir : ga:landingScreenName : nom du premier écran consulté.
    • Faible : ga:screenDepth : nombre de visionnages de l'écran par session, signalé sous forme de chaîne. Peut s'avérer utile pour les histogrammes.
    • Assombrir : ga:screenName : nom de l'écran.
    • Réalisé - ga:avgScreenviewDuration : temps moyen passé par les utilisateurs sur un écran, en secondes.
    • Atteint - ga:timeOnScreen : temps passé à consulter l'écran actuel.
    • Atteint - ga:screenviews : nombre total de visionnages de l'écran. Utilisez cette méthode à la place de ga:appviews.
    • Réunies - ga:uniqueScreenviews : nombre d'ga:screenviews différents (uniques) au cours d'une session. Utilisez cette méthode à la place de ga:uniqueAppviews.
    • Réalisé - 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 le nouveau nom de la métrique à la place.

  • Mettons - ga:appviews : utilisez ga:screenviews à la place.
  • Mettons - ga:uniqueAppviews : utilisez ga:uniqueScreenviews à la place.
  • Mettons - ga:appviewsPerVisit : utilisez ga:screenviewsPerSession à la place.

Colonnes ou variables personnalisées

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

    • Dim : 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.
    • Conformes - ga:metricXX : nom de la métrique personnalisée demandée, où XX fait référence au numéro ou à l'index de la métrique personnalisée.

Modifications apportées à 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.
  • Atteint - ga:localItemRevenue - Chiffre d'affaires généré par le produit en devise locale
  • Réalisé - ga:localTransactionRevenue - Revenus des transactions dans la devise locale
  • Respectés - ga:localTransactionShipping - Frais de port associés à la transaction dans la devise locale.
  • Atteinte - ga:localTransactionTax - Taxe sur les transactions dans la devise locale.

Exceptions

  • Ces données proviennent du suivi des exceptions.
    • Dim : ga:exceptionDescription : description de l'exception.
    • Atteint - ga:exceptionsPerScreenview : nombre d'exceptions générées divisé par le nombre de visionnages de l'écran.
    • Réalisé - ga:fatalExceptionsPerScreenview : nombre d'exceptions fatales générées, divisé par le nombre de visionnages de l'écran.

Conversions par objectif

  • Assombrissement : ga:goalCompletionLocation : chemin de la page ou nom de l'écran correspondant à un objectif réalisé avec un type de destination.
  • Assombrissement : ga:goalPreviousStep1 : chemin de la page ou nom de l'écran qui correspondait à un objectif type de destination, une étape avant la réalisation de l'objectif.
  • Faible - ga:goalPreviousStep2 : chemin de la page ou nom de l'écran qui correspondait à un objectif type de destination, deux étapes avant la réalisation de l'objectif.
  • Faible - ga:goalPreviousStep3 : chemin de la page ou nom de l'écran qui correspondait à un objectif type de destination, trois étapes avant la réalisation de l'objectif.

Modifications apportées à 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)AbandonRate → ga:goalXXAbandonRate
  • ga:goal(n)Abandons → ga:goalXXAbandons
  • ga:goal(n)Completions → ga:goalXXCompletions
  • ga:goal(n)ConversionRate → ga:goalXXConversionRate
  • ga:goal(n)Starts → ga:goalXXStarts
  • ga:goal(n)Value → ga:goalXXValue
  • ga:searchGoal(n)ConversionRate → ga:searchGoalXXConversionRate
  • Conformes - ga:percentSearchRefinements : pourcentage de fois où un affinement (c'est-à-dire une transition) est effectué entre des mots clés de recherche interne au cours d'une session.

Suivi des pages

  • Fait - ga:pageValue : valeur moyenne de cette page ou de cet 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 utilisant une tablette. Les valeurs possibles sont Yes ou No.
    • Faible - 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.

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

Temps

  • 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. Pour plus d'informations, consultez la page 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 l'article de référence sur les dimensions et les métriques pour en obtenir la définition.

Suivi des applications

  • Les données suivantes figurent dans les rapports du SDK de suivi des applications mobiles :
    • Atteint - ga:uniqueAppviews : nombre de vues de l'application par session.
    • Atteint - 'ga:appviews : nombre total de vues de l'application.
    • Atteint - ga:appviewsPerVisit : nombre moyen de vues de l'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.
  • Dim : ga:hasSocialSourceReferral : indique les visites qui ont accédé au site à partir d'un 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 de l'activité hors site importée par des partenaires du Centre des données sur les réseaux sociaux.
    • Faible - ga:socialActivityDisplayName : pour une activité de hub 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.
    • Dim – ga:socialActivityEndorsingUrl : pour une activité de plate-forme de données sur les réseaux sociaux, cette chaîne représente l'URL de l'activité sur le réseau social (par exemple, l'URL du post Google+, de l'URL 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 d'un message d'un post Google+).
    • Faible - ga:socialActivityTimestamp : pour une activité de la plate-forme 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é de hub 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 les réseaux sociaux.
    • Dim (ga:socialActivityUserProfileUrl) : pour une activité de plate-forme 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 plate-forme de données sur les réseaux sociaux, cette chaîne représente l'URL partagée par l'utilisateur associé sur le réseau social.
    • Dim (ga:socialActivityTagsSummary) : pour une activité de la plate-forme 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é.
    • Dim – ga:socialActivityUserHandle : pour une activité liée à un centre de données sur les réseaux sociaux, cette chaîne représente l'identifiant (c'est-à-dire le nom) de l'utilisateur à l'origine de l'activité sur le réseau social.
    • Dim – ga:socialActivityAction : pour une activité du centre de données sur les réseaux sociaux, cette chaîne représente le type d'action sur un réseau social associé à l'activité (vote, commentaire, +1, etc.).
    • Dim (ga:socialActivityNetworkAction) : pour une activité liée à un hub 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 à l'origine de l'activité.
    • Réalisé - ga:socialActivities : nombre d'activités pour lesquelles une URL de contenu a été partagée/mentionnée sur un réseau partenaire du Centre des 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.
    • Dim – ga:socialInteractionAction : pour les interactions sur les réseaux sociaux, chaîne représentant l'action sur un réseau social qui fait l'objet d'un suivi (par exemple, le bouton +1, le bouton "J'aime" ou les favoris)
    • Dim : ga:socialInteractionNetwork : pour les interactions sur les réseaux sociaux, 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, chaîne représentant la concaténation des ga:socialInteractionNetwork et des ga:socialInteractionAction suivies (par exemple, Google : +1, Facebook : "J'aime")
    • Dim : ga:socialInteractionTarget : pour les interactions sur les réseaux sociaux, chaîne représentant l'URL (ou la ressource) qui reçoit l'action sur un réseau social.
    • Atteint – ga:socialInteractions : nombre total d'interactions sur les réseaux sociaux sur votre site
    • Atteint – ga:uniqueSocialInteractions : nombre total d'interactions uniques sur les réseaux sociaux sur votre site Basé 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 "pagePath" du premier niveau hiérarchique dans "pagePath".
  • Dim – ga:pagePathLevel2 : cette dimension regroupe tous les "pagePath" du deuxième niveau hiérarchique dans "pagePath".
  • Dim – ga:pagePathLevel3 : cette dimension regroupe tous les "pagePath" du troisième niveau hiérarchique dans "pagePath".
  • Dim – ga:pagePathLevel4 : cette dimension regroupe tous les "pagePath" 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.

    • Atteint - 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 catégoriser 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.
    • Dim – ga:userTimingVariable : chaîne permettant de visualiser plus facilement le temps utilisateur dans les rapports.
    • Faible : ga:userTimingValue correspond au nombre de millisecondes écoulées envoyé à Google Analytics.
    • Met-ga:userTimingSample - Nombre d'échantillons envoyés.
    • Met - 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.
    • Dim – ga:mobileDeviceBranding: nom du fabricant du mobile ou de la marque (Samsung, HTC, Verizon, T-Mobile, etc.).
    • Faible - ga:mobileDeviceModel - Modèle de l'appareil mobile (exemple: Nexus S)
    • Assombrir : 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 utilisés pour 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 deux bugs:

Correction de bugs

  • Les filtres de requête contenant des caractères spéciaux à l'intérieur d'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 de vitesse du site suivantes 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 l'article de référence sur les dimensions et les métriques pour en obtenir la définition.

Rappel concernant l'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.

  • Au bout de quatre mois, les requêtes envoyées à l'ancienne version 2.3 du flux de données XML seront transmises à la version 2.4 et renverront une réponse XML version 2.4. À ce stade, toutes les règles de quotas de la version 2.4 s'appliqueront aux requêtes de la version 2.3.

  • Toutes les requêtes JSON version 2.3 ou 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, avec les versions 3.0 et 2.4, vous devez enregistrer votre application dans la console Google APIs et utiliser une clé API (ou un jeton OAuth 2.0) dans chaque requête.

Nous avons corrigé un petit bug lié à 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 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

  • L'API Core Reporting 3.0 est la dernière version majeure de notre API. Elle n'est pas rétrocompatible. Tout développement futur de l'API se fera sur cette version.

  • Nouvelles fonctionnalités

    • La nouvelle sortie JSON réduit la taille de la réponse environ 10 fois plus importante que 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.
    • La compatibilité avec OAuth 2.0 est la nouvelle méthode recommandée pour autoriser les utilisateurs.

  • Mises à jour

    • Nouvelle URL pour l'envoi des 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 de quota 503 a été remplacé par 403
    • Les réponses JSON ne sont pas acceptées.
    • La bibliothèque cliente Google Data JavaScript n'est pas compatible.
    • Aucun flux du compte. Toutes les requêtes de données de configuration doivent être effectuées via l' API Management.

Inscription

  • Toutes les applications créées avec 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 du client.

Règles pour les quotas

  • Le quota suivant s'applique aux deux API Anlaytics (API Management et API d'exportation de données).

    • 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 gérer un petit nombre de tests.

Abandons

  • Cette version annonce également l'abandon de la version 2.3 et l'arrêt prochain 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 seront transférées vers la version 2.4 et renvoient une réponse de la version 2.4. À ce stade, toutes les règles de quotas 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 les 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 du compte dans l'API d'exportation de données renvoient 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 inclut des données AdWords plus récentes et davantage de combinaisons de dimensions et de statistiques AdWords.

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

  • Nous avons assoupli certaines restrictions applicables aux combinaisons valides avec 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 retour 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 non valides 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 combinées avec des 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 sans 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 affiche 0,0 pour toutes les valeurs de l'intervalle de confiance. Dans un mois environ, nous supprimerons complètement cet attribut de tous les éléments de statistiques.

    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 mises à jour des données

  • Nous avons ajouté à l'API trois métriques concernant les performances de 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 définie sur 1).

  • ga:CTR renvoie désormais le pourcentage réel (par exemple, une valeur de 2% est renvoyée sous la forme 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 variables 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, une unité de devise est spécifiée comme 1000000). Prochainement, vous devrez indiquer la valeur réelle transmise à partir du code de suivi (par exemple, 1 unité sera désormais spécifiée comme 1).

  • Actuellement, ga:CTR est de type percent et renvoie la valeur 0,02. Dans un avenir proche, cette valeur sera modifiée et le pourcentage réel sera renvoyé (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 divers problèmes d'autorisation. Dans les 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 ajoute 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 davantage de combinaisons de dimensions et de métriques.

  • 10 nouvelles 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 Site Search interne.

  • 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 afin de 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 comprises entre 1 et 20.

  • Basées sur un objectif: 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é sur le contenu: ga:entranceBounceRate, ga:visitBounceRate, ga:entranceRate, ga:exitRate, ga:pageviewsPerVisit, ga:avgTimeOnPage, ga:avgTimeOnSite, ga:avgEventValue.

  • Recherche interne sur site: 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 deux bugs:

Correction de bugs

  • Nous avons précédemment ajouté un opérateur OU à une expression de filtre avec une dimension (par exemple, ga:keyword==store,ga:keyword==bar) pouvait générer des valeurs différentes de celles obtenues si chaque filtre était appliqué individuellement à 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 pour NE PAS indiquer s'il s'agissait d'un filtre de dimension ou de métrique à l'origine de l'erreur (même si l'expression de filtre incriminée continuera 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

  • Un bug qui empêchait le flux du compte de s'afficher en cas de définition incorrecte d'un nom d'objectif, d'un chemin vers l'objectif, d'une valeur de comparaison d'objectif ou d'un type de comparaison d'objectifs 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 et indique: 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'élément AdGroup.id de l'API AdWords.
    • ga:adwordsCampaignId: correspond à l'élément Campaign.id de l'API AdWords.
    • ga:adwordsCreativeId: correspond à l'identifiant 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é un problème qui empêchait le flux du compte de renvoyer de données si un objectif ou une étape était mal configuré pour l'un des profils.

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 inclure désormais les rapports sur tous les appareils mobiles. L'ID est le même que précédemment (-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 alignées sur 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 d'assurer à tous les utilisateurs un accès équitable aux ressources. Veuillez consulter notre documentation sur les règles relatives aux quotas pour en savoir plus. La nouvelle règle est la suivante:

    • Un même site Web ne peut pas effectuer plus de 10 000 requêtes par 24 heures.
    • Une application ne peut effectuer que 10 requêtes sur une période donnée d'une seconde.
    • Une application ne peut avoir que quatre requêtes en attente à la fois.

  • Nous avons assoupli certaines restrictions applicables aux combinaisons de variables et de statistiques. 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 plus d'informations sur ces nouvelles combinaisons, consultez le guide de référence mis à jour.

Correction de bugs

  • Nous avons corrigé un bug dans la manière dont l'API signale la valeur confidenceInterval pour les métriques. Auparavant, les intervalles de confiance pouvaient avoir une valeur de INF ou un nombre compris entre 0 et 1. Désormais, tous les intervalles de confiance auront une valeur 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. Ils sont maintenant corrigés pour renvoyer les données correctes.

Abandon du rappel concernant les dimensions et les 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:

Cette version fait passer le numéro de version majeure à 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 demande de compte ou de flux de données. Consultez la documentation pour en savoir plus.
    • Un nouvel espace de noms XML a été ajouté au compte et aux flux 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. Elle doit respecter la même syntaxe que les filtres.

  • Paramètre de requête pour les segments par défaut et personnalisés:

    • ...&segment=gaid::nombre
    • où "nombre" correspond à un ID faisant référence à un segment avancé défini dans l'interface Web de Google Analytics.
    • est indiqué 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 suivent toutes la convention goal(n)Completions, où (n) est 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 variable personnalisée

  • 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 vont être supprimées.

  • Si vous ne l'avez pas déjà fait, veuillez cesser d'utiliser les dimensions et métriques précédemment abandonnées. Ils seront bientôt supprimés et renverront des erreurs de 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 abandonne certaines anciennes:

  • Les dimensions et métriques suivantes sont désormais obsolètes. Nous allons les supprimer définitivement 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 remplacé par ga:visitsToTransaction

  • Toutes les données du suivi des événements sont désormais 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 globales sur la navigation sur le site sont désormais disponibles via les dimensions suivantes:

    D6. Navigation * ga:previousPagePath * ga:nextPagePath

  • La navigation sur la page de destination est désormais possible à l'aide des 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 dans l'interface utilisateur, sous Visiteurs -> Fidélité des visiteurs) est désormais accessible via la nouvelle dimension:

    • ga:visitLength

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

  • Nous avons assoupli certaines restrictions applicables aux combinaisons de variables et de statistiques. Vous pouvez désormais interroger la plupart des dimensions de contenu et de niveau visiteur ensemble. Par exemple, ga:pagePath et ga:source est désormais une combinaison valide. Veuillez consulter 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 requête est passé à 10 000. Le nombre de lignes renvoyées par défaut est toujours de 1 000, mais vous pouvez maintenant l'augmenter en définissant le paramètre de requête max-results.

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

  • Désormais, les requêtes de données doivent inclure 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:

  • Vous ne pourrez plus ajouter de nom d'utilisateur aux demandes de flux de compte. Seules les requêtes respectant le format suivant sont acceptées:
    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.

    Recherche :

    objectif : ga:ga:ga:ga: com cible : autrement : com cible : ga:ga:ga: complément:1ga:ga:compasse : autrement : comp :objectif : com cible : autrement : comp :objectif : com cible : autrement : com,