NET-Metrix Traffic Measurement Vorgaben

Transkript

1 NET-Metrix Traffic Measurement Vorgaben Version Inhaltsverzeichnis 1. Einleitung Checkliste Angebotsbezogene Informationen Anmeldeinformationen Logo Themenkategorie Skript-Einbau Skript-Generator Mess-Skript ohne Differenzierung nach Sektionen Mess-Skript mit Differenzierung nach Sektionen Skript-Varianten AJAX-Skript Kombi-Skript (inkl. SSL) SinglePageApplication-Skript Responsive Skript (verge.airve.com) Responsive Skript (jquery) Document append PHP Locallist Sektionen Allgemeine Sektionsvorgaben Spezifische Sektionsvorgaben Desktop Apps und Mobile Konsequenzen bei Abweichungen NET-Metrix Traffic Measurement Vorgaben Version

2 7. Zusätzliche Vorgaben Apps User Agent Zusammenspiel User Agent und Sektionen Cookie App-Referrer Zwei Varianten von App-Referrern App-Referrer-Vorgaben Sprachinformation bei Apps Code-Fragment für ios-apps in Objective C Variablen und Werte Code-Fragment für Android-Apps in Java Variablen und Werte Anmerkungen zum Android-Code-Fragment Anmerkungen Technische Prüfung Testing Instance / Pre-Testing seitens Kunde Post-Testing seitens NET-Metrix / Zugangsberechtigungen Disclaimer NET-Metrix Traffic Measurement Vorgaben Version

3 1. Einleitung Die korrekte Messung ist Voraussetzung für die Teilnahme an den Studien NET-Metrix-Audit, NET-Metrix-Mobile und NET-Metrix-Profile. Diese umfasst die Einhaltung folgender Aspekte: 1) Reglement 2) Vorgaben Abweichungen vom Reglement oder von den Vorgaben können von Einschränkungen der Publikation bis zum vorübergehenden oder finalen Ausschluss aus der/den Publikation/en führen. 2. Checkliste Aspekt Desktop- Mobile- App Site Site Anmeldeinformationen x x x Logo x x x Zuordnung Themenkategorie optional korrekte Angebotskennung x x x Syntax ist korrekt. x x x Es werden alle Parameter mitgeliefert (d, x, r). x x x Messung ausschliesslich nutzerinduzierter Aktionen mit relevanter Content-Veränderung / x x x keine automatischen Reloads Es werden alle zu messenden Bereiche/Events gemessen. x x x Pro Aktion wird nur 1 Request ausgelöst / keine Doppel-/Mehrfachmessung innerhalb x x x Angebot und/oder mit Partnerangebot/en Die Locallist ist vollständig, es sind alle Referrer eingetragen. x x x Sektionsvorgaben sind korrekt umgesetzt. / Abbildung der Initial-, Feed- und Event-Aufrufe n/a x x eines Angebots in der jeweils korrekten Sektion maximal 5'000 Sektionen pro Gesamtangebot und Kalendermonat x x x korrekte Umsetzung User Agent n/a n/a x korrektes Zusammenspiel User Agent und Sektion n/a n/a x identische Cookie-Kennung bei gesamter Nutzung, Neustart oder Update n/a n/a x Übermittlung App-Referrer n/a n/a x Übermittlung Sprachinformation n/a n/a x Pre-Testing seitens Kunde (Testing Instance) n/a n/a x NET-Metrix Traffic Measurement Vorgaben Version

