Personalmente, trovo utile avere nella mia scatola degli attrezzi informatici uno script che mi consenta di avere i dati salienti di Analytics, quelli per me utili da monitorare quotidianamente, in breve tempo.

La procedura per realizzare l’obiettivo tramite python e l’API Google Analytics non è delle più immediate… però vale bene la mezz’oretta di tempo necessaria per la messa in opera.

Occorre procedere per passaggi. In primo luogo ho installato i moduli python necessari via pip:

Installo i moduli python

pip install --upgrade google-api-python-client
pip install --upgrade oauth2client

Ho seguito i passaggi indicati da Google per la creazione di un’utenza di servizio nelle API.

Creo il progetto

Per creare il progetto si parte da qua:

https://console.developers.google.com/flows/enableapi?apiid=analyticsreporting.googleapis.com&credential=client_key

Nella piattaforma di sviluppo Google ho creato un progetto (io l’ho chiamato “analytics”, che fantasia…).

Creo il service account

A questo punto, ho creato il service account scegliendo quel progetto:

https://console.cloud.google.com/iam-admin/serviceaccounts

Ho creato la chiave. Ho generato e scaricato il file json nella cartella dove ho salvato il mio script, rinominandolo google_secrets.json

Ho associato al mio account Analytics la casella email generata da Google come utente con poteri di analisi e visualizzazione. (Dalle impostazioni, account, utenti).

La parte più noiosa è terminata, e per fortuna non dovrò più ripeterla. Ora viene la parte migliore.

Finalmente…lo script di esempio

Ho scaricato il file d’esempio HelloAnalytics.py inserendo il percorso del file JSON e l’id della vista da interrogare.

Le variabili da valorizzare sono:

KEY_FILE_LOCATION = ''

dove ho indicato il mio file google_secrets.json. E

VIEW_ID = ''

dove andrò a scrivere l’id della vista Analytics.
Per trovare l’id della vista ho usato Account Explorer:

https://ga-dev-tools.appspot.com/account-explorer/ 

oppure basta guardare in Analytics.

Poi ho lanciato

python HelloAnalytics.py

Tutto ok, lo script restituisce il risultato atteso, cioè i dati degli ultimi 7 giorni delle sessioni per paese.

Ora non resta che modificare lo script a proprio piacimento, giocando con date, dimensioni e metriche al fine di ottenere in output ciò che più serve. E qui, l’unico limite diventa la fantasia.

La storia di AWK è lunga, in termini informatici lunghissima. E’ il 1977 quando Alfred Aho, Peter Weinberger e Brian Kerningham (dalle iniziali dei tre il suo nome) presentano questo anomalo linguaggio interpretato, utilissimo per processare files di testo strutturati e generare report.

AWK è un più di un semplice tool e forse qualcosa meno di un completo linguaggio di programmazione, nel senso moderno del termine (anche se è un completo linguaggio di programmazione). Mostra la sua piacevolezza e potenza come filtro in una pipeline, dove si fa preferire alla criptica sintassi di SED e consente di evitare di scomodare il Perl.

AWK, nelle sue varianti (la più diffusa è quella a cura della Free Software Foundation, GAWK) è disponibile praticamente per qualsiasi sistema operativo possiate immaginare. Sì, anche il DOS.

Ma cosa rende insieme unico, attraente e insieme così poco conosciuto questo strumento che ha per logo un simpatico pinguino, 14 anni prima di Linux?

La “strana” logica di AWK

Per spiegarlo inizierò dal concetto di base su cui, a mio avviso, si fonda la corretta comprensione del linguaggio. No, non è un esempio di “Hello World”…

La logica di AWK è semplice, ma potente. Come quasi tutti gli strumenti nati in ambito UNIX, AWK ragiona in termini di linee di testo. Processa una linea alla volta applicando delle regole, composte da:

pattern {azione}

