Escreva e execute relatórios

Termo-chave: as Consultas agora chamam-se Relatórios. Pode ver estes termos usados de forma intercambiável na IU (interface do utilizador) e na documentação durante a transição para os Relatórios.

Crie um relatório

Nota: nem todos os utilizadores podem criar e editar relatórios. Saiba mais sobre o controlo de acesso no Ads Data Hub.

1. Navegue para o separador Consultas no Ads Data Hub.
2. Clique em + Criar consulta. É apresentada a página Criar um novo relatório.
3. Opcional: para filtrar modelos, pesquise, selecione ícones e escolha opções do menu pendente:
   • Origem de dados
   • Exemplo de utilização
   • Inventário
   • Acreditação do MRC
4. Opcional: clique em expand_content Expandir para pré-visualizar o SQL e os detalhes do modelo.
5. Clique em Usar modelo para selecionar o modelo que quer usar ou clique em add_circle Adicionar para começar do zero.
6. Introduza um nome para o relatório.
7. Escreva ou edite o relatório através de um SQL compatível com o BigQuery. Pode encontrar as tabelas e os campos disponíveis e inseri-los no SQL a partir do separador Tabelas Google.
8. Opcional: configure os parâmetros.
9. Opcional: configure o resumo das linhas filtradas.
10. Clique em Guardar.

Parâmetros

Os parâmetros tornam os relatórios mais flexíveis. Por exemplo, pode querer executar o mesmo relatório em diferentes campanhas. Em vez de criar relatórios duplicados 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 um relatório. 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 do relatório onde são criados, para que possa reutilizar o nome de um parâmetro noutro relatório.

Tipos de parâmetros

São permitidos os seguintes tipos de parâmetros:

• int64
• float64
• bool
• string
• date
• timestamp
• array, de qualquer um dos tipos permitidos

Crie um parâmetro

1. Abra um relatório guardado ou crie um novo.
2. Clique em Propriedades > Parâmetros > Adicionar parâmetro.
3. Introduza um nome no campo Nome. Vai usar este nome para fazer referência ao parâmetro no texto do relatório.
4. 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.
5. Opcional: repita os passos 2 a 4 até adicionar todos os parâmetros pretendidos.
6. Clique em Guardar

Use um parâmetro

No texto do relatório, use o formato de parâmetro SQL padrão, que precede o nome do parâmetro com @. No exemplo seguinte, o relatório 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

1. Abra o relatório que tem o parâmetro que quer eliminar.
2. Abra o separador Propriedades.
3. No cartão Parâmetros, clique em eliminar Eliminar junto ao parâmetro que quer eliminar.
4. Clique em Guardar.

Parâmetros reservados

A tabela seguinte apresenta os parâmetros reservados pelo Ads Data Hub. Pode usar estes parâmetros nos seus relatórios, 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 relatório. 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 relatório. 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 relatório. Um parâmetro definido pelo utilizador com este nome será ignorado e substituído pelos valores definidos na caixa de diálogo Nova tarefa. Sugestão: para evitar discrepâncias quando usar fusos horários no seu relatório, como nas cláusulas WHERE, pode usar time_zone para estabelecer correspondência com o fuso horário definido em Nova tarefa. Também é importante usar o mesmo fuso horário que a origem de dados.

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.

Nota: os requisitos de agregação aplicam-se aos próprios resumos das linhas filtradas. Se o resumo das linhas filtradas resultante ficar abaixo dos requisitos de agregação, o próprio resumo das linhas filtradas será filtrado.

Edite um relatório

1. Navegue para o separador Consultas no Ads Data Hub.
2. Clique no nome do relatório que quer editar.
3. Edite o relatório.
4. Clique em Guardar.

Execute um relatório

Ponto-chave: deve escrever e testar as suas {consultas} com o sandbox antes de as executar em dados reais. Saiba mais sobre as práticas recomendadas para escrever consultas no Ads Data Hub

Antes de executar um relatório, 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 sobre o controlo de acesso no BigQuery.

1. Navegue para o separador Consultas no Ads Data Hub.
2. Clique no nome do relatório que quer executar.
3. Clique em Executar.
   • O número esperado de bytes que o relatório irá usar é apresentado na parte superior da página.
4. 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.)
5. Se estiver a usar uma tabela de correspondência, selecione-a no menu pendente Tabela de correspondência de.
6. Especifique onde quer guardar os resultados do relatório no campo Tabela de destino.
7. Introduza as datas de início e de fim para determinar o intervalo de datas do relatório.
8. Introduza um fuso horário. Este deve corresponder ao fuso horário da plataforma de compras.
9. Opcional: introduza valores para quaisquer parâmetros.
10. Clique em Executar.

Veja os resultados

Após a execução do relatório, 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.