Gravar e gerar relatórios

Termo-chave: as consultas agora se chamam relatórios. Durante a transição para relatórios, é possível que você encontre esses dois termos na interface e na documentação.

Criar um relatório

Observação: nem todos os usuários podem criar e editar relatórios. Saiba mais sobre o controle de acesso no Ads Data Hub.

1. Acesse a guia Consultas no Ads Data Hub.
2. Clique em + Criar consulta. A página Criar um novo relatório é aberta.
3. Opcional: filtre modelos ao pesquisar, selecionar ícones e escolher as opções do menu suspenso:
   • Fonte de dados
   • Caso de uso
   • Inventário
   • Certificado pelo Media Rating Council (MRC)
4. Opcional: confira os detalhes do modelo e o SQL clicando em expand_content Expandir.
5. Escolha o modelo que você quer usar clicando em Usar modelo ou clique em add_circle Adicionar para começar do zero.
6. Atribua um nome ao relatório.
7. Crie ou edite o relatório 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.
8. Opcional: configure os parâmetros.
9. Opcional: configure o resumo das linhas filtradas.
10. Clique em Salvar.

Parâmetros

Os parâmetros tornam os relatórios mais flexíveis. Por exemplo, talvez você queira gerar o mesmo relatório em campanhas diferentes. Para evitar relatórios duplicados ou ter que codificar os IDs das campanhas antes de gerar cada um, é possível parametrizar o sistema para aceitar um ou mais IDs de campanhas na hora de gerar um relatório. O uso de parâmetros mantém seu código limpo, reduz as chances de erros durante a edição e permite que seu relatório seja reutilizado sem mudanças. O escopo dos parâmetros é definido para o relatório em que eles são criados. Assim, é possível reutilizar um nome de parâmetro em outro relatório.

Tipos de parâmetros

Permitimos os seguintes tipos de parâmetros:

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

Criar um parâmetro

1. Abra um relatório salvo ou crie um.
2. Clique em Propriedades > Parâmetros > Adicionar parâmetro.
3. Digite um nome no campo Nome, que será usado para se referir ao parâmetro no texto do relatório.
4. 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.
5. Opcional: repita as etapas de 2 a 4 até adicionar todos os parâmetros desejados.
6. Clique em "Salvar".

Usar um parâmetro

No texto do relatório, use o formato de parâmetro SQL padrão, que vem antes do nome do parâmetro com @. No exemplo a seguir, o relatório 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 Novo job inclui um campo Parâmetros. Insira valores para cada parâmetro definido.

Remover um parâmetro

1. Abra o relatório que tem o parâmetro que você quer excluir.
2. Abra a guia Propriedades.
3. No card Parâmetros, clique em Excluir ao lado do parâmetro que você quer remover.
4. Clique 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 origem de dados.

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.

Observação: os requisitos de agregação são válidos para os resumos de linhas filtradas. Se o resultado do resumo de linhas filtradas não atender aos requisitos de agregação, o próprio resumo vai ficar no filtro.

Editar um relatório

1. Acesse a guia Consultas no Ads Data Hub.
2. Clique no nome do relatório que você quer editar.
3. Edite o relatório.
4. Clique em Salvar.

Gerar um relatório

Importante: escreva e teste as {consultas} usando o sandbox antes de executá-las usando 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. Acesse a guia Consultas no Ads Data Hub.
2. Clique no nome do relatório que será gerado.
3. Clique em Executar.
   • Na parte de cima da página, mostramos o número esperado de bytes que o relatório vai usar.
4. 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.
5. Se você usa uma tabela de correspondências, selecione no menu suspenso Fazer correspondência de tabela de.
6. No campo Tabela de destino, especifique onde os resultados do relatório serão salvos.
7. Insira as datas de início e término do relatório.
8. Insira um fuso horário. Ele precisa ser igual ao fuso do ponto de compra.
9. Opcional: insira valores para todos os parâmetros.
10. Clique em Executar.

Conferir os resultados

Os resultados do relatório gerado ficam disponíveis na página "Jobs". 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.