Linguagem de consulta do Search Ads 360

Com a linguagem de consulta do Search Ads 360, você pode criar consultas de pesquisa para recuperar dados de relatórios e metadados de recursos usando a API Search Ads 360 Reporting.

Serviços de pesquisa

Você pode 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. Há dois métodos, Search e SearchStream.

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

  • 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 recurso de segmento.

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 pesquisáveis com detalhes sobre a compatibilidade e o tipo deles.

SearchAds360FieldService retorna uma lista de instâncias SearchAds360Field:

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

Consulte Extrair 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 especificada).
  • A consulta é ordenada por ID da campanha.

Consulte campaign para ver outros campos disponíveis que podem ser usados nas 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 ver outras métricas disponíveis que podem ser usadas nas 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.
  • Os dados são segmentados 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 ver uma lista de segmentos que podem ser usados nas consultas e Segmentação para mais informações sobre como segmentar os 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 um 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 da campanha selecionada e o atributo da estratégia de lances selecionada, 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 extrair metadados de campo.

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

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

Consulte Extrair metadados de recursos para mais informações sobre como extrair metadados de campo.

Saiba mais

Saiba como criar consultas na API Search Ads 360 Reporting: