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

Macroistruzioni

La nostra piattaforma supporta macro per i link call-to-action (CTA), permettendovi di aggiungere valori dinamici che si riempiono automaticamente, ottimizzando il vostro flusso di lavoro e creando un'esperienza utente più personalizzata.

Che 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 vostri link CTA, una macro inserirà dinamicamente informazioni, rendendo i vostri link più personalizzati e funzionali senza necessitare di aggiornamenti manuali.

Come usare le macro nei link CTA



Usare le macro nei vostri link CTA è semplice. Ecco come farlo:

Identifica la macro: Scegli la macro appropriata dalla lista fornita qui sotto.

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

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

Dove possono essere usate le macro?



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

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

Lista delle macro disponibili



Ecco una lista delle macro che puoi utilizzare, insieme a una descrizione 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 corrente.

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 degli utenti e l'esperienza complessiva.

Esempi di macro in azione



Per offrirti una migliore comprensione, 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 ogni 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 le macro possano rendere i tuoi CTA più pertinenti e aiutarti a recuperare dati dalla tua applicazione, a partire dal link target.

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

Questo ti consente di recuperare e visualizzare automaticamente dati utente completi basati sui valori delle macro, permettendo 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 in corso.
%ID_UNIC%Restituisce l'identificatore unico dell'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 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 optato per 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 vengono codificati per un utilizzo 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: 16/11/2024

È stato utile questo articolo?

Condividi il tuo feedback

Annulla

Grazie!