L'API Search Ads 360 Reporting s'appuie sur une plate-forme moderne et introduit plusieurs nouveaux concepts. Ils 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 rapport. Les deux méthodes de recherche renvoient tous les objets SearchAds360Row qui correspondent à votre requête de recherche. Pour en savoir plus, consultez la page
Créer des rapports de recherche.
Métadonnées de ressources
SearchAds360FieldService
vous permet de demander dynamiquement le catalogue des ressources, des champs de ressources, des clés de segmentation et des métriques disponibles dans les méthodes de recherche SearchAds360Service. Pour en savoir plus, consultez la page 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 la page
Structure de l'API Search Ads 360 Reporting.
Les rapports de 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
campaign et
adgroup rapports 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 pour récupérer les données de rapport spécifiques les mieux adaptées à votre entreprise. Pour en savoir plus, consultez la page Langage de requête 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 du format dans l'API Search Ads 360 Reporting.
Colonnes personnalisées
Dans le nouveau 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 de l'arborescence des comptes.
Gestion des comptes
Le nouveau 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 la page À propos des comptes administrateur Search Ads 360.
Vous pouvez interroger l'arborescence des comptes puis envoyer des requêtes pour chaque compte à partir duquel vous souhaitez obtenir des données de rapport.
En raison de la modification 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 d'assurer une parité fonctionnelle dans la mesure du possible. Pour obtenir la liste des champs concernés et de leurs substituts, consultez la page Mappages de champs.
En-tête du numéro client utilisé pour la connexion
login-customer-id est un nouvel en-tête requis lorsque vous utilisez un compte administrateur pour accéder à un compte administrateur secondaire ou client. Pour en savoir plus, consultez la page
En-tête du numéro client utilisé pour la 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 page
Gestion des versions.