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 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 des ressources et leurs attributs, segments, et les métriques. 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 segment tuple segment-ressource.

Consultez l'article Créer des rapports de recherche pour en savoir plus plus d'informations.

SearchAds360FieldService

Utilisez ce service pour interroger les métadonnées sur les champs et les ressources disponibles. Le service fournit un catalogue de champs interrogeables avec des détails sur leurs la compatibilité et le type.

SearchAds360FieldService renvoie une liste de SearchAds360Field instances:

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

Pour en savoir plus, consultez la section Récupérer les métadonnées de ressource.

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 d'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 les champs resource_name).
  • La requête trie par ID de campagne.

Consultez campaign pour 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 campaign. ressource:

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 dont l'état est PAUSED et dont la valeur est supérieure à 1 000 d'impressions.
  • Chaque SearchAds360Row renvoyé comporte un champ metrics contenant le paramètre les métriques sélectionnées.
  • La requête trie par ID de campagne.

Voir metrics pour d'autres que vous pouvez utiliser dans vos requêtes.

Requête pour des segments

Il s'agit d'une requête de base pour les segments liés aux attributs de campaign. ressource:

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 dont l'état est PAUSED et dont la valeur est supérieure à 1 000 d'impressions.
  • Il segmente les données par date.
  • En raison de la segmentation, chaque SearchAds360Row représente un tuple de une campagne et la plage de dates.
  • La requête trie par ID de campagne.

Consultez segments pour découvrir liste de segments à utiliser dans vos requêtes et la 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 Ressource bidding_strategy, si disponible. Ce type de ressource associée est appelée 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 dans chaque campagne sélectionnée.
  • Chaque SearchAds360Row renvoyé représente un objet campaign renseigné avec les attributs de campagne sélectionnés, ainsi que la stratégie d'enchères sélectionnée "bidding_strategy.name".

Voir campaign afin d'identifier les ressources attribuées 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 RESSOURCE OU CHAMP par une ressource (par exemple, 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 champs, consultez la section Récupérer les métadonnées de ressource. de métadonnées.

En savoir plus

Découvrez comment créer des requêtes dans l'API Search Ads 360 Reporting: