ÖWA Checker

1 Über diese Anleitung

 Im ÖWA-Checker Manual wird die Handhabung des ÖWA-Checkers für folgende Themen behandelt:

a)    Erstellung eines Protokolls über die im Messsystem eintreffenden Messrequests pro Digital-Angebot. Dies gilt für stationäre Websites, mobile-enabled Websites, Applications sowie Connected-TV.

b)    Aktivierung mobiler Geräte für Test der InApp-Befragungsfunktionalität

 

2 Protokollierung von Messrequests

2.1 Funktion des ÖWA-Checkers

Der ÖWA-Checker liefert ein Protokoll der im Messsystem der ÖWA eintreffenden Messimpulse.

Mit diesem Protokoll kann der Kunde die Integration der Messung in eine Webseite, in eine App oder in eine MEW nachvollziehen. Es werden eine durchgängige Verfolgung der funktionalen Integration der Messung vom Browser/Endgerät bis hin ins Messsystem ermöglicht und somit Test- und Troubleshooting-Aufgaben vereinfacht.

Der ÖWA-Checker dient zu Ihrer Unterstützung und gibt Ihnen bereits im Entwicklungs- und Testprozess die Möglichkeit zu verifizieren, ob die Integration der Web-, MEW- oder App-Messung in Ihre Webseite, in Ihre MEW oder in Ihre App technisch erfolgreich war.

Die Integration der Library in Apps können Sie im ersten Schritt alternativ auch im Developer-Log der jeweiligen Entwicklungsumgebung prüfen (vgl. Implementierung iOS/Android).

2.2 Aufbau des ÖWA-Checkers

Der ÖWA-Checker besteht aus den folgenden Komponenten:

2.2.1 ÖWA-Checker Frontend

Das ÖWA-Checker Frontend ist eine Website, die den Nutzern die Möglichkeit der Beantragung des Protokolls ermöglicht.

Das ÖWA-Checker-Frontend ist unter der folgenden URL erreichbar:

szmchecker.iocnt.net/static/owa/login.html

2.2.2 ÖWA-Checker App

ÖWA bietet für die unterstützten mobilen Betriebssysteme (iOS, Android)) Apps an, über welche die Protokolle einer App-Nutzung beantragt werden. Die Apps werden auf den folgenden Wegen distributiert:

https://apps.apple.com/at/app/%C3%B6wa-checker/id1351870421

https://play.google.com/store/apps/details?id=de.infonline.oewacheckerapp&pcampaignid=MKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1

2.3 Bedienung des ÖWA-Checkers

2.3.1 Hinweis zur Nutzung

Für die Beantragung eines Protokolls aus dem Messsystem sind folgende Voraussetzungen zu beachten:

  • Übermittelt die zu testende App auschließlich die VendorID und/oder InstallationID, kann diese App nicht mittels ÖWA-Checker getestet werden.
  • Die Beantragung des Protokolls muss mit dem gleichen Endgerät erfolgen, über welches der Nutzungsvorgang erzeugt wird.
  • Soll eine Web-Nutzung protokolliert werden, muss diese mit demselben Browser beantragt werden, mit dem anschließend die Webseitennutzung erfolgt. In der Zwischenzeit dürfen keine Cookies gelöscht werden.
  • Soll eine App-Nutzung protokolliert werden, muss diese mit der ÖWA-Checker-App beantragt werden.
  • Soll eine MEW-Nutzung protokolliert werden, muss diese mit demselben Browser beantragt werden, mit dem anschließend die MEW-Nutzung erfolgt. In der Zwischenzeit dürfen keine Cookies gelöscht werden.

Die Zustellung des Protokolls erfolgt mit einem Zeitversatz von bis zu 30 Minuten nach Beendigung des Protokollierungszeitraumes.

2.3.2 Schritt für Schritt – Anleitung

Die nachfolgenden Bedienungshinweise gelten, sofern nicht explizit anders beschrieben, sowohl für die Protokollierung eines Web-, einer App- als auch eines MEW-Nutzungsvorganges.

Schritt 1: Aufruf des ÖWA-Checkers

Aufruf der URL https://szmchecker.iocnt.net/static/owa/login.html im stationären Browser

Start der ÖWA-Checker-App. Nach Start der App wird automatisch das ÖWA-Checker-Frontend aufgerufen.

Aufruf der URL https://szmchecker.iocnt.net/static/owa/login.html im mobilen Browser

Schritt 2a: Bestätigung der Übertragung verschiedener Merkmale zur Geräteidentifizierung
(nur bei Nutzung der ÖWA-Checker-App unter Android)

Aufgrund geänderter Nutzungsbedingungen im Google-Store erscheint in der Android-App zunächst eine Abfrage, ob Sie damit einverstanden sind, neben der AdvertisingID (ADID) noch weitere IDs (Prüfsummen IMEI, InstallationID, AndroidID und MAC-Adresse) an die Systeme von der ÖWA zu übertragen:

Bei Bestätigung dieser Abfrage mit „Ja“ stimmen Sie zu, dass die ÖWA-Checker-App alle genannten IDs zur Identifizierung Ihres aktuellen Testgerätes an die ÖWA senden darf. Bei erneuter Nutzung der ÖWA-Checker-App auf demselben Android-Gerät erscheint dann die Abfrage nicht mehr.

Klicken Sie auf „Nein“, so stimmen Sie nur der Übermittlung der ADID an die ÖWA zu. In diesem Falle werden Sie bei jeder Nutzung der ÖWA-Checker-App unter Android erneut nach Genehmigung zur Übermittlung aller IDs gefragt.

Falls Sie mit Klick auf „Nein“ nur die Übermittlung der ADID erlaubt haben, können Sie anschließend die ÖWA-Checker-App nicht zum Testen von Android Apps verwenden, die eine Version 1.1.1 oder kleiner der Android-Library von der ÖWA nutzen.

Dies liegt daran, dass die Library erst ab Version 1.1.2 die ADID zur Geräteidentifizierung verwendet, frühere Versionen dagegen nicht. Somit kann bei alleiniger Übermittlung der ADID durch die ÖWA-Checker-App das Testgerät nicht im Messsystem identifiziert und somit kein Testprotokoll erstellt werden, wenn Android-Apps getestet werden, die eine Version der Library kleiner als 1.1.2 verwenden.

Sollten Sie hier irrtümlich „Nein“ angeklickt haben, starten Sie bitte die ÖWA-Checker-App erneut.

Schritt 2: Login

Bitte loggen Sie sich mit den Zugangsdaten ein, die Sie von der ÖWA oder von Ihrem Kunden, in dessen Auftrag Sie eine App entwickeln und testen, erhalten haben:

Sollte das Login nicht möglich sein, wenden Sie sich bitte direkt an support@oewa.at

Schritt 3: Bestätigen der Nutzungsbedingungen

Nach erfolgreichem Login werden Sie aufgefordert, die Nutzungsbedingungen des ÖWA-Checkers zu bestätigen. Dies ist Voraussetzung für seine weitere Nutzung.

Für den Fall, dass Sie die Nutzungsbedingungen nicht bestätigen möchten, nutzen Sie an dieser Stelle bitte die Logout-Funktion und beenden Sie die App bzw. den Browser.

Die nachfolgenden Punkte informieren Sie über die Überprüfung der Messimpulse. Diese lösen Sie aus, indem Sie auf den Button „ÖWA-Checker“ klicken.

Schritt 4: Eingabe der Protokollierungsparameter

Nach Bestätigung der Nutzungsbedingungen werden Sie zur Eingabe der Protokollierungsparameter aufgefordert. Bitte wählen Sie die folgenden Parameter aus bzw. ergänzen Sie diese:

  • Angebot: Bitte wählen Sie die von der ÖWA vergebene Angebotskennung aus, die von der zu protokollierenden Webseite, der App oder der MEW verwendet wird.
  • Dauer: Bitte wählen Sie die Dauer der Protokollierung aus (10/20/30 min). Die Protokollierung beginnt zu dem Zeitpunkt, an dem Sie die E-Mail-Bestätigung ausführen (siehe Schritt 5).
  • E-Mail: Bitte geben Sie Ihre E-Mail-Adresse an, an welche die Bestätigungs-E-Mail und das Protokoll versendet werden können.

Nach Eingabe der Daten klicken Sie bitte auf den „Start“-Button. Im nachfolgenden Dialog wird Ihnen die Speicherung des Auftrages bestätigt und der Hinweis auf die Bestätigungsmail gegeben (siehe Schritt 5):

