Dette er 3. del af min blogserie om Google Analytics API, og jeg anbefaler du læser Del 1 og Del 2, før vi går i gang med denne. I dag ser vi på hvordan vi kan hive data ud fra mere end en dimension og en metric, hvordan vi kan sortere og filtrere dataudtræk samt selvfølgelig hvordan vi omdanner disse udtræk til arrays.

Dataudtræk på på flere "dimensions" - Besøg pr dag opdelt efter kilde

I Del 2 så vi hvordan man kunne udtrække besøg for en given datoperiode. Dette er selvfølgelig ganske interessant, men for mange vil det nok også være interessant, at opdele denne trafik på kilde (organisk, henvisninger, direkte og betalt). Hvis vi bare ønsker det samlet antal opdelt på kilde, kan vi gøre som i anden del, forespørge på en dimension (ga:medium) og en metric (ga:visits) - men hvis vi ønsker at dele dette ud på dage er vi nødt til også at forespørge på ga:date. Når man forespørger på flere "dimensions" eller "metrics" adskildes disse blot af , (komma). Derfor skal vi forespørge denne url:

Denne url (husk at udskifte id til dit eget profil id) sender vi igen igennem vores hent_data funktion som nu vil returnere et xml feed med følgende struktur (uddrag):

Den eneste forskel der er her er at vi kan se vi har to dimensions, vi vil derfor lave et multidimensionelt array som opbygges sådan her:

For at få denne struktur bruger vi igen SimpleXML:

Da vi har brugt 2 dimensioner er der nu to noder der hedder "dimension". Disse to kan vi i SimpleXML tilgå som et array, dvs første dimension er [0] (dato) og anden dimension er [1] (kilde) - udover disse ændringer er koden den samme som på dag 2.

Kilder

APIen bruger følgende navne på kilder:

• (none) = direkte besøg
• organic = Organisk trafik (ikke betalt trafik fra søgemaskinerne)
• cpc = Betalt trafik (adwords)
• referral = Henvisninger

Dataudtræk på flere "metrics" - Bouncerate

Der er ingen metric der hedder bouncerate i Google Analytics API, men det er ganske nemt at regne denne ud, da vi kan forespørge på flere metrics. Bouncerate udregnes ved følgende formel: (antal afvisninger/antal indkomne visninger)*100. I API sprog bliver dette til (ga:bounces/ga:entrances)*100 - For at kunne lave denne udregning sender vi følgende url til hent_data():

Vores data udtræk ser nu sådan her ud:

Som ved flere "dimensions", ser vi nu, at der er to metrics noder i hvert disse kan vi igen hive ud som et array, udregne bouncerate og gemme i vores data array:

Flere "metrics" samt flere "dimensions" - Bouncerate opdelt på dag og kilde

Det er selvfølgelig også muligt at kombinere flere dimensions og flere metrics. Vi kan fx sagtens opdele bouncerate på kilde dvs, hvor høj er vores bouncerate på dem der kommer fra organisk trafik/cpc/henvisninger/direkte trafik, på en given dag eller periode. Her bruger vi ga:date,ga:medium som "dimensions" og ga:bounces,ga:entrances som metrics:

Igen sender vi urlen igennem hent_data() og behandler retursvar vha. SimpleXML. Strukturen er den samme som før, bort set fra der er kommet en ekstra dimension, derfor behandler vi næsten også data på samme måde som før: <?php //forsøg at logge ind, giv fejl hvis ikke if (login()) { //vi er nu logget ind echo 'logget ind'; $xml = hent_data('https://www.google.com/analytics/feeds/data?ids=ga:5311824&dimensions=ga:date,ga:medium&metrics=ga:bounces,ga:entrances&start-date=2009-04-01&end-date=2009-04-07'); //hent data fra google if ($xml) { //er xml loadet? $xml = str_replace('dxp:','',$xml); //simple xml håndtere namespaces på en lidt besværlig måde, så for nemhedens skyld fjerner vi bare dxp: fra noder i xml dokumentet $xml = new SimpleXMLElement($xml); //start simple xml og load vores xml ind $data = array(); //array vi vil gemme vores data i foreach ($xml->entry as $entry) { //gennemløb entry da det er her vores dage er gemt $dag=date('Y-m-d',strtotime($entry->dimension->attributes()->value)); //hent dato som er vores dimension - denne er ikke formateret så det må vi selv klare med date og strtotime $kilde = (string)$entry->dimension[1]->attributes()->value; //hent dimension 2 - dvs kilden for vores besøg $bounces=(integer)$entry->metric[0]->attributes()->value; //hent antal bounces - metric 1 $entrances = (string)$entry->metric[1]->attributes()->value; //hent antal entrances metric 2 $bouncerate = ($bounces/$entrances)*100; //udregn bouncerate $data[$dag][$kilde]=$bouncerate; //tilføj til vores data array } } } else { //ikke logget ind echo 'Der opstod en fejl i login'; } ?>

Sortering og filtrer

