Linguagem de consulta do Search Ads 360

A linguagem de consulta do Search Ads 360 permite criar consultas de pesquisa para recuperar dados de relatórios e metadados de recursos usando a API Search Ads 360 Reporting.

serviços da Pesquisa

É possível usar a linguagem de consulta do Search Ads 360 para consultar a API usando:

SearchAds360Service

Use esse serviço para consultar recursos e os atributos, segmentos e métricas relacionados a eles. Há dois métodos: Search e SearchStream.

As consultas SearchAds360Service retornam uma lista de SearchAds360Row instâncias:

  • Cada linha representa um recurso.
  • Se solicitado, as linhas incluem atributos e campos de métricas.
  • Se você solicitar segmentos, outras linhas serão incluídas para cada tupla de segmento-recurso.

Consulte Criar relatórios de pesquisa para mais informações.

SearchAds360FieldService

Use esse serviço para consultar metadados sobre campos e recursos disponíveis. O serviço fornece um catálogo de campos consultáveis com detalhes sobre a compatibilidade e o tipo deles.

SearchAds360FieldService retorna uma lista de SearchAds360Field instâncias:

  • Cada campo contém detalhes sobre o campo solicitado.

Consulte Recuperar metadados de recursos para saber mais.

Exemplos de consultas básicas

As seções a seguir fornecem exemplos de consultas básicas que podem ser adaptadas para criar suas próprias consultas.

Consultar atributos de um recurso

Esta é uma consulta básica para atributos do recurso campaign que retorna o ID, o nome e o status da campanha:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id
  • Cada SearchAds360Row retornado representa um objeto campaign.

  • As linhas são preenchidas com os campos selecionados (incluindo o resource_name da campanha).

  • A consulta é ordenada por ID da campanha.

Consulte campaign para outros campos disponíveis que podem ser usados em suas consultas.

Consultar métricas

Esta é uma consulta básica para métricas relacionadas a atributos do recurso campaign:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id

  • A consulta retorna campanhas com o status PAUSED e mais de 1.000 impressões.

  • Cada SearchAds360Row retornado tem um campo metrics preenchido com as métricas selecionadas.

  • A consulta é ordenada por ID da campanha.

Consulte metrics para outras métricas disponíveis que podem ser usadas em suas consultas.

Consultar segmentos

Esta é uma consulta básica para segmentos relacionados a atributos do recurso 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

  • A consulta retorna campanhas com o status PAUSED e mais de 1.000 impressões.

  • Ela segmenta os dados por data.

  • Como resultado da segmentação, cada SearchAds360Row representa uma tupla de uma campanha e o segmento de data.

  • A consulta é ordenada por ID da campanha.

Consulte segments para uma lista de segmentos que podem ser usados nas consultas e Segmentação para mais informações sobre como segmentar seus relatórios.

Esta é uma consulta básica no recurso campaign que une atributos do recurso bidding_strategy, se disponível. Esse tipo de recurso relacionado é conhecido como recurso atribuído.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

  • A consulta seleciona atributos de campanha e atributos relacionados de cada campanha selecionada.

  • Cada SearchAds360Row retornado representa um objeto campaign preenchido com os atributos de campanha selecionados, bem como o atributo de estratégia de lances selecionado, bidding_strategy.name.

Consulte campaign para saber quais recursos atribuídos estão disponíveis para consultas de campanha.

Consultar metadados de campo

É possível usar SearchAds360FieldService para recuperar metadados de campo.

Esta é uma consulta básica para metadados de campo:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • Substitua RESOURCE OR FIELD por um recurso (como customer ou campaign) ou um campo (como campaign.id, metrics.impressions, ou ad_group.id).

Consulte Recuperar metadados de recursos para mais informações sobre como recuperar metadados de campo.

Saiba mais

Saiba mais sobre como criar consultas na API Search Ads 360 Reporting: