Michel van LuijtelaarIntegrar los datos locales de GMBapi.com con BigQuery abre nuevas y potentes capacidades, permitiendo un análisis de datos avanzado, informes personalizados y una integración perfecta con tus herramientas existentes. Esta guía te lleva paso a paso a través de la configuración de la integración de BigQuery y cómo maximizar su potencial para tu negocio.
Lo que obtienes con nuestra integración de BigQuery
Con esta integración, puedes:
Acceder a tablas de BigQuery organizadas y estructuradas
(sin volcados de datos brutos).
Las tablas se actualizan diariamente con los datos más recientes de tus GBP.
Genera tus informes y estadísticas personalizados de Google
Business Profile.
Integra nuestras estadísticas prácticas directamente en tu propia plataforma, software o sitio web.
Utiliza el código proporcionado para replicar las visualizaciones que se ven en nuestro sitio web en tus informes o en tu sitio web.
Requisitos de integración de BigQuery y GMBapi.com
Antes de configurar tu integración con BigQuery, asegúrate de lo siguiente:
¡Tienes una cuenta activa en GMBapi.com con todas tus ubicaciones sincronizadas!
Tienes una cuenta de facturación activa asociada a tu Proyecto de Google Cloud.
Has creado una cuenta de servicio con los siguientes roles:Editor de datos de BigQuery es necesario para crear/editar una tabla dentro de tu GCPUsuario de trabajos de BigQuery - Necesario para programar y ejecutar consultas
Comparte el correo electrónico de la cuenta de servicio y el nombre(s) de las cuentas en app.gmbapi.com que deben recibir acceso.
Una vez que el acceso a las tablas sea compartido, puedes programar consultas usando la cuenta de servicio creada en tu propio proyecto de BigQuery.
Guía paso a paso para configurar la integración de BigQuery
*Si ya has creado una cuenta de Google Cloud Platform con la facturación configurada, puedes saltar al Paso 3
Paso 1: Crear un proyecto de Google Cloud
Navega a Google Cloud Platform.
Crea un nuevo proyecto o selecciona uno existente.
Paso 2: Configurar los detalles de facturación
Ve a la Google Cloud Console .
En el menú de la izquierda, selecciona “Facturación ” → luego haz clic en “Administrar cuentas de facturación ”.
Elige la organización apropiada (si corresponde) y haz clic en “Crear cuenta ”.
Introduce un nombre para tu cuenta de facturación, selecciona tu país y conéctala a la organización correcta.
Añade un método de pago válido y envíalo para habilitar la facturación.
Paso 2.1. Vincula tu cuenta de facturación al proyecto
En Cloud Console, selecciona el proyecto al que quieres conectarte.
Ve a la sección " Facturación ".
Si se te solicita, selecciona la cuenta de facturación para vincular a este proyecto.
Para cambiar las cuentas de facturación más tarde, haz clic en " Administrar cuentas de facturación ” y elige la opción adecuada.
⚠️ Nota: Sin la facturación habilitada, las consultas programadas y otras operaciones de BigQuery no se ejecutarán.
Paso 3: Crear y configurar una cuenta de servicio
En tu proyecto de Google Cloud, ve a IAM y administración > Cuentas de servicio .
Haz clic en Crear cuenta de servicio .
Asigna un nombre a tu cuenta de servicio (por ejemplo,
“Integración de BigQuery ”).Asigna los siguientes roles para asegurar que la cuenta de servicio tenga acceso para programar consultas y crear tablas dentro de GCP: Editor de datos de BigQuery Usuario de trabajos de BigQuery
Completa la creación de la cuenta de servicio y copia la dirección de correo electrónico generada.
Paso 4: Comparte el correo electrónico de la cuenta de servicio
Comparte el correo electrónico de la cuenta de servicio con nuestro equipo de soporte o a través de tu portal de gestión de integraciones.
Además, confirma la cuenta de GMBapi.com (grupo de ubicaciones de GBP) a la que deseas que acceda la cuenta de servicio.
Los datos se almacenan por cuenta de GBP y se requiere acceso explícito para cada una.
Nota: Si necesitas acceso a cuentas de GBP adicionales en el futuro, simplemente repite el Paso 3 en adelante para cada nueva cuenta.
Paso 5: Configura BigQuery
Ve a BigQuery en tu Google Cloud Console.
Crea un nuevo conjunto de datos o selecciona uno existente.
Importante : Establece la región del conjunto de datos en europe-west4 (Países Bajos).
Esto es necesario para transferir datos utilizando una consulta programada; las regiones de origen y destino deben coincidir. Dado que GMBapi.com almacena los datos en los Países Bajos, tu conjunto de datos también debe estar en esa región para habilitar la transferencia.
Nota: Si es necesario, puedes replicar o migrar tus datos a otra región más tarde. Más información 👉 Replicación de datos de BigQuery
Paso 6: Accede y utiliza tus datos
Una vez concedido el acceso, tienes dos formas principales de trabajar con tus datos:
Consultas programadas (Recomendado)
Usa consultas programadas en tu proyecto de BigQuery para copiar los datos organizados de GMBapi.com a tu propio conjunto de datos. Esto garantiza el acceso y la propiedad de los datos a largo plazo.
Usa las credenciales de la cuenta de servicio al configurar las consultas programadas.
Acceso directo a través de la API de BigQuery
Alternativamente, puedes usar las credenciales de la cuenta de servicio para acceder a los datos directamente a través de la API de BigQuery en tu código.
✅ Recomendación: Para un mejor control, portabilidad y preparación para el futuro, recomendamos crear una copia de las tablas dentro de tu propio proyecto de GCP, ya sea a través de consultas programadas o programáticamente usando la API de BigQuery.
Nuestro equipo proporcionará plantillas SQL listas para usar y fragmentos de código visuales para ayudarte a empezar rápidamente.
Ejemplos de casos de uso para la integración de BigQuery
Informes personalizados
Genera informes adaptados a las necesidades específicas de tu negocio, profundizando en las métricas de rendimiento SEO local.
Integración de plataforma
Integra nuestras perspectivas sin problemas en tu CRM, panel de control del sitio web o cualquier plataforma de análisis que utilice tu negocio.
Análisis Avanzado
Aprovecha las potentes capacidades analíticas de BigQuery para detectar tendencias, oportunidades e insights accionables más rápido que nunca.
Obtener Ayuda
Si te quedas atascado en algún punto del proceso, nuestro equipo está aquí para ayudarte. No dudes en contactarnos si no estás seguro sobre cómo configurar permisos, crear cuentas de servicio o programar consultas. Estamos comprometidos a hacer que tu proceso de integración sea fluido y exitoso.
Solicita acceso a un grupo de ubicaciones e inicia una prueba gratuita. Luego:
Contacta a nuestro equipo de soporte.
Configura tu proyecto de BigQuery.
Asegúrate de que tu cuenta de facturación esté activa.
Crea una cuenta de servicio con los roles correctos.
Comparte el correo electrónico de la cuenta de servicio y los nombres de las cuentas de app.gmbapi.com relevantes.
Comienza a programar consultas para recuperar tablas de datos estructurados.
Para obtener asistencia detallada, accede a nuestra documentación completa o contacta a nuestro equipo de soporte directamente para agilizar tu experiencia de integración con BigQuery.
Aprovecha todo el potencial de tus datos de SEO local con nuestra potente integración de BigQuery, facilitando la toma de decisiones más inteligentes y basadas en datos.
Preguntas frecuentes sobre GMBapi.com y la integración con BigQuery
Preguntas frecuentes
Para configurar la integración, necesitas una cuenta activa de GMBapi.com con tus ubicaciones sincronizadas, un proyecto de Google Cloud con la facturación habilitada y una cuenta de servicio con los roles correctos de BigQuery. Una vez que esto esté en su lugar, nuestro equipo puede otorgar acceso a tablas estructuradas de BigQuery que se actualizan diariamente con tus datos de Google Business Profile.
La cuenta de servicio debe tener los roles de BigQuery Data Editor y BigQuery Job User. El rol Data Editor permite a la cuenta crear y editar tablas dentro de tu proyecto, mientras que el rol Job User hace posible programar y ejecutar consultas. Sin estos roles, tu integración y transferencias de datos no funcionarán correctamente.
Tu conjunto de datos debe estar ubicado en europe-west4 porque GMBapi.com almacena sus datos en los Países Bajos. Google requiere que las regiones de origen y destino coincidan para que las transferencias de datos funcionen. Si las regiones no están alineadas, tus consultas programadas y tus pipelines de datos fallarán. Si es necesario, puedes replicar o migrar los datos a una región diferente más tarde, pero el conjunto de datos inicial debe estar en europe-west4.
Las tablas de BigQuery se actualizan diariamente con los datos más recientes de tus Google Business Profiles. Esto asegura que tus análisis, paneles y reportes siempre reflejen las últimas métricas de rendimiento de SEO local sin necesidad de actualizaciones manuales.
Puedes acceder a tus datos de dos formas principales. El método recomendado es utilizar consultas programadas, que copian las tablas estructuradas de GMBapi.com en tu propio proyecto de BigQuery para que mantengas el control y la propiedad a largo plazo. Alternativamente, puedes usar la API de BigQuery para consultar los datos directamente con las credenciales de tu cuenta de servicio. La mayoría de las empresas eligen las consultas programadas, ya que proporcionan mayor flexibilidad y portabilidad.
Sí, la integración está diseñada para funcionar sin problemas con tus herramientas existentes. Una vez que tus datos estén disponibles en BigQuery, puedes conectarlos directamente a tus paneles de control, sistemas CRM, sitios web o plataformas de análisis. Muchas empresas utilizan esta capacidad para crear paneles de control personalizados o integrar la información en sus flujos de trabajo existentes.
Si encuentras algún problema, ya sea con la configuración de la cuenta de servicio, la habilitación de la facturación o la programación de consultas, puedes comunicarte con el equipo de soporte de GMBapi.com. Nuestro equipo está disponible para guiarte a través del proceso y asegurarse de que tu integración funcione sin problemas de principio a fin.
