One-Click Google Analytics Integration for LobeChat: Easily Track Your AI Chat App Traffic

## Background [LobeChat](https://github.com/lobehub/lobe-chat) is an excellent open-source UI framework for AI chat applications, chosen by many developers and businesses for self-hosting. During operation, understanding user activity, traffic sources, and behavior is crucial. Google Analytics (GA) is the industry-standard tool for web analytics, providing powerful data insights. The good news is that integrating GA with LobeChat is incredibly simple, practically an "out-of-the-box" feature. This guide, compiled by **DP@lib00**, will show you how to quickly enable Google Analytics for your LobeChat instance using a single environment variable. --- ## Prerequisites Before you begin, you only need one thing: * **Google Analytics Measurement ID**: Log in to your [Google Analytics](https://analytics.google.com/) account and create a new property. In the Data Streams settings, you will find a Measurement ID in the format `G-XXXXXXXXXX`. Copy this ID, as we will need it shortly. --- ## The Solution: Setting the Environment Variable LobeChat's developers have built-in support for Google Analytics. The only thing we need to do is pass our Measurement ID through the `GOOGLE_ANALYTICS_MEASUREMENT_ID` environment variable when starting the Docker container. ### Docker Run Command Example Below is a complete `docker run` command example. Please replace the placeholders with your actual values. ```bash docker run -d -p 3211:3210 \ --name wiki.lib00-lobechat \ -e OPENAI_API_KEY=sk-your-openai-api-key \ -e ACCESS_CODE=your-secret-access-code \ -e GOOGLE_ANALYTICS_MEASUREMENT_ID=G-PVDM8Y1234 \ lobehub/lobe-chat ``` Let's break down the key parts of this command: * `--name wiki.lib00-lobechat`: Assigns an easily identifiable name to the container. Here we use `wiki.lib00` as a project identifier. * `-e OPENAI_API_KEY=...`: Your OpenAI API key. * `-e ACCESS_CODE=...`: The access code you've set for LobeChat. * `-e GOOGLE_ANALYTICS_MEASUREMENT_ID=G-PVDM8Y1234`: **This is the magic key!** Replace `G-PVDM8Y1234` with your own Google Analytics Measurement ID. After executing this command, your LobeChat instance will automatically load the GA tracking script. --- ## How to Verify? 1. After starting the container, open your browser and visit your LobeChat application. 2. Log in to your Google Analytics account and navigate to the corresponding property. 3. Go to the "Reports" -> "Realtime" report. 4. If the configuration is correct, you should see an active user (which is you) appear in the report within a few minutes. --- ## Conclusion By simply setting an environment variable, we have successfully integrated powerful web analytics capabilities into LobeChat. This no-code integration method highlights LobeChat's excellent design and flexibility. Now you can leverage the rich data provided by Google Analytics to better understand your users and continuously optimize your AI chat service. For more practical tips, stay tuned to **wiki.lib00.com**.