Macroistruzioni
La nostra piattaforma supporta le macro nei link di invito all'azione (CTA), consentendoti di aggiungere valori dinamici che vengono inseriti automaticamente per semplificare il tuo lavoro e offrire un'esperienza utente più personalizzata.
Che cos'è una macro?
Una macro è un segnaposto o un codice predefinito che viene sostituito automaticamente con un valore specifico o un insieme di valori. Nei link CTA, le macro inseriscono informazioni in modo dinamico, rendendo i link più personalizzati e funzionali senza bisogno di aggiornamenti manuali.
Come usare le macro nei link CTA
Usare le macro nei link CTA è semplice. Ecco come fare:
- Scegli la macro: Seleziona la macro più adatta dall'elenco qui sotto.
- Inserisci la macro: Aggiungi il codice della macro nel punto del link CTA in cui vuoi che compaia il valore dinamico.
- Salva e controlla l'anteprima: Salva le modifiche e visualizza l'anteprima del link CTA per verificare che la macro venga sostituita correttamente con il valore desiderato.
Dove si possono usare le macro?
Le macro possono essere usate come parametri di query in qualsiasi URL dei tuoi link CTA.
Con le macro puoi creare link CTA più utili, che si aggiornano automaticamente con le informazioni pertinenti.
Elenco delle macro disponibili
Ecco le macro che puoi usare, con una descrizione delle rispettive funzioni:
- %SESSION_UID%: Inserisce l'UID della sessione del giocatore.
Esempio: https://example.com/profile?session=%SESSION_UID%
- %APP_ID%: Inserisce l'ID della partita in corso.
Esempio: “https://example.com/events?game_id=%APP_ID%
Con queste macro puoi mantenere i tuoi link CTA sempre aggiornati e personalizzati, migliorando il coinvolgimento degli utenti e l'esperienza complessiva.
Esempi di macro in azione
Per capire meglio come funzionano, ecco alcuni esempi:
- Prima: “https://example.com/profile”
- Prima: “https://example.com/newsletter”
Questi esempi mostrano come le macro possano rendere le tue CTA più pertinenti e aiutarti a recuperare i dati della tua applicazione tramite il link di destinazione.
I valori delle macro, come %SESSION_UID% e %APP_ID%, possono essere recuperati dal link di destinazione e poi utilizzati per chiamare la nostra API e verificare le informazioni dell'utente.
In questo modo puoi recuperare e visualizzare dinamicamente informazioni dettagliate sull'utente in base ai valori delle macro, offrendo un'esperienza utente personalizzata ed efficiente.
Macro disponibili
Macro | Funzione |
|---|---|
%SESSION_UID% | Restituisce l'ID della sessione corrente dell'utente. |
%APP_ID% | Restituisce l'APP ID della partita in corso. |
%ID_UNIC% | Restituisce l'identificatore univoco dell'utente. |
%GENDER% | Restituisce il genere dell'utente. |
%USERNAME% | Restituisce il nome 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 |
%COMPANY_NAME% | Restituisce il nome dell'azienda dell'utente. |
%WEBSITE% | Restituisce il sito web dell'utente. |
%PROFIL_UID% | Restituisce l'identificatore univoco del profilo dell'utente. |
%PROFIL_TITLE% | Restituisce il titolo del profilo dell'utente. |
%PRIZE_UID% | Restituisce l'identificatore univoco 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% | Restituisce un valore che indica se l'utente ha acconsentito a ricevere le newsletter. |
%CUSTOM_TEXT% | Restituisce l'eventuale testo personalizzato associato all'utente. |
%CUSTOM_FORMAT% | Restituisce l'eventuale 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 località dell'utente. |
%REF% | Restituisce la fonte di provenienza della partecipazione: il parametro |
rawurlencode per garantirne la compatibilità con gli URL. I caratteri speciali vengono quindi codificati per poter essere usati in sicurezza nei link, preservandone il funzionamento ed evitando potenziali problemi con i caratteri riservati o non sicuri. Ad esempio, uno spazio viene convertito in %20 e un carattere speciale come & viene codificato come %26.Aggiornato il: 29/10/2026
Grazie!