Руководство по настройке инструмента анализа

Обзор

88API теперь поддерживает интеграцию с популярными аналитическими платформами, чтобы помочь вам отслеживать поведение пользователей и производительность веб-сайта:

• Google Analytics 4 (GA4): последняя версия платформы Google Analytics.
• Umami Analytics: инструмент аналитики с открытым исходным кодом, ориентированный на конфиденциальность.

Оба инструмента анализа можно включить одновременно, не конфликтуя друг с другом.

Особенности

✅ Интеграция без кода — настраивается только через переменные среды ✅ Автоматически внедрять скрипты в веб-интерфейс ✅Поддерживает Docker и независимое развертывание. ✅ Реализация, ориентированная на конфиденциальность ✅ Нет необходимости изменять внешний код

Настройки Google Аналитики 4

1. Получите идентификатор измерения

1. Посетите Google Analytics
2. Создайте новое свойство или выберите существующее.
3. Введите Управление → Поток данных.
4. Создайте или выберите поток данных веб-сайта.
5. Скопируйте свой Идентификатор измерения (формат: G-XXXXXXXXXX).

2. Настройте переменные среды

Использование Docker Compose:

Отредактируйте файл docker-compose.yml и раскомментируйте строку Google Analytics:

environment:
  - GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX # Замените фактическими измерениями. ID

Независимое развертывание:

Добавьте в файл .env или установите как переменную среды:

export GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX

Использование Docker Run:

docker run -d \
  -e GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX \
  ...Другие варианты...
  calciumion/new-api:latest

3. Перезапустите приложение.

# Docker Compose
docker-compose down && docker-compose up -d

# Автономное развертывание
# Перезапустите приложение напрямую

Настройки аналитики Umami

1. Получите учетные данные Умами

Вариант А. Используйте Umami Cloud

1. Зарегистрируйтесь в Umami Cloud
2. Добавьте новый сайт
3. Скопируйте свой Идентификатор сайта (формат UUID).

Вариант Б: самостоятельное размещение умами

1. Разверните свой собственный [экземпляр Umami] (https://cloud.umami.is/)
2. Создайте сайт в панели управления.
3. Скопируйте Идентификатор сайта и URL-адрес скрипта.

2. Настройте переменные среды

Использование Docker Compose:

Отредактируйте файл https://cloud.umami.is/:

environment:
  - UMAMI_WEBSITE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  # Необязательный：Требуется только для локальных экземпляров.
  - UMAMI_SCRIPT_URL=https://your-umami-domain.com/script.js

Независимое развертывание:

Добавьте в файл .env:

export UMAMI_WEBSITE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
export UMAMI_SCRIPT_URL=https://your-umami-domain.com/script.js  # Необязательный

Примечание. При использовании Umami Cloud нет необходимости устанавливать UMAMI_SCRIPT_URL, поскольку по умолчанию используется официальный URL-адрес.

3. Перезапустите приложение.

То же, что и Google Analytics: перезапустите приложение, чтобы применить изменения.

Используйте два инструмента анализа одновременно

Вы можете включить Google Analytics и Umami одновременно:

environment:
  - GOOGLE_ANALYTICS_ID=G-ABC123XYZ
  - UMAMI_WEBSITE_ID=a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6
  - UMAMI_SCRIPT_URL=https://analytics.umami.is/script.js

Проверить

После перезапуска приложения:

1. Откройте веб-интерфейс в браузере.
2. Откройте инструменты разработчика браузера (F12) → вкладка Сеть.
3. Обновите страницу.
4. Найдите следующие запросы:
   • Google Аналитика: https://www.googletagmanager.com/gtag/js
   • Умами: URL-адрес скрипта, который вы настроили.

Вы также можете просмотреть исходный код страницы и найти внедренный скрипт в разделе https://www.googletagmanager.com/gtag/js.

Поиск неисправностей

**Инструмент анализа не работает? **

1. ✅ Убедитесь, что переменные среды установлены правильно.
2. ✅ Перезапустите приложение после изменения переменных.
3. ✅ Проверьте консоль браузера на наличие ошибок.
4. ✅ Убедитесь, что идентификатор измерения/идентификатор места имеет правильный формат.
5. ✅ Проверьте, не мешает ли ваш блокировщик рекламы.

Пользователи Docker:

# Проверьте, установлены ли переменные среды
docker exec new-api env | grep -E "GOOGLE_ANALYTICS|UMAMI"

Соображения конфиденциальности

• Google Analytics собирает данные пользователей в соответствии с Политикой конфиденциальности Google.
• Умами ценит конфиденциальность и не собирает личные данные. – Если вы используете инструменты аналитики, рассмотрите возможность добавления политики конфиденциальности на свой веб-сайт.
• Оба инструмента соответствуют требованиям GDPR при правильной настройке.

Ссылка на переменную среды

Ссылки по теме

• Google Analytics
• Умами Аналитика
• Документация Умами
• Конфиденциальность Google Analytics