Criar e gerar relatórios

Este guia ensina a criar e gerar relatórios, além de mostrar os resultados.

Termo-chave: uma consulta é o texto SQL que é a base de um relatório. Um relatório é composto por vários componentes, incluindo a consulta, as configurações de entrada e saída, a programação e os detalhes de execução.

Criar um relatório

Analistas e superusuários podem criar e editar relatórios. Saiba mais sobre o controle de acesso no Ads Data Hub.

Importante: para não perder as mudanças, clique em Salvar depois de fazer atualizações em um relatório, incluindo programações.

1. No Ads Data Hub, abra a página Relatórios.
2. Clique em + Criar relatório. A página Criar um novo relatório é aberta.
   • Você pode filtrar modelos pesquisando, selecionando ícones de produtos e escolhendo opções do menu suspenso.
3. Escolha um modelo e clique em Usar modelo ou em SQL para começar do zero.
   • Confira os detalhes do modelo e o SQL clicando em expand_content Expandir.
4. Para editar o relatório, clique em Editar consulta. Use o editor de consultas para:
   • Personalize o relatório usando o SQL compatível com o BigQuery.
   • Configure os parâmetros na guia Propriedades.
   • Confira uma lista de tabelas e campos disponíveis na guia Tabelas do Google.
   • Confira uma lista de tabelas próprias importadas e os esquemas delas na guia "Tabelas próprias".
   • Clique em Executar para executar a consulta SQL. As execuções iniciadas no editor de consulta SQL não contribuem para o histórico de execução de um relatório e não vão aparecer na seção Atividade recente da página Início.
   • Clique em Concluído para confirmar as mudanças na consulta e retornar à página de configuração do relatório.
5. Atribua um nome ao relatório.
6. Se aplicável, defina os valores do parâmetro no card "Configuração".
7. Configure a entrada e a saída dos jobs executados neste relatório:
   • Selecione uma fonte de dados no campo Dados de anúncios de. Esse é o ID da conta do Ads Data Hub associado aos dados de anúncios 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 campo Conta da tabela de correspondência.
   • Selecione um período e fuso horário para o relatório. O fuso horário do relatório precisa corresponder ao fuso da conta de anúncios vinculada, como uma conta do Google Ads. Observação: o intervalo de datas personalizado para teste de consulta só é aceito quando você executa a consulta na tela do editor SQL.
   • Opcional: mude suas configurações de privacidade e configure o resumo da linha filtrada.
   • Escolha o projeto, o conjunto de dados e a tabela do BigQuery em que os resultados do relatório vão ser salvos.
8. Opcional: configure o relatório para ser executado em uma programação.
9. Clique em Salvar.

---

Parâmetros

Os parâmetros permitem especificar como um determinado relatório deve ser executado. Ao usar o SQL para criar um relatório (ou ao editar o SQL em um modelo de relatório), os parâmetros permitem reutilizar o mesmo código SQL em vários relatórios e definir valores de parâmetro diferentes em cada cópia do relatório. Por exemplo, é possível gerar dois relatórios que compartilham a mesma consulta ou modelo SQL em diferentes conjuntos de IDs de campanha. Para isso, configure um parâmetro e defina o valor dele na seção "Configuração" da página de detalhes do relatório. O uso de parâmetros mantém seu código SQL limpo, reduz as chances de erros durante a edição e permite que a mesma consulta SQL seja reutilizada em vários relatórios sem editar os valores no SQL.

No exemplo a seguir, o relatório tem um parâmetro chamado campaign_ids, que aceita um array de IDs de campanha int64:

  /* Parameters:
   *   @campaign_ids (ARRAY of INT64):
   *   A list of campaign IDs to analyze
   */

  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

Tipos de parâmetros

Permitimos os seguintes tipos de parâmetros:

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

Adicionar um parâmetro a um relatório

1. Abra um relatório salvo ou crie um.
2. Clique em Editar consulta.
3. Em Propriedades, clique em Adicionar parâmetro.
4. Digite um nome no campo Nome, que será usado para se referir ao parâmetro no texto do relatório.
5. Use o menu suspenso para selecionar o tipo de parâmetro.
   • Se você escolher o tipo de matriz, outro menu suspenso vai aparecer. Selecione o tipo de matriz neste menu suspenso.
6. Na consulta SQL, adicione o parâmetro usando o formato de parâmetro SQL padrão: @PARAMETER_NAME. Confira o exemplo que segue estas etapas.
7. Clique em Concluído e, depois, em Salvar.

Usar um parâmetro

1. Abra um relatório com parâmetros configurados.
2. No painel Configuração, insira valores para cada parâmetro definido.
3. Clique em Salvar para preservar os valores dos parâmetros.

Remover um parâmetro

1. Abra um relatório com parâmetros configurados.
2. Clique em Editar consulta para abrir o editor SQL.
3. Em Propriedades, clique em Excluir ao lado do parâmetro que você quer remover.
4. Clique em Concluído e, depois, em Salvar.

Parâmetros reservados

A tabela a seguir mostra os parâmetros reservados pelo Ads Data Hub. Esses parâmetros podem ser usados nos relatórios, mas não é possível criar um parâmetro com o mesmo nome de um que é reservado.

start_date	date A data de início (inclusive) referente ao job do relatório. 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 (inclusive) 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 do job do relatório. 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. Dica:para evitar discrepâncias ao usar fusos horários no seu relatório, como em cláusulas WHERE, use time_zone para que ele seja igual ao fuso definido em Novo job. Também é importante usar o mesmo fuso horário da origem de dados.

---

Resumo das linhas filtradas

Observação: os resumos de linhas filtrados são desnecessários quando você usa o modo de ruído. Saiba mais sobre os benefícios de usar ruído em vez de verificações de diferença.

Os resumos das linhas filtradas registram os dados que foram filtrados devido a verificações de diferenças. 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. Para consultas que usam o modo de privacidade das verificações de diferenças, o Ads Data Hub ativa e configura automaticamente um resumo de linha filtrada. Quando você edita a consulta, o ADH ajusta a configuração com base nas colunas selecionadas. Para saber mais sobre resumos de linhas filtradas ou para configurar um manualmente, consulte Resumo de linhas filtradas.

---

Editar um relatório

1. No Ads Data Hub, abra a página Relatórios.
2. Clique no nome do relatório que você quer editar.
3. Faça alterações no relatório. Por exemplo, edite o SQL, gerencie valores de parâmetro ou defina uma programação.
4. Clique em Salvar.

---

Gerar um relatório

Importante: teste as consultas SQL usando o sandbox antes de executar com dados reais. Confira mais práticas recomendadas para criar consultas no Ads Data Hub

Antes de gerar um relatório, é 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.

1. No Ads Data Hub, abra a página Relatórios.
2. Clique no nome do relatório que será gerado.
3. Clique em Executar.

Gerar um relatório em uma programação

1. No Ads Data Hub, abra a página Relatórios.
2. Clique no nome do relatório para o qual você quer definir uma programação.
   • Para definir uma programação para um novo relatório, crie o relatório e clique em Salvar.
3. Clique em + Definir programação.
4. No painel Programação, clique no botão Programar a execução deste relatório com os detalhes abaixo para ativar a opção.
5. Em Frequência, selecione um intervalo e um horário e insira um fuso horário.
   • Para usar uma expressão cron, clique no botão Definir programação usando uma expressão cron para ativar a opção e insira a expressão na caixa.
6. Clique em Concluído.
7. Clique em Salvar para confirmar as alterações no relatório.

Para mostrar jobs programados na página Início,selecione Qualquer pessoa na lista de filtros Proprietário.

---

Ver os resultados

Quando o relatório for concluído, você poderá conferir os resultados na página de detalhes. Para conferir os resultados mais tarde, abra o relatório na página Início. Também é possível analisar os dados no BigQuery, nas Planilhas ou no Data Studio.

Visualizar

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 Data Studio

Abra o menu suspenso Análises e selecione Análises com as Planilhas ou Análises com o Data Studio. Os dados vão aparecer em outra janela.