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

Подключите аналитику Vista Social к Tableau и создавайте собственные дашборды. Tableau получает данные напрямую из Vista Social и может обновлять их по расписанию, чтобы ваши дашборды всегда были актуальными.

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

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

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

• Интеграция с Tableau входит в дополнение Premium integrations.
• Для вашего аккаунта нужен API access, который также доступен как дополнение. Если в разделе Settings → Integrations вы не видите Generate API key, обратитесь в нашу службу поддержки, чтобы подключить эту функцию.
• Вам понадобится API-ключ Vista Social. Откройте Settings → Integrations и нажмите Generate API key, если у вас ещё нет ключа. Не сообщайте ключ никому: любой, у кого он есть, сможет просматривать данные вашего аккаунта.
• Можно использовать Tableau Cloud, Tableau Desktop 2023.3 или более позднюю версию либо Tableau Server 2026.1 или более позднюю версию. В Tableau Cloud уже есть коннектор REST API. Для Tableau Desktop и Tableau Server потребуется один раз установить драйвер (см. раздел Использование Tableau Desktop или Tableau Server ниже).

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

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

1. В Tableau нажмите New → Published Data Source, затем откройте вкладку Connectors и выберите REST API.
2. На вкладке General укажите этот адрес в поле REST API URL, задайте для Response Format значение JSON, а для Authentication выберите No Authentication:

https://vistasocial.com/api/integration/tableau/groups

3. На вкладке Advanced введите ключ API в поле HTTP Headers в следующем формате: x-api-key: YOUR_API_KEY

4. Нажмите Sign In. Вы увидите Id, Name и Type каждой группы профилей, к которой у вас есть доступ. Скопируйте Id группы, данные по которой хотите включить в отчет.

Шаг 2. Подключите Tableau к данным

1. Снова нажмите New → Published Data Source → Connectors → REST API.
2. На вкладке General заполните поля:
   • REST API URL: адрес экспорта (см. раздел Создайте адрес экспорта ниже)
   • Response Format: CSV, а для параметра CSV Delimiter укажите ,
   • Authentication: No Authentication
3. На вкладке Advanced введите x-api-key: YOUR_API_KEY в поле HTTP Headers, как и на шаге 1.
4. Нажмите Sign In. Tableau загрузит данные и отобразит их поля.
5. Проверьте типы полей. Для поля Date должен отображаться значок календаря. Если для Published At отображается Abc, нажмите значок и выберите Date & Time.

6. Нажмите Publish As, укажите название источника данных и опубликуйте его.

По возможности указывайте ключ API в поле HTTP Headers, так как веб-адреса часто сохраняются в журналах и истории браузера.

Создайте адрес экспорта

Начните с этого адреса и замените GROUP_ID идентификатором из шага 1:

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

Затем настройте параметры:

• export_type: post для одной строки на публикацию или daily для одной строки на профиль за день.
• format: оставьте csv для Tableau. Без этого параметра данные будут передаваться в формате 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

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

Шаг 3. Поддерживайте актуальность данных

Tableau хранит копию ваших данных, которая называется извлечением. Чтобы обновлять её автоматически:

1. Откройте опубликованный источник данных в Tableau.
2. Перейдите в раздел Extract Refreshes и создайте расписание обновления, например каждый день в 6:00.

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

Использование Tableau Desktop или Tableau Server

Настройки подключения такие же, как в шаге 2. Сначала один раз установите драйвер REST API:

1. Скачайте драйвер REST API (JDBC) со страницы загрузки драйверов Tableau.
2. Переместите файл .jar в папку драйверов Tableau:
   • Windows: C:\Program Files\Tableau\Drivers
   • macOS: ~/Library/Tableau/Drivers
   • Linux: /opt/tableau/tableau_driver/jdbc
3. Перезапустите Tableau.
4. В Tableau Desktop перейдите в раздел Connect → To a Server → REST API и заполните вкладки General и Advanced, как описано в шаге 2.

В Tableau Server драйвер устанавливает администратор сервера, чтобы опубликованные извлечения данных можно было обновлять по расписанию.

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

• Tableau задает тип каждого столбца при первом создании источника данных. Если у метрики на тот момент не было значений, например, метрики историй для группы, в которой еще нет историй, Tableau может интерпретировать ее как текст. Щелкните значок типа поля и выберите Number (whole) или Number (decimal).
• Даты и время публикаций используют собственный часовой пояс каждой публикации, который отображается в столбце Timezone.
• Ежедневные данные профиля включают некоторые поля списка, такие как Hourly, Hashtags и Page Fans Country. Они передаются как текст, и их лучше не включать в ваши диаграммы.
• Экспорт охватывает до 360 дней. Для более длительной истории создайте источник данных для каждого периода.
• Повторное создание ключа API отключает старый ключ. Отредактируйте источник данных и укажите новый ключ в заголовке x-api-key, иначе обновления перестанут работать.

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

• Недействительный ключ API: проверьте, что в заголовке x-api-key указан ваш текущий ключ из раздела Settings → Integrations.
• Нет доступа к этой группе профилей: проверьте ID группы из шага 1. Вы можете экспортировать только те группы, к которым у вас есть доступ.
• Параметры date_from и date_to обязательны и должны быть указаны в формате YYYY-MM-DD: добавьте days к адресу или укажите обе даты в формате YYYY-MM-DD.
• Запрашивайте данные максимум за 360 дней: сократите диапазон дат до 360 дней или меньше.
• Ваша подписка не включает интеграции: доступ к API не активирован для вашей учетной записи. Обратитесь в нашу службу поддержки, чтобы подключить его.
• Ваша подписка не включает дополнение Premium integrations: дополнение Premium integrations не активировано для вашей учетной записи. Обратитесь в нашу службу поддержки, чтобы подключить его.
• Слишком много запросов: для подключений Tableau действует собственный лимит запросов в минуту. Повторите обновление через минуту и не обновляйте много источников данных одновременно.

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

Q: Какая версия Tableau мне нужна?

A: Tableau Cloud работает сразу после подключения. Tableau Desktop версии 2023.3 или новее и Tableau Server версии 2026.1 или новее тоже подойдут после однократной установки драйвера REST API.

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

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

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

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

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

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

Читайте также:

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

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

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