Este artigo tem como objetivo orientar o cliente na preparação e utilização do Relatório Premium no Looker Studio, garantindo que os dados sejam corretamente formatados, carregados no BigQuery e vinculados ao dashboard. 

Antes de acessar o Relatório Premium, é necessário executar um script de formatação que organiza os arquivos de sessões em um padrão compatível com o esquema disponibilizado. Esse processo é fundamental para assegurar que as informações sejam exibidas corretamente no relatório. 

A documentação está dividida em etapas práticas: 

1. Execução do Script no Google Colab – Responsável por formatar os arquivos de sessão (.jsonl) e gerar a versão estruturada pronta para inserção no BigQuery. 

2. Configuração no BigQuery – Onde os dados formatados são carregados em uma tabela utilizando o esquema fornecido. 
3. Conexão com o Looker Studio – Etapa em que o Relatório Premium é vinculado à base de dados. 
4. Visualização no SZ – Procedimento para integrar o relatório final ao ambiente do SZ, dentro da seção Relatórios Premium. 

Links de apoio: 
Guia de Execução: Formatação e Visualização de Sessões no Looker Studio 


Etapa 1 – Copiar e Executar o Script no Google Colab 


1. Criar uma cópia do script no Google Drive 

  • Acesse o link do script - Link do Script. 
  • Clique em "Arquivo" > "Salvar uma cópia no Drive".

2. Criar estrutura de pastas no Google Drive 

  • Crie uma pasta chamada backups. 
  • Dentro de backups, crie outra chamada input. 
  • Coloque os arquivos .jsonl a serem formatados na pasta input.


3. Definir o nome do arquivo 

  • No script do Colab, localize a variável file_name e defina o nome do arquivo .jsonl que foi inserido. file_name = "nome_do_arquivo.jsonl"


4. Executar o script 

  • Clique em "Executar tudo".

  • Permitir a conexão com o Google Drive.

  • Selecione a conta que foi colocado o arquivo no drive  


5. Obter sessão formatada: 

  • O arquivo formatado estará disponível em: backups/output/formatted___reports_sessions.json 
  • Faça o download do arquivo 
  • Faça o download do schema: Link do Schema


Etapa 2 – Inserir os dados no BigQuery 


1. Acessar a página do BigQuery. 

1.1. Caso não tenha um projeto criado ainda, clique no botão "Criar Projeto": 


1.2. Defina um nome e local para o projeto:


Local indica onde o projeto vai ficar na hierarquia de recursos do Google Cloud: 


  • Sem organização: o projeto fica “solto”, vinculado à sua conta pessoal (Gmail).
  • Organização / Pasta: se você usa Google Workspace (conta corporativa), o projeto fica dentro da sua organização e opcionalmente dentro de uma pasta. Assim ele herda permissões (IAM) e políticas da organização. 

2. Criar um conjunto de dados clicando sobre as opções abaixo:


3. Preencha o campo “Código do conjunto de dados” com um nome para o conjunto. Em seguida, clique em “Criar conjunto de Dados”:



4. Clique no ícone de opções localizado no lado direito do nome do conjunto de dados criado e selecione a opção “Criar Tabela”: 



5. Dentro da aba de criação de tabela, configure da seguinte forma: 

  • Create table from (Criar tabela de): selecione “Fazer upload”.
  • Em Selecionar Arquivo: clique em Procurar e escolha o arquivo JSON (formatted___reports_sessions.json).
  • Formato do arquivo: selecione “JSON delimitado por nova linha”. 
  • Esquema: copie e cole o esquema disponibilizado em Link do Schema 
  • Tabela: nomeie a nova tabela que será criada dentro do Conjunto de dados. 


6. Em seguida, clique no botão “Criar tabela”. 

6.1. Será iniciado um job de inserção:


7. Quando o job de inserção de dados finalizar, será exibido uma mensagem na tela e a tabela estará disponível para utilizar no template do relatório. 


8. Após isso, dentro da tela de Relatório de Conversas, é preciso fazer uma cópia do template: 


9. Selecione a opção Criar > Fonte de dados. 

10. Escolha a fonte de dados do BigQuery.


11. Selecione o projeto, conjunto de dados e a tabela que foi criada anteriormente e clique em “Conectar”: 


12. Após conexão, os metadados da tabela serão carregados. Então basta clicar em “Adicionar ao relatório”. 


13. Assim, a base de dados está conectada ao template do Looker Studio. Então, clique em “Copiar relatório”. 


14. Se não for alterar nenhuma informação do template, basta clicar em “Leitura”. 


Com o modo de leitura ativado no Looker Studio, você poderá visualizar o dashboard e realizar análises com os dados formatados. 


Para visualizar no SZ, siga os passos abaixo: 


1. No menu lateral do SZ, acesse Relatórios > Premium: 


2. Clique no botão de “Adicionar”: 

3. Insira um título para identificação e o link do relatório gerado e clique em "Salvar”: 


4. Para visualizar, busque pelo nome inserido no título e clique sobre o item: 


Com isso, será possível visualizar os dados dentro do Relatório Premium.