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

# Macroistruzioni

La nostra piattaforma supporta i macro per i link call-to-action (CTA), consentendoti di aggiungere valori dinamici che si popolano automaticamente per ottimizzare il tuo flusso di lavoro e creare un'esperienza utente più personalizzata.

# Cos'è un macro?

Un macro è un segnaposto o codice predefinito che si espande automaticamente in un valore specifico o un insieme di valori. Nel contesto dei tuoi link CTA, un macro inserirà dinamicamente le informazioni, rendendo i tuoi link più personalizzati e funzionali senza richiedere aggiornamenti manuali.

# Come utilizzare i macro nei link CTA

Utilizzare i macro nei tuoi link CTA è semplice. Ecco come puoi farlo:

1. **Identifica il macro:** Scegli il macro appropriato dalla lista fornita qui sotto.

2. **Inserisci il macro:** Aggiungi il codice del macro nel tuo link CTA dove desideri che appaia il valore dinamico.

3. **Salva e anteprima:** Salva le modifiche e visualizza in anteprima il link CTA per assicurarti che il macro sia correttamente sostituito con il valore voluto.

# Dove possono essere usati i macro?

I macro possono essere utilizzati in qualsiasi URL all'interno dei tuoi link CTA come parametri di query.

Utilizzando i macro, puoi creare link CTA più utili che si aggiornano automaticamente con informazioni rilevanti.

# Lista dei macro disponibili

Ecco una lista dei macro che puoi utilizzare, con descrizioni delle loro funzioni:

1. **%SESSION_UID%:** Inserisce l'UID di sessione del giocatore.

**Esempio:** https://example.com/profile?session=%SESSION_UID%

2. **%APP_ID%:** Inserisce l'ID della partita attuale.

**Esempio:** https://example.com/events?game_id=%APP_ID%

Includendo questi macro, puoi garantire che i tuoi link CTA siano sempre aggiornati e personalizzati, migliorando il coinvolgimento degli utenti e l'esperienza complessiva.

# Esempi di Macro in Azione

Per offrirti una comprensione migliore, ecco alcuni esempi:

* **Prima:** https://example.com/profile

* **Dopo:** https://example.com/profile?session=%SESSION_UID%

|| Ciò ti consente di identificare la sessione unica di ciascun visitatore tramite il link CTA.

* **Prima:** https://example.com/newsletter

* **Dopo:** https://example.com/newsletter?game_id=%APP_ID%

|| Questo ti consente di attribuire quale visitatore è arrivato al link CTA da quale partita.

Questi esempi mostrano come i macro possano rendere i tuoi CTA più pertinenti e aiutarti a recuperare dati dall'applicazione, tramite il link mirato.

I valori dei macro, come %SESSION_UID% e %APP_ID%, possono essere recuperati dal link mirato e poi utilizzati per chiamare la nostra API per verificare le informazioni di quell'utente.

Questo ti consente di recuperare e mostrare dinamicamente dati completi dell'utente basati sui valori del macro, offrendo un'esperienza utente personalizzata ed efficiente.# Macro Disponibili

| Macro | Funzione |
| ---- |
| %SESSION_UID% | Restituisce l'ID della sessione attuale dell'utente. |
| %APP_ID% | Restituisce l'ID dell'APP della partita attuale in corso. |
| %ID_UNIC% | Restituisce l'identificatore unico per l'utente. |
| %GENDER% | Restituisce il genere dell'utente. |
| %USERNAME% | Restituisce il nome utente dell'utente. |
| %FIRSTNAME% | Restituisce il nome dell'utente. |
| %LASTNAME% | Restituisce il cognome dell'utente. |
| %EMAIL% | Restituisce l'indirizzo email dell'utente. |
| %PHONE_NUMBER% | Restituisce il numero di telefono dell'utente. |
| %ADDRESS% | Restituisce l'indirizzo dell'utente. |
| %ZIP_CODE% | Restituisce il codice postale dell'utente. |
| %TOWN% | Restituisce la città dell'utente. |
| %COUNTRY% | Restituisce il paese dell'utente. |
| %DOB% | Restituisce la data di nascita dell'utente nel formato `AAAA-MM-GG`. |
| %COMPANY_NAME% | Restituisce il nome azienda dell'utente. |
| %WEBSITE% | Restituisce il sito web dell'utente. |
| %PROFIL_UID% | Restituisce l'identificatore unico del profilo dell'utente. |
| %PROFIL_TITLE% | Restituisce il titolo del profilo dell'utente. |
| %PRIZE_UID% | Restituisce l'identificatore unico del premio. |
| %PRIZE_TITLE% | Restituisce il titolo del premio. |
| %PRIZE_REF% | Restituisce il riferimento del premio. |
| %PRIZE_CODE% | Restituisce il codice associato al premio. |
| %OPTIN_NEWSLETTER% | Indica se l'utente ha scelto di ricevere la newsletter. |
| %CUSTOM_TEXT% | Restituisce qualsiasi testo personalizzato associato all'utente. |
| %CUSTOM_FORMAT% | Restituisce qualsiasi formato personalizzato associato all'utente. |
| %SCORE% | Restituisce il punteggio dell'utente. |
| %SELECT_VALUE% | Restituisce il primo valore selezionato. |
| %SELECT_VALUE2% | Restituisce il secondo valore selezionato. |
| %CUSTOM_CHECKBOX% | Restituisce il valore della casella di controllo personalizzata. |
| %TIME_TAKEN% | Restituisce il tempo impiegato dall'utente in secondi. |
| %LOCALE% | Restituisce la localizzazione dell'utente. |

|| Nota:
|| Tutti i dati restituiti dai macro sono processati usando `rawurlencode` per garantire la compatibilità negli URL. Questo significa che i caratteri speciali sono codificati per un uso sicuro nei link, preservando la funzionalità ed evitando potenziali problemi con caratteri riservati o non sicuri. Ad esempio, uno spazio apparirà come `%20`, e caratteri speciali come & verranno codificati come `%26`.