L'API Search Ads 360 Reporting est basée sur une plate-forme moderne et introduit un certain nombre de nouveaux concepts. Celles-ci sont décrites dans les sections suivantes.
Ressources
Les objets "resource" remplacent les types de rapports. Au lieu de demander des types de rapports prédéfinis, vous pouvez désormais interroger toutes les ressources à l'aide d'un nouveau langage de requête de type SQL. Pour en savoir plus, consultez Structure de l'API Search Ads 360 Reporting.
Rapports sur la recherche
La recherche Google dispose de son propre service dans la nouvelle API. Le service Recherche remplace l'ancien service Rapports. Toutes les requêtes passent par SearchAds360Service, qui fournit deux méthodes, SearchStream et Search, pour rechercher et récupérer des données et des métriques de rapport. Les deux méthodes de recherche renvoient tous les objets SearchAds360Row correspondant à votre requête de recherche. Pour en savoir plus, consultez Créer des rapports de recherche.
Métadonnées de ressources
SearchAds360FieldService vous permet de demander de manière dynamique le catalogue pour les ressources, les champs de ressources, les clés de segmentation et les métriques disponibles dans les méthodes de recherche SearchAds360Service. Pour en savoir plus, consultez la section Récupérer les métadonnées de ressources.
Noms des champs
L'API introduit des noms de champs imbriqués séparés par la notation par points. Par exemple, campaign.id et ad_group.id. Vous pouvez également imbriquer davantage, par exemple ad_group.campaign.id. Pour en savoir plus, consultez Structure de l'API Search Ads 360 Reporting.
Dans l'ancienne API Search Ads 360, les rapports sont basés sur des champs distincts de différentes entités pour des concepts similaires. Par exemple, les rapports campaign et adgroup incluent un champ campaignId distinct.
Langage de requête
L'API introduit le langage de requête Search Ads 360. Il s'agit d'un langage flexible de type SQL qui vous permet de définir des requêtes afin de récupérer les données de rapport spécifiques qui conviennent le mieux à votre entreprise. Pour en savoir plus, consultez la page Langage de requête Search Ads 360.
Demandes d'obtention
Dans la nouvelle API, la recherche dispose de son propre service (SearchAds360Service), mais des requêtes GET existent toujours sur le service spécifique de chaque entité. Par exemple, vous pouvez obtenir des informations sur les colonnes personnalisées à partir de CustomColumnService. Pour en savoir plus, consultez Modifications du format dans l'API Search Ads 360 Reporting.
Colonnes personnalisées
Dans la nouvelle interface Search Ads 360, les colonnes de formules et les conversions personnalisées sont appelées colonnes personnalisées. En savoir plus sur les colonnes personnalisées Le nouveau CustomColumnService active les colonnes personnalisées. Si vous disposez des autorisations nécessaires, vous pouvez demander des ressources CustomColumn appartenant à n'importe quel compte dans l'arborescence des comptes.
Gestion de compte
La nouvelle interface Search Ads 360 organise les comptes selon une hiérarchie de comptes administrateur, administrateur secondaire et client. Un compte administrateur représente le compte d'agence, tandis que les comptes administrateur secondaires représentent les comptes d'annonceur dans l'ancienne interface Search Ads 360. Pour en savoir plus, consultez À propos des comptes administrateur Search Ads 360.
Vous pouvez interroger l'arborescence des comptes, puis envoyer des demandes pour chaque compte à partir duquel vous souhaitez générer des données de rapport.
En raison de la modification de la hiérarchie des comptes, les champs liés au concept annonceur/agence ont été remplacés par des alternatives appropriées pour assurer la parité fonctionnelle dans la mesure du possible. Consultez la section Mappages de champs pour obtenir la liste des champs concernés et de leurs substituts.
En-tête du numéro client de connexion
login-customer-id est un nouvel en-tête obligatoire lorsque vous utilisez un compte administrateur pour accéder à un compte administrateur secondaire ou client. Pour en savoir plus, consultez la section En-tête d'ID client de connexion.
Gestion des versions
L'API Search Ads 360 Reporting utilise la gestion sémantique des versions.
Il existe des versions majeures et mineures, au format vMAJOR_MINOR. Pour en savoir plus, consultez la section Gestion des versions.