> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.drimify.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Struttura API & dati

Esistono 3 modi per connettersi alla nostra API:

* Utilizzando Zapier - https://help.drimify.com/it/article/integrazione-con-zapier-rvxt54/
* Utilizzando Make - https://help.drimify.com/it/article/integrazione-con-makecom-1eh5fzp/
* Chiamate API dirette - documentazione ed esempi disponibili qui: https://endpoint.drimify.com/api/docs?ui=re_doc# Struttura Dati API

Ecco come potresti compilare la colonna **Data Example** basandoti sui formati comuni per questi tipi di campi:

| Key | Descrizione | Data Example |
| ---- |
| **Id** | ID univoco. | `123456` |
| **appId** | ID delle Applicazioni. | `123456` |
| **appRef** | Riferimento interno delle Applicazioni. | `my campaign` |
| **idunic** | I dati raccolti per il campo id univoco. | `ABC123XYZ` |
| **gender** | I dati raccolti per il campo genere. | `Male` / `Female` / `Prefer not a say` |
| **username** | I dati raccolti per il campo nome utente. | `johndoe` |
| **firstName** | I dati raccolti per il campo nome. | `John` |
| **lastName** | I dati raccolti per il campo cognome. | `Doe` |
| **email** | I dati raccolti per il campo e-mail. | `johndoe@example.com` |
| **dob** | I dati raccolti per il campo data di nascita. | `1990-01-01T00:00:00+01:00` |
| **address** | I dati raccolti per il campo indirizzo. | `123 Main St, Apt 4B` |
| **cp** | I dati raccolti per il campo codice postale. | `12345` |
| **town** | I dati raccolti per il campo città. | `New York` |
| **country** | I dati raccolti per il campo paese. | `United States` |
| **phoneNumber** | I dati raccolti per il campo numero di telefono. | `+12025550199` |
| **companyName** | I dati raccolti per il campo nome azienda. | `Example Corp.` |
| **website** | I dati raccolti per il campo sito web. | `https://www.example.com` |
| **optinNewsletter** | I dati raccolti per il campo di adesione alla newsletter. | `true` / `false` |
| **customText** | I dati raccolti per il campo di testo personalizzato. | `Custom entry value` |
| **customFormat** | I dati raccolti per il campo formato personalizzato. | `Custom entry value` |
| **profil** | Risultato profilo se test di personalità/quiz/sondaggio. | `Explorer` |
| **profilUid** | ID univoco profilo se test di personalità/quiz/sondaggio. | `EXPL123` |
| **score** | Punteggio utente se app basata su punteggio. | `85` |
| **prizeUid** | Uid premio, se nessun premio vinto questo restituisce "lost". | `0f8e4a298ba5c036c7db5e5ef1ce422e85ceb5e3` / `lost` |
| **prizeTitle** | Titolo del Premio registrato quando l'utente ha vinto un premio. | `Gold Membership` |
| **prizeRef** | Riferimento Premio registrato quando l'utente ha vinto un premio. | `GOLD2023` |
| **code** | Codice vinto dall'utente. | `WIN12345` |
| **date** | Timestamp del server. | `2024-11-10T19:09:32+01:00` |
| **publisherId** | L'ID del publisher. | `PUB123` |
| **sessionId** | ID della sessione utente. | `Session_296c9d74f159eacf374a2ac4e9d6f028` |
| **countryCode** | Codice paese basato sull'IP dell'utente. | `FR` |
| **selectValue** | I dati raccolti per il menu a discesa personalizzato. | `Option A` |
| **selectValue2** | I dati raccolti per il secondo menu a discesa personalizzato. | `Option B` |
| **customCheckbox** | I dati raccolti per la lista di caselle di controllo personalizzate. Se vengono selezionate più opzioni, i valori saranno separati da una barra verticale. (`∣`) | `Option 1 ∣ Option 2` |
| **timeTaken** | Tempo trascorso dall'utente sull'app in secondi. | `360` |
| **levelsPlayed** | Il numero totale di livelli completati dall'utente in Combo™, Percorso Dinamico™, o Calendario Dell'Avvento esperienze. Restituisce null per qualsiasi altro tipo di partita. | `123456` |
| **referral** | Fonte di traffico segnalata. | `direct` |
| **updatedAt** | La data in cui il dato è stato aggiornato. | `2024-11-10T19:09:32+01:00` |
| **connectionCountry** | Paese basato sull'IP dell'utente. | `France` |
| **updatedAtTimeStamp** | Un timestamp in cui il dato è stato aggiornato. | `1731262172` |
| **dateWithTimezone** | Timestamp convertito nel fuso orario dell'app. | `2024-11-10T17:09:32+01:00` |
| **played** | Una bandiera che restituisce `true` se l'utente ha giocato la meccanica di partita, altrimenti `false`. | `true` / `false` |
| **locale** | Lo scambio di lingua dell'applicazione utilizzato durante l'esperienza utente. | `en` |
| **ipAddress** | Indirizzo IP dell'utente. | `192.168.1.1` |