Tecnichal stuff.

Don't worry, it's in "English".

Before you start

You will need access to a Linkpulse installation. You should also have recieved an url from us, pointing to a javascript file to be included on your webpages.

Log traffic with Linkpulse

To implement realtime traffic logging with Linkpulse is just a matter of a copy & paste of some javascript on to your site. We recommend putting this javascript code in the header section of your markup. The same javascript can also be used for your touch based site (ie. mobile and tablet). You should have recieved the javascript url from us, if not please contact us.

code

Example of Linkpulse script tag

<script type="text/javascript" 
  src="//pp.lp4.io/app/aa/bb/bb/aabbcceedd00000000000000.js">
</script>

Log AMP traffic

During our years with Linkpulse in the news publishing world, we have often seen publishers underestimating the value of reducing the page loading/rendering speed factor. The AMP project (Accelerated Mobile Pages Project) is a great initiative that we developers at Linkpulse embrace and welcome. Finally a project focusing on page speed without going outside of the boundaries of HTML world.

Head over to the implementation documentation for Linkpulse with AMP pages for more details .

Implement metadata

We believe in the power of metadata as part of the analysis of the realtime traffic data. Therefore we implemented Open Graph Protocol in Linkpulse, as Facebook, Twitter and many more services have.

The cool thing with Open Graph is how easy it is to implement but still is a very powerful solution when it comes to share metadata for your published content. We strongly recommend you to implement Open Graph support on your sites, regardless if you are using Linkpulse or not.

Read more about how Linkpulse deals with this here.

Implement position tracking

Linkpulse is able to track where on the page occurred as well. Linkpulse does not only track x and y coordinates, but also logical positions grouped together to form a page composition layout, allowing you to group data and analyse your design in live and historical context.

Read more on how to implement position tracking here.

Rest API

Linkpulse REST API allows your code to retrieve live stats for your Linkpulse monitored sites. Use the API to publish top lists for your site or integrate the with your CMS plattform for stats withing your system.

Linkpulse REST API V2 is based on the JSON-API specification (http://jsonapi.org/). All responses are in json-api format.

The Linkpulse Rest API uses 2-legged OAuth 1.0 model for authorization (aka 'signed fetch'). Meaning that every request to the API must be signed with consumer key and secret. More information about OAuth can be found here.

You will need OAuth Consumer key and OAuth Consumer secret for the Linkpulse installation you want access via the API. More information on how to obtain these here.

Rest API resources

Resource Description
/v2/users/me returns the authenticated user information. details
/v2/inscreen Get inscreen data for urls, like viewtime and scroll depth etc. details
/v2/keystats Get key numbers for today, like clickratio details
/v2/query Query statistical collections. Do your own aggregation, sorting and filtering. details
/v2/scores Get urls weighted by score. Score is calculated from multiple data sources in Linkpulse. details
/v2/toppages Get urls with most pageviews details
/v2/topstories Monitor which pages are getting most click traffic right now details
/v2/uniqueusers Get uniqueusers numbers details

To be able to see the detailed API documentation, you will need OAuth Consumer key for the Linkpulse installation you want access. More information on how to obtain these here.

Code example is also available at https://api5.linkpulse.com/docs/

Feeds

Linkpulse feeds lets you retrieve live stats from the Dashboard widgets in XML, RSS or Json format. Use your existing filters to control the content. Feeds can be used in your own web app for custom widgets.

Feed types

Type Description
Top Stories Returns a list of your top articles details
Top List Returns a list of your top articles details
Click Flow Returns live status of page views and clicks details