L'API Search Ads 360 Reporting s'appuie sur une plate-forme moderne et introduit plusieurs nouveaux concepts. Ces éléments sont décrits dans les sections suivantes.
Ressources
Les objets de ressources 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 la page Structure de l'API Search Ads 360 Reporting.
Rapports de recherche
La recherche dispose de son propre service dans la nouvelle API. Le service de recherche remplace l'ancien service de 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 reporting. Les deux méthodes de recherche renvoient tous les objets SearchAds360Row correspondant à votre requête de recherche. Pour en savoir plus, consultez la section Créer des rapports sur les recherches.
Métadonnées de ressources
SearchAds360FieldService vous permet de demander de manière dynamique au catalogue 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 ressource.
Noms des champs
L'API introduit des noms de champs imbriqués séparés par la notation en 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 la page Structure de l'API Search Ads 360 Reporting.
Les rapports dans l'ancienne API Search Ads 360 sont basés sur des champs distincts sur 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êtes Search Ads 360. Il s'agit d'un langage flexible, semblable à SQL, qui vous permet de définir des requêtes pour récupérer les données de reporting spécifiques qui correspondent le mieux à votre entreprise. Pour en savoir plus, consultez le langage de requêtes Search Ads 360.
Requêtes GET
Dans la nouvelle API, la recherche dispose de son propre service (SearchAds360Service), mais les 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 la page Modifications de 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 La nouvelle CustomColumnService permet d'utiliser des colonnes personnalisées. Si vous disposez des autorisations nécessaires, vous pouvez demander des ressources CustomColumn appartenant à n'importe quel compte de l'arborescence.
Gestion des comptes
La nouvelle interface Search Ads 360 organise les comptes dans une hiérarchie de comptes administrateur, de comptes administrateur secondaire et de comptes client. Un compte administrateur représente le compte d'agence, et les comptes administrateur secondaire correspondent aux 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 obtenir des données de rapport.
En raison du changement de la hiérarchie des comptes, les champs liés au concept d'annonceur/d'agence ont été remplacés par des alternatives appropriées afin de fournir une parité fonctionnelle dans la mesure du possible. Consultez la section Mappages de champs pour obtenir la liste des champs concernés et 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 de l'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.