Guía de ayuda de BigQuery

Última actualización jueves, 9 de enero de 2025

Siga estos pasos para conectar sus datos de AccuRanker con Google BigQuery.

Requisitos previos

Para conectar BigQuery a AccuRanker, necesita:

  • Una suscripción a AccuRanker de 20.000 palabras clave o superior.
  • Ponerse en contacto con el servicio de atención al cliente de AccuRanker para solicitar la activación de Big Query.
  • Una cuenta de Google Cloud con una instancia de Google BigQuery.
  • Facturación activada en Google BigQuery.
  • Permisos para asignar funciones específicas para una cuenta de servicios de Google.

Guía paso a paso para configurar el acceso a BigQuery

1. Crear una cuenta de servicio

Sigue la documentación Crear una clave de cuenta de servicio de Google para configurar la autenticación de la clave de cuenta de servicio.

2. 2. Configurar los permisos de la cuenta de servicio

Admitimos tres escenarios de permisos diferentes para conceder los permisos necesarios a la cuenta de servicio. Si no has configurado los permisos anteriormente, lee la documentación de Google Gestión del acceso a las cuentas de servicio.

Puedes conceder acceso al proyecto o a un único conjunto de datos.

| Tipo de permisos | Función | Recurso | |------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------| | Función de administrador de BigQuery | Administrador de BigQuery | Proyecto o conjunto de datos ya creado | Propietario de datos de BigQuery y usuario de trabajo de BigQuery | Propietario de datos de BigQuery

Usuario de trabajo de BigQuery | Proyecto o conjunto de datos ya creado | Funciones IAM personalizadas | bigquery.tables.create

bigquery.tables.get

bigquery.tables.update

bigquery.tables.updateData

bigquery.tables.delete

bigquery.jobs.create Proyecto o conjunto de datos ya creado

Crear claves de cuenta de servicio

Para utilizar el flujo de cuentas de servicio, debe proporcionar el archivo JSON de su cuenta de servicio.

  1. Cree una Nueva Clave seleccionando el formato JSON.
  2. Haga clic en Crear.
  3. Descargue el archivo JSON a una ubicación segura; este archivo es esencial para conectarse a BigQuery.

Finalice la configuración de BigQuery

  1. Diríjase al dominio al que desea conectarse con BigQuery.
  2. En la vista general, haz clic en "Integraciones", donde encontrarás la integración de BigQuery.bigqueryintegration.png
  3. Dale un nombre a la conexión y especifica una ubicación para el conjunto de datos.
  • Si no estás seguro de la ubicación, puedes leer sobre las diferentes ubicaciones aquí.
  1. Cargue la clave JSON de la cuenta de servicio y haga clic en "Conectar".
  • Si ya ha creado un conjunto de datos, asegúrese de que la ubicación del conjunto de datos coincide con la del conjunto de datos ya creado.createbigqueryconnection.pngA continuación, probaremos la conexión y le avisaremos cuando la conexión se haya probado correctamente.

(Opcional) Rellenar datos históricos

Ahora puede ir a la configuración de su dominio e iniciar un backfill de sus datos de AccuRanker si necesita datos históricos.

Cómo actualizamos BigQuery y rellenamos los datos

Nos aseguramos de que nuestros datos de BigQuery se actualicen diariamente para reflejar los cambios más recientes. Todos los días añadimos nuevos datos del día anterior. Este enfoque garantiza que todos los conjuntos de datos críticos permanezcan actualizados al tiempo que se conservan los registros históricos para su análisis.

Proceso de actualización diaria

El proceso de actualización se centra en los siguientes conjuntos de datos:

Todas las clasificaciones de* y Clasificaciones propias de*

  • Estos conjuntos de datos se actualizan diariamente añadiendo nuevos datos.
  • Mantienen un registro completo y actualizado de las clasificaciones.

Metadatos de palabras clave* y metadatos de la competencia*

  • Estos conjuntos de datos se amplían cuando es necesario.
  • Se incorporan nuevos registros o se actualizan los existentes para garantizar que los metadatos sigan siendo precisos y completos.

Ciclo de actualización mensual

Además de las actualizaciones diarias, los conjuntos de datos Searchvolume* y AI*search_volume se gestionan en un ciclo mensual.

  • Calendario de actualización: El día 15 de cada mes, estas tablas se truncan y se sustituyen por los datos más recientes del Planificador de palabras clave de Google (GKP) y las métricas de volumen de búsqueda actualizadas.
  • Finalidad: este proceso garantiza la disponibilidad de los datos más precisos y recientes.
  • Datos históricos: Estos conjuntos de datos incluyen datos rellenados que abarcan los últimos cuatro años, lo que proporciona una sólida perspectiva histórica para el análisis de tendencias.

Rellenar datos

Tras una conexión satisfactoria, puede optar por rellenar sus datos. A continuación se explica cómo funciona:

  • Alcance: Decida hasta qué fecha desea rellenar los datos. Puedes rellenar los datos hasta la fecha de tu primer rango.
  • Restricciones: Para evitar comportamientos malintencionados, sólo puedes volver atrás una vez. Si necesita rellenar de nuevo, debe solicitarlo a través del servicio de atención al cliente.

Guía de esquemas BigQuery

La convención de nomenclatura para las tablas será

accuranker{nombre_esquema}{nuestro_lug_dominio_interno}

Los nombres de los esquemas se enumeran a continuación y cada esquema puede descargarse en formato JSON.

Descripción de las tablas

| Nombre de Tabla | Descripción | |-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | all_ranks | Esta tabla contiene toda la información sobre rankings de palabras clave, incluyendo rankings dinámicos y competidores. | | own_ranks | Esta tabla contiene toda la información sobre los rankings de palabras clave que usted rastrea. | | keyword_metadata | Esta tabla contiene detalles de las palabras clave actualmente rastreadas, incluyendo etiquetas y configuraciones específicas del dominio. | Metadatos de competidores Esta tabla contiene detalles de los competidores rastreados actualmente, incluyendo configuraciones para competidores. | Volumen de búsqueda Esta tabla contiene el volumen de búsqueda mensual de cada palabra clave. Si la palabra clave tiene una ubicación, muestra los volúmenes de búsqueda específicos de la ubicación y del país. Si no se especifica ninguna ubicación, el volumen de búsqueda es el mismo para ambas. | | ai_search_volume | Esta tabla contiene el volumen de búsqueda mensual de AI para cada palabra clave. Incluye el volumen de búsqueda* para un tipo de búsqueda específico y el volumen_total de búsqueda* para ambos tipos de búsqueda combinados. |