Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 37 Next »

Allow Baidu Analytics tracking to be easily added to and configured for a STK site.

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.

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

Concept Google Analytics

http://documentation.magnolia-cms.com/display/DOCS45/Google+Analytics+module#GoogleAnalyticsmodule-Configuration

 

  • No labels