Перейти к основному контенту

Настройка интеграции с Power BI для аналитики

Vie

Доступно как дополнение

Доступно как дополнение

 

Что можно экспортировать

  • Публикации: одна строка на публикацию с датой, профилем, сетью, типом публикации и такими показателями, как показы, вовлечённость, отметки «Нравится», комментарии, репосты и воспроизведения.
  • Ежедневные данные профиля: одна строка на профиль за каждый день с такими показателями, как количество подписчиков, показы, вовлечённость, охват и количество публикаций за этот день.

 

Перед началом

  • Интеграция с Power BI входит в дополнение Premium integrations.
  • Для вашего аккаунта нужен API access, который также предоставляется как дополнение. Если вы не видите Generate API key в разделе Settings → Integrations, свяжитесь с нашей службой поддержки, чтобы подключить эту функцию.
  • Вам понадобится ключ API Vista Social. Перейдите в раздел Settings → Integrations и нажмите Generate API key, если у вас ещё нет ключа. Не сообщайте его другим: любой, у кого есть ключ, сможет просматривать данные вашего аккаунта.
  • Для создания отчёта вам понадобится Power BI Desktop. Чтобы настроить обновление отчёта по расписанию, также понадобится Power BI Service.

 

Шаг 1. Найдите ID группы профилей

Каждый экспорт включает одну группу профилей. Чтобы посмотреть группы профилей и их ID:

  1. В Power BI Desktop нажмите Home → Get data, найдите blank и выберите Blank query.

Окно выбора источника данных в Power BI с выбранным пунктом Blank query

  1. Замените всё в редакторе запросов запросом ниже и вставьте свой API-ключ вместо YOUR_API_KEY. Если редактор запросов не открылся сразу, сначала нажмите 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
  1. Нажмите Next (или Done). Если Power BI покажет сообщение об отсутствующих учетных данных, нажмите Configure credentials, установите для параметра Authentication kind значение Anonymous и нажмите Connect. API-ключ уже указан в запросе, поэтому входить в систему в Power BI не нужно.

Окно подключения к источнику данных с параметром Authentication kind, установленным в значение Anonymous

Вы увидите таблицу с id, name и type каждой группы профилей, к которой у вас есть доступ. Скопируйте id группы, данные которой хотите включить в отчет. После этого запрос можно удалить.

Таблица Power BI со списком ID, названий и типов групп профилей

 

Шаг 2. Подключите Power BI к своим данным

  1. Нажмите Home → Get data → Web. Если пункта Web нет, нажмите стрелку под Get data или выполните поиск по слову web.
  2. Выберите Advanced.
  3. В поле URL parts вставьте адрес экспорта, заменив GROUP_ID на ID группы профилей:
  4. Проверьте столбец date. В данных публикаций даты представлены в виде текста, например «16 октября 2026 г.». Нажмите Transform Data, выберите столбец date, затем перейдите в Transform → Data Type → Date и нажмите Close & Apply. В данных профиля за каждый день уже используется формат YYYY-MM-DD, который обычно распознаётся как дата.
https://vistasocial.com/api/integration/powerbi/data?group=GROUP_ID&export_type=post&format=csv&days=90
  1. В разделе HTTP request header parameters введите x-api-key в качестве имени и вставьте свой API-ключ в качестве значения.
  2. Нажмите OK. Если Power BI предложит выбрать способ входа, выберите Anonymous и нажмите Connect. API-ключ передаётся в заголовке.
  3. На экране предварительного просмотра для параметра Data Type Detection выберите Based on entire dataset, чтобы метрики, значения которых отсутствуют в первых строках, также определялись как числа. Затем нажмите Load или Transform Data, чтобы сначала привести столбцы в порядок.

Данные публикаций Vista Social загружены в Power BI

Храните API-ключ в заголовке, а не в веб-адресе. Адреса часто сохраняются в журналах и истории браузера.

 

Изменение параметров экспорта

Измените параметры в адресе экспорта:

  • export_type: post одна строка на публикацию или daily одна строка на профиль за каждый день.
  • format: оставьте csv. Без этого параметра данные будут возвращены в формате JSON.
  • days: от 1 до 360. Скользящий период, заканчивающийся сегодня. При каждом запланированном обновлении его конец сдвигается вперёд.
  • date_from и date_to: фиксированный диапазон в формате YYYY-MM-DD продолжительностью до 360 дней. Используйте эти параметры вместо days. Если добавить оба варианта, будет использован параметр days.

Примеры:

  • Публикации за последние 30 дней: &export_type=post&format=csv&days=30
  • Данные профиля за каждый день за последние 90 дней: &export_type=daily&format=csv&days=90
  • Данные профиля за каждый день за первую половину года: &export_type=daily&format=csv&date_from=2026-01-01&date_to=2026-06-30

Чтобы создавать отчёты и по публикациям, и по данным профиля за каждый день, добавьте отдельный источник данных для каждого типа.

 

Использование пустого запроса

