INSTRUCTIE COMSCORE TAGS IMPLEMENTEREN AAN VAN ONDERWERP DATUM Deelnemers NOBO Andries de Jonge / Menno Hagen Implementatie van NOBO-tags Najaar 2016 DOEL: Implementatie NOBO-tags in app s /website Beste deelnemer, Hierbij ontvangen jullie de informatie voor de integratie van NOBO-tags in jullie apps en/of website(s). Vanaf het moment dat deze goed geïmplementeerd zijn, kan de traffic op jullie apps/websites goed gemeten en door NOBO gerapporteerd worden. Zowel de plaatsing als de inhoud van de tags zijn zeer belangrijk voor een correcte weergave van de online traffic, het bereik en de profielen van gebruikers van jullie web-pagina s en apps. NOBO maakt gebruik van comscore tags. Deze hebben een standaard-structuur en dienen toegevoegd te worden aan elke pagina binnen de websites en apps. In dit document geven we een toelichting op het proces m.b.t. de implementatie van de comscore tags, voor zowel web als apps, met daarbij verwijzingen naar de meegestuurde documentatie. In het kort ziet het proces er als volgt uit: 1. NOBO zal de nodige informatie, documentatie en tags sturen aan de developers. 2. De developers van de desbetreffende Publishers voegen de comscore-tags toe aan de apps en websites. 3. De apps en websites worden getest door het NOBO-team. 4. Het NOBO-team zal input/feedback geven op eventuele aanpassingen. 5. Op het moment dat de tags correct geïmplementeerd zijn, kunnen de apps en websites live gezet worden. a) Tevens zal comscore de data op dagelijkse basis gaan doorzetten naar Kantar. b) Kantar zal op haar beurt een check verrichten of er ook paneldata terugkomt. 6. Vanaf dit moment wordt de data geregistreerd en dient de Publisher deze data te controleren en te vergelijken met eigen interne data(bv via GA). Hiervoor is ook een handleiding beschikbaar. 7. Op het moment dat de comscore data en eigen data overeenkomen en binnen de marge van 10% vallen kan de data aan de markt gepresenteerd worden. 8. Vanaf dit moment is het business-as-usual en zal op 2-weeklijkse basis een Quality Control uitgevoerd worden op de tagging in apps/website en of de NOBO data qua volume niet erg buiten een nader af te spreken bandbreedte valt. PAGINA 1 VAN 6
1: Labels en waarden NOBO-tags dienen in zowel de web als in de app omgeving toegevoegd te worden. Beiden staan hieronder toegelicht. 1a: APP Integratie comscore SDK Om deze NOBO-metingen goed in de app te laten (ver)werken is het nodig voor elk gebruikt platform (ios, Android, etc.) de comscore SDK te integreren. De laatste versie van de SDKs en alle bijbehorende documentatie is te downloaden. c2 waarde, Publisher Secret en ns_site Bij het implementeren van de comscore tags dienen er verschillende comscore en NOBOlabels gevuld te worden. Los van de NOBO labels willen we graag de nadruk leggen op de c2- waarde, ns_site = total en de Publisher Secret. Deze waardes zijn van cruciaal belang om de metingen goed door te laten komen bij comscore. Deze dienen dan ook in elke meting aanwezig te zijn. C2: In jullie geval is de c2 waarde xxxxxxx en geeft de licentie-id aan. De Publisher secret(password) is van belang, deze is uniek. Het is van belang dat het label ns_site in alle metingen aanwezig is met waarde total. Waarden van de NOBO-labels Verdere informatie ten aanzien van de waarden of inhoud die deze NOBO-labels mogen bevatten, kunnen worden gevonden in het Excel bestand (vinex_labels_tagging_nobo- 20160101-v4-final.xlsx) en het pdf-document(vinex Memo Definition 2016.pdf) die als bijlage zijn verzonden bij dit bericht. Het PDF is een verkorte versie van het EXCEL. Voorkeur geniet om Excel als leidraad te nemen. Het is van belang deze instructies goed te volgen en de waarden exact over te nemen zoals aangegeven, aangezien de waarden in de tagging bepalen hoe de Publisher in de NOBO-data en dus in de planningssoftware van de mediabureaus naar voren zal komen. NB: Als het hier apps van Publishers betreft, die al (voor deze of andere) titels meelopen in de NOBO meting, MOET de tagging op een aantal velden exact overeen komen met de invulling in de tabel die is bijgevoegd in dit document. Als de inhoud niet exact matcht ontstaan trendbreuken in de data. PAGINA 2 VAN 6
Aanroepen van de tags Het is belangrijk dat op elke pagina er maar één comscore tag wordt aangeroepen waarin de Nobo-labels meegestuurd worden. Er is een uitzondering. Nadat de comscore SDK is verwerkt in de app, zal je zien dat op het moment dat je de app opstart er 2 comscore tags geladen worden. Een met ns_ap_ev=start en een met ns_ap_ev=view. Dit is in principe de enige keer dat er twee tags aangeroepen mogen worden. Label nb_idfa: Om een match te kunnen maken met een panel-lid is het van belang dat de ADID of IDFA meegegeven wordt in de comscore tag. Dit dient te gebeuren onder het label nb_idfa. Hier dient de ADID(Android) of IDFA(iOS) gehashed te worden met MD5 en dan afgeknipt te worden op 16 karakters. Meer te lezen in bijgesloten pdf, Setting Nb_idfa.pdf Als dit niet goed ingeregeld is, heeft dit gevolgen voor de opbouw van de profieldata. Voor meer informatie ten aanzien van dit punt zie memo_vinex_tagging_details-2016-04-04-1.pdf. Goedkeuring NOBO-team Op het moment dat de apps klaar zijn, ontvangen wij graag een testversie via Test-flight, Hockeystick of op andere manier. Wij zullen dan de apps testen en indien nodig feedback geven (inclusief charles sessies) ten aanzien van wat nog aangepast dient te worden. Apps naar App-store: Als de apps technisch goed zijn, kunnen ze doorgezet worden naar de store. De data zal vanuit comscore op dagelijkse basis doorgezet worden naar Kantar. Kantar zal op zijn beurt controleren of er ook panel-data doorkomt. Uiteraard is het aan te raden de apps opnieuw aan te bieden om door ons te laten testen wanneer een geupdate versie van de app wordt uitgebracht. 1b: Web: Voor de implementatie van de NOBO-tags binnen de site hoeft geen SDK geïmplementeerd hoeft te worden. Voor de plaatsing van de meetcodes verwijzen wij naar het bestand <Digital_Analytix_Content_Tagging_Guidelines-EU.pdf>. Het is raadzaam deze handleiding goed te lezen en de instructies op te volgen. Waarden van de NOBO labels Verdere informatie ten aanzien van de waarden of inhoud die deze NOBO-labels mogen bevatten, kunnen worden gevonden in het pdf-document en Excel bestand (vinex_labels_tagging_nobo-20160101-v4-final.xlsx) en het pdf-document(vinex Memo Definition 2016.pdf) die als bijlage zijn verzonden bij dit bericht. Het is belangrijk deze instructie ook goed te volgen, omdat de tagging bepaalt hoe de metingen (met welke namen en labels) terug komen in de NOBO data en planningssoftware. Ook hier is het van belang dat er maar één call naar de comscore tag wordt gedaan per pagina. PAGINA 3 VAN 6
Goedkeuring NOBO-team Op het moment dat de tags geïmplementeerd zijn, ontvangen wij graag een bericht en een link naar de site. Wij zullen dan de omgevingen testen en mocht dat nodig zijn feedback geven ten aanzien van wat nog aangepast dient te worden. Een handige tool om zelf te testen is de NOBO-checker, een extensie in Chrome waarmee je kan zien of de labels correct gevuld worden. 2. Controle door publisher op volumes: Het is mogelijk, nadat alle tags zijn geïmplementeerd om in het dashboard van comscore te kijken of er data binnenkomt en of de juiste volumes worden gegenereerd. Dit moet door de publisher zelf worden gecontroleerd door een vergelijking te maken met data uit andere bronnen, bijvoorbeeld Google Analytics. In comscore is een dashboard aangemaakt, dat kan helpen bij deze controle. De url van dit dashboard is: https://dax.comscore.eu/focus Login gegevens zijn op te vragen via mhagen@comscore.com Mochten er vragen zijn, ben ik op mail en/of telefoon te bereiken. Graag zien we de eerste test versie tegemoet! Met vriendelijke groet, Andries de Jonge +31 6 462 165 42 & Andries@2-0-1.com Menno Hagen +33 (0) 1 79 97 03 80 & mhagen@comscore.com PAGINA 4 VAN 6
Voorbeeld formulier om door NOBO-owner bij publisher te laten invullen per site/titel. label explination Value nb_01 Media Publisher nb_02 Sales Media Brand nb_11 web or app platform nb_12 website name or app name (technical) nb_21 first publication date nb_22 paid content flag nb_23 paid user flag nb_24 user login flag nb_25 media brand nb_26 secundair media brand nb_27 genre nb_28 event type (article or index) nb_29 media type nb_30 first edition date Via deze link kunnen alle SDK libraries en documentatie gedownload worden: https://digitalanalytix.box.com/s/qqhsq3r384rvmk92kyulkvmqvutectuj Let wel op dat je niet alleen de c2 waarde kenbaar maakt maar ook de publisher secret, zie zitten wel in de rar bestanden van deze link: C2 Value xxxxxxxx Publisher Secret Code xxxxxxxxxxxxx PAGINA 5 VAN 6
Bijlage met verplichte NOBO-NOM en comscore labels. Uitleg in bijgesloten excels. Mandatory labels Label name C2 ns_site MERK nb_01 nb_02 PLATFORM nb_11 nb_12 CONTENT nb_25 nb_27 nb_28 nb_29 nb_idfa APP - SDK Persistent values <<C2 value>> total Publisher brand and sales organization brand Media Publisher Sales Media Brand Platform selection web or app platform (web or app) website name or app name (technical) Content definition media brand genre event type (article or index) media type (replica, non-replica or general) ios - Identifier for Advertising (IDFA) Android - Google Advertising ID (AAID). Hased(MD5) and truncated on 16 characters NOM Labels Nb_21 First publication date -(format yyyymmdd) Nb_22 Content paid - (format y or n) Nb_23 User paying for content - (format y or n) Nb_24 User logged in - (format y or n) nb_30 First edition date - (format yyyymmdd) Veel voorkomende fouten/errors: Gebruik van lees tekens in de nobo waardes, deze dienen voorkomen te worden of encoded te worden komt geen data binnen o ns_total = view is missing in de comscore tag kantar krijgt data van nieuwe publisher niet door o comscore heeft data transfer nog niet doorgezet naar Kantar komt geen data binnen aan de kant van Kantar mbt panel leden o check of the idfa / adid goed doorgegeven worden, gehashed(md5) en afgeknipt op 16 karakters PAGINA 6 VAN 6