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 49 Next »

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, the user can easily enable Baidu Analytics tracking for all pages of the site by specifying the Baidu tracking ID and setting an enable flag to true. They should be able to easily disable tracking for all pages of the site by setting the enable flag to false.

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 of the same name 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/ with the same name as the site defined in Site Definitions to false or deleting the node in Configuration:/modules/baidu-analytics/config/sites/ with the same name as the site defined in Site Definitions 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