Criar uma consulta
- Acesse a guia Consultas no Ads Data Hub.
- Clique em + Criar consulta. A página Modelos de consulta do Analysis é aberta.
- Opcional: tenha acesso ao SQL do modelo clicando em Expandir.
- Selecione o modelo que você quer usar clicando em Usar modelo ou clique em Em branco para começar do zero.
- Atribua um nome ao relatório.
- Crie ou edite a consulta usando o SQL compatível com o BigQuery. É possível encontrar tabelas e campos disponíveis e inseri-los no SQL na guia Tabelas do Google.
- Opcional: configure os parâmetros.
- Opcional: configure o resumo das linhas filtradas.
- Clique em Salvar.
Parâmetros
Os parâmetros tornam as consultas mais flexíveis. Por exemplo, talvez você queira fazer a mesma consulta em campanhas diferentes. Para evitar duplicações ou ter que fixar os IDs das campanhas no código antes de cada execução, é possível parametrizar o sistema para aceitar um ou mais IDs de campanhas na hora de fazer a consulta. O uso de parâmetros mantém seu código limpo, reduz as chances de erros durante a edição e permite que a consulta seja reutilizada sem mudanças. O escopo deles é definido para a consulta em que eles são criados. Assim, é possível reutilizar um nome de parâmetro em outra consulta.
Tipos de parâmetros
Permitimos os seguintes tipos de parâmetros:
int64float64boolstringdatetimestamparray, de qualquer um dos tipos aceitos
Criar um parâmetro
- Abra uma consulta salva ou crie uma.
- Clique em Propriedades > Parâmetros > Adicionar parâmetro.
- Digite um nome no campo Nome, que será usado para se referir ao parâmetro no texto da consulta.
- Use o menu suspenso para selecionar o tipo de parâmetro.
- Se você escolher uma matriz, outro menu suspenso vai aparecer. Selecione o tipo de matriz nesse menu.
- Opcional: repita as etapas de 2 a 4 até adicionar todos os parâmetros desejados.
- Clique em "Salvar".
Usar um parâmetro
No texto da consulta, use o formato de parâmetro SQL padrão, que é colocar @ antes do nome. No exemplo a seguir, a consulta tem um parâmetro chamado @campaign_ids:
/* Parameters:
* @campaign_ids (ARRAY of INT64): A list of campaign IDs
* to conduct analysis on */
WITH user_reach AS (
SELECT
user_id,
count(*) AS num_views
FROM
adh.google_ads_impressions
WHERE
campaign_id in UNNEST(@campaign_ids)
GROUP BY
user_id
)
SELECT
COUNT(*) AS unique_users,
COUNTIF(num_views = 1) AS one_view,
COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
COUNTIF(num_views > 5) AS more_than_five_views
FROM
user_reach
Quando você faz a consulta, a caixa de diálogo Nova tarefa inclui um campo Parâmetros. Insira valores para cada parâmetro definido.
Remover um parâmetro
- Abra a consulta que tem o parâmetro que você quer excluir.
- Abra a guia Propriedades.
- No card Parâmetros, clique em Excluir ao lado do parâmetro que você quer remover.
- Clique em "Salvar".
Parâmetros reservados
A tabela a seguir mostra os parâmetros reservados pelo Ads Data Hub. Eles podem ser usados nas consultas, mas não é permitido criar um parâmetro com o mesmo nome de um reservado.
start_date
|
date
A data de início (inclusiva) referente à tarefa de consulta. Um parâmetro definido pelo usuário com esse nome será ignorado e substituído pelos valores definidos na caixa de diálogo Novo job. |
end_date
|
date
A data de término (inclusiva) referente ao job de consulta. Um parâmetro definido pelo usuário com esse nome será ignorado e substituído pelos valores definidos na caixa de diálogo Novo job. |
time_zone
|
string
O fuso horário referente ao job de consulta. Um parâmetro definido pelo usuário com esse nome será ignorado e substituído pelos valores definidos na caixa de diálogo Novo job. |
Resumo das linhas filtradas
Resumos das linhas filtradas: listam os dados que foram filtrados devido a verificações de privacidade. Os dados das linhas com filtros são somados e adicionados a uma linha agregadora. Os dados filtrados não podem mais ser analisados. No entanto, eles fornecem um resumo da quantidade de informação que foi filtrada e descartada.
Editar uma consulta
- Acesse a guia Consultas no Ads Data Hub.
- Clique no nome da consulta que você quer editar.
- Edite a consulta.
- Clique em Salvar.
Executar uma consulta
Antes de executar uma consulta, é preciso dar à conta de serviço a permissão dataEditor para o conjunto de dados que vai conter o resultado agregado.
Saiba mais sobre o controle de acesso no BigQuery.
- Acesse a guia Consultas no Ads Data Hub.
- Clique no nome da consulta que será feita.
- Clique em Executar.
- Na parte de cima da página, mostramos o número esperado de bytes que a consulta vai usar.
- Selecione um ID no menu suspenso Dados de anúncios de. Esses são os dados de anúncios do ID associado às informações que você quer consultar. Para consultar dados do sandbox, selecione Cliente de sandbox do ADH.
- Se você usa uma tabela de correspondências, selecione no menu suspenso Fazer correspondência de tabela de.
- No campo Tabela de destino, especifique onde os resultados da consulta vão ser salvos.
- Insira as datas de início e término da consulta.
- Insira um fuso horário. Ele precisa ser igual ao fuso do ponto de compra.
- Opcional: insira valores para todos os parâmetros.
- Clique em Executar.
Conferir os resultados
Os resultados da consulta executada ficam disponíveis na página "Atividades". Também é possível analisar os dados no BigQuery, nas Planilhas ou no Looker Studio.
Visualização
Clique em Visualizar na tarefa concluída. Os primeiros 20 resultados vão aparecer abaixo dela.
BigQuery
Por padrão, os resultados são exportados para o BigQuery. Clique em Visualizar tabela para abrir o BigQuery em outra janela.
Planilhas e Looker Studio
Abra o menu suspenso Análises e selecione Análises em Planilhas ou Análises no Looker Studio. Os dados vão aparecer em outra janela.