Zasady oskryptowania i prezentacji danych dla aplikacji mobilnych w wynikach badania Megapanel PBI/Gemius 22 grudnia, 2014 ul. Postępu 18 B, budynek Orion, IX piętro, 02-676 Warszawa, tel. (0 22) 378 30 50, fax. (0 22) 379 78 65
Spis treści Zawartość I. Wstęp... 2 II. Wskaźniki dostępne dla aplikacji mobilnych i warunki ich prezentacji w wynikach badania.... 2 1. Wskaźniki dostępne dla aplikacji mobilnych... 2 2. Warunki, których spełnienie jest konieczne w celu prezentacji wskaźników cookies... 2 3. Dodatkowe wymagania, konieczne do prezentacji wskaźników dotyczących czasu... 3 4. Dodatkowe wymagania, konieczne do prezentacji wskaźników dotyczących odsłon... 4 III. Definicje związane z pojęciem aktywnego korzystania z aplikacji... 5 IV. Narzędzia do zliczania aplikacji przygotowane przez Gemius... 6 Strona 1
I. Wstęp W wynikach badania Megapanel PBI/Gemius prezentowane mogą być - poza danymi dla witryn - również dane dla aplikacji, w tym również aplikacji mobilnych. Przez aplikację mobilną rozumie się aplikację przystosowaną do używania jej na urządzeniach mobilnych czyli telefonach i tabletach. W niniejszym dokumencie opisane jest jakie wskaźniki są obecnie możliwe do zaprezentowania dla takich aplikacji i jakie warunki muszą być w tym celu spełnione. Podstawowym, formalnym warunkiem koniecznym do prezentacji wyników dla aplikacji mobilnych jest podpisanie przez właściciela aplikacji lub inny podmiot upoważniony do jego reprezentowania (np. sieć reklamową, w której jest dana aplikacja) z firmą Gemius (kontakt: megapanel@gemius.com) umowy na audyt site-centric danej aplikacji w wynikach badania. W celu umieszczenia aplikacji (w tym aplikacji mobilnej) w grupie właścicielskiej danego podmiotu, należy przysłać: - wniosek aktualizacyjny wpis do rejestru usługodawców - oświadczenie właściciela o własności danej aplikacji II. Wskaźniki dostępne dla aplikacji mobilnych i warunki ich prezentacji w wynikach badania. 1. Wskaźniki dostępne dla aplikacji mobilnych Dla aplikacji mobilnych możliwe jest, po spełnieniu odpowiednich warunków, prezentowanie wskaźników cookies (cookies krajowe mobilne, cookies zagraniczne ogółem, cookies ogółem) oraz po spełnieniu dodatkowych wymagań również wskaźników dotyczących czasu (czas krajowy mobilny i czas krajowy ogółem) i odsłon (odsłony krajowe mobilne i odsłony zagraniczne). Prezentowane wskaźniki są dostępne jedynie dla całej populacji, bez podziału na poszczególnie grupy celowe. Także wskaźniki pochodne (np. % czasu mobilnego ) będą prezentowane. W przypadku aplikacji mobilnych nie mogą być obecnie prezentowane wskaźniki uruchomione aplikacje, czas uruchomienia oraz użytkownicy (Real users). Dodanie aplikacji mobilnej do danej grupy właścicielskiej (patrz: grupy.megapanel.pl) w wynikach badania nie wpływa na prezentowaną dla tej grupy liczbę użytkowników i liczbę cookie. Aplikacje mobilne mogą mieć wpływ jedynie na wskaźniki dotyczące czasu i odsłon dla grup właścicielskich, w których są umieszczone. 2. Warunki, których spełnienie jest konieczne w celu prezentacji wskaźników cookies Strona 2 a. Osobny identyfikator skryptu dedykowany do aplikacji. Stworzenie na koncie audytowym oddzielnego identyfikatora skryptu do zliczania korzystania z aplikacji. W przypadku używania systemu GemiusPrism musi to być skrypt o identyfikatorze PID różnym od zera. Jeżeli aplikacja używa przy wysyłaniu hitów zawsze innych cookie niż
cookie używane przy zliczaniu oglądalności witryn danego wydawcy może on (ten identyfikator) pochodzić z tego samego konta, na którym zliczane są też witryny danego wydawcy. Jeżeli zaś te same cookie mogą być używane zarówno przy zliczaniu oglądalności witryn jak i danej aplikacji to konieczne jest założenie oddzielnego konta w tym celu ze względu na współdzielenie plików cookies. Reklamy pojawiające się w aplikacji nie mogą być oskryptowane za pomocą identyfikatora służącego do pomiaru korzystania z aplikacji. b. Hit przy każdym uruchomieniu. Wysyłanie hitu przez aplikację na powyższy identyfikator przy każdym uruchomieniu aplikacji (niezależnie czy uruchomienie nastąpiło automatycznie przy starcie systemu czy też było wynikiem akcji użytkownika). Jeżeli w danej aplikacji nie występuje automatyczne uruchomienie aplikacji przy starcie systemu i równocześnie oskryptowane są jako odsłony poszczególne akcje i jedna z tych akcji jest równoznaczna z rozpoczęciem aktywnego korzystania z aplikacji to nie jest konieczne wysyłanie dodatkowo jeszcze jednego hita przy otwarciu aplikacji wystarczy hit oznaczający tę odsłonę. c. Prawidłowa obsługa gemiusowych plików cookie o nazwie gdyn. Cookie gemiusowe powinny być zapisywane na danym urządzeniu i odczytywane ponownie przy kolejnym uruchomieniu aplikacji. Cookie te nie mogą być nigdy kasowane automatycznie - ani przy zakończeniu działania aplikacji ani przy wyłączeniu urządzenia ani w żadnym innym momencie. Przy okazji informujemy, że warto, aby aplikacja wykorzystująca cookies, informowała o tym użytkowników, podobnie jak jest to robione na witrynach internetowych - zgodnie z zasadami informowania o używaniu cookies. d. Jedno cookie na jednym urządzeniu. Jedna aplikacja na jednym urządzeniu powinna nadawać jedno cookie. Zatem jeśli możliwe jest tworzenie różnych profili na danej aplikacji, ruch na każdym z tych profili powinien być oznaczany tym samym cookie. Cookie na aplikacjach mobilnych jest traktowane jako identyfikator urządzenia i należy dbać o to, aby nie było kasowane czy w inny sposób usuwane. e. UserAgent w każdym hicie. Z każdym wysyłanym hitem ma być przekazywane pole useragent, na podstawie którego będzie możliwe określenie, że jest to aplikacja mobilna (a nie aplikacja PC lub strona WWW). Szczegółowe zasady budowy pola useragent są określone w dokumencie umieszczonym pod adresem http://pliki.gemius.pl/audyt_gemius_pl/useragent_nowy_format_10_03_2014.pdf. f. Kontrola poprawności oskryptowania. Przejście z wynikiem pozytywnym procesu kontroli poprawności oskryptowania aplikacji w zakresie wymaganym do prezentacji wskaźników cookies. Prawidłowe oskryptowanie musi dotyczyć przynajmniej 95% aplikacji na używanych urządzeniach użytkowników. 3. Dodatkowe wymagania, konieczne do prezentacji wskaźników dotyczących czasu a. Stworzenie koncie audytowym (tym samym które jest używane też do zliczania cookie i odsłon) dwóch identyfikatorów technicznych skryptów audytowych jednego w celu zliczania aktywnego korzystania z aplikacji, a drugiego do pomiaru pasywnego korzystania z niej. Aby oddzielić hity techniczne od odsłon na koncie audytowym najlepiej (aby łatwo było sprawdzać ile odsłon jest zliczanych) jest zgromadzić skrypty dla odsłon w jednym folderze a skrypty techniczne w drugim. Muszą to być skrypty o Strona 3
innych identyfikatorach niż te wykorzystywane do zliczania odsłon w aplikacji. W przypadku używania systemu GemiusPrism muszą to być oczywiście skrypty o identyfikatorach PID różnych od zera. b. Wysyłanie hitów na pierwszy techniczny skrypt (skrypt aktywny ) przy pierwszym rozpoczęciu aktywnego korzystania z aplikacji (pierwszym wyświetleniu aplikacji na ekranie), każdym wznowieniu aktywnego korzystania z aplikacji (wyświetlenie aplikacji po tym jak była ona przez jakiś czas zminimalizowana/wygaszona choć jej proces nie był całkiem usunięty z pamięci urządzenia) oraz co 20 minut w czasie trwania aktywnego korzystania z aplikacji. Jeżeli w danej aplikacji oskryptowane są jako odsłony poszczególne akcje i jedna z tych akcji jest równoznaczna z pierwszym rozpoczęciem aktywnego korzystania z aplikacji (pierwszym wyświetleniem aplikacji na ekranie) to nie jest konieczne wysyłanie dodatkowo jeszcze jednego hita (technicznego) w tym momencie dla poprawnego liczenia czasu wystarczy wtedy sam hit oznaczający tę właśnie odsłonę. Dokładna definicja aktywnego korzystania z aplikacji znajduje się w dalszej części niniejszego dokumentu w punkcie III. c. Zliczanie hitów na drugi techniczny skrypt (skrypt pasywny ) w momencie zakończenia aktywnego z niej korzystania (czyli poza wyjątkiem korzystania z funkcji dostarczania samych treści dźwiękowych ma to się dziać w momencie gdy okno aplikacji znika z ekranu np. w wyniku automatycznego lub ręcznego wygaszenia ekranu urządzenia oraz w momencie minimalizacji albo zamknięcia aplikacji przez użytkownika. d. Przejście z wynikiem pozytywnym procesu kontroli poprawności oskryptowania aplikacji w zakresie wymaganym do prezentacji wskaźników dotyczących cookie i czasu. Prawidłowe oskryptowanie musi dotyczyć przynajmniej 95% aplikacji używanych na urządzeniach użytkowników. 4. Dodatkowe wymagania, konieczne do prezentacji wskaźników dotyczących odsłon a. Za odsłonę mogą zostać uznane jedynie te akcje wykonywane w aplikacji, które spełniają aktualną definicję odsłony obowiązującą w badaniu Megapanel PBI/Gemius. Zgodnie z uchwałą Rady Badania, za odsłonę uznajemy zdarzenie pełnego przeładowania nową treścią zawartości strony w oknie przeglądarki lub aplikacji z wyłączeniem komponentów statycznych, poprzedzone każdorazowo intencjonalną akcją użytkownika wynikłą z intencji pozyskania nowej treści, aktualizacji bieżącej treści lub skorzystania z nowej usługi. Przy czym za komponent statyczny uznajemy część graficzną i funkcjonalną warstwy prezentacji realizującą funkcję tła, nagłówka, stopki, menu lub paska nawigacji, które nie podlegają zmianie w zależności od dostarczanych treści bądź usług. W pełnym zbiorze odsłon wyodrębniamy dla wewnętrznych potrzeb badania Megapanel PBI/Gemius 2 typy odsłon: - Odsłona pełna to odsłona, w trakcie której następuje przeładowanie wszystkich komponentów statycznych. - Odsłona częściowa to odsłona, w trakcie której nie następuje przeładowanie wszystkich komponentów statycznych. Strona 4 b. Przed ostatecznym oskryptowaniem akcji w publicznie dostępnej wersji aplikacji właściciel aplikacji powinien wysłać do firmy Gemius zgłoszenie akcji które chce prezentować jako odsłony w wynikach badania. Procedura zgłaszania takich akcji jest opisana dokładnie w dokumencie umieszczonym pod adresem
http://pliki.gemius.pl/audyt_gemius_pl/procedura_zgloszenia_odslon_czesciowych.pdf W ostatecznej, publicznej wersji aplikacji powinny być zliczane jako odsłony tylko te ze zgłoszonych akcji, które uzyskały akceptację (potwierdzenie że to rzeczywiście są odsłoną) firmy Gemius w odpowiedzi na zgłoszenie. c. Po zatwierdzeniu przez Gemius listy akcji uznanych za odsłony firmie Gemius powinna zostać udostępniona testowa, deweloperska wersja aplikacji w której zostały jako odsłony oskryptowane zatwierdzone akcje. Gemius dokonuje sprawdzenia takiej wersji aplikacji i potwierdza, że wszystko zostało oskryptowane zgodnie z ustaleniami i dopiero wtedy aplikacja może być udostępniona publicznie. Jeżeli Gemius wykryje nieprawidłowości w oskryptowaniu to muszą one być poprawione przed publicznym udostępnieniem aplikacji. Hity oznaczające zliczenie odsłony muszą być wysyłane na inne identyfikatory skryptów niż identyfikatory skryptów technicznych (tzw. skrypt aktywny i skrypt pasywny) używanych do dokładnego zliczania aktywnego czasu korzystania z aplikacji. Skrypty te powinny być jednak umieszczone na tym samym koncie audytowym na którym są umieszczone skrypty techniczne. Aby oddzielić hity techniczne od odsłon na koncie audytowym najlepiej (aby łatwo było sprawdzać ile odsłon jest zliczanych) jest zgromadzić skrypty dla odsłon w jednym folderze a skrypty techniczne w drugim. W przypadku używania systemu GemiusPrism muszą to być skrypty o identyfikatorach PID różnych od zera. d. Odsłony wysyłane jako częściowe powinny być oznaczone w hicie wysyłanym przez aplikację w momencie wywołania danej akcji specjalnym parametrem hsrc=2. Odsłony pełne powinny być zaś oznaczane parametrem hsrc=1. Jeżeli przy skryptowaniu aplikacji właściciel aplikacji korzysta z narzędzi SDK przygotowanych przez Gemius to odsłony powinny być oznaczane jako częściowe lub pełne za pomocą specjalnego parametru opisanego w dokumentacji SDK. Użycie odpowiedniego parametru w SDK powoduje wysyłanie odpowiedniego parametru hsrc w hitach. W przypadku skryptowania aplikacji bez korzystania z SDK przygotowanych przez Gemius hity należy skonstruować zgodnie z zaleceniami opisanymi w dokumencie http://pliki.gemius.pl/audyt_gemius_pl/konstruowanie_hitu_w_aplikacjach_bez_uzycia_sdk.pdf III. Definicje związane z pojęciem aktywnego korzystania z aplikacji Aktywne korzystanie z aplikacji - Intencjonalna interakcja użytkownika z aplikacją, która umożliwia kontakt z treścią lub skorzystanie z usługi. Intencjonalne korzystanie z aplikacji definiujemy jako doprowadzenie przez użytkownika do dostarczenia mu treści (innej niż reklama) przez aplikację, na przykład w wyniku wykonania przez niego jakiejś akcji mającej miejsce przed dostarczeniem tych treści. Jako rozpoczęcie aktywnego korzystania z aplikacji rozumiemy więc też otwarcie okienka aplikacji w którym użytkownik może dokonywać dalszych wyborów - czyli jeżeli wyświetli się okienko aplikacji (np. zawierające opcje wyboru różnych treści w aplikacji) w wyniku kliknięcia na jej ikonkę w menu urządzenia to to już uznajemy za rozpoczęcie aktywnego z niej korzystania. W celu poprawnego zmierzenia czasu aktywnego korzystania z aplikacji skrypty Firmy Badawczej muszą być uruchomiane w takcie zdarzeń pokazania okna użytkownikowi oraz muszą z określoną częstotliwością być wywoływane, aż do zdarzenia odpowiadającemu ukryciu okna. W przypadku korzystania z funkcji aplikacji polegającej na dostarczaniu samych treści dźwiękowych (np. słuchanie radia) aktywne korzystanie trwa nadal nawet po ukryciu okna o ile treści dźwiękowe są nadal odtwarzane. Również za do spełnienia definicji rozpoczęcia Strona 5
aktywnego korzystania z aplikacji wystarczy w takim przypadku włączenie odtwarzania treści dźwiękowych, nawet jeżeli nie towarzyszy temu pokazanie okienka aplikacji na ekranie. Pokazanie okna - doprowadzenie przez użytkownika do wyświetlenia na ekranie w formie widocznej dla niego, dowolnego okienka aplikacji umożliwiającego kontakt z treścią (inną niż reklama) lub skorzystanie z jakiejś usługi dostępnej poprzez aplikację. Ukrycie okna - doprowadzenie przez użytkownika do usunięcia z widoku na ekranie okna programu na przykład przez jego zamknięcie lub zminimalizowanie. W przypadku aplikacji mobilnych za ukrycie okna uznajemy również wygaszenie ekranu (uniemożliwiające korzystanie z aplikacji) zarówno automatyczne (w wyniku braku aktywności przez jakiś czas) jak i bezpośrednio wywołane przez użytkownika. Przykładowe zdarzenia spełniające definicję intencjonalnego korzystania z aplikacji: - otwarcie, w formie widocznej dla użytkownika na ekranie, dowolnego okienka aplikacji umożliwiającego użytkownikowi kontakt z treścią (inną niż reklama) lub skorzystanie z usługi dostępnej poprzez aplikację. Cały czas, przez który takie okienko jest widoczne na ekranie użytkownika, uznawany jest za czas intencjonalnego korzystania z danej aplikacji. - W przypadku korzystania z funkcji aplikacji polegającej na dostarczaniu samych treści dźwiękowych (np. słuchanie radia) - świadome uruchomienie odtwarzania treści dźwiękowych, nawet jeżeli nie łączy się z otwarciem żadnego widocznego na ekranie okienka aplikacji. Automatyczne, nie uruchomione świadomie przez użytkownika, rozpoczęcie odtwarzania treści dźwiękowych nie jest uznawane za intencjonalne skorzystanie z aplikacji. IV. Narzędzia do zliczania aplikacji przygotowane przez Gemius Strona 6 Do zliczania aplikacji mobilnych Gemius przygotował odpowiednie zestawy narzędzi programistycznych - Software Development Kit (SDK) w wersjach na systemy: - Android - ios (zarówno 32-bitowe aplikacje jak również iphone 3s i 64-bitowe aplikacje) - Windows Phone 7 i 8 oraz Windows Store Apps. W celu otrzymania odpowiedniego narzędzia prosimy o kontakt pod adresem Megapanel@gemius.com Narzędzia te umożliwiają podstawowy pomiar bez pomiaru czasu aktywnego i pasywnego korzystania z aplikacji. W celu uzyskania możliwości prezentacji czasu dla aplikacji mobilnej w badaniu Megapanel PBI/Gemius konieczne jest samodzielne oskryptowanie aplikacji z użyciem identyfikatorów do pomiaru aktywnego i pasywnego korzystania. Hity służące do zliczania czasu należy skonstruować zgodnie z zaleceniami opisanymi w dokumencie: http://pliki.gemius.pl/audyt_gemius_pl/konstruowanie_hitu_w_aplikacjach_bez_uzycia_sdk.pdf Jako odsłony techniczne nie muszą być one w ogóle oznaczane parametrem hsrc (odróżniającym odsłony pełne od częściowych) a jeżeli nie byłoby to możliwe technicznie w danym przypadku to mogą być one oznaczane parametrem hsrc=1 tak jak pełne odsłony.