Le langage de requête Search Ads 360 vous permet de créer des requêtes de recherche pour récupérer des données de rapport et des métadonnées de ressources à l'aide de l'API Search Ads 360 Reporting.
Rechercher des services
Vous pouvez interroger l'API à l'aide du langage de requête Search Ads 360 à l'aide des éléments suivants:
SearchAds360Service
Utilisez ce service pour interroger des ressources et leurs attributs, segments et métriques associés. Il existe deux méthodes :
Search
etSearchStream
.Les requêtes
SearchAds360Service
renvoient une liste d'instancesSearchAds360Row
:- Chaque ligne représente une ressource.
- Si nécessaire, les lignes incluent des champs d'attributs et de métriques.
- Si vous demandez des segments, des lignes supplémentaires sont incluses pour chaque tuple segment-ressource.
Pour en savoir plus, consultez Créer des rapports de recherche.
SearchAds360FieldService
Utilisez ce service pour interroger des métadonnées sur les champs et les ressources disponibles. Le service fournit un catalogue de champs interrogeables avec des détails sur leur compatibilité et leur type.
SearchAds360FieldService
renvoie une liste d'instancesSearchAds360Field
:- Chaque champ contient des informations sur le champ demandé.
Pour en savoir plus, consultez la section Récupérer les métadonnées de ressources.
Exemples de requêtes de base
Les sections suivantes fournissent des exemples de requêtes de base que vous pouvez adapter pour créer vos propres requêtes.
Requête pour les attributs d'une ressource
Il s'agit d'une requête de base pour les attributs de la ressource campaign
, qui renvoie l'ID, le nom et l'état de la campagne:
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
- Chaque
SearchAds360Row
renvoyé représente un objetcampaign
. - Les lignes sont renseignées avec les champs sélectionnés (y compris le
resource_name
de la campagne donnée). - La requête trie par ID de campagne.
Consultez la section campaign
pour découvrir les autres champs disponibles que vous pouvez utiliser dans vos requêtes.
Requête pour des métriques
Il s'agit d'une requête de base pour les métriques liées aux attributs de la ressource campaign
:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
ORDER BY campaign.id
- La requête renvoie les campagnes avec l'état
PAUSED
et ayant enregistré plus de 1 000 impressions. - Chaque
SearchAds360Row
renvoyé comporte un champmetrics
renseigné avec les métriques sélectionnées. - La requête trie par ID de campagne.
Pour connaître les autres métriques disponibles que vous pouvez utiliser dans vos requêtes, consultez la section metrics
.
Requête pour des segments
Il s'agit d'une requête de base pour les segments liés aux attributs de la ressource campaign
:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions,
segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
- La requête renvoie les campagnes avec l'état
PAUSED
et ayant enregistré plus de 1 000 impressions. - Il segmente les données par date.
- En raison de la segmentation, chaque
SearchAds360Row
représente un tuple d'une campagne et le segment de date. - La requête trie par ID de campagne.
Consultez la section segments
pour obtenir la liste des segments que vous pouvez utiliser dans vos requêtes et la section Segmentation pour en savoir plus sur la segmentation de vos rapports.
Requête pour les attributs d'une ressource associée
Il s'agit d'une requête de base sur la ressource campaign
qui joint les attributs de la ressource bidding_strategy
, le cas échéant. Ce type de ressource associée est appelé ressource attribuée.
SELECT
campaign.id,
campaign.name,
campaign.status,
bidding_strategy.name
FROM campaign
ORDER BY campaign.id
- La requête sélectionne les attributs de campagne et les attributs associés pour chaque campagne sélectionnée.
- Chaque
SearchAds360Row
renvoyé représente un objetcampaign
renseigné avec les attributs de campagne sélectionnés, ainsi que l'attribut de stratégie d'enchères sélectionné,bidding_strategy.name
.
Consultez la section campaign
pour savoir quelles ressources attribuées sont disponibles pour les requêtes de campagne.
Requête pour les métadonnées de champ
Vous pouvez utiliser SearchAds360FieldService
pour récupérer les métadonnées d'un champ.
Voici une requête de base pour les métadonnées de champ:
SELECT name, category, selectable, filterable, sortable, selectable_with, data_type, is_repeated WHERE name = RESOURCE/FIELD
- Remplacez RESOURCE OR FIELD par une ressource (telle que
customer
oucampaign
) ou un champ (tel quecampaign.id
,metrics.impressions
ouad_group.id
).
Pour en savoir plus sur la récupération des métadonnées de champs, consultez la section Récupérer les métadonnées de ressources.
En savoir plus
Découvrez comment créer des requêtes dans l'API Search Ads 360 Reporting: