Google Analytics – Tous les journaux des modifications de l'API de configuration

Cette page décrit toutes les modifications apportées aux API de configuration Google Analytics. Elle inclut les journaux de modifications de l'API de provisionnement et de l'API de gestion. 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 répertoriés dans la section S'abonner ci-dessous.

S'abonner aux journaux de modifications associés

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

Inclut l'API de gestion et l'API de provisionnement.

Paramètres de conservation des données utilisateur dans l'API Management

Il est désormais possible de configurer de manière programmatique les paramètres de conservation des données utilisateur à l'aide des nouveaux champs "dataConservationTtl" et "dataResumeOnNewActivity" ajoutés à la ressource WebProperty.

Voici la version initiale de l'API User Deletion:

  • L'API User Deletion permet à un client Google Analytics de supprimer les données d'un utilisateur final donné dans un projet ou une propriété Web. Les demandes de suppression d'utilisateur peuvent être effectuées à l'aide de projets Firebase ou de propriétés Google Analytics. Pour en savoir plus, consultez la présentation de l'API User Deletion.

Opérations d'écriture dans l'API Management

Vous n'avez plus besoin d'inclure les opérations d'écriture dans l'API Management (création, mise à jour, suppression, correctif, etc.) pour les propriétés Web, les vues (profils) et les objectifs dans la liste d'autorisation. La limite quotidienne par défaut pour toutes les opérations d'écriture dans l'API Management est de 50 écritures/jour. Pour en savoir plus, consultez la page Limites et quotas.

Custom Metrics (Métriques personnalisées)

Cette version corrige un bug. Elle résout le problème qui empêchait la création d'une métrique personnalisée de type TIME lorsque min_value n'était pas défini. Les requêtes sans min_value créent désormais une métrique personnalisée avec un min_value par défaut de 0.

Devises

Cette version corrige un bug. Elle permet de résoudre un problème qui empêchait la prise en charge d'un sous-ensemble de devises dans l'interface Web Analytics, mais pas dans l'API. Cette version est compatible avec les devises suivantes:

  • UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL

Pour en savoir plus, consultez les ressources suivantes: - Documentation de référence sur les vues (profils). - Article du centre d'aide Référence des devises.

Cette version ajoute les audiences de remarketing à l'API Management.

Audiences de remarketing

L'API Management vous permet d'create, de get, de list, de update et d'audiences de remarketing patch pour une propriété Google Analytics. Pour en savoir plus sur le fonctionnement des audiences de remarketing, consultez l'article À propos des audiences de remarketing dans Analytics du centre d'aide.

Rapports non échantillonnés

L'API de rapports non échantillonnés n'est plus limitée à 100 rapports par jour. L'API utilise le même système de jetons par propriété, par jour que lors de la création d'un rapport non échantillonné via l'interface Web.

Rapports non échantillonnés

Le message de réponse de l'API de gestion ne contiendra plus de lien de téléchargement pour les rapports non échantillonnés auxquels l'utilisateur actuel n'a pas accès. Ce comportement est désormais cohérent avec le tableau de bord de l'interface utilisateur, où seuls les propriétaires de rapports peuvent voir le lien de téléchargement du document généré.

Segments

Cette version corrige un bug. Dans cette version, les segments comportant des valeurs de devise dans la définition s'affichaient de manière incorrecte lors de l'appel de la méthode Liste de segments.

Segments

Cette version corrige un bug. Cette version corrige un problème à cause duquel les utilisateurs dont les segments privés étaient épinglés à plusieurs vues (profils) entraînaient une erreur 500 lors de l'appel de la méthode de liste de segments.

Cette version ajoute un paramètre supplémentaire à l'URL des conditions d'utilisation de l'API de provisionnement:

  • L'ajout du paramètre d'URL provisioningSignup=false permet de résoudre un problème qui survenait lors du provisionnement d'un compte Google Analytics pour un utilisateur sans compte Google Analytics. Les développeurs doivent mettre à jour leur code pour ajouter ce paramètre à l'URL des conditions d'utilisation.

Vues (profils)

Dans cette version, la propriété currency de la vue (profil) est désormais définie par défaut sur USD si elle n'est pas définie lors d'une opération insert. De plus, les opérations get et list renverront USD pour les vues (profils) précédemment créées sans propriété currency.

Filtres

Cette version marque la suppression finale des champs de filtre obsolètes IS_MOBILE et IS_TABLET, qui doivent être remplacés par DEVICE_CATEGORY=mobile et DEVICE_CATEGORY=tablet. Les requêtes d'insertion, de mise à jour et de correctif qui définissent les champs de filtre sur IS_MOBILE et IS_TABLET renvoient une erreur.

Filtres

Cette version permet d'utiliser une dimension personnalisée pour un champ de filtre en ajoutant une propriété fieldIndex à toutes les sections des détails du filtre. Par exemple, vous pouvez désormais définir l'expression de filtre avec "field": "CUSTOM_DIMENSION" et "fieldIndex": "1" pour que le filtre fonctionne sur la première dimension personnalisée.

Buts

Cette version résout également un problème qui entraînait l'échec de la création d'un objectif avec "comparisonValue": "0".

Cette version marque l'abandon et la suppression finaux de la ressource dailyUpload. La ressource dailyUpload a été officiellement abandonnée le 20 juin 2014. Toutes les données de coût doivent désormais être importées à l'aide de la ressource d'importation.

Cette version ajoute deux nouvelles collections à l'API Management : les dimensions personnalisées et les métriques personnalisées.

Statistiques et dimensions personnalisées

Vous pouvez désormais créer, répertorier, récupérer, corriger et mettre à jour des dimensions et métriques personnalisées avec l'API Management.

La réponse de la méthode list pour toutes les collections inclut désormais une liste vide pour la propriété items lorsque la collection ne contient aucune ressource. Auparavant, la propriété items était omise de la réponse. Consultez la documentation de référence de l'API afin d'obtenir des informations complètes sur les requêtes et les réponses pour les données de configuration Google Analytics.

Cette version introduit un nouveau champ d'application pour l'API de gestion de Google Analytics. - analytics.manage.users.readonly - Affichez les autorisations des utilisateurs de Google Analytics.

Un nouveau champ de filtres DEVICE_CATEGORY a été ajouté, et IS_MOBILE et IS_TABLET sont désormais obsolètes. Utilisez DEVICE_CATEGORY=mobile et DEVICE_CATEGORY=tablet.

La ressource Vue (profil) inclut à présent une propriété enhancedECommerceTracking qui indique si l'e-commerce amélioré est activé (true) ou désactivé (false).

Cette version inclut de nouveaux types d'importation de données et l'abandon de la ressource dailyUpload.

Importation de données

Consultez le Guide du développeur sur l'importation de données pour découvrir comment utiliser l'API de gestion pour importer des données dans votre compte Google Analytics.

Mises en ligne

  • La ressource upload accepte désormais les types d'importation suivants :
    • Données de la campagne
    • Données relatives au contenu
    • Données de coût
    • Données relatives aux produits
    • Données relatives aux rejets de débit
    • Données utilisateur
  • La ressource upload dispose d'une nouvelle méthode migrateDataImport pour migrer les données de coût existantes customDataSources.

Abandon des importations quotidiennes

  • La ressource dailyUpload est désormais obsolète. Consultez le guide de migration pour savoir comment utiliser la fonctionnalité Importation de données.
  • La ressource dailyUpload continuera de fonctionner pendant six mois supplémentaires, après quoi tout customDataSources restant avec la propriété uploadType définie sur analytics#dailyUploads sera automatiquement migré et ne fonctionnera qu'avec la ressource upload.
  • Les utilisateurs actuels de la ressource dailyUpload doivent mettre à jour leur code et migrer vers la ressource d'importation dès que possible.

Voici la version initiale de l'API de gestion des comptes:

  • L'API de gestion des comptes peut être utilisée pour créer des comptes Google Analytics de manière automatisée. Cette API n'est disponible que sur invitation. Elle est destinée aux fournisseurs de services qualifiés et aux partenaires de grande taille. Pour plus d'informations, consultez la page Présentation de l'API de gestion des comptes.

Cette version ajoute deux nouvelles API de configuration.

Filtres

Rapports non échantillonnés: API Management

Nous ajoutons une ressource Rapports non échantillonnés à l'API Management. Les rapports non échantillonnés sont les rapports Google Analytics (GA) générés à l'aide de données non échantillonnées.Les rapports non échantillonnés ne sont actuellement disponibles que pour les utilisateurs de GA Premium. 

Segments: API Management v2.4 et v3.0

Les modifications suivantes ont été apportées à la collection de segments:

  • Les segments d'utilisateurs et de séquences sont désormais compatibles avec l'API.
  • La collection de segments renvoie désormais tous les segments intégrés et personnalisés au niveau de la session et au niveau de l'utilisateur.
  • La propriété definition des segments utilise désormais la nouvelle syntaxe pour les segments. Cela inclut les définitions des segments existants au niveau de la session, qui passeront de definition: "" à definition: "sessions::condition::".
  • Une nouvelle propriété type a été ajoutée à la ressource Segment pour indiquer si un segment est CUSTOM (créé par un utilisateur dans l'interface Web) ou BUILT_IN (fourni par Google Analytics).

Tests

Les métriques AdSense suivantes peuvent désormais être utilisées comme objectifs d'optimisation:

  • ga:adsenseAdsClicks : nombre de fois où les utilisateurs ont cliqué sur les annonces AdSense de votre site.
  • ga:adsenseAdsViewed : nombre d'annonces AdSense vues. Un bloc d'annonces peut contenir plusieurs annonces.
  • ga:adsenseRevenue : total des revenus générés par les annonces AdSense.

Nouvelle collection "Résumés du compte"

Les modifications suivantes ont été apportées aux segments par défaut en raison de l'abandon des dimensions ga:isMobile et ga:isTablet:

  • Le segment gaid::-11 a été renommé Trafic sur mobile par Trafic sur mobile et tablette. La définition de ce segment est passée de "ga:isMobile==Yes" à "ga:deviceCategory==mobile,ga:deviceCategory==tablet". Notez que ga:isMobile incluait le trafic provenant des tablettes, ce qui est reflété dans la nouvelle définition. Si vous souhaitez seulement enregistrer le trafic sur mobile, à l'exception des tablettes, passez au nouveau segment Trafic sur mobile (gaid::-14).
  • La définition du segment gaid::-13 est passée de ga:isTablet==Yes à ga:deviceCategory==tablet. Elle continue de représenter le trafic des tablettes.
  • Le segment gaid::-14 a été ajouté. Le nom du segment est Trafic sur mobile et sa définition est ga:deviceCategory==mobile.

Corrections de bugs:

  • Les informations de fuseau horaire pour les vues (profils) ont été corrigées. Détails: Avant ce correctif, dans certains cas, lors de la création de listes de vues (profils) dans l'API Management, des informations de fuseau horaire incorrectes pour une vue (profil) étaient renvoyées. Le fuseau horaire des vues (profils) est désormais le même que celui défini dans l'interface d'administration de Google Analytics.

Cette version présente les opérations d'écriture pour les ressources de propriété Web, de vue (profil) et d'objectif, ainsi qu'un ensemble de trois nouvelles ressources permettant de gérer les autorisations des utilisateurs.

API de configuration et de configuration du compte

Autorisations des utilisateurs dans l'API Management

  • La nouvelle ressource accountUserLinks permet de gérer les autorisations de compte pour les utilisateurs.
  • La nouvelle ressource webpropertyUserLinks permet de gérer les autorisations de propriété pour les utilisateurs.
  • La nouvelle ressource profileUserLinks permet de gérer les autorisations de vue (profil) pour les utilisateurs.
  • Les autorisations d'un utilisateur autorisé sont désormais disponibles dans les ressources Compte, Propriété Web et Vue (profil).
  • Un nouveau champ d'application a été introduit. Il est requis pour gérer les autorisations des utilisateurs. https://www.googleapis.com/auth/analytics.manage.users.
  • Pour en savoir plus, consultez le Guide du développeur sur les autorisations utilisateur.

Dans le cadre du lancement de nouveaux segments, nous apporterons les modifications suivantes à la collection de segments:

  • Tous les ID de segment passeront d'entiers positifs à des chaînes alphanumériques. Si vous avez enregistré les ID de segment des utilisateurs, nous vous recommandons de les mettre à jour afin qu'ils utilisent les nouveaux ID.
  • La collection de segments n'affiche que les segments existants au niveau des visites. Les nouveaux segments de visiteurs, de cohortes et de séquences ne sont actuellement pas compatibles avec l'API.
  • La collection de segments continuera d'afficher les segments par défaut existants avec les mêmes identifiants numériques à exclure. Toutefois, les nouveaux segments par défaut ne sont actuellement pas compatibles.

Cette version ajoute deux nouvelles propriétés à la ressource Webproperty:

  • profileCount : renvoie le nombre de profils associés à une propriété. Cela vous permet de filtrer les propriétés qui n'ont pas de profil (par exemple, profileCount = 0).
  • industryVertical : affiche le secteur/la catégorie sélectionné pour une propriété.

Corrections de bugs:

  • La propriété eCommerceTracking de la ressource de profil est désormais cohérente avec les paramètres d'e-commerce de la section "Administration" de l'interface Web. Renvoie true lorsque le suivi de l'e-commerce est activé, et false dans le cas contraire.
  • La ressource Webproperty inclut désormais une propriété level pour indiquer si la propriété Web est PREMIUM ou STANDARD.
  • Un nouveau point de terminaison a été ajouté à la version 3 de l'API Management pour pouvoir accéder aux ressources de tests et les modifier.
  • La ressource Profile inclut désormais une propriété type permettant de déterminer si un profil est configuré pour un site Web ou une application. Les deux valeurs possibles sont WEB ou APP.

Cette version ajoute des réponses d'erreur utiles à l'API Management.

  • De nouveaux codes d'erreur, motifs et descriptions ont été ajoutés au corps des réponses d'erreur de l'API. Tous les codes ont été documentés pour les versions (version 2.4 et version 3.0) de l'API Management.

Cette version ajoute des données, modifie des fonctionnalités existantes et corrige un bug.

Nouvelles données

  • La collection de segments avancés contient désormais un champ segmentId qui peut être utilisé dans le paramètre segment de l'API d'exportation des données.

Changements

  • Le type de données pour max-results a été remplacé par integer.

  • La valeur par défaut et maximale de max-results a été remplacée par 1 000.

Correction de bugs

  • Les comptes, sites Web et profils des tests réalisés avec l'Optimiseur de Site Google ne sont plus inclus dans les collections correspondantes.

Cette version ajoute deux nouvelles versions de l'API avec de nombreuses nouvelles fonctionnalités et abandonne l'ancienne version. Ces modifications ont un impact sur la manière dont vous demandez et traitez les données de l'API.

Version 3.0

  • Il s'agit de la dernière version majeure de notre API et n'est pas rétrocompatible. Tout le développement futur de l'API s'effectuera sur cette version.

  • Nouvelles données

    • Représentation complète des objectifs d'événement
    • ID de propriété Web interne pouvant être utilisé pour créer un lien profond dans l'interface utilisateur GA.
    • Configurations de profil pour les paramètres de requête de recherche sur les pages et les sites par défaut
  • Changements

Version 2.4

  • Il s'agit d'une mise à niveau de version mineure qui est principalement rétrocompatible avec la version 2.3 existante.

  • Changements

    • Une nouvelle règle de quotas
    • Intégration dans la console Google APIs pour gérer l'accès aux API et demander plus de quotas
    • Maintien de la compatibilité avec les mécanismes d'autorisation existants et OAuth 2.0
    • Nouvelle URL pour l'envoi des requêtes: https://www.googleapis.com/analytics/v2.4/management/…
    • Réponses en XML uniquement
    • Incompatibilité avec la bibliothèque cliente JavaScript Google Data
    • La sortie XML est cohérente avec la version 2.3. Les autres bibliothèques clientes Google Data existantes continueront donc de fonctionner.

Obsolescence

  • Nous annonçons l'abandon de l'ancienne version 2.3 de l'API Management. Elle continuera de fonctionner pendant deux mois, après quoi toutes les requêtes v2.3 renverront une réponse v2.4.

Il s'agit de la version bêta de l'API de gestion de Google Analytics.

Nouveaux flux

Bibliothèques clientes mises à jour

  • L'API de gestion est disponible dans la même bibliothèque que l'API d'exportation de données Google Analytics. Les bibliothèques Java et JavaScript de Google Data ont été mises à jour. Pour accéder à chaque flux, spécifiez l'URI du flux approprié dans la méthode getManagementFeed() des bibliothèques.

Nouvelle documentation

  • Une nouvelle section de la documentation destinée aux développeurs Google Analytics a été créée pour décrire le fonctionnement de la nouvelle API Management.