4 3. Angebotsbezogene Informationen 3.1 Anmeldeinformationen Information Desktop-Site Mobile-Site App Angebotsnamen x x x URL x x x OS n/a n/a x Device n/a n/a x Themenkategorie optional Logo x x x Publikation (ja/nein) x x x SSL (ja/nein) x x x CGA x x x E-Paper (ja/nein) x x x Unterangebot/e (ja/nein) x x x Partnerangebot/e (ja/nein) x x x 3.2 Logo Der Kunde liefert NET-Metrix die Logos für die angemeldeten Angebote gemäss der im Folgenden festgelegten Spezifikationen. Aspekt Allgemein Desktop-, Mobile-Site App Grösse Format Bemerkung Es werden ausschliesslich quadratische Logos verwendet. auf Favicon basiertes Logo der Website auf App Store basiertes Logo der jeweiligen App 100 x 100 Pixel PNG 24- oder 32-Bit mit Alphakanal (Icon auf transparentem Hintergrund), alternativ: GIF, TIFF, JPG 3.3 Themenkategorie Nr. Kategorie Beschreibung 1 News Newsmeldungen, Nachrichten / Hintergrundberichte / Panorama / Wissen / Dossiers, Magazine 2 Wirtschaft Wirtschafts- und Börsenmeldungen 3 Sport Sport allgemein 4 Service Wetter / Shop / Archiv / Anzeigen / Verzeichnisse / Kalender / Verkehrsinfos / Directories / Medizin 5 Unterhaltung People / Fun / Games / Blogs, Foren / Unterhaltungsmusik / Kino / Web-Radio, Web-TV 6 Lifestyle Mode, Kosmetik / Reisen / Konsum, Ratgeber / Gourmet / Liebe, Erotik / Wellness / Familie 7 Kultur Bühne / Literatur / Musik und Film / Bildende Kunst / Architektur / Bücher 8 Social Media 9 Anderes NET-Metrix Traffic Measurement Vorgaben Version

5 4. Skript-Einbau 4.1 Skript-Generator Nach der Anmeldung erhalten unsere Kunden die angebotsspezifischen Skript-Informationen. Nach Einrichtung und Freischaltung der sogenannten angebotsspezifischen Kennung kann das Skript auch via Skript-Generator auf unserer Website erstellt werden. 4.2 Mess-Skript ohne Differenzierung nach Sektionen <!-- NET-Metrix-Audit version="1.5" --> <script language="javascript" type="text/javascript"> <!-- var NETMX=" document.write("<img src=\""+netmx+"?r="+escape(document.referrer)+"&d="+(math.random()*100000) +"&x="+screen.width +"x"+screen.height+"\" width=\"1\" height=\"1\" alt=\"\" />"); // --> </script> <noscript> <img src=" width="1" height="1" alt="" /> </noscript> <!-- /NET-Metrix-Audit --> Der Platzhalter <offer> ist durch die Kennung des Webangebots zu ersetzen (die Kennung wird durch die NET-Metrix vergeben). Das Skript ist in alle abrufbaren Seiten des Web- oder Mobile-Angebotes einmal einzufügen. Das Skript darf nicht in eine Tabelle, einen Newsletter oder in sich automatisch öffnende Pop-ups eingefügt werden. Das Mess-Skript soll am Anfang des Seitenaufbaus implementiert werden. Damit wird sichergestellt, dass bei jedem Seitenaufruf eine Zählung stattfindet. Wir empfehlen, das Skript gleich nach dem Bodytag einzufügen. 4.3 Mess-Skript mit Differenzierung nach Sektionen <!-- NET-Metrix-Audit version="1.5" --> <script language="javascript" type="text/javascript"> <!-- var NETMX=" document.write("<img src=\""+netmx+"?r="+escape(document.referrer)+"&d="+(math.random()*100000) +"&x="+screen.width+"x"+screen.height+"\" width=\"1\" height=\"1\" alt=\"\" />"); // --> </script> <noscript> <img src=" width="1" height="1" alt="" /> </noscript> <!-- /NET-Metrix-Audit --> NET-Metrix Traffic Measurement Vorgaben Version

