Attributi del profilo

Gli attributi del profilo in Adobe Target sono parametri specifici di un visitatore. Tali attributi vengono memorizzati nel profilo del visitatore in modo da fornire informazioni che puoi usare nelle attività.

Un profilo utente contiene informazioni demografiche e comportamentali relative a un visitatore di una pagina web. Queste informazioni possono includere età, genere, prodotti acquistati, ultima visita e così via, utilizzati da Target per personalizzare il contenuto utilizzato per il visitatore.

Quando un visitatore naviga nel tuo sito web o ritorna per un’altra sessione, gli attributi di profilo salvati nel profilo possono essere utilizzati per indirizzare il contenuto o registrare le informazioni per il filtraggio dei segmenti.

Per impostare gli attributi del profilo:

  1. Fai clic su Tipi di pubblico > Script di profilo.

    Scheda Script di profilo

  2. Fare clic su Crea script.

    Finestra di dialogo Crea script di profilo

    Sono disponibili i seguenti tipi di attributi di profilo:

    Tipo di parametro Descrizione
    mbox Passaggio diretto attraverso il codice della pagina quando viene creata la mbox. Consulta Trasmettere parametri a una mbox globale.
    Nota: ha un limite di 50 attributi univoci di profilo per chiamata mbox. Target Se devi passare più di 50 attributi di profilo a Target, trasmettili utilizzando il metodo API Aggiornamento profilo . Per ulteriori informazioni, consulta Aggiornamento profilo nella documentazione Adobe Target API.
    Profilo Definito direttamente con uno snippet di codice JavaScript. Questi snippet possono memorizzare i totali correnti come il denaro totale speso dal consumatore e vengono eseguiti su ogni richiesta mbox. Consulta Attributi degli script di profilo di seguito.

Attributi degli script di profilo

Definizione di un attributo di script del profilo con il relativo frammento di codice JavaScript associato.

Puoi utilizzare gli script di profilo per acquisire gli attributi di un visitatore attraverso più visite. Gli script di profilo sono snippet di codice definiti in Target utilizzando una forma di JavaScript lato server. Ad esempio, puoi utilizzare uno script di profilo per acquisire la frequenza con cui un visitatore visita il tuo sito e l’ultima volta che lo ha visitato.

Gli script di profilo sono diversi dai parametri di profilo. I parametri di profilo acquisiscono informazioni sui visitatori utilizzando l’implementazione del codice mbox di Target.

Creare gli script di profilo

Gli script di profilo sono disponibili nella scheda Tipi di pubblico dell’interfaccia di Target.

Per aggiungere uno script di profilo, fai clic sulla scheda Script di profilo, Crea script, quindi scrivi lo script.

Oppure

Per copiare uno script di profilo esistente, dall'elenco Script di profilo fai clic sull'icona dei puntini di sospensione per lo script desiderato, quindi fai clic su Duplica.

Ora puoi modificare il pubblico per crearne uno simile.

Gli script di profilo eseguono dei “catcher” per acquisire attributi di profilo per ogni richiesta di posizione. Quando viene ricevuta una richiesta di posizione, Target determina quale attività deve essere eseguita e visualizza il contenuto appropriato per quell’attività e per quell’esperienza. Target tiene traccia anche del successo dell’attività ed esegue eventuali script di profilo rilevanti. Questa procedura consente di tenere traccia delle informazioni sulla visita, ad esempio la posizione del visitatore, l’ora del giorno, il numero di volte in cui il visitatore è stato sul sito, se ha effettuato acquisti in precedenza e così via. Queste informazioni vengono poi aggiunte al profilo del visitatore, in modo da poter monitorare meglio la sua attività sul sito.

Gli attributi degli script di profilo hanno il tag user. inserito prima del nome dell’attributo. Ad esempio:

if (mbox.name == 'Track_Interest') { 
    if (profile.get('model') == "A5" &&; profile.get('subcat') == "KS6") { 
        return (user.get('A5KS6') || 0) + 1; 
    } 
}

Considera le seguenti informazioni:

  • Fai riferimento agli attributi dello script di profilo (incluso se stesso) nel codice con user.get('parameterName').
  • Salva le variabili accessibili alla successiva esecuzione dello script (alla successiva richiesta mbox) con user.setLocal('variable_name', 'value'). Fai riferimento alla variabile con user.getLocal('variable_name'). Questo processo è utile nelle situazioni in cui desideri fare riferimento alla data e all’ora dell’ultima richiesta.
  • I parametri e i valori sono sensibili all’uso di maiuscole e minuscole. Usa le stesse maiuscole e minuscole dei parametri e dei valori ricevuti durante l’attività o il test.
  • Per ulteriore sintassi JavaScript, vedi la sezione “Riferimento JavaScript per i parametri del profilo di script”, più avanti.
  • Il parametro rimane nel profilo dopo la disattivazione dello script. Gli utenti i cui profili contengono già un parametro utilizzato nel pubblico di un’attività si qualificano in tale attività.
  • Gli script di profilo non possono essere eliminati mentre vengono utilizzati in un’attività.
  • Non è consigliabile creare script di profilo dipendenti che utilizzano il risultato di uno script di profilo in un altro script di profilo. L’ordine di esecuzione dello script di profilo non è garantito.

Visualizzazione delle schede di informazioni sugli script di profilo

Puoi visualizzare schede a comparsa di script di profilo simili come schede informative. Queste schede informative sullo script di profilo ti permettono di visualizzare l’elenco delle attività che si riferiscono allo script di profilo selezionato, insieme ad altri metadati utili.

Ad esempio, per accedere alla scheda di informazioni sullo script di profilo seguente, fai clic sull'icona Info per lo script di profilo desiderato dall'elenco (Tipi di pubblico > Script di profilo).

La scheda Informazioni script contiene le informazioni seguenti: Nome, descrizione e codice script.

Scheda di informazioni Script di profilo

Fai clic su Visualizza tutti i dettagli per visualizzare i tipi di pubblico e le attività che fanno riferimento allo script di profilo selezionato.

Scheda di informazioni Script di profilo > Scheda Utilizzo script

NOTA

La scheda Utilizzo script non visualizza le attività che fanno riferimento allo script di profilo selezionato nelle situazioni seguenti:

  • L'attività si trova nello stato Bozza .
  • Il contenuto o l'offerta utilizzato/a nell'attività impiega variabili di script (o un'offerta in linea all'interno dell'attività o un'offerta nel catalogo Offerte).

Target disabilita gli script di profilo in determinate situazioni

Target disabilita automaticamente gli script di profilo in determinate situazioni, ad esempio se richiedono troppo tempo o hanno troppe istruzioni.

Quando uno script di profilo è disabilitato, viene contrassegnato da un’icona gialla di avviso nell’interfaccia utente di Target, come illustrato di seguito:

Al passaggio del mouse puoi visualizzare dettagli sugli errori, come illustrato di seguito:

Il sistema disabilita gli script di profilo in alcune circostanze. I motivi più frequenti sono:

  • Riferimento a una variabile non definita.
  • Riferimento a un valore non valido. Questo errore è spesso causato dal riferimento a valori URL e altri dati immessi dall’utente senza una corretta convalida.
  • Troppe istruzioni JavaScript. Target ha un limite di 2.000 istruzioni JavaScript per script, ma questo limite non può essere calcolato semplicemente leggendo manualmente il codice JavaScript. Ad esempio, Rhino tratta tutte le chiamate di funzione e le chiamate “nuove” come 100 istruzioni. Qualsiasi chiamata a qualsiasi funzione consuma 100 istruzioni. Inoltre, la dimensione dei dati immessi, ad esempio i valori URL, può influire sul conteggio delle istruzioni.
  • Mancato rispetto delle istruzioni evidenziate nella sezione Best practice qui sotto.

Best practice

Le seguenti linee guida hanno lo scopo di facilitare la scrittura di script di profilo semplificati, il più possibile privi di errori, mediante la scrittura di codice che genera un errore controllato in modo da consentire l’elaborazione degli script senza determinare un blocco di sistema. Queste linee guida sono il risultato di best practice collaudate in termini di efficienza. Applica queste linee guida unitamente ai principi e alle raccomandazioni stilati dalla community di sviluppo Rhino.

  • Impostare il valore dello script corrente su una variabile locale nello script utente, impostare un failover su una stringa vuota.

  • Convalida la variabile locale verificando che non si tratti di una stringa vuota.

  • Utilizza funzioni di manipolazione basate su stringhe rispetto a Espressioni regolari.

  • Utilizza cicli limitati “for” invece di cicli aperti “for” o “while”.

  • Non superare 1.300 caratteri o 50 iterazioni di ciclo.

  • Non superare 2.000 istruzioni JavaScript. Target ha un limite di 2.000 istruzioni JavaScript per script, ma questo limite non può essere calcolato semplicemente leggendo manualmente il codice JavaScript. Ad esempio, Rhino tratta tutte le chiamate di funzione e le chiamate “nuove” come 100 istruzioni. Inoltre, la dimensione dei dati immessi, ad esempio i valori URL, può influire sul conteggio delle istruzioni.

  • Presta attenzione non solo alle prestazioni dello script, ma anche alle prestazioni combinate di tutti gli script. Come best practice, Adobe consiglia meno di 5.000 istruzioni in totale. Il conteggio del numero di istruzioni non è ovvio, ma è importante notare che gli script che superano le 2.000 istruzioni vengono disattivati automaticamente. Il numero di script di profilo attivi non deve superare 300. Ogni script viene eseguito con ogni singola chiamata mbox. Esegui solo il numero di script necessario.

  • In un’espressione regex, con punto-asterisco all’inizio (ad esempio: /.*match/, /a|.*b/) non è quasi mai necessario. La ricerca regex inizia da tutte le posizioni in una stringa (a meno che non sia delimitata con ^), e punto-asterisco è quindi implicito. L’esecuzione dello script può essere interrotta se a un’espressione regex corrispondono dati di input sufficientemente lunghi (anche solo di qualche centinaia di caratteri).

  • In caso di esito negativo, inserisci lo script in un try/catch.

  • Le seguenti raccomandazioni possono aiutarti a limitare la complessità degli script di profilo. Gli script di profilo possono eseguire un numero limitato di istruzioni.

    Come best practice:

    • Mantenere gli script di profilo piccoli e semplici il più possibile.
    • Evita espressioni regolari o utilizza solo espressioni regolari semplici. Anche le espressioni semplici possono richiedere molte istruzioni da valutare.
    • Evita la ricorsione.
    • Gli script di profilo devono essere testati sulle prestazioni prima di essere aggiunti a Target. Tutti gli script di profilo vengono eseguiti su ogni richiesta mbox. Se gli script di profilo non vengono eseguiti correttamente, l’esecuzione delle richieste mbox richiede più tempo, il che può influire sul traffico e sulla conversione.
    • Se gli script di profilo diventano troppo complessi, è consigliabile utilizzare invece i token di risposta.
  • Per ulteriori informazioni, consulta la documentazione del motore JS Rhino .

Debug degli script di profilo

Per eseguire il debug degli script di profilo possono essere utilizzati i seguenti metodi:

NOTA

L’utilizzo di console.log all’interno di uno script di profilo non genera il valore del profilo, perché gli script di profilo vengono eseguiti sul lato server.

  • Aggiungi gli script di profilo come token di risposta per eseguire il debug degli script di profilo:

    In Target, fai clic su Amministrazione, fai clic su Token di risposta, quindi attiva lo script di profilo di cui desideri eseguire il debug.

    Ogni volta che carichi una pagina per il sito con Target su di essa, parte della risposta da Target contiene il valore per lo script di profilo specificato, come mostrato di seguito:

  • Utilizza lo strumento di debug mboxTrace per eseguire il debug degli script di profilo.

    Questo metodo richiede un token di autorizzazione che è possibile generare facendo clic su Target > Amministrazione > Implementazione > Genera token di autorizzazione nella sezione Strumenti di debug .

    Poi aggiungi questi due parametri all'URL della tua pagina dopo il "?": mboxTrace=window&authorization=YOURTOKEN.

    L’aggiunta di questi parametri è un po’ più informativa rispetto al token di risposta, in quanto ottieni uno snapshot precedente all’esecuzione e uno snapshot successivo del profilo. Mostra anche tutti i profili disponibili.

Domande frequenti sugli script di profilo

È possibile utilizzare script di profilo per acquisire informazioni da una pagina che si trova in un livello di dati?

Gli script di profilo non sono in grado di leggere la pagina direttamente poiché vengono eseguiti lato server. I dati devono essere trasmessi mediante una richiesta mbox o altri metodi per l’immissione di dati in Target. Una volta che i dati sono in Target, gli script di profilo possono leggere i dati come un parametro mbox o un parametro di profilo.

Riferimento JavaScript per parametri del profilo di script

È necessaria una conoscenza semplice di JavaScript per utilizzare in modo efficace il profilo di script
Parametri. Questa sezione serve come riferimento rapido per consentirti di utilizzare questa funzionalità in pochi minuti.

I parametri del profilo di script si trovano nella scheda mbox/profiles. È possibile scrivere programmi JavaScript che restituiscono qualsiasi tipo di valore JavaScript (stringa, numero intero, array e così via).

Esempi di parametri di profilo di script

Nome: user.recency

var dayInMillis = 3600 * 24 * 1000;
if (mbox.name == 'orderThankyouPage') {
    user.setLocal('lastPurchaseTime', new Date().getTime());
}
var lastPurchaseTime = user.getLocal('lastPurchaseTime');
if (lastPurchaseTime) {
    return ((new Date()).getTime() - lastPurchaseTime) / dayInMillis;
}

Crea una variabile per il giorno misurato in millisecondi. Se il nome della mbox è orderThankyouPage, imposta un attributo di profilo utente locale (invisibile) denominato lastPurchaseTime per mostrare il valore della data e dell’ora correnti. Il valore dell'ultimo acquisto viene letto e, se definito, Target restituisce il tempo trascorso dall'ultimo acquisto, diviso per il numero di millisecondi in un giorno (che si traduce nel numero di giorni dall'ultimo acquisto).

Nome: user.frequency

var frequency = user.get('frequency') || 0;
if (mbox.name == 'orderThankyouPage') {
    return frequency + 1;
}

Crea una variabile denominata frequency inizializzandola al valore precedente o a 0, in assenza di un valore precedente. Se il nome della mbox è orderThankyouPage, viene restituito il valore incrementale.

Nome: user.monetaryValue

var monetaryValue = user.get('monetaryValue') || 0;
if (mbox.name == 'orderThankyouPage') {
    return monetaryValue + parseInt(mbox.param('orderTotal'));
}

Crea una variabile chiamata monetaryValue, che cerca il valore corrente per un visitatore specificato (o impostata su 0 in assenza di un valore precedente). Se il nome della mbox è orderThankyouPage, viene restituito nuovo valore monetario aggiungendo il precedente e il valore del parametro orderTotal trasmesso alla mbox.

Nome: adobeQA

if (page.param("adobeQA"))
     return page.param("adobeQA");
else if (page.param("adobeqa"))
     return page.param("adobeqa");
else if (mbox.param("adobeQA"))
     return mbox.param("adobeQA");

Crea una variabile denominata adobeQA per monitorare un utente per Controllo qualità delle attività.

Oggetti e metodi

I parametri del profilo di script possono fare riferimento alle proprietà e ai metodi seguenti:

Oggetto o metodo Dettagli
page.url L’URL corrente.
page.protocol Il protocollo utilizzato per la pagina (http o https).
page.domain Il dominio dell’URL corrente (tutto ciò che precede la prima barra). Ad esempio, www.acme.com in http://www.acme.com/categories/men_jeans?color=blu e&size=small.
page.query La stringa di query per la pagina corrente. Tutto ciò che segue il segno “?”. Ad esempio, blue&size=small in http://www.acme.com/categories/mens_jeans?color=blue&size=small.
page.param(‘<par_name>’) Il valore del parametro indicato da <par_name>. Se l’URL corrente è la pagina di ricerca di Google e hai inserito page.param('hl'), riceverai “en” per l’URL http://www.google.com/search?hl=en& q=what+is+asdf&btnG=Google+Search.
page.referrer Lo stesso set di operazioni di cui sopra si applica al referrer e alla destinazione (ad esempio referrer.url è l’indirizzo url del referrer).
landing.url, landing.protocol, landing.query e landing.param Simile a quella della pagina, ma per la pagina di destinazione.
mbox.name Il nome della mbox attiva.
mbox.param(‘<par_name>’) Un parametro mbox in base al nome specificato nella mbox attiva.
profile.get(‘<par_name>’) Il parametro del profilo utente creato dal client in base al nome <par_name>. Ad esempio, se l’utente imposta un parametro di profilo denominato “gender”, il valore può essere estratto utilizzando “profile.gender”. Restituisce il valore del “profile.<par_name>” impostato per il visitatore corrente; restituisce null se non è stato impostato alcun valore. Tieni presente che profile.get(<par_name>) è qualificato come chiamata di funzione.
user.get(‘<par_name>’) Restituisce il valore del “user.<par_name>” impostato per il visitatore corrente; restituisce null se non è stato impostato alcun valore.
user.categoryAffinity Restituisce il nome della categoria migliore.
user.categoryAffinities Restituisce un array con le categorie migliori.
user.isFirstSession Restituisce true se è la prima sessione del visitatore.
user.browser Restituisce l’agente utente nell’intestazione HTTP. Ad esempio, puoi creare una destinazione dell’espressione rivolta solo agli utenti Safari: if (user.browser != null && user.browser.indexOf('Safari') != -1) { return true; }

Operatori comuni

Tutti gli operatori JavaScript standard sono presenti e utilizzabili. Gli operatori JavaScript possono essere utilizzati su stringhe e numeri (e altri tipi di dati). Una rapida descrizione:

Operatore Descrizione
== Indica uguaglianza. È vero se gli operandi da entrambe le parti sono uguali.
!= Indica disuguaglianza. È vero se gli operandi da entrambe le parti non sono uguali.
< Indica che la variabile a sinistra è inferiore alla variabile a destra. Restituisce false se le variabili sono uguali.
> Indica che la variabile a sinistra è maggiore della variabile a destra. Restituisce false se le variabili sono uguali.
<= Come < a meno che le variabili siano uguali, restituisce vero.
>= Come > a meno che le variabili siano uguali, restituisce vero.
&& Stabilisce una relazione logica di tipo “AND” tra le espressioni alla sua sinistra e alla sua desta: restituisce true solo quando entrambe le parti sono vere (in caso contrario restituisce false).
`
// Controlla se la sorgente contiene tutti gli elementi del formato booleano di destinazione (origine Array, destinazione Array).
// estrae la sottostringa dalla destinazione (corrispondente a regexp) e la decodifica Array/*String*/ decode(String encoding, String regexp, String target).
La funzione supporta anche l’uso di valori stringa costanti, raggruppamenti (`condition1

Video di formazione: Script di profilo Badge tutorial

Questo video include informazioni sull'utilizzo e sulla creazione degli script di profilo.

  • Cos’è uno script di profilo
  • Differenza tra script di profilo e parametro di profilo
  • Creare uno script di profilo semplice
  • Utilizzare il menu Token disponibile per accedere alle opzioni disponibili
  • Abilitare e disabilitare gli script di profilo

In questa pagina