Langage de requête Search Ads 360

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 et SearchStream.

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

  • 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'instances SearchAds360Field:

  • 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 objet campaign.
  • 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 champ metrics 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.

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 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 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 ou campaign) ou un champ (tel que campaign.id, metrics.impressions ou ad_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: