Allow Baidu Analytics tracking to be easily added to and configured for a STK site.
Purpose
Problem
User wants to add Baidu Analytics tracking to their STK 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 be using.
- Google is sometimes blocked in China which can make Google Analytics inaccurate for websites hosted in China.
Goals
For each STK site, users should be able to easily enable and disable Baidu Analytics tracking for all pages of the site by specifying the Baidu tracking ID and setting an enable flag.
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.
Enable Baidu Analytics tracking for all pages of a site
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.
Disable Baidu Analytics tracking for all pages of a site
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.
Installation
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.
Proposal
Design
Standard Baidu Analytics page tracking for all pages of a site is enabled if and only if there is a node in Configuration:/modules/baidu-analytics/config/sites/ with the same name as the site defined in Site Definitions and its enabled property is set to true and its trackerID property is set to a valid ID provided by Baidu Analytics.
Questions
What if the trackerID is set but set incorrectly?
What if the website temporarily cannot connect to Baidu Analytics?
Related
Google Analytics Module
Overview
Content Tools
Apps
Activity