Journal des modifications de l'API de création de rapports sur les entonnoirs multicanaux Google Analytics

Nous mettons régulièrement à jour l' API de création de rapports sur les entonnoirs multicanaux 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 de création de rapports sur les entonnoirs multicanaux de Google Analytics susceptibles d'avoir une incidence sur votre application. Nous recommandons aux développeurs d'API de consulter régulièrement cette liste pour prendre connaissance des nouvelles annonces. Vous pouvez également vous abonner aux modifications via les flux listés dans la section S'abonner ci-dessous.

S'abonner aux journaux de modifications associés

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

Inclut l'API 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.

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

ID de la transaction

  • dimension mcf:transactionId : ID de la transaction, fourni par la méthode de suivi de l'e-commerce, pour l'achat effectué dans le panier.

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.

Chemins de conversion

  • dimension – mcf:dcmAd : nom de l'annonce DCM de l'événement DCM (impression ou clic) correspondant à la conversion Google Analytics.
  • mcf:dcmAdPath : chemin de conversion dans lequel les interactions sont représentées par des annonces DCM.
  • dimension – mcf:dcmAdType : nom du type d'annonce DCM associé à l'événement DCM (impression ou clic) correspondant à la conversion Google Analytics.
  • dimension – mcf:dcmAdvertiser : nom de l'annonceur DCM associé à l'événement DCM (impression ou clic) correspondant à la conversion Google Analytics.
  • mcf:dcmAdvertiserPath : chemin de conversion dans lequel les interactions sont représentées par des annonceurs DCM.
  • dimension - mcf:dcmCampaign - nom de la campagne DCM de l'événement DCM (impression ou clic) correspondant à la conversion Google Analytics.
  • mcf:dcmCampaignPath : chemin de conversion dans lequel les interactions sur le chemin sont représentées par des campagnes DCM
  • dimension - mcf:dcmCreative - nom de la création DCM de l'événement DCM (impression ou clic) correspondant à la conversion Google Analytics.
  • - mcf:dcmCreativePath : chemin avant conversion dans lequel les interactions sont représentées par des créations DCM.
  • dimension – mcf:dcmCreativeVersion : version de la création DCM de l'événement DCM (impression ou clic) correspondant à la conversion Google Analytics.
  • mcf:dcmCreativeVersionPath : chemin de conversion dans lequel les interactions sont représentées par des versions de la création DCM.
  • dimension - mcf:dcmNetwork : réseau utilisé
  • dimension – mcf:dcmPlacement : nom de l'emplacement de site DCM de l'événement DCM (impression ou clic) correspondant à la conversion Google Analytics.
  • mcf:dcmPlacementPath : chemin de conversion dans lequel les interactions sont représentées par des emplacements DCM.
  • dimension – mcf:dcmSite : nom du site DCM sur lequel la création DCM a été diffusée pour l'événement DCM (impression ou clic) correspondant à la conversion Google Analytics.
  • mcf:dcmSitePath : chemin de conversion dans lequel les interactions sont représentées par des sites DCM.
  • métrique - mcf:firstImpressionConversions : nombre de conversions pour lesquelles une impression de campagne DCM correspond à la première interaction avec une conversion au cours d'une période d'analyse de 30 jours. Cette dimension inclut à la fois les objectifs réalisés et les transactions.
  • métrique – mcf:firstImpressionValue : valeur des conversions pour lesquelles une impression de campagne DCM a été la première interaction avec une conversion au cours d'une période d'analyse de 30 jours. Cette dimension inclut à la fois les objectifs réalisés et les transactions.
  • métrique : mcf:impressionAssistedConversions : nombre de conversions pour lesquelles une impression de campagne DCM est apparue dans le chemin de conversion, mais n'a pas constitué l'interaction finale avant la conversion. Cette dimension inclut à la fois les objectifs réalisés et les transactions.
  • métrique – mcf:impressionAssistedValue : valeur des conversions pour lesquelles une impression de campagne DCM est apparue dans le chemin de conversion, mais n'a pas constitué l'interaction finale avant la conversion. Cette dimension inclut à la fois les objectifs réalisés et les transactions.

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.

Chemins de conversion

  • Dimension mcf:adwordsCustomerIDPath : séquence du numéro client AdWords le long des chemins de conversion.

Interactions

  • Dimension mcf:adwordsCustomerID : correspond à l'API AdWords Customer.id.

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.

Chemins de conversion

  • Dimension mcf:adwordsAdGroupIDPath : séquence de l'ID du groupe d'annonces AdWords le long des chemins de conversion.
  • Dimension mcf:adwordsCampaignIDPath : suite de l'ID de campagne AdWords le long des chemins de conversion.
  • Dimension mcf:adwordsCreativeIDPath : séquence de l'ID de la création AdWords le long des chemins de conversion.
  • Dimension mcf:adwordsCriteriaIDPath : séquence des ID de critères AdWords le long des chemins de conversion.

Interactions

  • Dimension mcf:adwordsAdGroupID : correspond à l'API AdWords AdGroup.id.
  • Dimension mcf:adwordsCampaignID : correspond à l'API AdWords Campaign.id.
  • Dimension mcf:adwordsCreativeID : correspond à l'API AdWords Ad.id.
  • Dimension mcf:adwordsCriteriaID : correspond à l'API AdWords Criterion.id.

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 de création de rapports sur les entonnoirs multicanaux. 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.

Voici la version initiale de l'API de création de rapports sur les entonnoirs multicanaux:

  • Cette nouvelle API vous permet de demander les données des entonnoirs multicanaux pour un utilisateur authentifié. Les données sont issues des données du chemin de conversion, qui montrent les interactions des utilisateurs avec différentes sources de trafic au cours de plusieurs visites, avant la conversion. Vous pouvez ainsi analyser l'impact de plusieurs canaux marketing sur les conversions au fil du temps. Pour en savoir plus sur les données disponibles et sur la manière d'utiliser l'API, consultez la page API des rapports sur les entonnoirs multicanaux.