Если вы предпочитаете работать в редакторе запросов, нажмите Home → Get data → Blank query и вставьте запрос ниже. Замените GROUP_ID на ID группы профилей, а YOUR_API_KEY на свой API-ключ. Измените параметры внутри 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

Нажмите Next (или Done) и при появлении запроса выберите Anonymous. Затем нажмите Ctrl+A, чтобы выделить все столбцы, и выберите Transform → Detect Data Type. Если столбец date по-прежнему имеет текстовый формат, задайте для него тип Date. Переименуйте запрос и нажмите Close & Apply.

 

Что насчёт параметра Web API?

В плитке Web API в разделе Get data есть только поле URL, поэтому через неё нельзя передать заголовок x-api-key. Этот способ работает, если добавить &api_key=YOUR_API_KEY в конец адреса экспорта, но тогда ключ будет сохранён везде, где записывается этот адрес. По возможности используйте Web → Advanced.

 

Шаг 3: Создайте первую визуализацию

После загрузки данных создайте визуализации привычным для вас способом в Power BI. Например, чтобы построить график вовлечённости с течением времени:

  1. На панели Visualizations выберите тип диаграммы, например Line chart.
  2. На панели Data перетащите date на X-axis, а такой показатель, как engagement, на Y-axis.

Линейный график в Power BI: дата по оси X, вовлечённость по оси Y

 

Шаг 4: Поддерживайте данные в актуальном состоянии

  1. Опубликуйте отчёт в Power BI Service.
  2. В Power BI Service откройте Settings семантической модели.
  3. В разделе Data source credentials нажмите Edit credentials, выберите Anonymous и войдите в систему. Ваш API-ключ останется в заголовке, настроенном на шаге 2.
  4. В разделе Refresh включите запланированное обновление и выберите время, например ежедневно в 6:00.

Если в адресе указано days, при каждом обновлении будут загружаться данные за последние дни.

 

Важные примечания

  • Дата и время публикации указаны в часовом поясе самого поста, который отображается в столбце timezone.
  • Ежедневные данные профиля включают некоторые поля со списками, например hourly, hashtags и page_fans_country. Они передаются в виде текста, поэтому лучше удалить их в разделе Transform Data.
  • Экспорт охватывает период до 360 дней. Чтобы получить данные за более длительный период, добавьте отдельный запрос для каждого периода.
  • Power BI отображает большие значения в сокращённом виде, например «4 тысячи». Чтобы увидеть точное число, выберите визуальный элемент, откройте Format visual → Callout value и установите для параметра Display units значение None.
  • При создании нового API-ключа старый перестаёт работать. Обновите ключ в заголовке x-api-key источника данных, иначе обновление данных перестанет работать.

 

Устранение неполадок

  • Недействительный API-ключ: проверьте, что в заголовке x-api-key указан ваш текущий ключ из раздела Settings → Integrations.
  • (500): Внутренняя ошибка сервера при подключении: API-ключ не дошёл до Vista Social. Проверьте, что вы добавили заголовок x-api-key в раздел HTTP request header parameters. Если вы использовали плитку Web API, добавьте к адресу &api_key= и свой ключ.
  • Нет доступа к этой группе профилей: проверьте ID группы из шага 1. Вы можете экспортировать только группы, к которым у вас есть доступ.
  • Параметры date_from и date_to обязательны и должны быть указаны в формате YYYY-MM-DD: добавьте days к адресу или укажите обе даты в формате YYYY-MM-DD.
  • Запрашивайте данные не более чем за 360 дней: сократите период до 360 дней или меньше.
  • Ваша подписка не поддерживает интеграции: доступ к API не активирован для вашей учётной записи. Свяжитесь с нашей службой поддержки, чтобы подключить его.
  • Ваша подписка не включает дополнение для премиум-интеграций: дополнение для премиум-интеграций не активировано для вашей учётной записи. Свяжитесь с нашей службой поддержки, чтобы подключить его.
  • Слишком много запросов: для подключений Power BI установлен собственный лимит запросов в минуту. Повторите обновление через минуту и не обновляйте много источников данных одновременно.

 

Часто задаваемые вопросы

Q: Нужно ли мне войти в Power BI, чтобы воспользоваться этой функцией?

A: Нет, чтобы создать отчет в Power BI Desktop. Чтобы опубликовать отчет и настроить его обновление по расписанию, нужна учетная запись Power BI Service.

 

Q: Можно ли экспортировать данные более чем по одной группе профилей?

A: Каждый источник данных охватывает одну группу профилей. Добавьте отдельный источник для каждой группы, данные по которой хотите включить в отчет.

 

Q: Эти данные совпадают с данными в отчетах Vista Social?

A: Да. Power BI считывает те же данные о публикациях и ежедневные данные профилей, которые Vista Social использует в отчетах. Вы можете объединять их и визуализировать по своему усмотрению.

 

Нужна помощь?

Свяжитесь с нашей службой поддержки, и мы с радостью поможем.

 

Статьи по теме:

Настройка интеграции с Looker Studio для аналитики

Настройка интеграции с Tableau для аналитики

Зарегистрируйтесь и попробуйте Vista Social бесплатно в течение 14 дней!

Похожие статьи