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 reportresponses, 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 completateLa 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 pianiLe 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 minutiIl 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.