Linguagem de consulta do Search Ads 360

Com a linguagem de consulta do Search Ads 360, é possível criar consultas de pesquisa para recuperar dados de relatórios e metadados de recursos usando a API Search Ads 360 Reporting.

Pesquisar serviços

Use 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 de SearchAds360Row:

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

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

SearchAds360FieldService

Use este 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 instâncias SearchAds360Field:

  • 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 básicos de consulta que você pode adaptar 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.
  • Os pedidos de consulta por ID da campanha.

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

Consultar métricas

Esta é uma consulta básica para métricas relacionadas aos 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.
  • Os pedidos de consulta 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 aos 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.
  • Ele segmenta os dados por data.
  • Como resultado da segmentação, cada SearchAds360Row representa uma tupla de uma campanha e do segmento de data.
  • Os pedidos de consulta por ID da campanha.

Consulte segments e confira uma lista dos segmentos que você pode usar nas suas consultas. Já em Segmentação, você encontra mais informações sobre como segmentar seus relatórios.

Essa é 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 relacionados de cada campanha selecionada.
  • Cada SearchAds360Row retornado representa um objeto campaign preenchido com os atributos da campanha selecionados, bem como o atributo da estratégia de lances selecionada, bidding_strategy.name.

Consulte campaign para descobrir quais recursos atribuídos estão disponíveis para consultas da 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 do campo.

Saiba mais

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