Struttura API & dati
Ci sono 3 modi per collegarsi alla nostra API:
- Tramite Zapier - https://help.drimify.com/it/article/integrazione-con-zapier-rvxt54/
- Tramite Make - https://help.drimify.com/it/article/integrazione-con-makecom-1eh5fzp/
- Tramite chiamate API dirette - documentazione ed esempi disponibili qui: https://endpoint.drimify.com/api/docs?ui=re_doc
Cosa restituisce l’API
L’API restituisce un record per ogni partecipazione: i campi del modulo, il risultato (punteggio, profilo o premio) e i campi tecnici, come indicato nella tabella qui sotto. Non restituisce le singole risposte fornite dal giocatore alle domande di un quiz o di un sondaggio. Per visualizzare tutte le risposte, usa l’esportazione dei dati della tua app, in cui ogni domanda ha una colonna dedicata.
Struttura dei dati dell’API
Ecco come potresti compilare la colonna Esempio di dati, in base ai formati più comuni per questi tipi di campi:
Chiave | Descrizione | Esempio di dati |
|---|---|---|
Id | ID univoco. |
|
appId | ID dell’app. |
|
appRef | Riferimento interno dell’app. |
|
idunic | Dati raccolti nel campo ID univoco. |
|
gender | Dati raccolti nel campo genere. |
|
username | Dati raccolti nel campo nome utente. |
|
firstName | Dati raccolti nel campo nome. |
|
lastName | Dati raccolti nel campo cognome. |
|
Dati raccolti nel campo e-mail. | ||
dob | Dati raccolti nel campo data di nascita. |
|
address | Dati raccolti nel campo indirizzo. |
|
cp | Dati raccolti nel campo codice postale. |
|
town | Dati raccolti nel campo città. |
|
country | Dati raccolti nel campo paese. |
|
phoneNumber | Dati raccolti nel campo numero di telefono. | |
companyName | Dati raccolti nel campo nome azienda. |
|
website | Dati raccolti nel campo sito web. | |
optinNewsletter | Dati raccolti tramite la casella di consenso all’iscrizione alla newsletter. |
|
customText | Dati raccolti nel campo di testo personalizzato. |
|
customFormat | Dati raccolti nel campo con formato personalizzato. |
|
profil | Profilo risultante, se l’app è un test della personalità, un quiz o un sondaggio. |
|
profilUid | ID univoco del profilo, se l’app è un test della personalità, un quiz o un sondaggio. |
|
score | Punteggio dell’utente, se l’app prevede un punteggio. |
|
prizeUid | ID del premio. Se non è stato vinto alcun premio, restituisce |
|
prizeTitle | Titolo del premio registrato quando l’utente vince un premio. |
|
prizeRef | Riferimento del premio registrato quando l’utente vince un premio. |
|
code | Codice vinto dall’utente. |
|
date | Timestamp del server. |
|
publisherId | ID dell’editore. |
|
sessionId | ID della sessione dell’utente. |
|
countryCode | Codice del paese ricavato dall’indirizzo IP dell’utente. |
|
selectValue | Dati raccolti tramite il menu a discesa personalizzato. |
|
selectValue2 | Dati raccolti tramite il secondo menu a discesa personalizzato. |
|
customCheckbox | Dati raccolti tramite l’elenco personalizzato di caselle di controllo. Se vengono selezionate più opzioni, i valori sono separati da una barra verticale. ( |
|
timeTaken | Tempo trascorso dall’utente sull’app, in secondi. |
|
levelsPlayed | Numero totale di livelli completati dall’utente nelle esperienze Combo™, Percorso Dinamico™ o Calendario Dell'Avvento. Restituisce null per tutti gli altri tipi di gioco. |
|
referral | Sorgente del traffico di provenienza. |
|
updatedAt | Data dell’ultimo aggiornamento dei dati. |
|
connectionCountry | Paese ricavato dall’indirizzo IP dell’utente. |
|
updatedAtTimeStamp | Timestamp dell’ultimo aggiornamento dei dati. |
|
dateWithTimezone | Timestamp convertito nel fuso orario dell’app. |
|
played | Indicatore che restituisce |
|
locale | Lingua dell’app utilizzata durante l’esperienza dell’utente. |
|
ipAddress | Indirizzo IP dell’utente. |
|
Aggiornato il: 19/10/2026
Grazie!