Third Party Analytics

For Subscriptions, we provide two additional events that can be fired for third party analytics: display of the paywall and display of the meter. This functionality can be found in the Configuration section. These services can be integrated using the same infrastructure as the more general Instant Articles analytics.

Paywall and Meter Behavior

Paywall events fire instantly when an article is opened on. As such, it may fire before the actual paywall is within view.

Paywalled articles are not counted towards page views. When a paywall event is fired, the general Instant Articles page view event is not fired.

If it is imperative that paywalled article views are counted as page views, additional effort will be required to ensure that the paywall display event encompasses both.

The meter event fires a short period of time – usually 1 to 2 seconds – after an article is opened.

Android paywall views are available in Facebook Analytics as a page event. Firing a Facebook Pixel event for that might lead to double paywall counts on Facebook Analytics

What kind of analytics services are supported?

At launch we are providing support for both URL and Javascript-based services.

URL analytics services

A request will be made to the supplied URL, providing event information via query parameters. The following query parameters will be provided.

Query Parameters:

  • ia_share_url – URL of the selected content
  • ia_title – Title of Article accessed
  • ia_referrer – ia.facebook.com
  • read_count – User's read count for the current month including IAs and mobile web
https://my-url-analytics.com/?ia_title=...&ia_share_url=...&ia_referrer=..&read_count=...

Javascript

We provide two Javascript objects for use in better understanding interaction with the paywall and meter.

ia_document.shareURL;
ia_document.title;
ia_document.referrer;
ia_subscription.readCount;

Example Chartbeat script that accesses the javascript objects

  <script type='text/javascript'>
     var _sf_async_config = {};
    /** CONFIGURATION START **/
    _sf_async_config.uid = 1234;
    _sf_async_config.domain = 'www.my_example_domain.com';
    _sf_async_config.title = ia_document.title;
    /** SET CUSTOM FIELDS **/
    var _cbq = window._cbq = (window._cbq || []);
    _cbq.push(['_readcount', ia_subscription.readCount]);
    /** CONFIGURATION END **/
    window._sf_endpt = (new Date()).getTime();
<p></script></p>
<script defer src="//<a href="http://static.chartbeat.com/js/chartbeat_fia.js">static.chartbeat.com/js/chartbeat_fia.js"></a>>;