Articoli su: Sviluppatori e API
Questo articolo è disponibile anche in:

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.


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


  1. 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%


  1. %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:



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


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



  • 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.

Aggiornato il: 01/03/2025

È stato utile questo articolo?

Condividi il tuo feedback

Annulla

Grazie!