Guide de configuration de l'outil d'analyse

Aperçu

88API prend désormais en charge l'intégration avec les plateformes d'analyse populaires pour vous aider à suivre le comportement des utilisateurs et les performances du site Web:

Google Analytics 4 (GA4): la dernière version de la plateforme d'analyse de Google
Umami Analytics: un outil d'analyse open source axé sur la confidentialité

Les deux outils d'analyse peuvent être activés simultanément sans conflit.

✅ Intégration sans code - configurée uniquement via des variables d'environnement ✅ Injecte automatiquement des scripts dans l'interface Web ✅ Prend en charge le déploiement Docker et autonome ✅ Mise en œuvre axée sur la confidentialité ✅ Aucune modification du code frontal requise

Configuration de Google Analytics 4

1. Obtenez votre identifiant de mesure

Visitez Google Analytics
Créez une nouvelle propriété ou sélectionnez-en une existante
Accédez à Admin → Flux de données
Créez ou sélectionnez un flux de données Web
Copiez votre ID de mesure (Format: G-XXXXXXXXXX)

2. Configurer les variables d'environnement

Using Docker Compose:

Editez le fichier docker-compose.yml et décommentez la ligne Google Analytics:

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

Standalone Deployment:

Ajoutez au fichier .env ou définissez comme variable d'environnement:

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. Redémarrez l'application

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

# Standalone Deployment
# Restart your application directly

Configuration d'Umami Analytics

1. Obtenez les informations d'identification Umami

Option A: Using Umami Cloud

Inscrivez-vous sur Umami Cloud
Ajouter un nouveau site Web
Copiez votre ID de site Web (format UUID)

Option B: Self-hosting Umami

Déployez votre propre [instance Umami] (https://umami.is/docs/install)
Créez un site Web dans le tableau de bord
Copiez votre ID de site Web et votre URL de script.

2. Configurer les variables d'environnement

Using Docker Compose:

Editez le fichier 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:

Ajoutez au fichier .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. Redémarrez l'application

Identique à Google Analytics: redémarrez l'application pour appliquer les modifications.

Utilisation simultanée des deux outils d'analyse

Vous pouvez activer à la fois Google Analytics et Umami:

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

Vérification

Après avoir redémarré l'application :

Ouvrez l'interface Web dans votre navigateur
Ouvrez les outils de développement du navigateur (F12) → onglet Réseau
Actualisez la page
Recherchez les demandes suivantes:

Google Analytics: https://www.googletagmanager.com/gtag/js
Umami : Votre URL de script configurée

Vous pouvez également vérifier le code source de la page et rechercher le script injecté dans la section <head>.

Dépannage

Analytics tools not working?

✅ Vérifiez que les variables d'environnement sont correctement définies
✅ Redémarrez l'application après avoir modifié les variables
✅ Vérifiez la console du navigateur pour les erreurs
✅ Assurez-vous que le format de l'ID de mesure/ID de site Web est correct.
✅ Vérifiez si les bloqueurs de publicités interfèrent

Docker Users:

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

Considérations relatives à la confidentialité

Google Analytics collecte les données des utilisateurs conformément à la Politique de confidentialité de Google
Umami est axé sur la confidentialité et ne collecte pas de données personnelles
Si vous utilisez des outils d'analyse, envisagez d'ajouter une politique de confidentialité à votre site Web.
Les deux outils, lorsqu'ils sont configurés correctement, peuvent être conformes aux exigences du RGPD

Référence des variables d'environnement

Variables	Obligatoire	Valeur par défaut	Descriptif
`GOOGLE_ANALYTICS_ID`	Non	-	ID de mesure Google Analytics 4 (Format: G-XXXXXXXXXX)
`UMAMI_WEBSITE_ID`	Non	-	Identifiant du site Web Umami (format UUID)
`UMAMI_SCRIPT_URL`	Non	`https://analytics.umami.is/script.js`	URL du script Umami (uniquement requis pour les auto-hébergés)

Aperçu

Principales fonctionnalités

Configuration de Google Analytics 4

1. Obtenez votre identifiant de mesure

2. Configurer les variables d'environnement

3. Redémarrez l'application

Configuration d'Umami Analytics

1. Obtenez les informations d'identification Umami

2. Configurer les variables d'environnement

3. Redémarrez l'application

Utilisation simultanée des deux outils d'analyse

Vérification

Dépannage

Considérations relatives à la confidentialité

Référence des variables d'environnement

Liens connexes

Sommaire