Javascript, HTML, CSS e... !
0 commenti

Connettore dati da Webtrends a Data Studio con USER_PASS e Schema Dinamico

Data Studio add-on: Webtrends (connettore personalizzato)

Lingue disponibili per le linee guida (guidelines available languages): ITALIANO - ENGLISH

 

Webtrends Data Studio Community Connector: linee guida
________________________________________

I connettori per Data Studio consentono connessioni dirette da Data Studio a qualsiasi origine dati accessibile via web per la realizzazione di report e dashboard.
Con Google Apps Script è possibile creare il proprio connettore seguendo le linee guida della documentazione ufficiale: https://developers.google.com/datastudio/connector/build

Questo articolo è dedicato alle linee guida per l'utilizzo di un connettore, per la piattaforma Analytics di Webtrends (Infinity), che ho realizzato con Apps Script e reso disponibile nella 'Open Source Community Connector'.
Potete trovare il sorgente del connettore comodamente nel mio account GitHub (webtrends).

Le caratteristiche tecniche contenute nello sviluppo di questo connettore sono: autenticazione di tipo USER_PASS e Schema dei dati generato dinamicamente in base all'id del report indicato.

Per poter utilizzare e provare in modo autonomo un connettore della Community fare riferimento alla relativa documentazione ufficiale: https://developers.google.com/datastudio/connector/use

Una volta avviato il connettore webtrends, in base alle indicazioni di cui sopra se non trovato nella Galleria dei Connettori di Google Data Studio, sarà necessario fornire le credenziali di accesso al proprio account Webtrends:



webtrends data studio community connector - credenziali di accesso

Fig. 1 - Add-on Webtrends per Google Data Studio - Richiesta credenziali di accesso alla piattaforma Webtrends


Il sistema controlla l'effettiva validità delle credenziali fornite ed in caso di errore verrà mostrato il seguente messaggio informativo: Spiacenti. Le credenziali sono state inviate, ma non sono valide.

In caso di inserimento corretto si accederà alla schermata successiva dove è richiesto l'inserimento dell'ID dell'Account Webtrends, l'ID del Report che si intende interrogare (che sono campi obbligatori) ed il timezone (facoltativo, di default è impostato su Europe/Rome):



webtrends data studio community connector - dati per il recupero del report

Fig. 2 - Add-on Webtrends per Google Data Studio - Dati per il recupero del report (obbligatorio l'Account ID ed il Report ID)


Dopo alcuni secondi, se le informazioni inserite sono corrette, si accederà ad un'altra schermata che mostra i campi interessati dal report interrogato e la tipologia, differenziati in dimensioni e metriche. In questo caso modificare manualmente i dati di aggregazione per le metriche affinché risultino coerenti con il dato in questione:



webtrends data studio community connector - dimensioni e metriche del report interrogato

Fig. 3 - Add-on Webtrends per Google Data Studio - Dimensioni e Metriche del Report interrogato


Sarà possibile a questo punto cliccare su 'CREA RAPPORTO' (o su 'ESPLORA') per realizzare la propria dashboard con i valori estratti direttamente dalla propria sorgente di dati:



webtrends data studio community connector - dashboard con i dati di webtrends

Fig. 3 - Add-on Webtrends per Google Data Studio - Dashboard con i dati di Webtrends


ATTENZIONE: considerando che, come è noto, la richiesta di report su Webtrends non produce una risposta in tempo reale, è possibile che, selezionando un determinato range di date, non venga restituito alcun dato. In questo caso è necessario attendere alcuni secondi (possono essere anche alcuni minuti in caso di selezione di un intervallo temporale espanso) e cliccare sull'icona per aggiornare i dati (refresh) presente in altro nella barra degli strumenti nell'interfaccia dell'editor di Data Studio visibile nell'immagine precedente.

 

 

Webtrends Data Studio Community Connector: guidelines
________________________________________

Connectors for Data Studio allow direct connections from Data Studio to any data source for reports and dashboards creation.
With Google Apps Script you can create your own connector following the guidelines of the official documentation: https://developers.google.com/datastudio/connector/build

This article is dedicated to the guidelines for the use of a connector, for the Analytics Webtrends platform (Infinity), which I realized with Apps Script and published in the 'Open Source Community Connector'.
You can find the webtrend connector source in my GitHub account (webtrends).

USER_PASS authentication and Dynamic schema are characteristics of the connector.

To use the connector, refer to the official documentation: https://developers.google.com/datastudio/connector/use

Once the webtrends connector is started, you will need to provide login credentials to your Webtrends account:



webtrends data studio community connector - login credentials

Fig. 1 - Add-on Webtrends for Google Data Studio - Login credentials


The system checks the validity of the credentials and shows an error if they are not correct.

If credentials are correct, you will access the next screen where it is required to enter the ID of the Webtrends account, the ID of the Report you wish to query (which are mandatory fields) and the timezone (optional, default is set to Europe/Rome):



webtrends data studio community connector - data for querying the report

Fig. 2 - Add-on Webtrends for Google Data Studio - Data for querying the report


After a few seconds, if the information entered is correct, you will access another screen that shows the fields from the queried report and their type, divided into dimensions and metrics. In this case, manually change the aggregation data for the metrics to be consistent with the data:



webtrends data studio community connector - dimensions and metrics of the queried report

Fig. 3 - Add-on Webtrends for Google Data Studio - Dimensions and Metrics of the queried report


At this point you can click on 'CREATE REPORT' (or 'EXPLORE') to create your own dashboard with the values extracted directly from your data source:



webtrends data studio community connector - dashboard with webtrends data

Fig. 3 - Add-on Webtrends for Google Data Studio - Dashboard with Webtrends data


ATTENTION: since the report request on Webtrends does not produce a response in real time, it is possible that by selecting a certain range of dates no data is returned. In this case it is necessary to wait a few seconds (it can be even a few minutes if an expanded time interval is selected) and click on the refresh icon in the toolbar dashboard editor interface of Data Studio.

Tags

Michele Pisani

Michele Pisani

Sviluppatore Javascript ed esperto in Digital Analytics

L'esperienza nel settore Digital Analytics unita ad anni di sviluppo in Javascript ha trovato la massima espressione in Google Apps Script che mi ha permesso, con estrema facilità e poche righe di codice, di realizzare potenti applicazioni interattive e processi automatizzati integrati con i prodotti della G Suite.

Come contattarmi
scrivi un commento

0 Commenti

Non ci sono commenti

Nessuno ha ancora commentato questo articolo, fallo tu per primo!

scrivi un commento

Scrivi un commento

Il tuo indirizzo email non sarà pubblicato.I campi contrassegnati da un * sono obbligatori
Puoi utilizzare i seguenti tag nei commenti:
[bold]testo[/bold] se vuoi evidenziare un testo con il grassetto[code]function helloworld() { }[/code] se vuoi pubblicare una porzione di codice[url]http://www.appsscript.it[/url] se devi riferirti ad un indirizzo web