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:

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):

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:

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:

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:

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):

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:

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:

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.