Crie uma consulta
- Navegue para o separador Consultas no Ads Data Hub.
- Clique em + Criar consulta. É apresentada a página Modelos de consulta de análise.
- Opcional: clique em Expandir para pré-visualizar o SQL do modelo.
- Clique em Usar modelo para selecionar o modelo que quer usar ou clique em Em branco para começar do zero.
- Introduza um nome para o relatório.
- Escreva ou edite a consulta através de um SQL compatível com o BigQuery. Pode encontrar tabelas e campos disponíveis e inseri-los no seu SQL no separador Tabelas do Google.
- Opcional: configure os parâmetros.
- Opcional: configure o resumo das linhas filtradas.
- Clique em Guardar.
Parâmetros
Os parâmetros tornam as consultas mais flexíveis. Por exemplo, pode querer executar a mesma consulta em diferentes campanhas. Em vez de criar consultas duplicadas ou codificar os IDs de campanhas antes de cada execução, pode configurar um parâmetro que aceite um ou mais IDs de campanhas a serem introduzidos a partir do cartão Executar quando executa uma consulta. A utilização de parâmetros mantém o código limpo, reduz as hipóteses de introduzir erros com a edição e permite que a sua consulta seja reutilizada sem edição. Os parâmetros encontram-se ao nível da consulta onde são criados, para que possa reutilizar o nome de um parâmetro noutra consulta.
Tipos de parâmetros
São permitidos os seguintes tipos de parâmetros:
int64float64boolstringdatetimestamparray, de qualquer um dos tipos permitidos
Crie um parâmetro
- Abra uma consulta guardada ou crie uma nova.
- Clique em Propriedades > Parâmetros > Adicionar parâmetro.
- Introduza um nome no campo Nome. Vai usar este nome para fazer referência ao parâmetro no texto da consulta.
- Use o menu pendente para selecionar o tipo de parâmetro.
- Se selecionar matriz, é apresentado um menu pendente adicional. Selecione o tipo de matriz no menu pendente.
- Opcional: repita os passos 2 a 4 até adicionar todos os parâmetros pretendidos.
- Clique em Guardar
Use um parâmetro
No texto da consulta, use o formato de parâmetro SQL padrão, que precede
o nome do parâmetro com @. No exemplo seguinte, a consulta contém
um parâmetro com o nome @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 executar a consulta, a caixa de diálogo Nova tarefa contém um campo Parâmetros. Introduza os valores para cada parâmetro definido.
Remova um parâmetro
- Abra a consulta que tem o parâmetro que quer eliminar.
- Abra o separador Propriedades.
- No cartão Parâmetros, clique em eliminar Eliminar junto ao parâmetro que quer eliminar.
- Clique em Guardar.
Parâmetros reservados
A tabela seguinte apresenta os parâmetros reservados pelo Ads Data Hub. Pode usar estes parâmetros nas suas consultas, mas não pode criar um parâmetro com o mesmo nome de um parâmetro reservado.
start_date
|
date
A data de início (inclusive) da tarefa de consulta. Um parâmetro definido pelo utilizador com este nome será ignorado e substituído pelos valores definidos na caixa de diálogo Nova tarefa. |
end_date
|
date
A data de fim (inclusive) da tarefa de consulta. Um parâmetro definido pelo utilizador com este nome será ignorado e substituído pelos valores definidos na caixa de diálogo Nova tarefa. |
time_zone
|
string
O fuso horário da tarefa de consulta. Um parâmetro definido pelo utilizador com este nome será ignorado e substituído pelos valores definidos na caixa de diálogo Nova tarefa. |
Resumo das linhas filtradas
Resumos das linhas filtradas: dados de registos que foram filtrados devido a verificações de privacidade. Os dados das linhas filtradas são somados e adicionados a uma linha geral. Embora não seja possível analisar mais detalhadamente os dados filtrados, fornece um resumo da quantidade de dados filtrados dos resultados.
Edite uma consulta
- Navegue para o separador Consultas no Ads Data Hub.
- Clique no nome da consulta que quer editar.
- Edite a consulta.
- Clique em Guardar.
Execute uma consulta
Antes de executar uma consulta, certifique-se de que deu à conta de serviço
autorização de dataEditor para o conjunto de dados que irá conter a saída das suas
junções.
Saiba mais acerca do controlo de acesso no BigQuery.
- Navegue para o separador Consultas no Ads Data Hub.
- Clique no nome da consulta que quer executar.
- Clique em
Executar.
- O número esperado de bytes que a consulta irá usar é apresentado na parte superior da página.
- Selecione um ID no menu pendente Dados de anúncios de. Estes devem ser os dados de anúncios do ID associado aos dados de anúncios que quer consultar. (Se quiser consultar os dados da sandbox, selecione Cliente da sandbox do ADH.)
- Se estiver a usar uma tabela de correspondência, selecione-a no menu pendente Tabela de correspondência de.
- Especifique onde quer guardar os resultados da consulta no campo Tabela de destino.
- Introduza as datas de início e de fim para determinar o intervalo de datas da consulta.
- Introduza um fuso horário. Este deve corresponder ao fuso horário da plataforma de compras.
- Opcional: introduza valores para quaisquer parâmetros.
- Clique em Executar.
Veja os resultados
Após a execução da consulta, pode pré-visualizar os resultados na página "Tarefas". Também pode explorar os dados no BigQuery, no Sheets ou no Data Studio.
Pré-visualize
Clique em Pré-visualizar na tarefa concluída. Os primeiros 20 resultados são apresentados abaixo da tarefa.
BigQuery
Os resultados são exportados para o BigQuery por predefinição. Clique em Ver tabela para abrir o BigQuery numa nova janela.
Sheets e Data Studio
Abra o menu pendente Explorar e selecione Explorar com o Sheets ou Explorar com o Data Studio nas opções. Esta ação abre os dados numa nova janela.