Schritt 5: Protokollierungsauftrag bestätigen

Nach Absenden der Protokollierungsparameter erhalten Sie eine E-Mail an die von Ihnen angegebene E-Mail-Adresse. Bitte öffnen Sie diese E-Mail und klicken auf den darin enthaltenen Aktivierungslink. Der Aktivierungslink kann von jedem beliebigen Endgerät aus aufgerufen werden.

Ab dem Zeitpunkt der Aktivierung beginnt die Protokollierung der Nutzung im SZM-System. Es werden die Nutzungsvorgänge

  • Ihres stationären Browsers (Web) / Endgerätes (App) / mobilen Browsers (MEW)
  • für die angegebene Angebotskennung
  • für die angegebene Dauer

protokolliert.

2.4 Auswertung des Protokolls

2.4.1 Protokollinhalte

Nach Beendigung des Protokollierungszeitraumes sowie der nachgelagerten Verarbeitungszeit von bis zu 30 Minuten wird Ihnen das Protokoll der Nutzung im CSV-Format an die angegebene
E-Mail-Adresse zugestellt.

Das CSV-File enthält je Nutzeraktion/Event eine Zeile. Jede Zeile enthält folgende Werte:

  • time: UNIX Timestamp in UTC
  • client: Identifizierungsmerkmal des Endgerätes/Browsers
    error: INFOnline-Error-Code
  • site: Angebotskennung der Web/App/Mew
  • code: Inhaltscode gemäß Kat 2.0 (Web und MEW: obligatorisch, App: nur bei mobilen PIs)
  • type: Typ des abgerufenen Pixels, mögliche Werte:
    • cp: Content-Pixel (in normalen Content-Seiten)
    • fp: Flash-Pixel
    • xp: Test-Pixel (wird nicht gezählt)
  • oc: Inhaltscode gemäß KAT 1.2 (nur Web; kann leer sein)
  • sv: Steuerung Frabo-Auslieferung, mögliche Werte:
    • ke oder [leer]: Frabo wird nicht ausgeliefert
    • mo: mobiler Frabo wird ausgeliefert
    • in: stationärer Frabo wird ausgeliefert
  • mc: Hash-Wert für MClient-Verfahren (kann leer sein)
  • mg: Angabe tum SZMnG-Migrationsmodus, mögliche Werte:
    • [leer]: SZMnG-Migrationsmodus ist nicht aktiviert
    • yes: SZMnG-Migrationsmodus ist aktiviert
  • event: Event der App-Messung (nur App)
  • parameter: technische Parameter der Messung (automatisch von Messsystem bzw. Messlibrary ermittelt), kann teilweise hier beschriebene Werte nochmals enthalten
  • useragent: Useragent-String des Browsers
  • url: aufgerufene URL (Web, Mew)
  • pis: Angabe, ob Messimpuls PI-relevant ist, mögliche Werte:
    • 0: Messimpuls ist nicht PI-relevant (nur bei bestimmten App-Events)
    • 1: Messimpuls ist PI-relevant
  • dimension: Messform (Web, App, Hyb)

Anhand dieses Protokolls erhalten Sie nun die Möglichkeit, die von Ihnen ausgeführten Nutzungsvorgänge auf Validität zu prüfen. Bitte überprüfen Sie die jeweiligen Nutzeraktionen/Events auf korrekte Übermittlung der oben genannten Werte.

2.4.2 Error-Codes

