Cree informes de Power BI con datos de NowMetrix

La conexión consta de dos etapas opcionales:

NowMetrix REST API → Power Query → Power BI Desktop → optional Power BI Service

• Power BI Desktop crea la consulta, el modelo de datos y el informe.
• Power BI Service publica el informe para acceder a él desde el navegador, compartirlo y actualizarlo de forma programada.

El ejemplo preparado importa las últimas 30 filas diarias disponibles de /v1/overview. Cada fila incluye la fecha, el tracker, la zona horaria del tracker, las páginas vistas y las visitas.

Necesita:

• una cuenta de NowMetrix con acceso a la REST API;
• acceso al tracker sobre el que desea elaborar informes;
• Microsoft Power BI Desktop para crear el informe; y
• una cuenta y un espacio de trabajo de Power BI adecuados si desea publicar el informe o programar actualizaciones.

Microsoft y el administrador de su organización gestionan las licencias de Power BI, los permisos de los espacios de trabajo y las frecuencias de actualización disponibles. Puede completar la configuración de Desktop sin publicar el informe.

1. Inicie sesión en NowMetrix.
2. Abra Ajustes → API.
3. Cree una clave nueva con la etiqueta Microsoft Power BI.
4. Copie la clave completa inmediatamente. Solo se muestra una vez.
5. Anote el ID del tracker del sitio web que desea importar.

1. Abra Power BI Desktop y cree un informe en blanco.
2. Seleccione Inicio → Obtener datos → Consulta en blanco. Si no aparece en la lista, seleccione Obtener datos → Más y busque Consulta en blanco.
3. El Editor de Power Query se abre con una consulta nueva.
4. Seleccione Inicio → Editor avanzado.

No seleccione el cuadro de diálogo básico Web para este ejemplo. Se utiliza el Editor avanzado porque NowMetrix requiere un encabezado de autorización Bearer y la respuesta debe convertirse de JSON a filas de tabla.

1. Elimine el contenido existente del Editor avanzado.
2. Pegue la consulta completa que aparece a continuación.
3. Sustituya nm_YOUR_KEY y TRACKER_ID en las dos primeras líneas.
4. Mantenga ambos valores entre comillas.
5. Seleccione Listo.

let
    ApiKey = "nm_YOUR_KEY",
    TrackerId = "TRACKER_ID",

    Response = Json.Document(
        Web.Contents(
            "https://api.nowmetrix.com",
            [
                RelativePath = "v1/overview",
                Query = [
                    site = TrackerId,
                    days = "30"
                ],
                Headers = [
                    Authorization = "Bearer " & ApiKey,
                    Accept = "application/json"
                ],
                Timeout = #duration(0, 0, 0, 30)
            ]
        )
    ),

    DailyRows = if List.IsEmpty(Response[daily]) then
        #table(type table [date = text, pageviews = Int64.Type, visits = Int64.Type], {})
    else
        Table.FromRecords(Response[daily]),

    AddTracker = Table.AddColumn(
        DailyRows,
        "tracker",
        each Response[site],
        type text
    ),
    AddTimezone = Table.AddColumn(
        AddTracker,
        "timezone",
        each Response[timezone],
        type text
    ),
    ReorderedColumns = Table.ReorderColumns(
        AddTimezone,
        {"date", "tracker", "timezone", "pageviews", "visits"}
    ),
    TypedColumns = Table.TransformColumnTypes(
        ReorderedColumns,
        {
            {"date", type date},
            {"tracker", type text},
            {"timezone", type text},
            {"pageviews", Int64.Type},
            {"visits", Int64.Type}
        }
    )
in
    TypedColumns

La consulta utiliza una URL base fija junto con RelativePath y Query. Esto mantiene el origen predecible para futuras actualizaciones y envía la clave de API únicamente en el encabezado HTTPS Authorization.

Power BI puede preguntarle cómo debe conectarse a https://api.nowmetrix.com.

1. Seleccione Anónimo.
2. Aplique la configuración a https://api.nowmetrix.com.
3. Seleccione Conectar.
4. Si se le solicita un nivel de privacidad, seleccione el que requiera su organización. Privado ofrece la separación más estricta con respecto a otros orígenes de datos.

