Prima di iniziare

Una configurazione senza intoppi parte da quattro semplici elementi. Li prepari in anticipo: il resto sarà immediato.

Elemento	Significato
Account della dashboard	Un account utente NowMetrix attivo con accesso al tracker pertinente.
ID tracker	L'identificatore interno del sito web, ad esempio `TRACKER_ID`.
Accesso al sito web	L'autorizzazione ad aggiungere lo snippet di monitoraggio di NowMetrix al template del sito web o al tag manager.
Dominio di produzione	Il nome host finale che dovrebbe comparire in NowMetrix, ad esempio `example-news.com`.

1. Accedere alla dashboard

Apra dash.nowmetrix.com ed effettui l'accesso. Verrà visualizzata la vista in tempo reale del tracker utilizzato più di recente.

Se l'organizzazione utilizza il single sign-on, scelga il metodo di accesso fornito dal responsabile dell'account. Se dopo l'accesso non riesce ad accedere a un tracker, chieda a un amministratore di aggiungere il proprio utente all'elenco corretto dei tracker.

2. Trovare il tracker

Ogni sito web ha un ID tracker distinto. È l'etichetta che indica a NowMetrix a quale sito appartiene un Pageview in arrivo. Utilizzerà lo stesso ID per il monitoraggio, le richieste API e la risoluzione dei problemi.

Utilizzi ID neutri negli esempi e negli script di test. In produzione, sostituisca TRACKER_ID con l'ID tracker assegnato al sito web.

3. Installare il monitoraggio

Aggiunga lo snippet a ogni pagina che desidera visualizzare in NowMetrix. Per una redazione, in genere si tratta di pagine degli articoli, pagine principali delle sezioni, landing page e homepage.

<script src="https://ua.realtimely.io/script.js" data-site="TRACKER_ID" defer></script>

Posizionamento consigliato:

Inserisca lo snippet nel template di pagina condiviso, all'interno della sezione <head>.
Lo carichi una sola volta per pagina.
Lo mantenga attivo sia sulle varianti delle pagine desktop sia su quelle per dispositivi mobili.
Non lo blocchi tramite la logica del consenso ai cookie, a meno che non sia richiesto dalla configurazione legale.

Google Tag Manager

In Google Tag Manager, crei un tag HTML personalizzato e incolli lo snippet standard di NowMetrix. Lo attivi su tutte le pagine che devono essere monitorate.

<script src="https://ua.realtimely.io/script.js" data-site="TRACKER_ID" defer></script>

Abiliti Support document.write per il tag HTML personalizzato. Senza questa impostazione, il tracker potrebbe non inizializzarsi correttamente in Google Tag Manager.

Monitoraggio manuale

Per la maggior parte dei siti web, il monitoraggio automatico è la scelta giusta. Se gestisce una single-page app o ha bisogno del pieno controllo sui cambi di percorso, lo disabiliti con data-auto="false" e invii manualmente il Pageview.

<script src="https://ua.realtimely.io/script.js" data-site="TRACKER_ID" data-auto="false" defer></script>

Inviare manualmente un Pageview

<script>
document.addEventListener("DOMContentLoaded", () => {
    realtimely.trackPageview();
});
</script>

Inviare dati personalizzati del Pageview

Facoltativamente, può passare un URL, un titolo o un referrer personalizzato. È utile per le single-page app, il routing personalizzato o le pagine in cui l'URL visibile deve essere normalizzato prima del monitoraggio.

<script>
document.addEventListener("DOMContentLoaded", () => {
    realtimely.trackPageview("TRACKER_ID", {
        url: "https://example-news.com/about",
        title: "About our publication",
        referrer: "https://google.com"
    });
});
</script>

4. Verificare i dati in arrivo

Ed ecco la parte più soddisfacente: pubblichi lo snippet, apra una pagina reale e passi a Pagine principali. La visita dovrebbe comparire entro pochi secondi.

Controllo	Risultato previsto
Utenti in tempo reale	Il numero di utenti attivi aumenta quando vengono aperte le pagine.
Pagine principali	La pagina aperta compare con il relativo percorso, titolo e numero di utenti attivi.
Fonti	Le fonti dirette, referrer, di ricerca, social o UTM vengono raggruppate nella vista Fonti.
Panoramica	I Pageview e le visite giornalieri iniziano ad accumularsi per il tracker.

Modello di tutela della privacy

NowMetrix funziona senza cookie né archiviazione locale. Utilizza hash anonimizzati per un periodo di 24 ore, consentendo di misurare i visitatori unici giornalieri senza creare un profilo del visitatore persistente.

I dati utente anonimizzati vengono conservati solo per 24 ore. Dopodiché i salt usati per l'hashing vengono rimossi, quindi le visite mensili vengono calcolate a partire dai totali dei visitatori unici giornalieri.

5. Configurare il primo flusso di lavoro

Monitoraggio dalla dashboard

Utilizzi le viste in tempo reale e quelle della dashboard per monitorare utenti attivi, Pagine principali, Fonti, dispositivi, Paesi e il Pulse di oggi.

Accesso API

Gli amministratori dell'account e i membri del team con accesso API possono creare chiavi API personali in Impostazioni -> API. Consulti la documentazione di riferimento della REST API per endpoint ed esempi.

Accesso del team

Quando i dati iniziano ad arrivare, inviti le persone che dovranno utilizzarli. Conceda a ciascuna persona l'accesso solo ai tracker necessari; gli amministratori gestiscono le impostazioni dell'account e possono concedere l'accesso API personale a editor selezionati.

Se un membro del team non riesce a visualizzare un tracker, controlli l'elenco dei tracker assegnati prima di modificare l'installazione del monitoraggio.

Integrazione legacy

Monitoraggio AMP

Utilizzi questa integrazione solo se il sito web serve ancora pagine AMP. Per le nuove installazioni, utilizzi lo snippet JavaScript standard o la configurazione Google Tag Manager riportata sopra.

Aggiunga prima il componente AMP per l'analisi:

<script async custom-element="amp-analytics" src="https://cdn.ampproject.org/v0/amp-analytics-0.1.js"></script>

Quindi aggiunga la configurazione AMP di NowMetrix:

<amp-analytics config="https://ua.realtimely.io/amp/amp.v1.json" data-credentials="include">
    <script type="application/json">
        {"vars": {"accountId": "TRACKER_ID"}}
    </script>
</amp-analytics>

Se i dati non compaiono

Verifichi che lo snippet sia presente nell'HTML generato della pagina online.
Controlli che l'ID tracker corrisponda al tracker selezionato nella dashboard.
Apra gli strumenti per sviluppatori del browser e cerchi eventuali richieste di rete bloccate.
Verifichi che la pagina non venga servita da un template memorizzato nella cache privo dello snippet.
Contatti l'assistenza NowMetrix per verificare se il tracker sta ricevendo eventi.

Metta online il primo sito web con NowMetrix.