Facebook instant article¶

Sie möchten das volle Potential Ihrer Daten über das INFOnline Measurement erheben?

Wir empfehlen Ihnen die pseudonyme Messung zusätzlich in Ihre Facebook instant article einzubinden. Bitte beachten Sie, dass die Teilnahme Ihres Digital-Angebots an der IVW-Ausweisung eine parallele Integration der pseudonymen Messung und Zensusmessung in Ihrer Facebook instant article erfordern kann.

Zensusmessung¶

Achtung

Sollten Sie die pseudonyme Messung über den INFOnline Measurement Manager aktivieren, ist es zwingend erforderlich das Standalone-Script in den Facebook instant article eingebunden zu lassen.

Voraussetzungen¶

Relay-Client-Container (gehostet von der INFOnline oder selbst)
Registrierter Domain-Service-Name als CNAME (von der INFOnline gehostet), AAA(A) (selbst gehostet) DNS-Eintrag
Angebotskennung (von der INFOnline GmbH bereitgestellt)

Integration¶

Ein Publisher kann den fbia Sensor für die Zensusmessung innerhalb eines iframe in jeden Artikel einbetten, indem er das Element Analytics verwendet. Alles, was in diesem <iframe> steht, wird zu Beginn jedes Artikel-Ladevorgangs ausgeführt, die Webansicht bleibt jedoch für den Leser verborgen. Diese Einbettung muss im <body> des Artikels enthalten sein und wird nicht im <head> oder <footer> unterstützt. Jede <figure> sollte nur einen <iframe> enthalten. Wenn ein Publisher mehr als einen Tracker hinzufügen möchte, kann er den gesamten unescapten Satz von HTML und Skripten in einen <iframe> einfügen oder eine <figure class="op-tracker"> für jeden <iframe> verwenden.

<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>

Folgende Parameter können mit dem Funktionsaufruf IOMb(<command>, Parameter) übergeben werden:

Befehl	Abkürzung	Name	Typ	Standard	Länge	Muster	Obligatorisch	Beschreibung
`'configure'`	st	site	String	-	15	`^[a-zA-Z0-9_]*$`	yes	Site identifier
`'configure'`	dn	domainServiceName	String	-	-	INFOnline CNAME convention¹	yes	Domain Service Name (CNAME oder AAA(A) Host)²
`'configure'`	cn	country	Enum	de	-	-	nein	INFOnline Land (de oder at)
`'pageview'`	cp	code	String	`Leercode_nichtzuordnungsfaehig`	256	`[^a-zA-Z0-9,_/\-?#.]`	no	Seitencode für den IVW Kat 2.0 Verband
`'pageview'`	co	Kommentar	String	-	256	`/[ -~]/`	no	Optionaler Kommentar
`'pageview'`	fu	fbiaUrl	String	-	-	URI ³	yes	Canonical URL des digitalen Inhalts

¹ 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})$/

² Entspricht die Notation von dn / domainServiceName nicht der genannten INFOnline CNAME convention, findet keine Messung statt
³ URI schema

Attention

Bevor irgendwelche Ereignisse (z.B. Pageview) gemessen werden können, muss der fbia Sensor mit dem Befehl configured konfiguriert werden!

Attention

Das Folgende gilt für Parameter:
- Nicht gesetzt und der Parameter ist optional -> Standardwert wird verwendet!
- Nicht gesetzt und der Parameter ist obligatorisch -> Verarbeitung wird abgebrochen und eine Meldung auf der Browser-Konsole im Debug-Modus protokolliert!
- Jeder Parameter wird vor der Verarbeitung abgefragt!

Keine Messung möglich¶

Es ist aktuell nicht möglich, digitale Video- oder Audioinhalte innerhalb von Facebook Instant Articles zu messen, da die Ereignisschnittstelle im Facebook-Ökosystem für Instant Articles fehlt.

Pseudonyme Messung¶

Voraussetzungen¶

Angebotskennung von der INFOnline GmbH bereitgestellt

Integration¶

Ein Publisher kann den IOMp Facebook Instant Articles Standalone-Web-Sensor-Code innerhalb eines Iframe auf jedem Artikel einbetten, indem er das Analytics Element nutzt. Alles, was sich in diesem <iframe> befindet, wird zu Beginn jedes Artikel-Ladevorgangs ausgeführt, aber die Webansicht bleibt für den Leser verborgen. Diese Einbettung muss im <body> des Artikels enthalten sein und wird im <head> oder <footer> nicht unterstützt. Jede <figure> sollte nur einen <iframe> enthalten. Wenn ein Publisher mehr als einen Tracker hinzufügen möchte, kann er den gesamten unescapten Satz von HTML und Skripten in einen <iframe> einfügen oder eine <figure class="op-tracker"> für jeden <iframe> verwenden.

<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>

Die folgenden Parameter müssen und können über den Befehl configure übergeben werden:

Abkürzung	Name	Typ	Standard	Länge	Muster	Obligatorisch	Beschreibung
st	site	String	-	15	`^[a-zA-Z0-9_]*$`	yes	Angebotskennung
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 Universum (de oder at)
dc	distributionChannel	Enum	web	-	-	no	Distribution channel can be web, hyb, app, ctv
dg	debug	Boolean	false	-	-	no	Debug flag

Die folgenden Parameter können über den Befehl pageview bereitgestellt werden:

Abkürzung	Name	Typ	Standard	Länge	Muster	Obligatorisch	Beschreibung
cp	code	String	`Leercode_nichtzuordnungsfaehig`	256	`[^a-zA-Z0-9,_/\-?#.]`	no	Seitencode für den IVW Kat 2.0 Verband
co	comment	String	-	256	`/[ -~]/`	no	Optionaler Kommentar
pt	pixelType	Enum	cp	-	-	no	One of cp, sp, xp
fu	fbiaUrl	String	-	-	URL²	yes	Canonical URL des digitalen Inhalts

Bevor irgendwelche Ereignisse (z.B. Pageview) gemessen werden können, muss der IOMp Standalone-Sensor mit dem Befehl configured konfiguriert werden!

Für Parameter gilt folgendes:

Nicht gesetzt und der Parameter ist optional -> Standardwert wird verwendet!
Nicht gesetzt und der Parameter ist obligatorisch -> die Verarbeitung wird abgebrochen und eine Meldung auf der Browserkonsole im Debug-Modus protokolliert!
Jeder Parameter wird vor der Verarbeitung abgefragt!

Häufige Fehler¶

Es ist nicht möglich, digitale Video- oder Audioinhalte zu messen, da die Ereignisschnittstelle im Facebook-Ökosystem für Instant Articles fehlt.

Letztes Update: July 19, 2023