Datos AI Visibility en Looker Studio

Conecte sus datos de visibilidad AI a Google Looker Studio para paneles e informes personalizados.

Resumen

Genere una clave API personal en la configuración de su cuenta, configure el Community Connector de Looker Studio (o use el conector JSON) e introduzca su clave API. Sus datos de visibilidad AI — incluyendo puntuaciones de visibilidad, recuentos de menciones y análisis de sentimiento de ChatGPT, Gemini, Perplexity y Claude — estarán disponibles como fuente de datos de Looker Studio para paneles personalizados.

Índice
  1. ¿Qué es la integración de Looker Studio?
  2. Requisitos previos
  3. Guía paso a paso
    1. Generar una clave API
    2. Configurar el conector
    3. Conectar sus datos
  4. Campos de datos disponibles
  5. Referencia API
  6. Descargar script del conector
  7. Preguntas frecuentes

¿Qué es la integración de Looker Studio?

La integración de Looker Studio le permite importar sus datos de monitoreo de visibilidad AI en Google Looker Studio (anteriormente Google Data Studio). Esto le permite:

  • Crear paneles personalizados adaptados a sus necesidades de informes
  • Combinar datos de visibilidad AI con otras fuentes de datos de marketing
  • Compartir informes interactivos con su equipo o clientes
  • Configurar informes automáticos por correo electrónico con entrega programada
  • Visualizar tendencias en diferentes plataformas de AI a lo largo del tiempo

Cada usuario accede solo a sus propios datos a través de una clave API personal. Sus datos nunca se comparten con otros usuarios.

Requisitos previos

  • Una cuenta activa del AI Visibility Tool (cualquier plan)
  • Al menos un área temática con resultados de análisis completados
  • Una cuenta de Google con acceso a Looker Studio

Guía paso a paso

Paso 1: Generar una clave API

  1. Inicie sesión en su cuenta del AI Visibility Tool.
  2. Haga clic en su dirección de correo electrónico en el menú superior derecho.
  3. Select "API Keys" from the dropdown menu under "Integrations".
  4. Haga clic en "Crear clave API" y asígnele un nombre descriptivo (p. ej. "Looker Studio").
  5. Copie la clave API inmediatamente — solo se mostrará una vez.
Importante: La clave API se muestra solo una vez después de la creación. Guárdela de forma segura. Si la pierde, deberá crear una nueva clave.

Su clave API comienza con el prefijo avt_ seguido de 48 caracteres. Puede tener hasta 3 claves API activas al mismo tiempo.

Paso 2: Configurar el conector

Hay dos formas de conectar sus datos a Looker Studio:

Opción A: Community Connector (Recomendado)
  1. Descargue el script del conector (ver abajo).
  2. Vaya a script.google.com y cree un nuevo proyecto.
  3. Pegue el código del script del conector en el editor.
  4. Actualice la API_BASE_URL variable a su URL de implementación.
  5. Implemente el script: Haga clic en "Implementar" → "Nueva implementación" → Tipo: "Complemento" → Implementar.
  6. Copie el ID de implementación para usarlo en Looker Studio.
Opción B: Conector JSON (Sin script requerido)
  1. Open Looker Studio and click "Create" → "Data Source".
  2. Search for the "JSON" or "Custom JSON/CSV" connector.
  3. Introduzca la URL de la API: https://your-domain.com/api/v1/looker/data
  4. Agregue el encabezado de autorización: Authorization: Bearer YOUR_API_KEY
  5. Configure los parámetros de fecha según sea necesario.

Paso 3: Conectar sus datos

  1. In Looker Studio, click "Create" → "Data Source".
  2. Seleccione su conector (Community Connector o conector JSON).
  3. Introduzca su clave API cuando se le solicite.
  4. Click "Connect" — the available fields will be loaded automatically.
  5. Click "Create Report" to start building your dashboard.
Consejo: Comience con un gráfico de rango de fechas y una tabla que muestre las puntuaciones de visibilidad por sistema de AI para obtener una visión rápida de sus datos.

Campos de datos disponibles

Las siguientes dimensiones y métricas están disponibles en Looker Studio:

Dimensiones

Campo Escriba Descripción
date Fecha La fecha en que se realizó el análisis (AAAA-MM-DD)
topic_area Texto Nombre del área temática (selección) que se está monitoreando
prompt Texto El texto del prompt enviado al sistema de AI
category Texto Categoría asignada al prompt
funnel_stage Texto Etapa del embudo de marketing (p. ej. Conciencia, Consideración, Decisión)
ai_system Texto La plataforma de AI consultada (p. ej. ChatGPT, Gemini, Perplexity, Claude)
brand Texto La marca que se rastrea en busca de menciones