6 Der Platzhalter <offer> ist durch die Kennung des Webangebots zu ersetzen (die Kennung wird durch die NET-Metrix vergeben) und <sk> durch die Bezeichnung der Sektionen. Das Skript darf nicht in eine Tabelle, einen Newsletter oder in sich automatisch öffnende Pop-ups eingefügt werden. Das Mess-Skript soll am Anfang des Seitenaufbaus implementiert werden. Damit wird sichergestellt, dass bei jedem Seitenaufruf eine Zählung stattfindet. NET-Metrix empfiehlt, das Skript gleich nach dem Bodytag einzufügen. 4.4 Skript-Varianten AJAX-Skript <html> <head> <script language="javascript" type="text/javascript"> <!-- function NET-Metrix(sk) { settimeout('sendpixel("'+sk+'")', 0); } function sendpixel(sk) { var strnetmx = " <offer>.wemfbox.ch/cgi-bin/ivw/cp/"; var img = new Image(); img.src = strnetmx+sk+"?d="+(math.random()*1000)+"&x="+screen.width+"x"+screen.height; } --> </script> </head> <body> <!-- Parameter z.b. 'home/news' kann frei definiert werden --> <a href="javascript:net-metrix('home/news');">count on Click</a> </body> </html> Kombi-Skript (inkl. SSL) <!-- NET-Metrix-Audit version="1.5" --> <script language="javascript" type="text/javascript"><!-- var NETMX = ((' == document.location.protocol)? ' : ' <offer>.wemfbox.ch/cgibin/ivw/cp/home' ); document.write("<img src=\""+netmx+"?r="+escape(document.referrer)+"&d="+(math.random()*100000)+"&x=" +screen.width+"x"+screen.height+"\" width=\"1\" height=\"1\" />"); // --> </script> <noscript> <img src=" width="1" height="1" alt="" /> </noscript> <!-- /NET-Metrix-Audit --> Hinweis: Die SSL-Messung ist kostenpflichtig, da eine eigene SSL-Kennung notwendig ist, die Sie bei uns bestellen müssen. Die Gebührenübersicht finden Sie auf unserer Website. NET-Metrix Traffic Measurement Vorgaben Version

7 4.4.3 SinglePageApplication-Skript <script> (function(){ /* Client-Config */ var ssl = document.location.protocol === ' var offer = ssl? '<offer>-ssl' : '<offer>'; var section = 'test-neu'; /* do not touch */ var domain = document.location.protocol + '//' + offer + '.wemfbox.ch'; var path = 'cgi-bin/ivw/cp/' + section; var random = Math.random(); var screensize = screen.width + 'x' + screen.height; var referrer = document.referrer; var urlparam = 'd=' + random + '&r=' + referrer + '&x=' + screensize; var url = domain + '/' + path + '?' + urlparam; var nmx = new Image(); nmx.src = url; })(); </script> Responsive Skript (verge.airve.com) <script language="javascript" src="scripts/verge.min.js" type="text/javascript"> </script> <!-- NET-Metrix-Audit version="1.5" --> <script language="javascript" type="text/javascript"> <!-- if(verge.viewportw() > 760){ var NETMX=" }else{ var NETMX=" } document.write("<img src=\""+netmx+"?r="+escape(document.referrer)+"&d="+(math.random()*100000)+"&x=" +screen.width+"x"+screen.height+"\" width=\"1\" height=\"1\" alt=\"\" />"); // --> </script> <noscript> <img src=" width="1" height="1" alt="" /> </noscript> <!-- /NET-Metrix-Audit --> NET-Metrix Traffic Measurement Vorgaben Version

8 4.4.5 Responsive Skript (jquery) <!-- NET-Metrix-Audit version="1.5" --> <script language="javascript" type="text/javascript"> <!-- if($(window).width() > 760){ var NETMX=" }else{ var NETMX=" } document.write("<img src=\""+netmx+"?r="+escape(document.referrer)+"&d="+(math.random()*100000)+"&x=" +screen.width+"x"+screen.height+"\" width=\"1\" height=\"1\" alt=\"\" />"); // --> </script> <noscript> <img src=" width="1" height="1" alt="" /> </noscript> <!-- /NET-Metrix-Audit --> Document append <script> var NETMX=" var netmximage = document.createelement("img"); var netmxref = encodeuri(document.referrer); netmximage.id = "nmxpixel"; netmximage.src = NETMX+"?r="+netmxRef+"&d="+(Math.random()*100000)+"&x="+screen.width+"x"+screen. height; netmximage.width = "1"; netmximage.height = "1"; document.body.appendchild(netmximage); </script> PHP <?php $referer = $_SERVER['HTTP_REFERER'];?> <img src=" echo $referer?>&d=<?php echo rand(1,100000)?>" width="1" height="1" alt="" /> NET-Metrix Traffic Measurement Vorgaben Version

9 5. Locallist In der Locallist werden pro Webangebot alle Domains und URLs eingetragen, die für das jeweilige Webangebot gemessen werden sollen: 1) Die Zählung erfolgt nur, wenn das Mess-Skript auf einer der Seiten eingebaut ist, deren URL mit einem Eintrag in der Locallist des jeweiligen Webangebots korrespondiert. Dadurch wird Missbrauch verhindert wie auch unbeabsichtigte Fehl-Implementationen (bspw. dass ein Teilnehmer sein Mess-Skript in ein fremdes Webangebot einbaut). 2) Die Liste pro Webangebot ist stets auf dem neusten Stand zu halten. Die Kunden sind gebeten, NET-Metrix zu informieren, wenn ein neues Unterangebot mit einem anderen Namen mitgemessen werden soll. Nur so kann NET-Metrix sicherstellen, dass die Webstatistik die Nutzer aller Bereiche des jeweiligen Webangebots gezählt werden. Via Kundendatenbank Netclient kann der Kunde die aktuellen Eintragungen einsehen. 3) Die Erweiterung der Locallist erfolgt erst nach vorgängiger Prüfung seitens NET-Metrix. Bestimmte URLs könnten unter Verwendung der Wildcard * (Stern) zusammengefasst werden. Beispiele * * * * *muster.ch *test.muster.ch *kaffee.muster.ch *tee.muster.ch muster.ch *test.muster.tv *kaffee.muster.com *tee.muster.at Zusammenfassung * *.muster.ch *muster.* Hinweis: Die NET-Metrix behält sich vor, die Locallist zu ändern, um Fehlmessungen zu verhindern. NET-Metrix Traffic Measurement Vorgaben Version

