Criar e gerar relatórios

Este guia ensina como criar e gerar relatórios, além de mostrar como conferir seus 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, o cronograma 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 ao pesquisar, selecionar ícones de produtos e escolher opções no menu suspenso.
3. Escolha um modelo e clique em Usar modelo ou clique 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 "Tabela própria".
   • Clique em Executar para executar a consulta SQL. As execuções iniciadas no editor de consultas SQL não contribuem para o histórico de execução de um relatório e não aparecem na seção Atividade recente da página Início.
   • Clique em Concluído para confirmar as mudanças na consulta e voltar à página de configuração do relatório.
5. Atribua um nome ao relatório.
6. Se aplicável, defina os valores de 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ências.
   • Selecione um período e um fuso horário para o relatório. O fuso horário do relatório precisa corresponder ao fuso horário da conta de anúncios vinculada, como uma conta do Google Ads. Observação: o período personalizado para teste de consultas só é compatível quando você executa a consulta na tela do editor de SQL.
   • Opcional: mude suas configurações de privacidade e configure o resumo das linhas filtradas.
   • Escolha o projeto, o conjunto de dados e a tabela do BigQuery em que os resultados do relatório serão salvos.
8. Opcional: configure a programação de exibição do relatório.
9. Clique em Salvar.

---

Parâmetros

Com os parâmetros, você especifica como um determinado relatório deve ser gerado. Ao usar SQL para criar um relatório (ou ao editar o SQL de 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âmetros diferentes em cada cópia do relatório. Por exemplo, é possível executar 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 reutilizar a mesma consulta SQL em vários relatórios sem editar valores no próprio SQL.

No exemplo a seguir, o relatório tem um parâmetro chamado campaign_ids, que aceita uma 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 nesse menu suspenso.
6. Na consulta SQL, adicione o parâmetro usando o formato 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 de SQL.
3. Em Propriedades, clique em excluir 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, utilize time_zone para que ele seja igual ao fuso definido em Novo job. Também é importante usar o mesmo fuso horário da fonte de dados.
params	string Namespace para nomear tabelas exportadas. Use no seguinte formato para criar um marcador de posição na consulta e forneça o nome da tabela ao executar o relatório: params.TABLE_NAME (não use um @ inicial usado por outros parâmetros). Para mais informações e exemplos de uso desse parâmetro, consulte Exportar várias tabelas usando uma única consulta.

---

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 de verificações diferenciais, o Ads Data Hub ativa e configura automaticamente um resumo de linha filtrada. Quando você edita a consulta, o Ads Data Hub ajusta automaticamente a configuração com base nas colunas selecionadas. Para saber mais sobre resumos de linhas filtradas ou 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 mudanças no relatório. Por exemplo, edite o SQL, gerencie valores de parâmetros 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 de acordo com uma programação

1. No Ads Data Hub, abra a página Relatórios.
2. Clique no nome do relatório que você quer programar.
   • 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.
5. Em Frequência, selecione um intervalo e um horário do dia 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 a posição ativada e insira a expressão na caixa.
6. Clique em Concluído.
7. Clique em Salvar para confirmar as mudanças no relatório.

Para mostrar os jobs programados na página Inicial, selecione Qualquer pessoa na lista de filtros Proprietário.

---

Ver os resultados

Depois que o relatório for gerado, você poderá conferir os resultados na página de detalhes dele. Para conferir os resultados depois, 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 em Planilhas ou Análises no Looker Studio. Os dados vão aparecer em outra janela.