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:

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

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

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:

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

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

%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

MacroFunzione
%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!