Das Feld error gibt Ihnen einen Hinweis darauf, ob die eingehenden Messimpulse technisch korrekt sind. Die nachfolgende Tabelle beschreibt die möglichen Codes, die im Feld error übermittelt werden. Die Error-Codes N<x> sind Hinweise (Notifications) und stellen keinen Fehler dar.

  • OK – No Error (Wenn kein Error (Ex) aufgetreten ist, Notifications (Nx) sind möglich)
  • E2 – kein Parameter angegeben
  • E3 – Cookie konnte nicht gesetzt werden
  • E4 – Request lautet weder GET noch POST
  • E6 – Problem mit ae-Container
  • E7 – ae-Container ist kein JSON
  • E8 – keine uuid gefunden
  • E9 – kein offerIdentifier gesetzt
  • E10 – JSON-Fehler
  • E11 – Keine Events innerhalb des ae-Containers
  • N1 – keine UUID in ae oder mi gefunden
  • N3 – uuid gefunden, ie gesetzt (App-Messung)
  • N4 – kein i00-Cookie gesetzt
  • N5 – Cookie aufgrund höherer Versionsnummer erneuert
  • N6 – mi gefunden, ie gesetzt (Hybrid-Messung)
  • N7 – ls gefunden, ie gesetzt (iPhone-Hack)
  • N8 – keine id gefunden, benutze Hash
  • N9 – keine id gefunden, benutze Hash und JavaScript-Fingerprint
  • N10 – LSO nicht zugreifbar
  • N11 – Fehler in aid.io
  • N13 – Kein Seitencode übermittelt, Standard Leercode gesetzt
  • N14 – Cookie defekt, wurde neu gesetzt
  • N15 – LSO gesetzt, nicht für Client-Resolving nutzbar
  • N22 – Kein Privacy-Setting angegeben
  • N23 – Fehlerhaftes Privacy-Setting
  • A1 – Referrer nicht in Whitelist aufgeführt (Datensatz in Filtered-DWH schreiben)
  • A2 – Fehler bei Clientresolving (Datensatz in Filtered-DWH schreiben)
  • A3 – Session konnte nicht aufgelöst werden
  • A4 – Prüfsumme im Datensatz stimmt nicht
  • A6 – NoScript wurde genutzt, war aber nicht aktiviert (Datensatz in Filtered-DWH schreiben)
  • A7 – Aufruf einer App wurde aufgrund einer IVW-Korrektur gefiltert
  • A8 – Aufruf einer Mew innerhalb einer App (hybrid) wurde aufgrund einer IVW-Korrektur gefiltert
  • A9 – Aufruf einer Mew wurde aufgrund einer IVW-Korrektur gefiltert
  • A10 – Device liefert via Library Daten aus der Zukunft
  • A11 – JSON in Datensatz (ae oder mi) konnte nicht verarbeitet werden. Defektes JSON-Objekt
  • A12 – Flash-Pixel (fp)
  • A13 – Newsletter-Pixel (np)
  • A14 – Test-Pixel (keine Messung)
  • A15 – Leercode wurde durch String „Leercode_nichtzuordnungsfaehig“ ersetzt
  • A17 – Plausibilitätscheck (keine Messung)
  • A18 – Fehler Plausibilitätscheck (keine Messung)
  • A19 – Subdomain Messung ungleich Subdomain Siteconfig (keine Messung)
  • A21 – Nicht erlaubte PI mit leerer URL (keine Messung)

3 Aktivierung mobiler Geräte für Tests zur InApp-Befragungsfunktionalität

3.1 Funktion des ÖWA-Checkers

Für die ÖWA Plus InApp-Befragung wurde der ÖWA-Checker um eine neue Funktionalität erweitert. Diese dient dazu Entwicklungs- bzw. Testgeräte als Tester zu markieren. Dadurch haben App-Entwickler die Möglichkeit, die „erfolgreiche“ Integration der InApp-Befragungslibrary in ihrer App zu überprüfen. Desweiteren sind verschiedene funktionale Tests bzgl. der Befragungseinladung und dem Fragebogen möglich.

Technisch gesehen übermittelt diese neue Funktion des ÖWA-Checkers eine eindeutige Geräte-ID des Testgerätes an das Befragungssystem. Beim Start der App bzw. bei Auslösung einer potentiell die Befragungseinladung startenden Aktion seitens des Entwicklers wird dann die (auf einer Geräte-ID basierende) Abfrage an das Befragungssystem dahingehend, ob das Testgerät in der Test-Befragungsstichprobe ist, innerhalb einer bestimmten Zeitspanne stets positiv beantwortet. Folglich ist das Gerät erfolgreich als Testgerät markiert. Die App startet daher immer die Befragungseinladung. Die so ermittelten Befragungsdaten fließen nicht in die ÖWA Plus ein.

Diese Funktion entspricht der Aktivierung eines Testercookies für mobile bzw. für stationäre Webseiten im SZM-Messystem.

Alle Apps, die auf einem registrierten Testgerät laufen und die gegen die Befragungslibrary gelinkt sind, werden ggf. die Befragung einblenden!

3.2 Bedienung des ÖWA-Checkers