Efter som vi gemmer vores data i et array, ville det være nemt at sortere i PHP, men vi kan også bede APIen om at gøre det for os ved at bruge sort parametren. Ligeledes kan vi inkludere eller ekskludere bestemte data ved at bruge filter. Hvis vi tager udgangspunkt i vores data kald fra Del 2 kan vi fx nemt sortere dagene, efter hvilken dag der har flest besøgende:

Vi sorterer her vores resultater efter ga:visits (ga:visits) og med foranstillet - (minus) fortæller vi google, at vi vil sortere i faldende orden. Stigende orden er standard og kræver derfor ikke noget fortegn. Du kan sortere efter alle metrics og dimensions.

Filtrer

Filtrering af data er en anelse mere kompliceret end sortering. Filtrering betyder at vi fortæller Google Analytics API, at vi kun ønsker data som opfylder bestemte krav. Hvis vi kun ville udtrække dage, hvor der var flere besøg end 50, kan vi gøre det sådan her: ga:visits>=50 - operatorene i filtrer skal i visse tilfælde urlencodes, så ga:visits>=50 bliver til: ga:visits%3E%3D50 - den fulde url er nu:

Sender vi urlen igennem vores funktion fra dag 2 får vi følgende array:

Der er i alt 12 operatorer (6 metrics 6 dimensions) (direkte fra Googles dokumentation):

Vi kan selvfølgelig også kombinere sortering og filtrer uden problemer.

Fejlfinding og leg

Som med alt andet handler det om at lege lidt med APIen og prøve at hive forskellige datarapporter ud. Dette vil unægteligt resulterer i nogle fejl, og tvivl om hvordan data hives ud via SimpleXML. Som standard er det XML vi får ud fra APIen helt uden mellemrum, hvilket kan gøre det meget uoverskueligt hvis vi udskriver vores $xml variabel til skærmen. Dette kan dog ændres, simpelthen ved at tilføje &prettyprint=true til vores data url kald. Hvis denne parameter tilføjes får vi udskrevet XMLen opstillet pænt. (Nb. udskriv $xml før du kalder simplexml). Det er en rigtig god ide at fjerne prettyprint igen, da formateringen betyder ekstra data der skal sendes fra APIen.

Hvis du er i tvivl om hvordan du får fat på et element i SimpleXML kan du lave en var_dump($entry) i foreach løkken. Her vil du så få hele strukturen at se.

Og så er det bare at angive stien til noden.

Afslutning

Nu har vi fulgt hinanden nogle dage og dette er i første omgang den sidste planlagte del af serien. Dette betyder dog ikke at det er slut for dig, vi har kun lige rodet i overfladen af Google Analytics API, og nu handler det bare om at være nysgerrig og komme i gang med at grave dybere. Jeg kan næsten garantere at der kommer mere fra mig om APIen men hvornår det lige bliver ved jeg ikke, men snup et rss feed for blog indlæg tagget med Google Analytics API - så er du den første til at vidde når der er nye guldkorn :)

Endnu engang kan du hente min kildekode til dag 3

Håber du har fået noget ud af at følge denne blog serie - og som altid så er du velkommen til at skrive spørgsmål og kommentarer, og skal da heller ikke udelukke at specifikke spørgsmål omkring APIen kan resultere i endnu et blogindlæg i serien.

Skrevet d. 7. Maj 2009 20:26 af Claus Heinrich

Jeg simpelthen elsker dette Martin... Mange tak for din 3 trins raket. Denne guide vil absolut blive brugt og fulgt nøje når jeg vil lave min egne udtræk via deres API.

Det må have været svært at få det hele beskrevet så godt, men tror vi er rigtig mange der er utrolig glade for du har taget dig denne tid.

Og at vi får alle koderne er simpelthen bare perfekt. Ikke noget med at genopfinde den dybe tallerken.
Tak tak og atter tak Martin!

Link til seneste blogindlæg: Linkbuilding via bookmarking sites

Skrevet d. 7. Maj 2009 20:56 af Martin Nielsen

Velbekommen. Det har jo stået stille så længe her, så tænkte jeg ville lægge hårdt ud med Analytics API - indrømmer gerne at disse 3 indlæg har trukket tænder ud - brugte det meste af min søndag på eksempler og omskrivninger.

Det sværeste har faktisk næsten været at vidde hvor man skulle stoppe. Jeg er selv dybt fascineret af APIen og kunne vrøvle videre i alt evighed (og gjorde det flere steder) men håber på jeg har ramt et niveau hvor alle får noget ud af indlæggene.

skriv kommentar

Felter markeret med gult og * er påkrævet

Navn: * E-mail * Website Indtast bogstaverne *	Kommentar * (tilladt html: <code></code>)
	Opdateringer pr. e-mail
	Ønsker du et link til dit seneste blogindlæg?

Hvis du linker til en af mine blog artikler fra et blogsystem der udsender pings vil du få et gratis do-follow link fra mig, du kna også twitte om en post og få et link til din twitter profil (Jeg forbeholder mig dog retten til at slette eller nofollow spam :P)