sia il pattern che l’azione sono opzionali.
Se manca il pattern, l’azione viene applicata a tutti i record.
Se a mancare è l’azione, il record che corrisponde al pattern è scritto sullo standard output (quindi di default sullo schermo).

Quello che AWK fa, in pratica, è leggere il testo una riga alla volta, separarlo in campi definiti da un delimitatore (modificabile), assegnare i valori a delle variabili predefinite ($1,$2,$3…) e applicare le regole indicate dal programmatore.

AWK può ricevere il testo da processare attraverso una pipe, oppure può presentarsi sotto forma di script, invocabile con awk -f nomescript.awk e processare il file o i files indicato/i.

Un esempio vale mille parole

Complicato? Un esempio mostrerà tutta la semplicità del linguaggio.
Immaginiamo di avere un file di testo chiamato amici.txt:

Aldo, 23
Carlo, 28
Mario, 35
Piero, 17
Stefano, 30
Umberto, 29

Ok, l’esempio è senza senso, ma serve solo per illustrare l’utilizzo di AWK…

se io passo l’output di cat amici.txt tramite una pipe ad AWK in questo modo:

cat amici.txt | awk '/Stefano/ {print $2}'

oppure processo amici.txt direttamente così:

 awk '/Stefano/ { print $2 }' amici.txt

il risultato a schermo sarà… 30

Ricordate? pattern e azione. Se e quando AWK trova “Stefano” stampa il secondo campo, cioè il numero 30. La virgola è il delimitatore di default di AWK. Se avessi avuto come delimitatore il punto e virgola avrei potuto scrivere:

cat amici.txt | awk -F; "/Stefano/ {print $2}"

Giochiamo un po’… se avessi scritto:

cat amici.txt | awk "/Stefano/ {print $2, $1}"

il risultato sarebbe stato:

30, Stefano

iniziate a capire l’utilità di questo strumento, ad esempio per processare al volo files csv?

un po’ di esempi banalissimi:

{print $1} stampa il primo campo di ogni linea di un file

 /pippo/   stampa tutte le linee che contengono pippo

lenght($0) < 40 stampa tutte le linee che contengono meno di 40 caratteri

e via dicendo…

Come dicevo, posso usare AWK in una pipe, ma posso anche scrivere dei veri e propri programmi, di maggiore complessità.

Uno script AWK è fatto di 3 parti (al massimo…)

Un programma AWK consta di tre parti: le assegnazioni e le operazioni per così dire preliminari, tipo l’assegnazione di variabili globali, che troveranno posto qui:

BEGIN {
...
}

(ovviamente questa sezione è del tutto opzionale)

poi seguiranno le istruzioni secondo la logica /pattern/ {azione} che abbiamo già visto.
I pattern possono essere combinati con gli operatori booleani || (OR), && (AND) e ! (NOT).
Le azioni consistono di uno o più comandi, funzioni o assegnazione di variabili, separate da a capo o da punti e virgola e contenute dentro le parentesi graffe {}.
I comandi possono essere assegnazione di variabili (o array), comandi di stampa, funzioni interne, comandi per controllare il flusso dell’operazione.

e per finire, anch’esso opzionale:

END {
...
}

dove andrò, ad esempio, a stampare il risultato finale di una mia elaborazione (potrei aver sommato tutti i valori presenti in $2 di tutte le righe in una variabile e dentro END andrò a stampare, alla fine, il valore totale di quella variabile…).

Se salvo il mio script con un nome, ad esempio pippo.awk, posso eseguirlo con:

awk -f pippo.awk

o più comodamente iniziando il mio script con:

  #!/usr/bin/awk -f

e poi rendendolo eseguibile.

Le variabili possono essere assegnate nel modo più semplice possibile:
PIPPO = “dsajsakdsk”

Gli arrays possono essere creati con la funzione split:

split (stringa,array[,separatore])

…il resto lo lascio alla vostra fantasia!

In libreria, per approfondire