OneMetrics para Excel

Hay tres formas de llevar OneMetrics a Excel. Elige la que mejor se adapte a tu equipo: Power Query con una clave de API, una URL de feed sin claves o el complemento de Office con fórmulas.

  • Windows, Mac y Excel para la Web
  • Clave de API o URL de feed
  • Plantillas listas para usar
  • Power Query + clave de API

    Consultas a medida o consultas guardadas, editables en Power Query. Excel de escritorio.

  • URL de feed

    La opción más simple: sin claves y compatible con Excel para Mac y para la Web.

  • Complemento de Office

    Fórmulas =ONEMETRICS.QUERY() y =ONEMETRICS.RUN() y un panel para insertar consultas guardadas. Microsoft 365.

Requisitos

  • Una cuenta de OneMetrics con al menos una conexión activa. Crea tu cuenta gratis.
  • Excel para Windows o Mac con Microsoft 365 (Power Query). Para Excel para la Web, usa la URL de feed o el complemento.
  • Una clave de API (opciones A y C) creada en Claves de API por un administrador del espacio de trabajo.

A. Power Query con clave de API

Plantillas: api-key-query.pq (consulta a medida) y saved-query.pq (consulta guardada).

  1. Paso 1: Crea una clave de API

    En OneMetrics ve a Claves de API → Crear clave y copia la clave mk_live_…. Si quieres, limítala a algunos clientes.

  2. Paso 2: Abre una consulta en blanco

    En Excel abre Datos → Obtener datos → De otras fuentes → Consulta en blanco.

  3. Paso 3: Pega la plantilla

    En el Editor de Power Query pulsa Inicio → Editor avanzado, borra el contenido y pega la plantilla. Cambia los valores del bloque *Settings*:

    • ApiKey: tu clave de API.
    • Connector: por ejemplo meta_ads o shopify.
    • Fields: los ID de los campos (los encuentras en el Explorador de la app).
    • DateRange: un periodo predefinido o fechas de inicio y fin.
    • En saved-query.pq, SavedQueryId: cópialo en Consultas guardadas → ⋯ → Copiar ID.
    Settings
    ApiKey = "mk_live_…",
    Connector = "meta_ads",
    Fields = {"date", "data_source_name", "campaign_name", "spend", "impressions", "clicks", "ctr"},
    DateRange = [preset = "last_30_days"],   // o [start = "2026-01-01", end = "2026-01-31"]
    Currency = null,                         // p. ej. "USD" para convertir
    Recomendado: crea un parámetro en Inicio → Administrar parámetros llamado OneMetricsApiKey y usa ApiKey = OneMetricsApiKey para no repetir la clave.
  4. Paso 4: Credenciales y privacidad

    Pulsa Listo. Si Excel pide credenciales para https://onemetrics.co, elige Anónimo: la clave ya viaja en la cabecera Authorization.

    Si aparece el aviso de niveles de privacidad, elige Organizativo (o Privado si combinas datos con otras fuentes sensibles).

  5. Paso 5: Carga los datos

    Pulsa Inicio → Cerrar y cargar. Las columnas llegan con tipo (fechas, moneda, porcentajes) y con nombres en el idioma de tu cuenta.

B. URL de feed (sin clave de API)

Plantilla: feed-csv.pq.

  1. Paso 1: Genera la URL del feed

    En la app abre una consulta guardada y ve a ⋯ → URL del feed → Generar. Copia la URL completa.

    URL
    https://onemetrics.co/api/v1/feeds/TOKEN.csv
  2. Paso 2: Conéctala en Excel

    Opción rápida: Datos → Desde la Web y pega la URL. Para tipos de datos más precisos, pega la plantilla feed-csv.pq en una consulta en blanco y cambia FeedToken.

    Cuando Excel pida credenciales, elige Anónimo y pulsa Cerrar y cargar.

C. Complemento de Office (Microsoft 365)

Agrega fórmulas que viven en las celdas y un panel para insertar consultas guardadas. Requiere matrices dinámicas (Microsoft 365, Excel 2021 o posterior, o Excel para la Web).

  1. Paso 1: Instala el complemento

    En Excel para la Web: Inicio → Complementos → Más complementos → Mis complementos → Cargar mi complemento y sube el manifiesto. En Windows o Mac, usa un catálogo de carpeta compartida.

    Administradores de Microsoft 365: en el centro de administración ve a Configuración → Aplicaciones integradas → Cargar aplicaciones personalizadas y asígnalo a usuarios o grupos.

    Manifiesto
    https://onemetrics.co/excel-addin/manifest.xml
  2. Paso 2: Guarda tu clave de API

    Abre Datos → OneMetrics, pega tu clave mk_live_… y pulsa Guardar. La clave queda guardada solo para ti y para este complemento.

  3. Paso 3: Inserta datos o fórmulas

    Desde el panel inserta una consulta guardada como tabla en una hoja nueva o como fórmula en la celda seleccionada. También puedes escribir las fórmulas a mano:

    =ONEMETRICS.QUERY("ID-DE-LA-CONSULTA"; "last_30_days")
    Los resultados se guardan en memoria 10 minutos por combinación de argumentos, así que recalcular no gasta consultas de tu plan.

Actualiza los datos

  1. Paso 1: Manual

    Datos → Actualizar todo (Ctrl+Alt+F5).

  2. Paso 2: Automática

    En Datos → Consultas y conexiones, clic derecho en la consulta → Propiedades → marca Actualizar cada N minutos y/o Actualizar al abrir el archivo. Te recomendamos un mínimo de 60 minutos.

    Cada actualización cuenta como una consulta de tu plan. En Excel para la Web (SharePoint u OneDrive) solo la URL de feed funciona sin pasos extra.

Solución de problemas

OneMetrics.UNAUTHORIZED
La clave de API no es válida o fue revocada. Crea una nueva en Claves de API.
OneMetrics.AUTH_EXPIRED
Hay que reconectar la cuenta de la plataforma en Conexiones.
OneMetrics.PLAN_LIMIT
Se alcanzó el límite de tu plan. Revisa Uso en la app o mejora tu plan en Precios.
OneMetrics.RATE_LIMITED
Demasiadas solicitudes por minuto. Espera un minuto y vuelve a actualizar.
Formula.Firewall
Revisa los niveles de privacidad o activa Archivo → Opciones → Datos → Opciones de consulta → Privacidad → Ignorar los niveles de privacidad, solo si confías en todas las fuentes del libro.
La fórmula devuelve #N/A
El complemento no tiene una clave de API guardada. Ábrelo desde Datos → OneMetrics y guarda tu clave.

¿Algo no funciona?

Escríbenos con el nombre de tu espacio de trabajo y los pasos que seguiste. Te respondemos en español o inglés.

Contactar soporte