Loading...

Typeform

Risposte ai tuoi form Typeform (una colonna per domanda), risposte al giorno, visite e tasso di completamento.

Il connettore Typeform porta nel foglio i dati dei tuoi form: le singole risposte con una colonna per ogni domanda, oppure conteggi aggregati (risposte al giorno, per piattaforma, per risposta a una domanda), piu' gli insight del form (visite, tasso di completamento, abbandoni per domanda).

Il collegamento non usa un login Google: va inserito un Personal Access Token di Typeform, che crei da Account > Personal tokens > Generate a new token selezionando gli scope accounts:read, forms:read e responses:read. Il token viene verificato subito e funziona sia con gli account sul data center globale sia con quelli sul data center UE (il connettore riconosce da solo quale usare).

Nel report scegli il form come "proprieta'": le domande e gli hidden field di quel form compaiono automaticamente tra le dimensioni (voci "Q: ..." e "Hidden: ...").

Le metriche e dimensioni sono divise in tre categorie, una sola per report: responses (le risposte, con filtro per periodo), insights (visite e completamento per piattaforma, dato complessivo del form) e insights_questions (visualizzazioni e abbandoni per domanda, dato complessivo del form).

Metriche disponibili

Metrica Periodo Aggregazione Note
Risposte period sum Categoria responses. Numero di risposte completate nel periodo.
Tempo di Compilazione (secondi, totale) period sum Categoria responses. Somma dei secondi tra apertura e invio.
Tempo di Compilazione (secondi, medio) period avg Categoria responses. Ricalcolato per riga e nei totali come tempo totale / risposte.
Punteggio (totale) period sum Categoria responses. Somma del punteggio calcolato da Typeform (quiz/logica), 0 se il form non lo usa.
Punteggio (medio) period avg Categoria responses. Punteggio totale / risposte.
Visite Totali all-time sum Categoria insights. Dato complessivo del form, il periodo del report viene ignorato.
Visite Uniche all-time sum Categoria insights. Dato complessivo del form.
Risposte (Insights) all-time sum Categoria insights. Dato complessivo del form, puo' differire dal conteggio della categoria responses perche' quest'ultima filtra per periodo.
Tasso di Completamento (%) all-time avg Categoria insights. Come calcolato da Typeform, in percentuale. Nei totali viene usato il valore complessivo del form fornito da Typeform.
Tempo Medio (secondi) all-time avg Categoria insights. Tempo medio di compilazione, convertito da millisecondi a secondi.
Visualizzazioni all-time sum Categoria insights_questions. Quante volte la domanda e' stata vista, dato complessivo.
Abbandoni all-time sum Categoria insights_questions. Quanti rispondenti hanno abbandonato il form su quella domanda, dato complessivo.
Tasso di Abbandono (%) all-time avg Categoria insights_questions. Abbandoni / visualizzazioni x 100, ricalcolato anche nei totali.

Dimensioni disponibili

Dimensione Note
Data (Invio) Categoria responses. Data di invio della risposta, nel fuso orario del foglio. Da sola produce il conteggio delle risposte al giorno.
Inviata il Categoria responses. Data e ora complete di invio.
Aperta il Categoria responses. Data e ora in cui il rispondente ha aperto il form.
ID Risposta Categoria responses. Aggiungila per ottenere una riga per ogni singola risposta.
Token Risposta Categoria responses. Identificativo tecnico della risposta usato da Typeform.
ID Form Tutte le categorie.
Titolo Form Tutte le categorie.
Piattaforma Categorie responses e insights: desktop, phone, tablet o other.
Browser Categoria responses.
Referer Categoria responses. URL della pagina da cui e' stato aperto il form.
User Agent Categoria responses.
ID Rete Categoria responses. Identificativo anonimo della rete del rispondente assegnato da Typeform.
Q: <domanda> (una per domanda del form) Categoria responses. Una dimensione per ogni domanda del form scelto, con il testo della domanda come nome. Scelte multiple separate da virgola, ranking nell'ordine indicato dal rispondente ("A > B > C"), si/no come true/false. Le domande dentro gruppi o matrici compaiono come "Gruppo / Domanda".
Hidden: <nome> (uno per hidden field) Categoria responses. Il valore dell'hidden field passato nell'URL del form (es. utm_source).
ID Domanda Categoria insights_questions.
Ref Domanda Categoria insights_questions. Il riferimento leggibile assegnato alla domanda in Typeform.
Testo Domanda Categoria insights_questions.
Tipo Domanda Categoria insights_questions (es. multiple_choice, short_text, rating).

Limiti noti

  • Una categoria per report
    responses, insights e insights_questions leggono endpoint diversi con granularita' diverse: un singolo report non puo' mescolare metriche o dimensioni di categorie diverse, il salvataggio lo blocca. Per confrontarle servono report separati.
  • Solo risposte completate
    La categoria responses include solo le risposte inviate fino in fondo (response_type=completed): le risposte parziali non compaiono. Il numero di chi ha iniziato senza finire si ricava dagli insights (visite vs risposte, abbandoni per domanda).
  • Insights senza periodo e non su tutti i piani
    Le categorie insights e insights_questions sono sempre il dato complessivo del form (l'API Typeform non accetta un intervallo di date) e l'API Insights non e' disponibile su tutti i piani Typeform: in quel caso il report restituisce un errore esplicito di Typeform (403).
  • Massimo 50.000 risposte per report e ritardo di pochi minuti
    Il connettore scarica al massimo 50.000 risposte per singolo report (50 pagine da 1.000): per form piu' grandi restringi il periodo. Typeform stesso avverte che le risposte degli ultimi 30 minuti circa possono non essere ancora disponibili via API.

Tempi di esecuzione

Nella categoria responses il periodo del report filtra le risposte per data di invio (submitted_at, in UTC); sono incluse solo le risposte completate, non quelle parziali. Le righe vengono aggregate in base alle dimensioni scelte: con la sola dimensione "Date (Submitted)" ottieni le risposte al giorno, aggiungendo "Response ID" ottieni una riga per risposta. Le medie (tempo di compilazione, punteggio) e nei totali sono sempre ricalcolate come rapporto tra le somme, non come media delle medie.

Le categorie insights e insights_questions ignorano il periodo del report: l'API Insights di Typeform restituisce solo il dato complessivo del form dalla sua creazione. Il "Tasso di completamento" e' in percentuale (0-100), il "Tempo medio" e' convertito in secondi (l'API lo fornisce in millisecondi).

Date e orari sono mostrati nel fuso orario del foglio (impostazioni dello script), mentre Typeform li mostra nel fuso dell'account: vicino a mezzanotte una stessa risposta puo' risultare in due giorni diversi nei due strumenti.

Typeform limita l'API a 2 richieste al secondo per account: su form con decine di migliaia di risposte l'esecuzione puo' richiedere qualche decina di secondi.