Tecnichal stuff.

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

Add more power to Linkpulse with 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.

HTML meta markup

Linkpulse can also retrieve metadata from the traditional html meta markup code from your site and in many cases this works great.

code

Example of traditional meta tags


<meta name="title" content="Add more power to Linkpulse with metadata" />
<meta name="description" content="We believe in power of metadata as part of the analysis of the realtime trafic data." />
<link id="fb_thumb" rel="image_src" href="http://www.linkpulse.com/gfx/linkpulse-180-white.png" />
<link rel="canonical" href="http://www.linkpulse.com/docs/opengraph/" />
<meta name="keywords" content="Linkpulse,metadata,open graph" />
        

Open Graph Protocol

Your site might already have Open Graph Tags implemented, if so, then you are set since Linkpulse will autodetect these and use them as source for the metadata.

Implementing Open Graph is easy and many publishing platforms already supports this per default.

code

Basic Metadata with Open Graph


<meta property="og:title" content="Add more power to Linkpulse with metadata" />
<meta property="og:type" content="article" />
<meta property="og:url" content="http://www.linkpulse.com/docs/opengraph/" />
<meta property="og:image" content="http://www.linkpulse.com/gfx/linkpulse-180-white.png" />
<meta property="og:description" content="We believe in power of metadata as part of the analysis of the realtime trafic data." />
        

Even more meta power

Linkpulse supports several more Open Graph fields and we have introduced a few ourself. See the example under and the field guide table.

Notice the lp:channel, read more about this further down.

code

Advance example


 <meta property="og:title" content="Add more power to Linkpulse with metadata" />
 <meta property="og:type" content="article" />
 <meta property="og:url" content="http://www.linkpulse.com/docs/opengraph/" />
 <meta property="og:image" content="http://www.linkpulse.com/gfx/linkpulse-180-white.png" />
 <meta property="og:description" content="We believe in power of metadata as part of the analysis of the realtime trafic data." />
 <meta property="article:author" content="Nils Dahl"/>
 <meta property="article:published_time" content="2012-08-10T09:29:00"/>
 <meta property="article:modified_time" content="2012-08-12T14:48:00"/>
 <meta property="article:section" content="documentation"/>
 <meta property="lp:channel" content="web"/>
        

Give me total meta power

In some case you want to provide different metadata to Linkpulse than eg. Facebook. This is very easy, duplicate your existing Open Graph tags and swap the prefix 'og:' with 'lp:'. With some of the attributes you will need to add 'lp.', eg. article.autor will be lp.article.author.

code

Advance example with lp: prefix


 <meta property="lp:title" content="Add more power to Linkpulse with metadata" />
 <meta property="lp:type" content="article" />
 <meta property="lp:url" content="http://www.linkpulse.com/docs/opengraph/" />
 <meta property="lp:image" content="http://www.linkpulse.com/gfx/linkpulse-180-white.png" />
 <meta property="lp:description" content="We believe in power of metadata as part of the analysis of the realtime trafic data." />
 <meta property="lp.article:author" content="Nils Dahl"/>
 <meta property="lp.article:published_time" content="2012-08-10T09:29:00"/>
 <meta property="lp.article:modified_time" content="2012-08-12T14:48:00"/>
 <meta property="lp.article:section" content="documentation"/>
 <meta property="lp:channel" content="web"/>
        

Open Graph fields

Field (LP) Type Description
title string Title for your url
description string Description/synopsis for this url. Linkpulse only uses the first 255 chars of the given value.
type string Url type, eg. frontpage, article, sectionpage
url url Url to this page. Note: Linkpulse uses this value for the url to log trafic on. Meaning that you can log several different url's on to one single url.
image url Url to the image representing this url.
article.author string Author/Owner of the content on this url. More authors can be added with comma as delimter.
Example:
<meta property="lp.article:author" content="Nils Dahl,Tarjei Gilbrant, Erik Weden"/> Power tip:
Use email or another unique id for the author and then map the id to the user in Linkpulse.
article.published_time dateTime When was the article published.
article.modified_time dateTime When was the article updated.
article.section string Section this article resides in, use short unique names for this value. Eg. sport, technews, forum etc.
lp.channel string lp.channel is a new field that we have introduced. We use this to identify which channel/plattform the user is accessing the content via. Eg. is the user viewing the smartphone version or the desktop version of a page.
Eg. mobile,table,TV,RSS and desktop.