Langage de requête Search Ads 360

Le langage de requêtes 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.

Services de recherche

Vous pouvez utiliser le langage de requête Search Ads 360 pour interroger l'API à l'aide des éléments suivants:

SearchAds360Service

Utilisez ce service pour interroger les ressources et leurs attributs, segments et métriques associés. Il existe deux méthodes : Search et SearchStream.

Les requêtes SearchAds360Service renvoient une liste d'instances SearchAds360Row:

  • Chaque ligne représente une ressource.
  • Si vous le souhaitez, les lignes incluent des attributs et des champs de métrique.
  • 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 sur les recherches.

SearchAds360FieldService

Utilisez ce service pour interroger les métadonnées sur les champs et les ressources disponibles. Le service fournit un catalogue de champs pouvant être interrogés avec des informations spécifiques sur leur compatibilité et leur type.

SearchAds360FieldService renvoie une liste d'instances SearchAds360Field:

  • Chaque champ contient des informations sur le champ demandé.

Pour en savoir plus, consultez 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.

Interroger 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 objet campaign.
  • Les lignes sont renseignées avec les champs sélectionnés (y compris l'resource_name de la campagne donnée).
  • La requête est triée par ID de campagne.

Consultez campaign pour connaître les autres champs disponibles que vous pouvez utiliser dans vos requêtes.

Interroger les métriques

Voici 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 plus de 1 000 impressions.
  • Chaque SearchAds360Row renvoyé comporte un champ metrics renseigné avec les métriques sélectionnées.
  • La requête est triée par ID de campagne.

Consultez metrics pour découvrir les autres métriques disponibles que vous pouvez utiliser dans vos requêtes.

Requête pour des segments

Voici 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 plus de 1 000 impressions.
  • Il segmente les données par date.
  • À la suite de la segmentation, chaque SearchAds360Row représente un tuple d'une campagne et du segment de date.
  • La requête est triée par ID de campagne.

Consultez segments pour obtenir la liste des segments que vous pouvez utiliser dans vos requêtes et Segmentation pour en savoir plus sur la segmentation de vos rapports.

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 de chaque campagne sélectionnée.
  • Chaque SearchAds360Row renvoyé représente un objet campaign 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 campaign pour savoir quelles ressources attribuées sont disponibles pour les requêtes de campagne.

Interroger les métadonnées d'un champ

Vous pouvez utiliser SearchAds360FieldService pour récupérer les métadonnées de 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 (par exemple, customer ou campaign) ou un champ (par exemple, campaign.id, metrics.impressions ou ad_group.id).

Pour en savoir plus sur la récupération des métadonnées de champ, 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: