Configurar la integración de Power BI para analíticas

Disponible como complemento

Qué puedes exportar

• Publicaciones: una fila por publicación, con la fecha, el perfil, la red, el tipo de publicación y métricas como impresiones, interacción, Me gusta, comentarios, compartidos y reproducciones.
• Datos diarios del perfil: una fila por perfil y por día, con métricas como seguidores, impresiones, interacción, alcance y la cantidad de publicaciones que se hicieron ese día.

Antes de comenzar

• La integración de Power BI es parte del complemento Premium integrations.
• Tu cuenta necesita API access, que también es un complemento. Si no ves Generate API key en Settings → Integrations, contacta a nuestro equipo de soporte para agregarlo.
• Necesitas una clave de API de Vista Social. Ve a Settings → Integrations y haz clic en Generate API key si aún no tienes una. Mantén la clave privada: cualquiera que la tenga puede leer los datos de tu cuenta.
• Necesitas Power BI Desktop para crear el informe. Para actualizarlo de forma programada, también necesitas Power BI Service.

Paso 1: Encuentra el ID de tu grupo de perfiles

Cada exportación incluye un grupo de perfiles. Para ver tus grupos de perfiles y sus ID:

1. En Power BI Desktop, haz clic en Home → Get data, busca blank y selecciona Blank query.

2. Reemplaza todo el contenido del editor de consultas con la consulta de abajo e ingresa tu clave de API en lugar de YOUR_API_KEY. Si el editor de consultas no se abre de inmediato, primero haz clic en Advanced Editor.

let
    Source = Json.Document(
        Web.Contents(
            "https://vistasocial.com/api/integration/powerbi/groups",
            [Headers = [#"x-api-key" = "YOUR_API_KEY"]]
        )
    ),
    Groups = Table.FromRecords(Source)
in
    Groups

3. Haz clic en Next (o Done). Si Power BI muestra un mensaje sobre credenciales faltantes, haz clic en Configure credentials, selecciona Anonymous en Authentication kind y haz clic en Connect. Tu clave de API ya está incluida en la consulta, así que Power BI no necesita iniciar sesión.

Verás una tabla con el id, el name y el type de cada grupo de perfiles al que puedes acceder. Copia el id del grupo sobre el que quieres crear informes. Después puedes eliminar esta consulta.

Paso 2: Conecta Power BI a tus datos

1. Haz clic en Home → Get data → Web. Si no ves Web, haz clic en la flecha debajo de Get data o busca web.
2. Elige Advanced.
3. En URL parts, pega la dirección de exportación y reemplaza GROUP_ID por el ID de tu grupo de perfiles:
4. Revisa la columna date. En los datos de publicaciones, aparece como texto, por ejemplo, "October 16, 2026". Haz clic en Transform Data, selecciona la columna date, luego ve a Transform → Data Type → Date y haz clic en Close & Apply. Los datos diarios de perfiles ya usan YYYY-MM-DD y, por lo general, se detectan como una fecha.

https://vistasocial.com/api/integration/powerbi/data?group=GROUP_ID&export_type=post&format=csv&days=90

4. En HTTP request header parameters, escribe x-api-key como nombre y pega tu clave de API como valor.
5. Haz clic en OK. Si Power BI te pregunta cómo iniciar sesión, elige Anonymous y haz clic en Connect. El encabezado contiene tu clave de API.
6. En la pantalla de vista previa, establece Data Type Detection en Based on entire dataset, para que las métricas que están vacías en las primeras filas también se conviertan en números. Luego, haz clic en Load o en Transform Data para ordenar las columnas primero.

Guarda tu clave de API en el encabezado, no en la dirección web. Las direcciones suelen guardarse en los registros y en el historial del navegador.

Cambia los datos que exportas

Edita las opciones en la dirección de exportación:

• export_type: post para una fila por publicación o daily para una fila por perfil y día.
• format: conserva csv. Si no lo incluyes, los datos se devuelven como JSON.
• days: de 1 a 360. Es un período móvil que termina hoy, por lo que cada actualización programada lo adelanta.
• date_from y date_to: un período fijo en formato YYYY-MM-DD, de hasta 360 días. Usa estas opciones en lugar de days. Si agregas ambas, se usará days.

Algunos ejemplos:

• Publicaciones de los últimos 30 días: &export_type=post&format=csv&days=30
• Datos diarios de perfiles de los últimos 90 días: &export_type=daily&format=csv&days=90
• Datos diarios de perfiles del primer semestre del año: &export_type=daily&format=csv&date_from=2026-01-01&date_to=2026-06-30

Para crear informes con datos de publicaciones y datos diarios de perfiles, agrega una fuente de datos para cada uno.

Usar una consulta en blanco

Si prefieres trabajar en el editor de consultas, haz clic en Home → Get data → Blank query y pega la consulta que aparece abajo. Reemplaza GROUP_ID por el ID de tu grupo de perfiles y YOUR_API_KEY por tu clave de API. Luego, edita las opciones dentro de Query = [...].

let
    Source = Csv.Document(
        Web.Contents(
            "https://vistasocial.com/api/integration/powerbi/data",
            [
                Query = [group = "GROUP_ID", export_type = "post", format = "csv", days = "90"],
                Headers = [#"x-api-key" = "YOUR_API_KEY"]
            ]
        ),
        [Delimiter = ",", Encoding = 65001, QuoteStyle = QuoteStyle.Csv]
    ),
    Headers = Table.PromoteHeaders(Source, [PromoteAllScalars = true])
in
    Headers

Haz clic en Next (o Done) y elige Anonymous si se te solicita. Luego, presiona Ctrl+A para seleccionar todas las columnas y haz clic en Transform → Detect Data Type. Si date sigue siendo texto, cambia el tipo a Date manualmente. Cambia el nombre de la consulta y haz clic en Close & Apply.

¿Qué pasa con la opción Web API?

El mosaico Web API en Get data solo tiene un campo para la URL, por lo que no puede enviar el encabezado x-api-key. Funciona si agregas &api_key=YOUR_API_KEY al final de la dirección de exportación, pero tu clave se guarda en todos los lugares donde se registre esa dirección. Cuando puedas, usa Web → Advanced.

Paso 3: Crea tu primera visualización

Una vez que tus datos estén cargados, crea visualizaciones como lo harías normalmente en Power BI. Por ejemplo, para graficar la interacción a lo largo del tiempo:

1. En el panel Visualizations, elige un gráfico, por ejemplo Line chart.
2. Desde el panel Data, arrastra date a X-axis y una métrica como engagement a Y-axis.

Paso 4: Mantén tus datos actualizados

1. Publica tu informe en Power BI Service.
2. En Power BI Service, abre Settings del modelo semántico.
3. En Data source credentials, haz clic en Edit credentials, elige Anonymous e inicia sesión. Tu clave de API permanece en el encabezado que configuraste en el paso 2.
4. En Refresh, activa la actualización programada y elige una hora, por ejemplo, todos los días a las 6:00 a. m.

Con days en tu dirección, cada actualización obtiene los datos más recientes de los últimos días.

Notas importantes

• Las fechas y horas de publicación usan la zona horaria propia de cada publicación, que se muestra en la columna timezone.
• Los datos diarios del perfil incluyen algunos campos de lista, como hourly, hashtags y page_fans_country. Se reciben como texto y es mejor eliminarlos en Transform Data.
• Una exportación incluye hasta 360 días. Para obtener un historial más extenso, agrega una consulta por cada período.
• Power BI muestra los totales grandes en formato abreviado, por ejemplo, "4 mil". Para ver el número exacto, selecciona el objeto visual, abre Format visual → Callout value y establece Display units en None.
• Al generar una nueva clave de API, la anterior deja de funcionar. Actualiza la clave en el encabezado x-api-key de tu fuente de datos o las actualizaciones dejarán de funcionar.

Solución de problemas

• Clave de API no válida: verifica que el encabezado x-api-key tenga tu clave actual de Settings → Integrations.
• (500): Error interno del servidor al conectar: la clave de API no llegó a Vista Social. Verifica que hayas agregado el encabezado x-api-key en HTTP request header parameters. Si usaste el mosaico Web API, agrega &api_key= con tu clave a la dirección.
• No tienes permiso para acceder a este grupo de perfiles: verifica el ID del grupo del Paso 1. Solo puedes exportar los grupos a los que tienes acceso.
• Se requieren date_from y date_to, con el formato YYYY-MM-DD: agrega days a la dirección o ambas fechas con el formato YYYY-MM-DD.
• Limita las consultas a un máximo de 360 días a la vez: acorta el rango de fechas a 360 días o menos.
• Tu suscripción no incluye integraciones: el acceso a la API no está activo en tu cuenta. Contacta a nuestro equipo de soporte para agregarlo.
• Tu suscripción no incluye el complemento de integraciones prémium: el complemento de integraciones prémium no está activo en tu cuenta. Contacta a nuestro equipo de soporte para agregarlo.
• Demasiadas solicitudes: las conexiones de Power BI tienen su propio límite por minuto. Actualiza de nuevo después de un minuto y evita actualizar muchas fuentes de datos al mismo tiempo.

Preguntas frecuentes

Q: ¿Necesito iniciar sesión en Power BI para usar esto?

A: No para crear el informe en Power BI Desktop. Necesitas una cuenta de Power BI Service para publicar el informe y actualizarlo según un horario.

Q: ¿Puedo exportar más de un grupo de perfiles?

A: Cada fuente de datos incluye un grupo de perfiles. Agrega una por cada grupo sobre el que quieras crear informes.

Q: ¿Los datos son los mismos que aparecen en los informes de Vista Social?

A: Sí. Power BI lee los mismos datos de publicaciones y perfiles diarios que Vista Social usa en tus informes, para que puedas combinarlos y crear gráficos a tu manera.

¿Necesitas ayuda?

Comunícate con nuestro equipo de soporte. Con gusto te ayudaremos.

Lecturas relacionadas:

Cómo configurar la integración con Looker Studio para analíticas

Cómo configurar la integración con Tableau para analíticas

Regístrate ahora y prueba Vista Social gratis durante 14 días.