Purpose
Problem
Allow users to easily add Baidu Analytics tracking to their Magnolia CMS website. Baidu Analytics is the equivalent of Google Analytics in China.
Administrators of websites in China may prefer Baidu Analytics to Google Analytics because:
- It may be more familiar to Chinese website administrators.
- It is integrated with other Baidu services such as their advertising platform that the administrator may want use.
- Google is sometimes blocked in China which can make Google Analytics inaccurate for websites hosted in China.
Goals
For each site, the user should be able to configure the Baidu Analytics tracking ID for the site.
For each site, the user should be able to enable and disable Baidu Analytics tracking for the site.
For each site, if the tracking ID is added for a site and Baidu Analytics is enabled for a site, then standard Baidu Analytics page tracking should work on each page of the site.
Use Cases
Since Google Analytics and Baidu Analytics are similar in functionality, and there is already a Google Analytics module, we will try to match the user experience for the Baidu Analytics module to the Google Analytics module wherever that makes sense.
Under Configuration:/modules/baidu-analytics/config/sites/ will be nodes corresponding to sites as defined in Site Definitions.
Each node in Configuration:/modules/baidu-analytics/config/sites/ will contain two properties enabled and trackerID.
A user enables standard Baidu Analytics page tracking for all pages of a site by creating a node in Configuration:/modules/baidu-analytics/config/sites/ with the same name as the site defined in Site Definitions and setting its enabled property to true and setting its trackerID property to the ID provided by Baidu Analytics.
A user disables standard Baidu Analytics page tracking for all pages of a site by either setting the enabled property of the node in Configuration:/modules/baidu-analytics/config/sites/ corresponding to the site to false or deleting the node in Configuration:/modules/baidu-analytics/config/sites/ corresponding to the site altogether.
After installation Configuration:/modules/baidu-analytics/config/sites/ will contain two nodes, a site node for the default CE site and a default node for the default EE site. The enabled properties of both nodes will be set to false and the trackerID property of both nodes will not be set.
Questions
What if the trackerID is set but set incorrectly?
Proposal
Design
Related
Google Analytics Module
Overview
Content Tools
Apps
Activity