Zum Inhalt

Standalone-Lösung: Zensusmessung hybrid (hybride Messung)

Voraussetzungen

  • Relay-Client-Container (gehostet von der INFOnline oder einem selbst)
  • Registrierter Domain-Service-Name als CNAME (gehostet von der INFOnline), AAA(A) (selbst gehostet) DNS-Eintrag
  • Angebotskennung (bereitgestellt von der INFOnline GmbH)
  • INFOnline App SDK Zensus (iOS / Android)

Anwendungsbereiche

Der hybride Sensor für die Zensusmessung kann in folgenden Bereichen und plattformübergreifenden Entwicklungsframeworks eingesetzt werden:

Merkmale

Der hybride Sensor verfügt über folgende Funktionen:

  • Automatische Erkennung von Android- und iOS-Webviews
  • Verfügt über zwei Modi: Hybrid- und normale Messung
  • Befehlswarteschlange (ermöglicht die Aufteilung von bundle loading und command input)
  • Parsen, Validieren und Serialisieren von Befehlen
  • Messung von Seitenaufrufen innerhalb eines Android- oder iOS-Webviews

Bootstrapping

Mit Preload und Bundle-Loader

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
<!DOCTYPE html>
<html lang='en'>
<head>
  <meta charset='UTF-8'>
  <title>Website</title>
  <!-- begin preload of IOMb standalone sensor -->
  <link rel='preload' href='//<domain service name>/iomb/latest/sensor/standalone/hybrid/es6/bundle.js' as='script' id='IOMbBundle'>
  <link rel='preload' href='//<domain service name>/iomb/latest/bootstrap/loader.js' as='script'>
  <!-- end preload of IOMb standalone sensor -->
  <!-- begin loading of IOMb bootstrap code -->
  <script type='text/javascript' src="//<domain service name>/iomb/latest/bootstrap/loader.js"></script>
  <!-- end loading of IOMb bootstrap code -->
</head>
<body>
<!-- Content -->
</body>
</html>
| Info | | -- | | Der <domain service name> sollte durch den AAA(A) oder CNAME DNS Eintrag der Serviceplattform (Relay Client) ersetzt werden. |

Ohne Preload und Bundle-Loader

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
<!DOCTYPE html>
<html lang='en'>
<head>
  <meta charset='UTF-8'>
  <title>Website</title>
  <!-- begin loading of IOMb bootstrap code -->
  <script type='text/javascript' src="//<domain service name>/iomb/latest/bootstrap/stub.js"></script>
  <!-- end loading of IOMb bootstrap code -->
</head>
<body>
<!-- Content -->
<script type='text/javascript' src='//<domain service name>/iomb/latest/sensor/standalone/hybrid/es6/bundle.js'></script>
</body>
</html>
| Achtung | | -- | | Jede Änderung der Pfade zum Bundle oder Stub führt unweigerlich zu einer Fehlfunktion der Messung. Lediglich der <Domain Service Name> sollte durch den AAA(A) oder CNAME DNS-Eintrag der Serviceplattform (Relay Client) ersetzt werden. |

Konfiguration

Zur Konfiguration des hybriden Sensors muss der Publisher ein Skript-Snippet in den <body> des HTML-Inhalts einfügen. Das Snippet selbst enthält die folgende Anweisung: 

1
2
3
<script type='text/javascript'>
  IOMb('configure', { st: 'foo', dn: 'data-acbd18db4c.example.com' });
</script>
Die folgenden Parameter müssen und können über den Befehl configure angegeben werden:

Abkürzung Name Typ Standard Länge Muster Obligatorisch Beschreibung
st site String - 15 ^[a-zA-Z0-9_]*$ yes Site identifier
dn domainServiceName String - - INFOnline CNAME convention1 yes Domain Service Name (CNAME oder AAA(A) Host)2
cn country Enum de - - no INFOnline country (de oder at)
dc distributionChannel Enum web - - no Distributionskanal kann web, hyb, app, ctv sein
dg debug Boolean false - - no Debug flag
hy hybrid Boolean false - - no Muss truesein, um den Hybridmodus zu aktivieren

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

2 Entspricht die Notation von dn / domainServiceName nicht der genannten INFOnline CNAME convention, findet keine Messung statt

Achtung
Bevor Pageview-Events gemessen werden können, muss der hybride Sensor mit dem Befehl configured konfiguriert werden!
Achtung
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!
Achtung
Um im Hybridmodus zu messen, muss der Parameter hy auf true gesetzt werden.

Pageview

Um einen Pageview zu messen (der digitale Inhalt wird vom Empfänger angesehen), muss der Publisher den Pageview-Befehl über die globale Funktion IOMb() senden. Um ein Pageview-Event aus dem hybriden Sensorzu senden, muss der Publisher ein Skript-Snippet im des HTML-Inhalts platzieren. Das Snippet selbst enthält die folgende Anweisung: 

1
2
3
<script type='text/javascript'>
  IOMb('pageview', { cp: 'bar', co: 'baz' });
</script>
Die folgenden Parameter können mit dem pageview-Befehl übergeben 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 Eines von cp, sp, xp
Achtung
Der Inhalt der Parameter cp und co wird abgeschnitten, wenn die maximale Länge überschritten wird. Des Weiteren wird der Inhalt des Parameters cp bereinigt und alle Zeichen, die das obige Muster verletzen, werden durch ein '.' ersetzt.
Achtung
Wenn die hybride Umgebung erkannt wird, wird der Code in die hybride Notation mit den folgenden Regeln umgewandelt:
Bedingung Ergebnis
App Angebotskennung gleich Web Angebotskennung ___hyb2___{App Angebotskennung}___{app code}
App Angebotskennung entspricht nicht Web Angebotskennung ___hyb___{Web Angebotskennung}___{app code}
Letztes Update: October 28, 2021