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
eSearchStream
.As consultas
SearchAds360Service
retornam uma lista de instâncias deSearchAds360Row
:- 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ânciasSearchAds360Field
:- 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 objetocampaign
. - 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 campometrics
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.
Consultar atributos de um recurso relacionado
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 objetocampaign
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
oucampaign
) ou um campo (comocampaign.id
,metrics.impressions
ouad_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: