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

Macroistruzioni

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

Cos'è una macro?



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

Come utilizzare le macro nei link CTA



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

Individua la macro: Scegli la macro appropriata dalla lista fornita di seguito.

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

Salva e anteprima: Salva le modifiche e visualizza in anteprima il link CTA per assicurarti che la macro sia sostituita correttamente con il valore previsto.

Dove possono essere usate le macro?



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

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

Lista delle macro disponibili



Ecco una lista delle macro utilizzabili, con descrizioni di ciò che fanno:

%SESSION_UID%: Inserisce l'UID della 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 queste macro, puoi garantire che i tuoi link CTA siano sempre aggiornati e personalizzati, aumentando l'engagement dell'utente e l'esperienza complessiva.

Esempi di Macro in Azione



Per una comprensione migliore, ecco alcuni esempi:

Prima: https://example.com/profile

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

Questo ti permette di identificare la sessione unica di ciascun visitatore attraverso il link CTA.

Prima: https://example.com/newsletter

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

Questo ti permette di attribuire quali visitatori sono arrivati al link CTA da quale partita.

Questi esempi mostrano come le macro possano rendere i tuoi CTA più pertinenti e aiutarti a recuperare dati dalla tua applicazione, dal link mirato.

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

Questo ti consente di recuperare dinamicamente e visualizzare dati utente completi basati sui valori delle macro, abilitando 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.
%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 YYYY-MM-DD.
%COMPANY_NAME%Restituisce il nome dell'azienda dell'utente.
%WEBSITE%Restituisce il sito web dell'utente.
%PROFIL_UID%Restituisce l'identificatore unico del profilo utente.
%PROFIL_TITLE%Restituisce il titolo del profilo utente.
%PRIZE_UID%Restituisce l'identificatore unico per il 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 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 lingua locale dell'utente.


Nota:
Tutti i dati dei macro restituiti 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 & saranno codificati come %26.

Aggiornato il: 22/02/2025

È stato utile questo articolo?

Condividi il tuo feedback

Annulla

Grazie!