Facebook instant article¶

You want to collect the full potential of your data via INFOnline Measurement?

We recommend that you additionally integrate the pseudonymous measurement into your facebook instant article. Please note that participation of your site in IVW reporting may require parallel integration of pseudonymous measurement and census measurement in your facebook instant article.

Census measurement¶

Attention

If you activate pseudonymous measurement via the INFOnline Measurement Manager, it is mandatory to have the standalone script integrated in facebook instant article.

Requirements¶

Relay client container (hosted by INFOnline or self-hosted)
Registered domain service name as CNAME (hosted by INFOnline), AAA(A) (self-hosted) DNS entry
Site ID (provided by INFOnline GmbH)

Integration¶

A publisher can embed the fbia sensor for census measurement within an iframe in any article by using the Analytics element. Everything in this <iframe> will be executed at the beginning of each article load, but the web view will remain hidden from the reader. This embedding must be included in the <body> of the article and is not supported in the <head> or <footer>. Each <figure> should contain only one <iframe>. If a publisher wants to add more than one tracker, they can put the entire unescaped set of HTML and scripts into one <iframe> or use one <figure class="op-tracker"> for each <iframe>.

<figure class="op-tracker">
  <iframe>
    <!-- begin loading of IOMb bootstrap code -->
    <script type='text/javascript' src="//<domain service name>/iomb/latest/bootstrap/stub.js"></script>
    <script type='text/javascript' src='//<domain service name>/iomb/latest/sensor/standalone/fbia/es6/bundle.js'></script>
    <!-- end loading of IOMb bootstrap code -->
    <script>
      // The URL the user shared
      // (if there are no redirections, otherwise the final URL in the chain)
      IOMb('configure', { st: 'foo', dn: '<domain service name>' });
      IOMb('pageview', { cp: 'bar', fu: ia_document.shareURL });
    </script>
  </iframe>
</figure>

The following parameters can be passed with the function call IOMb(<command>, parameter):

command	abbreviation	name	type	standard	length	pattern	mandatory	description
`'configure'`	st	site	String	-	15	`^[a-zA-Z0-9_]*$`	yes	site identifier
`'configure'`	dn	domainServiceName	String	-	-	INFOnline CNAME convention¹	yes	Domain Service Name (CNAME or AAA(A) host)²
`'configure'`	cn	country	Enum	de	-	no	INFOnline country (de or at)
`'pageview'`	cp	code	String	`page_code_non-assignable`	256	`[^a-zA-Z0-9,_/\-?#.]`	no	page code for the IVW Kat 2.0 Association
`'pageview'`	co	comment	string	-	256	`/[ -~]/`	no	optional comment
`'pageview'`	fu	fbiaUrl	String	-	URI ³	yes	Canonical URL of the digital content

¹ INFOnline CNAME convention: /^(data-)([a-f0-9]{10})\.([a-zA-Z0-9][a-zA-Z0-9-_]{0,61})(?:\.([a-z]{2,62}))?\.([a-z]{2,62})$/

² If the notation of dn / domainServiceName does not match the INFOnline CNAME convention mentioned, no measurement takes place
³ URI schema

Attention

Before any events (e.g. pageview) can be measured, the fbia sensor must be configured with the configured command!

Attention

The following applies to parameters:
- Not set and the parameter is optional -> default value is used!
- Not set and the parameter is mandatory -> processing is aborted and a message is logged on the browser console in debug mode!
- Each parameter is queried before processing!

No measurement possible¶

It is currently not possible to measure digital video or audio content within Facebook Instant Articles because the event interface is missing in the Facebook ecosystem for Instant Articles.

Pseudonymous measurement¶

Prerequisites¶

Publisher site identifier provided by the INFOnline GmbH

Integration¶

A publisher can embed the IOMp Facebook instant articles standalone web sensor code within an iframe on each article using the Analytics element. Anything in this <iframe> will execute at the beginning of each article load, but the webview will remain hidden from the reader. This embed must be included in the <body> of the article and is not supported in the <head> or <footer>. Each <figure> should contain only one <iframe>. If a publisher wants to add more than one tracker, he can add the full unescaped set of HTML and scripts in one <iframe> or use one <figure class="op-tracker"> for each <iframe>.

<figure class="op-tracker">
  <iframe>
    <!-- begin loading of IOMp bootstrap code -->
    <script
      type="text/javascript"
      src="//script.ioam.de/sensor/latest/bootstrap/stub.js"
    ></script>
    <script
      type="text/javascript"
      src="//script.ioam.de/sensor/latest/standalone/fbia/es6/bundle.js"
    ></script>
    <!-- end loading of IOMp bootstrap code -->
    <script>
      // The URL the user shared
      // (if there are no redirections, otherwise the final URL in the chain)
      IOMp('configure', { st: 'foo'. ct: '0400810101' });
      IOMp('pageview', { cp: 'bar', co: 'baz', fu: ia_document.shareURL });
    </script>
  </iframe>
</figure>

The following parameters must and can be provided via the configure command:

Abbreviation	Name	Type	Default	Length	Pattern	Mandatory	Description
st	site	String	-	15	`^[a-zA-Z0-9_]*$`	yes	Site identifier
ct	consent string	String	-	10	`^([0-9a-fA-F]{2})([0-9a-fA-F]{6})$`	yes	INFOnline consent string (optin)
cn	country	Enum	de	-	-	no	INFOnline country (de or at)
dc	distributionChannel	Enum	web	-	-	no	Distribution channel can be web, hyb, app, ctv
dg	debug	Boolean	false	-	-	no	Debug flag

The following parameters can be provided via pageview command:

Abbreviation	Name	Type	Default	Length	Pattern	Mandatory	Description
cp	code	String	`Leercode_nichtzuordnungsfaehig`	256	`[^a-zA-Z0-9,_/\-?#.]`	no	Page code for the IVW Kat 2.0 association
co	comment	String	-	256	`/[ -~]/`	no	Optional comment
pt	pixelType	Enum	cp	-	-	no	One of cp, sp, xp
fu	fbiaUrl	String	-	-	URI ²	yes	Canonical URL of the digital content

Before any events (e.g. pageview) can be measured the IOMp standalone sensor has to be configured by the configured command!

The following applies to parameters:

Not set and the parameter is optional -> Default value is used!
Not set and the parameter is mandatory -> processing will be aborted and a message is logged to browser console in debug mode!
Every parameter will be asserted before being processed!

Common pitfalls¶

It's not possible to measure any digital video or audio content due to the missing event interface in the Facebook instant articles eco system.

Last update: July 21, 2023