Linguagem de consulta do Search Ads 360

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

Pesquisar serviços

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 seus atributos, segmentos, e métricas. 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 campos de atributos e métricas.
  • Se você solicitar segmentos, linhas adicionais serão incluídas para cada tupla segment-resource.

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 para consulta com detalhes sobre seus compatibilidade e tipo.

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 básicos de consulta que você pode adaptar para criar suas próprias consultas.

Consultar atributos de um recurso

Esta é uma consulta básica dos 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 valor resource_name).
  • A consulta ordena por ID da campanha.

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

Consultar métricas

Esta é uma consulta básica de métricas relacionadas aos atributos de campaign. recurso:

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 o métricas selecionadas.
  • A consulta ordena por ID da campanha.

Consulte metrics para outros métricas disponíveis que você pode usar em suas consultas.

Consultar segmentos

Esta é uma consulta básica para segmentos relacionados a atributos do campaign. recurso:

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 ordena por ID da campanha.

Consulte segments para lista de segmentos que você pode usar em suas consultas e Segmentação para obter mais informações sobre a segmentação dos seus relatórios.

Essa é uma consulta básica no recurso campaign que une atributos do 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 e a estratégia de lances selecionados bidding_strategy.name.

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

Consultar metadados de campo

Você pode 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 OU 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.

Saiba mais

Saiba como criar consultas na API Search Ads 360 Reporting: