O DataBridge oferece acesso em tempo real aos dados de Players do OnSign, espelhando automaticamente os eventos — playback, interatividade, atividade de Apps e status do Player — para o Google BigQuery no momento em que ocorrem. Não é necessário exportar manualmente ou gerar relatórios agendados.
Este guia é dividido em duas partes:
- Parte 1 — criar um projeto no Google Cloud, configurar uma Service Account com permissões de BigQuery Admin e gerar a chave de autenticação JSON.
- Parte 2 — criar um Dataset no BigQuery e conectá-lo ao OnSign através das configurações de External Data Storage.
Parte 1 — Configurando o acesso ao BigQuery
Etapa 1 — Abrir IAM & Service Accounts
Nota: Certifique-se de estar logado em uma organização e de ter um projeto selecionado antes de continuar.
Etapa 2 — Criar uma Service Account
- Clique em + Create service account no topo da página.
- Preencha os campos do formulário:
- Clique em Create and continue para avançar para a etapa de permissões.
Etapa 3 — Atribuir o papel de BigQuery Admin
- Na etapa de Permissions, clique em Select a role.
- Procure e selecione BigQuery Admin.
- Clique em Continue e depois em Completed para finalizar a criação da Service Account.
Nota: Você pode ver uma mensagem dizendo "Policy updated. It may take a few minutes for these changes to become active." — isso é esperado.
Etapa 4 — Gerar a chave JSON
- Na lista de Service Accounts, clique no three-dot menu (⋮) ao lado da sua nova conta.
- Selecione Manage keys.
- Clique em Add key → Create new key.
- Selecione JSON como tipo de chave e clique em Create.
- O arquivo .json será baixado automaticamente — salve-o em um local seguro.
Importante: Este arquivo JSON contém a chave privada da sua Service Account. Ele não pode ser recuperado caso seja perdido — você precisará gerar uma nova chave. Nunca envie esse arquivo para um repositório público.
Parte 2 — Conectando o BigQuery ao OnSign
Etapa 5 — Criar um Dataset no BigQuery
- Acesse console.cloud.google.com/bigquery.
- No painel esquerdo, clique no three-dot menu (⋮) ao lado do nome do seu projeto.
- Selecione Create dataset e preencha as configurações:
- Clique em Create dataset para confirmar. O novo dataset aparecerá na árvore do projeto.
Nota: Um ID de dataset é composto por duas partes. A primeira corresponde ao Project ID, e a segunda, que aparece após o ponto (.), corresponde ao BigQuery Dataset ID. Por exemplo, em my-project.sales_data, my-project é o Project ID e sales_data é o BigQuery Dataset ID.
Etapa 6 — Abrir External Data Storage no OnSign
- No OnSign, clique no ícone do usuário no canto inferior esquerdo.
- Vá em Settings → External Data Storage.
- Clique em + New External Storage.
Etapa 7 — Selecionar a fonte de dados
Na janela New External Storage, defina Platform como Google BigQuery.
Escolha uma Source entre as opções disponíveis:
| Source | Tabela BigQuery | Descrição |
| Playback Events | playback_events |
Registros de reprodução de conteúdo dos players |
| Interactivity Events | interactivity |
Eventos de interação do usuário |
| App Events | app_events |
Eventos gerados por Apps nos Players |
| Player Info and Status | player_status |
Status e informações dos Players em tempo real |
- Clique em Confirm para prosseguir.
Nota: Cada fonte de dados cria uma tabela separada no seu dataset do BigQuery. Você pode adicionar múltiplas conexões com fontes diferentes.
Etapa 8 — Configurar a conexão com o BigQuery
- Preencha os campos de configuração:
- Opcionalmente, use o seletor Fields para escolher quais campos de evento armazenar — ou deixe em branco para armazenar todos.
- Opcionalmente, adicione um Notification Email para receber alertas caso o envio de dados falhe.
- Clique em Confirm para salvar. O OnSign começará a enviar dados ao BigQuery automaticamente.
Nota: Ativar a opção For Internal Use oculta a conexão dos usuários finais — apenas os proprietários da plataforma poderão vê-la.
Etapa 9 — Adicionar mais fontes de dados (opcional)
Você pode conectar múltiplas fontes ao mesmo dataset. Repita as Etapas 6 a 8 para cada fonte adicional. Por exemplo, ao adicionar Player Info and Status como uma segunda conexão, é criada uma tabela player_status ao lado de playback_events no mesmo dataset.
Nota: A fonte Player Info and Status inclui um campo adicional, Data Ingestion Period, que controla a frequência de envio dos dados de status do Player ao BigQuery (a cada 5, 10, 15 ou 30 minutos).
Caso ainda tenha dúvidas, assista ao vídeo passo a passo abaixo.