88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support

Hướng dẫn thiết lập công cụ phân tích

Tổng quan

88API hiện hỗ trợ tích hợp với các nền tảng phân tích phổ biến để giúp bạn theo dõi hành vi của người dùng và hiệu suất trang web:

  • Google Analytics 4 (GA4): Phiên bản mới nhất của nền tảng phân tích của Google
  • Umami Analytics: Công cụ phân tích nguồn mở, tập trung vào quyền riêng tư

Cả hai công cụ phân tích có thể được kích hoạt đồng thời mà không có xung đột.

Các tính năng chính

✅ Tích hợp mã 0 - chỉ được định cấu hình thông qua các biến môi trường ✅ Tự động chèn script vào giao diện Web ✅ Hỗ trợ triển khai Docker và độc lập ✅ Triển khai tập trung vào quyền riêng tư ✅ Không cần sửa đổi mã giao diện người dùng

Thiết lập Google Analytics 4

1. Lấy ID đo lường của bạn

  1. Truy cập Google Analytics
  2. Tạo thuộc tính mới hoặc chọn thuộc tính hiện có
  3. Đi tới Quản trị viên → Luồng dữ liệu
  4. Tạo hoặc chọn luồng dữ liệu web
  5. Sao chép ID đo của bạn (Định dạng: G-XXXXXXXXXX)

2. Cấu hình biến môi trường

Using Docker Compose:

Chỉnh sửa tập tin docker-compose.yml và bỏ ghi chú dòng Google Analytics:

environment:
  - GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX # Replace with your actual Measurement ID

Standalone Deployment:

Thêm vào tệp .env hoặc đặt làm biến môi trường:

export GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX

Using Docker Run:

docker run -d \
  -e GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX \
  ...Other options...
  calciumion/new-api:latest

3. Khởi động lại ứng dụng

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

# Standalone Deployment
# Restart your application directly

Thiết lập phân tích Umami

1. Lấy thông tin xác thực Umami

Option A: Using Umami Cloud

  1. Đăng ký trên Umami Cloud
  2. Thêm trang web mới
  3. Sao chép ID trang web (định dạng UUID) của bạn

Option B: Self-hosting Umami

  1. Triển khai phiên bản Umami của riêng bạn
  2. Tạo một trang web trong bảng điều khiển
  3. Sao chép ID trang web và URL tập lệnh của bạn

2. Cấu hình biến môi trường

Using Docker Compose:

Chỉnh sửa tập tin docker-compose.yml:

environment:
  - UMAMI_WEBSITE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  # Optional: Only required for self-hosted instances
  - UMAMI_SCRIPT_URL=https://your-umami-domain.com/script.js

Standalone Deployment:

Thêm vào tập tin .env:

export UMAMI_WEBSITE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
export UMAMI_SCRIPT_URL=https://your-umami-domain.com/script.js  # Optional

Note: If using Umami Cloud, you do not need to set UMAMI_SCRIPT_URL, as it defaults to the official URL.

3. Khởi động lại ứng dụng

Tương tự như Google Analytics - khởi động lại ứng dụng để áp dụng các thay đổi.

Sử dụng đồng thời cả hai công cụ phân tích

Bạn có thể bật cả Google Analytics và Umami cùng lúc:

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

Xác minh

Sau khi khởi động lại ứng dụng:

  1. Mở giao diện Web trên trình duyệt
  2. Mở công cụ dành cho nhà phát triển trình duyệt (F12) → tab Mạng
  3. Làm mới trang
  4. Tìm các yêu cầu sau:
  • Google Analytics: https://www.googletagmanager.com/gtag/js
  • Umami: URL tập lệnh được định cấu hình của bạn

Bạn cũng có thể kiểm tra mã nguồn trang và tìm tập lệnh được chèn vào trong phần <head>.

Khắc phục sự cố

Analytics tools not working?

  1. ✅ Xác minh rằng các biến môi trường được đặt chính xác
  2. ✅ Khởi động lại ứng dụng sau khi thay đổi biến
  3. ✅ Kiểm tra bảng điều khiển trình duyệt xem có lỗi không
  4. ✅ Đảm bảo định dạng ID đo lường/ID trang web là chính xác
  5. ✅ Kiểm tra xem các trình chặn quảng cáo có can thiệp không

Docker Users:

# Check if environment variables are set
docker exec new-api env | grep -E "GOOGLE_ANALYTICS|UMAMI"

Cân nhắc về quyền riêng tư

  • Google Analytics thu thập dữ liệu người dùng theo Chính sách quyền riêng tư của Google
  • Umami tập trung vào quyền riêng tư và không thu thập dữ liệu cá nhân
  • Nếu sử dụng công cụ phân tích, hãy cân nhắc thêm chính sách bảo mật vào trang web của bạn
  • Cả hai công cụ khi được định cấu hình chính xác đều có thể tuân thủ các yêu cầu của GDPR

Tham chiếu biến môi trường

BiếnBắt buộcGiá trị mặc địnhMô tả
GOOGLE_ANALYTICS_IDKhông-Mã đo lường Google Analytics 4 (Định dạng: G-XXXXXXXXXX)
UMAMI_WEBSITE_IDKhông-ID trang web Umami (định dạng UUID)
UMAMI_SCRIPT_URLKhônghttps://analytics.umami.is/script.jsURL tập lệnh Umami (Chỉ bắt buộc đối với tự lưu trữ)

Các liên kết liên quan

Mục lục

Tổng quan
Các tính năng chính
Thiết lập Google Analytics 4
1. Lấy ID đo lường của bạn
2. Cấu hình biến môi trường
3. Khởi động lại ứng dụng
Thiết lập phân tích Umami
1. Lấy thông tin xác thực Umami
2. Cấu hình biến môi trường
3. Khởi động lại ứng dụng
Sử dụng đồng thời cả hai công cụ phân tích
Xác minh
Khắc phục sự cố
Cân nhắc về quyền riêng tư
Tham chiếu biến môi trường
Các liên kết liên quan