Snoobin asennus Flash-sivulle (Action script 3)

Tämä ohje on tarkoitettu Flash:ssa käytettävän Action Script-kielen versiolle 3.
Ohjeen Action Script 1 & 2 versiolle saat täältä »

Flash –animaation seuranta toteutetaan kutsumalla animaatiosta suoraan snoobi.trackPageView(pathParam) –funktiota, joka lähettää kävijäseurantatiedot Snoobin keräyspalvelimelle. Snoobi raporttiin animaation tapahtumat tulevat sivulatauksina, eli ne näkyvät raportin ”Sivut ” –paneelissa.

1. Asennus Flash -sivustolle

Snoobi-skripti asennetaan flash-animaation sisältävälle sivulle normaalisti ennen sulkevaa </body> -tagia.

2. snoobi.trackPageView funktion kutsu animaatiosta

Aina kun tietty tapahtuma (napin painallus, videon katselu, framen lataus jne.) halutaan mitata animaatiossa, kutsutaan snoobi.trackPageView(pathParam) –funktiota. Käytännössä trackPageView on snoobi-nimisen olion tarjoama metodi. Pakollisessa pathParam –parametrissa annetaan polku, joka kuvaa animaatiossa tehtävää tapahtumaa. Snoobi.trackPageView-funktio on JavaScript-funktio, jonka kutsumista varten Flash-animaatio tarvitsee external.ExternalInterface-kirjaston. Kuvassa 1 kyseinen kirjasto on sisällytetty Action Scriptiin rivillä 3.

Esimerkki 1. www.kampanjantekijat.com/flash -osoitteessa oleva animaatio

Animaatioon on määritelty navigointipainikkeita, joita klikkaamalla animaatiossa näytettävä sisältö (=sivu) vaihdetaan. Kuvan 1 Action Script:n rivillä 11 on määritelty funktio showPage, joka huolehtii sivujen näyttämisestä navigaatiopainikkeita klikkaamalla. ShowPage-funktioon on myös määritelty snoobi.trackPageView-funktion kutsu riveille 19-21. Esimerkissä snoobi.trackPageView-funktiota kutsutaan pathParametrin-arvolla "/actionscript3demo/page/"+pathName. Esimerkissä pathName-muuttujan arvo on pages-taulukossa määritellyn halutun sivun nimi. Esimerkiksi ensimmäistä sivua kutsuttaessa pathName-muuttuja saisi arvon container_1.

Kuva 1. snoobi.trackPageView –funktion kutsu animaatiosta

Esimerkissä 1 Snoobi –raporttiin muodostuu sivulataus, jonka URL on www.kampanjantekijat.com/actionscript3demo/page/container_1

Voit ladata tästä Flash-esimerkin (.fla), joka havainnollistaa miten seurannan tulisi toimia jos käytössä ei ole parametrilla tehtyä selkokielistystä (150 KB). Avaamiseen tarvitset Adoben Flash 8 / CS3 ohjelman.

3. Selkokielistäminen ja osiointi parametrilla ("automaattinen selkokielistys" ja "automaattinen osiointi")

Selkokielistäminen ja osiointi parametrilla tehdään snoobi.trackPageView –funktion lisäparametreilla page_name ja section.

Esimerkki 2. www.kampanjantekijat.com/flash -osoitteessa oleva animaatio

Esimerkin 2 Action Script on muutoin sama kuin esimerkissä 1 sillä erotuksella, että esimerkissä 2 käytetään automaattista sivujen nimeämistä ja osiointia. Esimerkissä 2 snoobi.trackPageView-funktiota kutsutaan edelleen pathParametrin-arvolla "/actionscript3demo/page/"+pathName. Uusina parametreina snoobi.trackPageView-funktiossa käytetään pagename-parametria arvolla "Flash » Sivu + key" sekä section-parametria arvolla "Demo Flash AS3".

Kuva 3. snoobi.trackPageView-funktion kutsu automaattisella sivujen nimeämisellä ja osioinnilla

Esimerkissä 2 Snoobi –raporttiin muodostuu sivulataus, jonka sivulle annetaan nimeksi "Flash » Sivu 1" ja sivu liitetään osioon "Demo Flash AS3"

Voit ladata tästä Flash-esimerkin (.fla), joka havainnollistaa miltä Flash-tiedosto näyttää jos käytössä on parametrilla toteutetut sivun nimet ja osiointi (144 KB). Avaamiseen tarvitset Adoben Flash 8 / CS3 ohjelman.

Mitä Flash-animaatiossa kannattaa mitata?

Animaatiossa kannattaa mitata kaikki tapahtumat, jotka ovat kävijän laadun määrittelemisen kannalta oleellisia. Tässä muutamia esimerkkejä:

1. Navigoinnissa liikkuminen

Kun kävijä klikkaa navigoinnissa flash –animaation eri osiin ne kannattaa mitata

2. Lomakkeiden lähettäminen

Kun lomake lähetetään onnistuneesti. Jos Flashissa on erilaisia lomakkeita, ne kannattaa myös erotella toisistaan

3. Linkkien klikkaaminen

Jos Flashin tarkoitus on esim. ohjata kävijöitä muille sivuille tai sivustoille Flashin ulkopuolella, tai klikkaamaan sähköpostilinkkejä, ne kannattaa ottaa mukaan seurantaan

4. Videoiden katselu

mitä videoita kävijät katselevat animaatiossa

videoon kannattaa lisätä ns. checkpointteja, jotka kertovat kuinka pitkälle videoita katsotaan

video voidaan jakaa esimerkiksi neljään osaan ja aina kun kolmasosa videosta on katsottu, kutsutaan snoobi.trackPageView –funktiota eri pathParam –arvolla

play-nappia painettu -> snoobi.trackPageView('/video_aloitus')

1/3 katsottu -> snoobi.trackPageView('/video_1_3')

2/3 katsottu -> snoobi.trackPageView('/video_2_3')