Métricas

Campo Escriba Descripción
visibility_score Número Puntuación de visibilidad general (0–100) para la marca en la respuesta de AI
mention_count Número Número de veces que la marca fue mencionada en la respuesta de AI
position_score Número Puntuación de clasificación de posición — valores más altos indican menciones más tempranas
sentiment_score Número Puntuación de sentimiento de -1 (negativo) a +1 (positivo)
web_search_used Booleano Si el sistema de AI utilizó búsqueda web para generar la respuesta

Referencia API

La API REST utiliza su clave API personal para la autenticación. Todos los endpoints devuelven JSON.

Autenticación

Incluya su clave API en cada solicitud utilizando uno de estos métodos:

  • Encabezado (recomendado): Authorization: Bearer avt_your_key_here
  • Parámetro de consulta: ?api_key=avt_your_key_here

Endpoints

GET /api/v1/looker/schema

Devuelve el esquema (definiciones de campos) para la fuente de datos.

Solicitud de ejemplo:

curl -H "Authorization: Bearer avt_your_key_here" \
  https://your-domain.com/api/v1/looker/schema
GET /api/v1/looker/data

Devuelve los datos de visibilidad reales. Soporta filtrado y paginación.

Parámetros:

Parámetro Escriba Descripción
date_from String Fecha de inicio (AAAA-MM-DD)
date_to String Fecha de fin (AAAA-MM-DD)
selection_id Entero Filtrar por ID de área temática
ai_system String Filtrar por sistema de AI (p. ej. chatgpt, gemini, perplexity, claude)
limit Entero Número de registros a devolver (predeterminado: 1000)
offset Entero Número de registros a omitir (predeterminado: 0)

Solicitud de ejemplo:

curl -H "Authorization: Bearer avt_your_key_here" \
  "https://your-domain.com/api/v1/looker/data?date_from=2025-01-01&date_to=2025-01-31&limit=500"
GET /api/v1/looker/selections

Devuelve una lista de sus áreas temáticas (selecciones) con sus IDs. Use estos IDs para filtrar solicitudes de datos.

Solicitud de ejemplo:

curl -H "Authorization: Bearer avt_your_key_here" \
  https://your-domain.com/api/v1/looker/selections

Límite de velocidad: La API permite hasta 100 solicitudes por minuto por clave API. Looker Studio almacena los datos en caché automáticamente, por lo que este límite rara vez se alcanza durante el uso normal.

Descargar script del conector

Descargue el archivo de Google Apps Script para el Community Connector:

Descargar script del conector (connector.gs)

Después de descargar, abra el archivo en un editor de texto, actualice la API_BASE_URL y pegue el código en un nuevo proyecto de Google Apps Script.

Preguntas frecuentes

La integración de Looker Studio está disponible en todos los planes, incluido el plan gratuito. Todos los usuarios pueden generar claves API y conectar sus datos a Looker Studio.

No. Cada clave API está vinculada a su cuenta personal. La API solo devuelve datos de sus propias áreas temáticas y resultados de análisis. No hay forma de acceder a los datos de otro usuario.

Puede tener hasta 3 claves API activas al mismo tiempo. Puede eliminar las claves no utilizadas y crear nuevas en cualquier momento.

Las claves API se muestran solo una vez en la creación por razones de seguridad. Si pierde una clave, elimínela de su página de Claves API y cree una nueva. Luego actualice la clave en la configuración de su fuente de datos de Looker Studio.

Looker Studio obtiene datos actualizados de la API cada vez que se abre o actualiza un informe. También puede configurar los ajustes de actualización de datos de Looker Studio. Los datos de visibilidad AI subyacentes se actualizan cada vez que ejecuta nuevos análisis en la herramienta.

Asegúrese de que su clave API sea correcta y esté activa. Verifique la página de Claves API en su cuenta para comprobar el estado de la clave. Si la clave fue eliminada o desactivada, cree una nueva y actualícela en la configuración del conector de Looker Studio.

Sí. La API REST es una API JSON estándar que funciona con cualquier herramienta que pueda enviar solicitudes HTTP — incluyendo Excel, Google Sheets, Power BI, Tableau, scripts de Python y más.
Volver a la documentación