Microsoft Clarity

Il connettore Microsoft Clarity porta nel foglio i dati di comportamento utenti (traffico, dispositivi, sorgenti) del tuo sito collegato a Clarity.

Autenticazione diversa dagli altri connettori: non usa un login OAuth, ma un token generato manualmente da te in Clarity (Impostazioni > Data Export > Generate new API token). Il token è legato a un singolo sito/progetto Clarity: se ne gestisci più di uno, dovrai creare una connessione separata per ciascuno, con un nome a tua scelta (Clarity non fornisce un nome sito recuperabile via API).

Nessuna metrica selezionabile: l'API restituisce sempre tutti i blocchi di dati disponibili (traffico, dispositivi, sorgenti, ecc.), non è possibile scegliere quali includere.

Nessun intervallo di date personalizzato: il periodo è limitato a tre finestre fisse (ultime 24, 48 o 72 ore), non un vero calendario come negli altri connettori.

Metriche disponibili

Non selezionabili: l'API restituisce sempre tutti i blocchi di dati disponibili in un'unica risposta, senza un elenco di metriche da scegliere.

Dimensioni disponibili

Limiti noti

• Massimo 3 dimensioni per report
  Puoi combinare al massimo 3 delle dimensioni disponibili in uno stesso report (limite dell'API Clarity).
• Limite di 10 chiamate al giorno per progetto Clarity
  L'API di Microsoft Clarity accetta al massimo 10 richieste al giorno per ogni progetto/sito. Superato il limite, le esecuzioni successive falliscono fino al giorno dopo: se pianifichi report automatici frequenti su questo connettore, tienine conto nella frequenza dello schedule.
• Offset e Limit funzionano, anche se non compaiono nel form
  Il form dedicato di Microsoft Clarity non mostra i campi Offset e Limit, ma le colonne "Offset" e "Limit" del foglio di configurazione restano attive: se le compili a mano, vengono applicate ai dati già scaricati (l'API di Clarity non supporta paginazione, quindi il filtro avviene dopo il download). Se lasci "Limit" vuoto viene usato un limite predefinito di 10.000 righe.
• Massimo 1.000 righe per risposta, nessuna paginazione
  L'API restituisce un'unica risposta senza pagine successive, fino a un massimo di 1.000 righe complessive.
• "Aggiungi risultati" (Append Rows) sempre attivo
  A differenza degli altri connettori, qui l'accumulo dei risultati nel tempo è sempre attivo e non disattivabile: l'API di Clarity non conserva uno storico, quindi ogni esecuzione aggiunge le righe di quel momento a quelle già presenti, invece di sovrascriverle.
• Le colonne si adattano ai dati ricevuti
  Lo schema delle colonne si "congela" al primo report riuscito: se un'esecuzione successiva restituisce colonne nuove, vengono aggiunte in fondo; se ne mancano alcune rispetto a prima, restano vuote per quella riga invece di sparire. Le colonne già scritte non cambiano mai posizione, per non disallineare i dati già accumulati con Append Rows.