Zasady oskryptowania i prezentacji danych dla aplikacji

Zasady oskryptowania i prezentacji danych dla aplikacji

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ść
Strona 1
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
Gemius © 2014
www.gemius.com
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: [email protected]) 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”
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ż
Strona 2 Gemius © 2014
www.gemius.com
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 Gemius © 2014
www.gemius.com
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.
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
Strona 4 Gemius © 2014
www.gemius.com
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 Gemius © 2014
www.gemius.com
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
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
[email protected]
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.
Strona 6 Gemius © 2014
www.gemius.com