10 6. Sektionen Mit Erweiterungen der URL im Messskript können sogenannte Sektionen eingerichtet werden, welche die Nutzung des Webangebots nach verschiedenen Teilbereichen (bspw. News, Sport, Service etc.) oder Channels (Desktop-Site, Mobile-Site, Tablet-App etc.) abbilden. Sie ermöglichen die interne Traffic-Analyse dieser Teilbereiche oder Channels im internen Auswertungstool. Ohne Sektionen liegt der Traffic nur für das Gesamtangebot vor. Die Sektionen in NET-Metrix-Audit und NET-Metrix-Mobile müssen auf Seiten des teilnehmenden Webangebots erstellt werden. NET-Metrix hat keinen Einfluss auf die Sektionsgestaltung und -umsetzung. Die Sektionen können unter Einhaltung der im Folgenden beschriebenen Vorgaben auch über den Skript-Generator auf unserer Website erstellt werden. 6.1 Allgemeine Sektionsvorgaben 1) Codes: Die Sektion darf nur aus Buchstaben (ohne Umlaute), Zahlen, Bindestrichen (-) und Unterstrichen (_) bestehen. Der Slash (/) gilt als Trennzeichen für die Sektionsebene. Es dürfen keine Doppel- oder Mehrfach-Slashes (//, /// etc.) oder Sonderzeichen verwendet werden. Hinweis: Der Sektionspfad ist "casesensitiv", achten Sie daher auf die Gross-/Kleinschreibung. 2) Feld-Länge: max. 255 Zeichen 3) Anzahl Sektionen: max für das Gesamtangebot inkl. aller mitgemessener Elemente 6.2 Spezifische Sektionsvorgaben Desktop Grundsätzlich kann der Kunde die Sektionsstruktur bis auf die im Folgenden beschriebenen Ausnahmen individuell festlegen. Hinweis: Das Mapping in NET-Metrix-Profile setzt entsprechende Sektionen voraus. Channel Unterangebot Partnerangebot Kooperationsangebot (embedded) Facebook Instant Articles Google AMP Sektionsvorgabe /suboffer/[name] /external/[name] /embedded/[name] /fbinstant /gamp [ ] = variabel NET-Metrix Traffic Measurement Vorgaben Version

11 6.2.2 Apps und Mobile Channel App Android Phone App Android Tablet App Android Watch App Android TV App Android Universal (ohne Split) App Android Universal (mit Split) App ios Phone (iphone) App ios Tablet (ipad) App ios Universal (ohne Split) App ios Universal (mit Split) Mobile-Site Tablet-Site App tvos (Apple TV) App watchos (Apple Watch) App Windows Phone App Windows Tablet App Windows Desktop App Windows Universal (ohne Split) App Windows Universal (mit Split) Sektionsvorgabe /apps/[name]/android/phone /apps/[name]/android/tablet /apps/[name]/android/watch /apps/[name]/android/tv /apps/[name]/android/universal /apps/[name]/android/universal/phone /apps/[name]/android/universal/tablet /apps/[name]/android/universal/watch /apps/[name]/android/universal/tv /apps/[name]/ios/phone /apps/[name]/ios/tablet /apps/[name]/ios/universal /apps/[name]/ios/universal/phone /apps/[name]/ios/universal/tablet /mobilesite /tabletsite /apps/[name]/tvos/tv /apps/[name]/watchos/watch /apps/[name]/windows/phone /apps/[name]/windows/tablet /apps/[name]/windows/desktop /apps/[name]/windows/universal /apps/[name]/windows/universal/phone /apps/[name]/windows/universal/tablet /apps/[name]/windows/universal/desktop [ ] = variabel Hinweis: Sofern die vorgegebene Grundstruktur in sich belassen wird, sind weitere Sektionen vor oder nach diesen Sektionsvorgaben erlaubt, es gelten die allgemeinen Vorgaben (siehe Kapitel 6.1). NET-Metrix Traffic Measurement Vorgaben Version

12 6.3 Konsequenzen bei Abweichungen 1) Von den Vorgaben abweichende Sektionen können zu einer fehlerhaften Abbildung und/oder Zuordnung des Traffics führen. Dies kann dazu führen, dass betroffene Angebote oder Sektionen nicht wie gewünscht in den Publikationen NET-Metrix-Audit oder NET-Metrix-Mobile erscheinen und/oder nicht (vollumfänglich) für die Berechnung der Sektionen in NET-Metrix-Profile berücksichtigt werden können. 2) Eine detaillierte Sektionierung unter Beachtung der maximalen Anzahl von für das Gesamt- Webangebot inkl. aller mitgemessener Elemente kann im Falle einer nicht reglementkonformen Messung eine Korrektur der Traffic-Zahlen in den Publikationen NET-Metrix-Audit- und/oder NET-Metrix-Mobile ermöglichen resp. erleichtern. 3) Die Verantwortung der korrekten Umsetzung der Sektionsvorgaben liegt beim Kunden. NET-Metrix übernimmt keine Verantwortung für die Konsequenzen, die sich aus den Abweichungen von den Sektionsvorgaben ergeben. 7. Zusätzliche Vorgaben Apps 7.1 User Agent Der User Agent der gemessenen App muss die Identifizierung der Dimensionen Operating System (OS) und Device ermöglichen. OS Device User Agent Android (Google) Phone Mozilla/5.0 (Linux; U; Android-phone) Android (Google) Tablet Mozilla/5.0 (Linux; U; Android-tablet) Android (Google) TV Mozilla/5.0 (Linux; U; Android-tv) Android (Google) Universal Mozilla/5.0 (Linux; U; Android-universal) ios (Apple) Phone Mozilla/5.0 (ios-phone; U; CPU iphone OS like Mac OS X) ios (Apple) Tablet Mozilla/5.0 (ios-tablet; U; CPU ipad OS like Mac OS X) ios (Apple) Universal Mozilla/5.0 (ios-universal; U; CPU OS like Mac OS X) tvos (Apple) TV Mozilla/5.0 (tvos-tv; U; CPU Apple TV OS like Mac OS X) Windows (Microsoft) Phone Mozilla/4.0 (compatible; Windows OS; Windows-phone) Windows (Microsoft) Tablet Mozilla/4.0 (compatible; Windows OS; Windows-tablet) Windows (Microsoft) Desktop Mozilla/4.0 (compatible; Windows OS; Windows-desktop) Windows (Microsoft) Universal Mozilla/4.0 (compatible; Windows OS; Windows-universal) NET-Metrix Traffic Measurement Vorgaben Version

