
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.
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.