← Все инструкции
Интеграции

Подключение Google Analytics 4

Полная инструкция: какой service account использовать, где выдать ему доступ и где взять правильный GA4 Property ID.

11. Что уже должно быть настроено в JuraSale

  1. Администратор JuraSale один раз загружает JSON-ключ service account в «Настройки сервиса → Google Analytics». Этот JSON общий для всех сайтов: создавать новый ключ для каждого сайта не нужно.
  2. На странице интеграции конкретного сайта JuraSale показывает email service account. Именно этот адрес нужно добавить в Google Analytics. Сам JSON и private_key владельцу сайта передавать не нужно.

22. Выберите правильный ресурс GA4

  1. Откройте Google Analytics и в селекторе сверху выберите аккаунт и ресурс, который относится именно к подключаемому сайту.
  2. Если в аккаунте несколько ресурсов, дополнительно проверьте «Администратор → Потоки данных / Data streams»: веб-поток должен относиться к нужному домену. Это помогает не выдать доступ не тому ресурсу.

33. Выдайте доступ service account

  1. В выбранном ресурсе откройте «Администратор → Управление доступом к ресурсу / Property Access Management». Нажмите «+ → Добавить пользователей / Add users».
  2. Вставьте email service account, который показывает JuraSale, назначьте роль «Viewer / Читатель» и нажмите «Добавить / Add». Роли Viewer достаточно для чтения отчётов через GA4 Data API.
  3. Доступ можно выдать и на уровне Analytics Account, тогда он наследуется всеми ресурсами этого аккаунта. Для JuraSale безопаснее выдавать доступ только на уровне нужного Property.

44. Найдите именно Property ID

  1. В том же ресурсе откройте «Администратор → Сведения о ресурсе / Property details». Скопируйте поле «Property ID». Это числовой идентификатор, например 123456789.
  2. Не используйте Measurement ID / Google tag ID вида G-XXXXXXXXXX из «Потоки данных», не используйте ID аккаунта Analytics и не используйте название ресурса. JuraSale нужен только числовой GA4 Property ID.

55. Сохраните данные в JuraSale

  1. Откройте нужный сайт в JuraSale → «Интеграции → Google Analytics». В поле «GA4 Property ID» вставьте только цифры. Поле Property name можно заполнить произвольным понятным названием.
  2. Нажмите «Сохранить», затем «Проверить подключение». При успехе JuraSale сможет читать отчёты этого GA4-ресурса.

66. Ошибка «Service account не имеет доступа»

  1. Почти всегда это означает несоответствие между доступом и Property ID: service account добавлен в один GA4-ресурс, а в JuraSale указан ID другого.
  2. Сверьте одновременно три значения: 1) email service account в JuraSale; 2) этот же email присутствует в Property Access Management нужного ресурса; 3) Property ID в JuraSale совпадает с «Property details» этого же ресурса.
  3. Если вы случайно вставили G-XXXXXXXXXX, удалите его и укажите числовой Property ID. После исправления сохраните настройки и снова нажмите «Проверить подключение».

77. После успешного подключения

  1. Данные появятся в разделе «Аналитика». Основной отчёт JuraSale сохраняет в своей БД, поэтому повторное открытие работает быстрее.
  2. Кнопка «Обновить из GA4» принудительно получает свежие данные; Realtime загружается отдельно.
Не отправляйте другим пользователям API-токены, OAuth secrets или JSON-ключ сервисного аккаунта.