13 7.2 Zusammenspiel User Agent und Sektionen Es muss sichergestellt sein, dass der User Agent jeweils mit der entsprechenden Sektion korrespondiert. Dabei sind folgende Kombinationen erlaubt: Sektion (schematisch) Erlaubter User Agent /apps/[name]/android/phone Mozilla/5.0 (Linux; U; Android-phone) /apps/[name]/android/tablet Mozilla/5.0 (Linux; U; Android-tablet) /apps/[name]/android/watch mit NET-Metrix zu klären /apps/[name]/android/tv Mozilla/5.0 (Linux; U; Android-tv) /apps/[name]/android/universal Mozilla/5.0 (Linux; U; Android-universal) Mozilla/5.0 (Linux; U; Android-phone) Mozilla/5.0 (Linux; U; Android-tablet) Mozilla/5.0 (Linux; U; Android-tv) /apps/[name]/android/universal/phone Mozilla/5.0 (Linux; U; Android-phone) /apps/[name]/android/universal/tablet Mozilla/5.0 (Linux; U; Android-tablet) /apps/[name]/android/universal/watch mit NET-Metrix zu klären /apps/[name]/android/universal/tv Mozilla/5.0 (Linux; U; Android-tv) /apps/[name]/ios/phone Mozilla/5.0 (ios-phone; U; CPU iphone OS like Mac OS X) /apps/[name]/ios/tablet Mozilla/5.0 (ios-tablet; U; CPU ipad OS like Mac OS X) /apps/[name]/ios/universal Mozilla/5.0 (ios-universal; U; CPU OS like Mac OS X) Mozilla/5.0 (ios-phone; U; CPU iphone OS like Mac OS X) Mozilla/5.0 (ios-tablet; U; CPU ipad OS like Mac OS X) /apps/[name]/ios/universal/phone Mozilla/5.0 (ios-phone; U; CPU iphone OS like Mac OS X) /apps/[name]/ios/universal/tablet Mozilla/5.0 (ios-tablet; U; CPU ipad OS like Mac OS X) /apps/[name]/tvos/tv Mozilla/5.0 (tvos-tv; U; CPU Apple TV OS like Mac OS X) /apps/[name]/watchos/watch mit NET-Metrix zu klären /apps/[name]/windows/phone Mozilla/4.0 (compatible; Windows OS; Windows-phone) /apps/[name]/windows/tablet Mozilla/4.0 (compatible; Windows OS; Windows-tablet) /apps/[name]/windows/desktop Mozilla/4.0 (compatible; Windows OS; Windows-desktop) /apps/[name]/windows/universal Mozilla/4.0 (compatible; Windows OS; Windows-universal) Mozilla/4.0 (compatible; Windows OS; Windows-phone) Mozilla/4.0 (compatible; Windows OS; Windows-tablet) Mozilla/4.0 (compatible; Windows OS; Windows-desktop) /apps/[name]/windows/universal/phone Mozilla/4.0 (compatible; Windows OS; Windows-phone) /apps/[name]/windows/universal/tablet Mozilla/4.0 (compatible; Windows OS; Windows-tablet) /apps/[name]/windows/universal/desktop Mozilla/4.0 (compatible; Windows OS; Windows-desktop) NET-Metrix Traffic Measurement Vorgaben Version

