> ## 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).

# Passaggio delle Informazioni Utente tramite Parametri URL

Le esperienze di Drimify supportano ora il pre-riempimento delle informazioni degli utenti direttamente tramite l'URL utilizzando parametri di query string. Questo permette un'esperienza più personalizzata e ottimizza la raccolta dei dati.

### ✅ Parametri URL Supportati

Puoi inserire le seguenti variabili opzionali nell'URL:

| Parametro | Descrizione | Valore Esempio |
| --- |
| `fname` | nome | John o codificato in base64 (`Sm9obg==`) |
| `lname` | cognome | cognome o codificato in base64 (`RG9l`) |
| `email` | indirizzo email | Testo normale o codificato in base64 (`am9obi5kb2VAZXhhbXBsZS5jb20=`) |
| `phone` | Numero Di Telefono | Testo normale o codificato in base64 (`KzMzMTAxMDEwMTAx`) |

### 🔗 Esempi di URL

**Valori codificati in Base64:**
```
https://apps.drimify.com/your-experience-id/?session_uid=ABC123&fname=Sm9obg==&lname=RG9l&email=am9obi5kb2VAZXhhbXBsZS5jb20=&phone=KzMzMTAxMDEwMTAx
```

**Valori in testo normale:**
```
https://apps.drimify.com/your-experience-id/?session_uid=ABC123&fname=John&lname=Doe&email=john.doe@example.com&phone=%2033101010101
```

### 🔒 Logica di Codifica & Decodifica

* Puoi inviare i valori sia come **testo normale** che come **stringhe codificate in Base64**.
* Drimify rileverà automaticamente i valori codificati in Base64 e li decodificherà.
* Sia per valori codificati in Base64 che per testo normale, **tutti i valori verranno anche decodificati dall'URL** sul nostro lato per garantire che caratteri speciali come spazi (`%20`), `@` o `=` siano interpretati correttamente.

### ⚠️ Importante per gli Integratori

Assicurati che:

* Se invii **testo normale**, deve essere **codificato in URL** prima di essere aggiunto all'URL.
* Se invii **Base64**, devi:

1. Prima codificare in URL il valore originale (es., John Doe → John%20Doe)
2. Poi codificare in Base64 quel risultato (John%20Doe → Sm9obiUyMERvZQ==)
3. Passarlo nella query string
4. Quando passi valori tramite parametri URL, le stringhe codificate in base64 **devono includere l'adeguato padding (`=`)**. Senza il corretto padding, il sistema potrebbe non decodificare correttamente il valore e verrà trattato come testo normale.

**Perché?**

Questo assicura che i caratteri speciali siano preservati correttamente e decodificati a dovere in tutti i casi.

### ✉️ Validazione Email

Per la sicurezza e l'integrità dei dati:

* Il parametro `email` verrà utilizzato solo se supera la validazione del formato standard di email.
* Se il valore non corrisponde a un formato valido, verrà ignorato e non memorizzato.

### 📞 Validazione Numero di Telefono

Per la sicurezza e l'integrità dei dati:

* Il numero di telefono deve essere fornito nel formato internazionale corretto, ad esempio: **+33101010101**.
* Il valore verrà utilizzato solo se corrisponde a un formato valido in base al codice del paese.
* Se il numero non soddisfa la struttura richiesta, verrà ignorato e non memorizzato.

### 💡 Casi d'Uso

* Così come supportiamo `session_uid` per identificare una sessione utente, ora supportiamo `fname`, `lname`, ed `email` per **pre-riempire i dati dell'utente ed evitare la visualizzazione di un modulo di raccolta dati**.
* Questo è ideale quando si lanciano esperienze da campagne email o strumenti CRM, dove le informazioni del partecipante sono già note.
* Rintraccia sessioni individuali utente con meno attrito.
* Offri un'esperienza utente fluida e personalizzata.

### ❓Hai Bisogno di Aiuto?

Se non sei sicuro su come codificare correttamente i valori o vuoi consigli su come integrarti con la tua piattaforma, non esitare a [contattare il nostro team di supporto] o a consultare la nostra [guida all'integrazione per sviluppatori].