1. Espere hasta que la vista previa de la consulta muestre date, tracker, timezone, pageviews y visits.
2. Cambie el nombre de la consulta a NowMetrix Daily.
3. Seleccione Inicio → Cerrar y aplicar.
4. Abra la vista Datos y confirme que las filas y los tipos de columna son correctos.

Un informe sencillo confirma que los campos importados funcionan correctamente:

1. Vuelva a la vista Informe.
2. Añada un gráfico de líneas.
3. Coloque date en el eje X.
4. Coloque pageviews y visits en el eje Y.
5. Añada dos elementos visuales de tipo Tarjeta para las sumas de pageviews y visits.
6. Opcionalmente, añada tracker como segmentación cuando el modelo contenga varios trackers.

Seleccione Inicio → Actualizar para probar la actualización completa en Desktop. Los elementos visuales existentes se actualizan cuando finaliza la consulta.

1. Guarde el archivo PBIX en una ubicación protegida.
2. En Power BI Desktop, seleccione Inicio → Publicar.
3. Inicie sesión con la cuenta de Power BI de su organización.
4. Seleccione el espacio de trabajo previsto.
5. Abra el informe publicado desde el cuadro de diálogo de confirmación.

La publicación crea un informe y un modelo semántico asociado. La actualización programada se configura en el modelo semántico, no en un gráfico ni en una página de informe concretos.

1. Abra el espacio de trabajo en Power BI Service.
2. Busque el modelo semántico creado por el archivo PBIX publicado.
3. Abra Configuración o seleccione Actualizar → Programar actualización.
4. En Credenciales del origen de datos, edite las credenciales de https://api.nowmetrix.com.
5. Seleccione Anónimo como método de autenticación y el nivel de privacidad requerido por su organización.
6. Active la programación de actualización y seleccione una frecuencia y una zona horaria adecuadas.
7. Active las notificaciones de errores de actualización para el propietario del modelo semántico u otra persona responsable.
8. Guarde la configuración, seleccione Actualizar ahora y consulte el Historial de actualización.

Las frecuencias de actualización disponibles dependen de la licencia de Power BI y de la capacidad del espacio de trabajo. Microsoft documenta los controles, límites, comportamiento ante errores e historial de actualización actuales en su guía de actualización programada.

Los parámetros de Power Query facilitan el cambio del tracker o la renovación de la clave sin editar toda la consulta. Mejoran el mantenimiento, pero no son un almacén de secretos.

1. En el Editor de Power Query, seleccione Inicio → Administrar parámetros → Nuevo parámetro.
2. Cree un parámetro de texto obligatorio llamado pNowMetrixApiKey e introduzca la clave de API como valor actual.
3. Cree otro parámetro de texto obligatorio llamado pNowMetrixTrackerId e introduzca el ID del tracker.
4. Sustituya las dos primeras líneas de la consulta por las líneas siguientes.

    ApiKey = pNowMetrixApiKey,
    TrackerId = pNowMetrixTrackerId,

Después de publicar, los parámetros editables pueden aparecer en la configuración del modelo semántico. El acceso al espacio de trabajo debe seguir estando restringido, ya que los usuarios con permisos suficientes pueden inspeccionarlos o modificarlos.

Cree una consulta de Power Query independiente para cada conjunto de datos y utilice relaciones en el modelo cuando corresponda:

• Utilice una clave de API de NowMetrix exclusiva para cada modelo semántico de Power BI.
• Conceda al usuario de NowMetrix únicamente el acceso a los trackers que requiera el informe.
• Guarde el archivo PBIX en una ubicación protegida y no lo publique nunca como descarga pública.
• Considere usuarios de confianza a los editores de PBIX y a los propietarios del modelo semántico, ya que pueden inspeccionar la consulta.
• No incluya la clave en elementos visuales, filtros de informes, URL, capturas de pantalla ni documentación.
• Utilice la audiencia más reducida del espacio de trabajo de Power BI que cumpla el requisito de elaboración de informes.
• Revise los permisos de informes, espacios de trabajo, aplicaciones, compilación, uso compartido y descarga antes de distribuir el contenido.
• Revoque inmediatamente la clave si el archivo PBIX, el espacio de trabajo o la cuenta del propietario pueden haberse visto comprometidos.
• Cuando cambie la propiedad, confirme que las credenciales de actualización y las notificaciones de errores siguen funcionando.