14 7.3 Cookie Die Client-Identifizierung erfolgt auch über Cookies. Aus diesem Grunde ist darauf zu achten, dass die App Cookies akzeptiert. Dabei darf in der gesamten App nur eine Cookie-Kennung akzeptiert werden. Die identische Cookie- Kennung muss erhalten bleiben bei gesamter App-Nutzung für alle gemessenen Content-Bereiche inkl. Partnerangebote Neustart der App Update der App Update des Device-OS 7.4 App-Referrer Anhand des Referrers kann der Traffic schneller analysiert und plausibilisiert werden. Wir empfehlen allen Kunden, welche Apps mitmessen, den App-Referrer gemäss folgender Logik umzusetzen Zwei Varianten von App-Referrern Bei den App-Referrern unterscheiden wir: Website-Referrer (r= Parameter): Herkunft des Aufrufs Skript-Referrer: Einbauort des Zählpixels Fiktives Beispiel: Kennung: nmx Locallist: Hauptangebot: *net-metrix.ch*, *netmetrix.ch*; Partnerangebot: *wemf.ch* App: Netmetrix, ios, Phone Sektionsvorgabe: /apps/netmetrix/ios/phone User Agent: Mozilla/5.0 (ios-phone; U; CPU iphone OS like Mac OS X) App-Referrer-Vorgaben Navigationsbeispiel 1: App-Start, keine weiteren Aktionen Website-Referrer: (leer) Skript-Referrer: Navigationsbeispiel 2: nach App-Start Klick auf Service Website-Referrer: Skript-Referrer: NET-Metrix Traffic Measurement Vorgaben Version

