DataBridge le brinda acceso en tiempo real a los datos de Players de OnSign, replicando automáticamente los eventos —playback, interactividad, actividad de Apps y estado del Player— hacia Google BigQuery en el momento en que ocurren. No necesita exportaciones manuales ni reportes programados.
Esta guía se divide en dos partes:
Parte 1 — crear un proyecto en Google Cloud, configurar una Service Account con permisos de BigQuery Admin y generar la clave de autenticación JSON.
Parte 2 — crear un Dataset en BigQuery y conectarlo a OnSign mediante la configuración de External Data Storage.
Parte 1 — Configuración del acceso a BigQuery
Paso 1 — Abrir IAM & Service Accounts
- Ingrese a console.cloud.google.com y seleccione su proyecto (por ejemplo, databridge-demo).
- En el menú lateral izquierdo, navegue a IAM & Admin → Service Accounts.
Nota: Asegúrese de haber iniciado sesión en una organización y de tener un proyecto seleccionado antes de continuar.
Paso 2 — Crear una Service Account
- Haga clic en + Create service account en la parte superior de la página.
- Complete los campos del formulario:
- Haga clic en Create and continue para avanzar al paso de permisos.
Paso 3 — Asignar el rol de BigQuery Admin
- En el paso de Permissions, haga clic en Select a role.
- Busque y seleccione BigQuery Admin.
- Haga clic en Continue y luego en Completed para finalizar la creación de la Service Account.
Nota: Es posible que vea un mensaje que dice "Policy updated. It may take a few minutes for these changes to become active." — esto es normal.
Paso 4 — Generar la clave JSON
- En la lista de Service Accounts, haga clic en el three-dot menu (⋮) junto a su nueva cuenta.
- Seleccione Manage keys.
- Haga clic en Add key → Create new key.
- Seleccione JSON como tipo de clave y haga clic en Create.
- El archivo .json se descargará automáticamente — guárdelo en un lugar seguro.
Importante: Este archivo JSON contiene la clave privada de su Service Account. No puede recuperarse si se pierde — deberá generar una nueva clave. Nunca suba este archivo a un repositorio público.
Parte 2 — Conexión de BigQuery con OnSign
Paso 5 — Crear un Dataset en BigQuery
- Ingrese a console.cloud.google.com/bigquery.
- En el panel izquierdo, haga clic en el three-dot menu (⋮) junto al nombre de su proyecto.
- Seleccione Create dataset y complete la configuración:
- Haga clic en Create dataset para confirmar. El nuevo dataset aparecerá en el árbol del proyecto.
Nota: Un ID de dataset consta de dos partes. La primera corresponde al Project ID, y la segunda, que aparece después del punto (.), corresponde al BigQuery Dataset ID. Por ejemplo, en my-project.sales_data, my-project es el Project ID y sales_data es el BigQuery Dataset ID.
Paso 6 — Abrir External Data Storage en OnSign
- En OnSign, haga clic en el ícono de usuario en la esquina inferior izquierda.
- Vaya a Settings → External Data Storage.
- Haga clic en + New External Storage.
Paso 7 — Seleccionar la fuente de datos
- En la ventana New External Storage, configure Platform como Google BigQuery.
- Elija una Source entre las opciones disponibles:
| Source | Tabla en BigQuery | Descripción |
|---|---|---|
| Playback Events | playback_events |
Registros de reproducción de contenido de los Players |
| Interactivity Events | interactivity |
Eventos de interacción del usuario |
| App Events | app_events |
Eventos generados por Apps en los Players |
| Player Info and Status | player_status |
Estado e información de los Players en tiempo real |
- Haga clic en Confirm para continuar.
Nota: Cada fuente de datos crea una tabla independiente en su dataset de BigQuery. Puede agregar varias conexiones con distintas fuentes.
Paso 8 — Configurar la conexión con BigQuery
- Complete los campos de configuración:
- De forma opcional, use el selector Fields para elegir qué campos de evento almacenar, o déjelo en blanco para almacenar todos.
- De forma opcional, agregue un Notification Email para recibir alertas si falla el envío de datos.
- Haga clic en Confirm para guardar. OnSign comenzará a enviar datos a BigQuery automáticamente.
Nota: Activar la opción For Internal Use oculta la conexión de los usuarios finales — solo los propietarios de la plataforma podrán verla.
Paso 9 — Agregar más fuentes de datos (opcional)
- Puede conectar varias fuentes al mismo dataset. Repita los Pasos 6 a 8 por cada fuente adicional.
- Por ejemplo, al agregar Player Info and Status como una segunda conexión, se crea una tabla player_status junto a playback_events en el mismo dataset.
Nota: La fuente Player Info and Status incluye un campo adicional, Data Ingestion Period, que controla con qué frecuencia se envían los datos de estado del Player a BigQuery (cada 5, 10, 15 o 30 minutos).
Si aún tiene dudas, vea el video paso a paso a continuación.