Im Folgenden wird der Ablauf zur Registrierung eines Mobilgerätes für Tests zur InApp-Befragung geschildert.

Schritt 1: Aufruf des ÖWA-Checkers

Nach Start der ÖWA-Checker-App wird automatisch das ÖWA-Checker-Frontend aufgerufen.

Schritt 2 a: Bestätigung der Übertragung verschiedener Merkmale zur Geräteidentifizierung
(nur bei Nutzung der ÖWA-Checker-App unter Android!)

Aufgrund geänderter Nutzungsbedingungen im Google-Store erscheint in der Android-App zunächst eine Abfrage dahingehend, ob Sie damit einverstanden sind, dass neben der AdvertisingID (ADID) noch weitere IDs (Prüfsummen IMEI, InstallationID, AndroidID und MAC-Adresse) übertragen werden:

Die Beantwortung der Frage ist nur für die Bereitstellung des SZM-Messprotokolls (die Hauptfunktion der ÖWA-Checker-App) relevant. Die Registrierung des Testgerätes für die Durchführung der InApp-Befragung funktioniert unabhängig davon, welche Antwort Sie hier auswählen. Sofern Sie also lediglich einen Test zur InApp-Befragung für Ihr Gerät aktivieren wollen, können Sie hier eine beliebige Antwort auswählen.

Schritt 2 b: Login

Bitte loggen Sie sich mit den Zugangsdaten ein, die Sie von der ÖWA oder von Ihrem Kunden, in dessen Auftrag Sie eine App entwickeln und testen, erhalten haben:

Schritt 3: Bestätigen der Nutzungsbedingungen

Nach erfolgreichem Login werden Sie aufgefordert, die Nutzungsbedingungen des ÖWA-Checkers zu bestätigen. Die Bestätigung der Nutzungsbedingungen ist Voraussetzung für die weitere Nutzung des ÖWA-Checkers, auch für die darin enthaltene InApp-Testfunktion.

Für das Testen der InApp-Befragungslibrary klicken Sie auf den unteren der beiden Buttons.

Schritt 4: Anforderung und Initialisierung des InApp-Befragungstests

Auf dieser Seite werden Sie gebeten, die Dauer des InApp-Befragungstests anzugeben:

Innerhalb dieses Zeitraums ist Ihr Gerät auf dem Befragungssystem als Testgerät registriert. Nach Klick auf den Button „Absenden“ wird die ID Ihres Gerätes an das Befragungssystem übermittelt: Das Gerät steht dann für InApp-Befragungstests zur Verfügung:

Bitte beachten Sie, dass es bis zu fünf Sekunden dauern kann, bis der obige Bildschirm zur erfolgreichen Übermittlung erscheint. Bitte drücken Sie in dieser Zeit nicht noch einmal auf den „Absenden“-Button.

Schritt 5: Öffnen der zu testenden App

Wenn Sie nun Ihre zu testende App innerhalb der im ÖWA-Checker angegebenen Zeit verwenden, muss Ihnen während der Nutzung eine ÖWA Plus-Befragungseinladung angezeigt werden.

Durch einen Klick auf den Button „Teilnehmen“ können Sie den ÖWA Plus-Fragebogen starten. Auf dem Display wird nun die hinterlegte Angebotskennung, die an den Fragebogen übergeben wird, visualisiert und kann vom Tester auf Korrektheit überprüft werden. Auch die Version der implementierten InApp-Library wird angezeigt. Bitte überprüfen Sie alle Klickflächen und den Einstieg in den Fragebogen.

Wird Ihnen keine Befragungseinladung angezeigt, spricht dies für eine fehlerhafte Implementierung der Befragungslibrary.

Die Interaktion mit der Befragungseinladung sperrt kurzfristig die erneute Auslieferung der neuen Befragung in der App.

Wenn Sie die App erneut testen wollen, können Sie das Gerät entweder neu als Tester mit dem ÖWA-Checker markieren oder Sie warten innerhalb der von Ihnen gewählten Testdauer 1 Minute, um die Tests zu wiederholen.

Ist die von Ihnen gewählte Testdauer abgelaufen und Sie öffnen die Testapp erneut, wird das Testgerät für 25 Stunden gesperrt und lässt sich nicht mehr über den ÖWA-Checker als Testgerät markieren. Bitte wenden Sie sich in diesem Fall an support@oewa.at.