15 Navigationsbeispiel 3: innerhalb Service Klick auf Glossar Website-Referrer: Skript-Referrer: Navigationsbeispiel 4: innerhalb Glossar Klick auf das mitgemessene Partnerangebot Website-Referrer: Skript-Referrer: Sprachinformation bei Apps Für die korrekte Messung einer App im Rahmen der NET-Metrix-Studien müssen eine Vielzahl von Parametern übergeben und einige Header Information gesetzt werden, die standardmässig nicht übergeben werden. Auch für ein korrektes Cookie-Handling sind speziell auf Android-Devices einige Besonderheiten zu beachten. Die folgenden Code-Fragmente demonstrieren die korrekte Übergabe aller benötigten Parameter und Header-Variablen Code-Fragment für ios-apps in Objective C // Random Number int randomint = arc4random() % ; NSString *randomstring = [NSString stringwithformat:@"%d",randomint]; // URL String NSString *offerkey NSString *appname NSString *platform NSString *device NSString *urlstring = [NSString stringwithformat:@" offerkey, appname, platform, device, randomstring]; // NS-URL NSURL * url = [NSURL URLWithString:urlString]; // Request NSMutableURLRequest * request = [[NSMutableURLRequest alloc] initwithurl:url]; // Create client with custom useragent i.e. Mozilla/5.0 (ios-phone; U; CPU iphone OS like Mac OS X) [request setvalue:@"[useragent]" forhttpheaderfield:@"user-agent"]; // Set Accept-Language Header i.e. de [request setvalue:@"[language_iso]" forhttpheaderfield:@"accept-language"]; NSURLConnection * theconnection = [[NSURLConnection alloc] initwithrequest:request delegate:nil]; [request release]; [theconnection release]; NET-Metrix Traffic Measurement Vorgaben Version

16 Variablen und Werte Die Werte für die Variablen finden Sie auf unserer Website: Variable Beispielwert [offer] netmx [useragent] Mozilla/5.0 (ios-phone; U; CPU iphone OS like Mac OS X) [name] news [platform] ios [device] phone [language_iso] de Code-Fragment für Android-Apps in Java // Create a local instance of cookie store CookieStore cookiestore = new BasicCookieStore(); // Create local HTTP context HttpContext localcontext = new BasicHttpContext(); // Bind custom cookie store to the local context localcontext.setattribute(clientcontext.cookie_store, cookiestore); // Create client with custom useragent i.e. Mozilla/5.0 (Linux; U; Androidphone) AndroidHttpClient client = AndroidHttpClient.newInstance("[useragent]"); // Create get request for NetMetrix-Tag HttpGet getrequest = new HttpGet("[offer].wemfbox.ch/cgibin/ivw/CP/apps/[name]/[platform]/[device]?d="+ MathUtils.random( , Integer.MAX_VALUE)); ( oder alternativ: HttpGet getrequest = new HttpGet(" System.currentTimeMillis()); ) // Set Accept-Language Header i.e. "de" getrequest.setheader("accept-language", "[language_iso]"); // execute the request with localcontext (cookie store) HttpResponse response = client.execute(getrequest, localcontext); NET-Metrix Traffic Measurement Vorgaben Version

17 Variablen und Werte Die Werte für die Variablen finden Sie auf unserer Website: Variable [offer] [useragent] [name] [platform] [device] [language_iso] Beispielwert netmx Mozilla/5.0 (Linux; U; Android-phone) news Android phone de Anmerkungen zum Android-Code-Fragment Der Cookie Store muss einen globalen/statischen Context haben und beim Beenden und Starten der App serialisiert und gespeichert werden Anmerkungen Der Sprachcode entspricht der RFC Definition des Accept-Language Headers und besteht aus einem ISO 639 Sprachcode mit optionalem ISO 3316 Ländercode für nationale Varianten. Zum Beispiel "en-uk" für britisches Englisch oder "de" für eine beliebige Variante von Deutsch. Bitte beachten Sie, dass der ISO 3316 Ländercode vom aktuellen System NICHT verwendet wird. Die Angabe des reinen ISO 639 Sprachcodes ist daher völlig ausreichend. 8. Technische Prüfung NET-Metrix empfiehlt dringend, das korrekte Funktionieren und die Vorgabenumsetzung vor dem Release zu testen, um Fehler rechtzeitig entdecken und beheben zu können. Abweichungen von den reglementarischen und technischen Vorgaben können von Einschränkungen der Publikation bis zum vorübergehenden oder finalen Ausschluss aus der/den Publikation/en führen. 8.1 Testing Instance / Pre-Testing seitens Kunde Die Testing Instance soll helfen, die Skriptimplementierung der mit dem NET-Metrix-Tag im Rahmen von NET- Metrix-Audit und/oder NET-Metrix-Mobile zu messenden Elemente zu überprüfen. NET-Metrix Traffic Measurement Vorgaben Version

18 Der Ablauf umfasst folgende Schritte: Schritt 1/6: Anforderung Zugangsdaten Schritt 2/6: Anpassung des Original-Skripts in das Test-Skript Schritt 3/6: Anmelden Schritt 4/6: Testen Schritt 5/6: Abmelden Schritt 6/6: Anpassung des Test-Skripts in das Original-Skript Die vollständige Anleitung finden Sie auf unserer Website. Können auf Kundenseite keine eigenen und/oder nicht ausreichend Kontrollen durchgeführt werden, kann NET-Metrix ausnahmsweise vorgängig Prüfungen oder Teile davon übernehmen. In diesem Falle ist NET-Metrix mit genügendem zeitlichem Vorlauf zu kontaktieren. Bei Nachfolge-Prüfungen von Überarbeitungen oder Adhoc-Versionen legen wir unseren Fokus auf etwaige bereits festgestellte Fehler und können aus Ressourcengründen nicht jede einzelne Überarbeitung oder Adhoc-Version von Grund auf testen. Es ist zu beachten, dass NET-Metrix je nach Auslastung zwischen 5 und 10 Arbeitstagen Vorlauf benötigt. 8.2 Post-Testing seitens NET-Metrix / Zugangsberechtigungen Anpassungen von Desktop- und Mobile-Sites sowie Releases von Apps sind NET-Metrix mitzuteilen und werden technisch geprüft. Die Ergebnisse werden in einem Prüfbericht dokumentiert. Der Teilnehmer unterstützt NET-Metrix bei den durchzuführenden Kontrollen. Insbesondere werden NET-Metrix bei Bedarf Zugangsberechtigungen unentgeltlich erteilt (bspw. bei ansonsten kostenpflichtigen Logins oder Abos). Werden relevante Zugangsbeschränkungen im Rahmen der Kontrollen für NET-Metrix nicht aufgehoben, kann dies zur Nicht-Teilnahme bzw. zum vorübergehenden Ausschluss aus den Publikationen NET-Metrix-Audit und/oder NET-Metrix-Mobile führen. 9. Disclaimer NET-Metrix ist bemüht, die Dienstleistung sorgfältig zu erbringen und unterstützt ihre Kunden bestmöglich bei der Umsetzung. NET-Metrix kann aber keine Garantien für die Richtigkeit der erbrachten Dienstleistungen übernehmen. Insbesondere die korrekte und vollständige Umsetzung der technischen Vorgaben liegt in der Verantwortung des Kunden. Die vertraglichen Vereinbarungen sind hierzu in den Besonderen Bestimmungen NET-Metrix-Audit, NET- Metrix-Mobile und NET-Metrix-Profile festgelegt. NET-Metrix Traffic Measurement Vorgaben Version