Adobe Experience Platform Launch è stato ridefinito come suite di tecnologie di raccolta dati in Adobe Experience Platform. Di conseguenza, sono state introdotte diverse modifiche terminologiche nella documentazione del prodotto. Consulta questo documento come riferimento consolidato delle modifiche terminologiche.
L’estensione tag Core è l’estensione predefinita rilasciata con Adobe Experience Platform.
Questo documento descrive le opzioni disponibili quando si utilizza l’estensione Core per creare una regola.
In questo capitolo sono descritti i tipi di evento disponibili nell'estensione core. Per informazioni sulle opzioni che possono essere impostate per diversi tipi di eventi, vedi la sezione Opzioni.
L’evento tab-blur attiva l’azione quando una scheda perde lo stato attivo. Non sono disponibili impostazioni per questo tipo di evento.
L’evento tab-focus attiva l’azione quando una scheda diventa attiva. Non sono disponibili impostazioni per questo tipo di evento.
L’evento blur attiva l’azione quando un modulo perde lo stato attivo. Per ulteriori informazioni sulle impostazioni personalizzabili degli eventi, consulta la sezione Opzioni.
L’evento focus attiva l’azione quando un modulo diventa attivo. Per ulteriori informazioni sulle impostazioni personalizzabili degli eventi, consulta la sezione Opzioni.
L’evento submit attiva l’azione quando un modulo viene inviato. Per ulteriori informazioni sulle impostazioni personalizzabili degli eventi, consulta la sezione Opzioni.
L’evento viene attivato quando viene premuto un tasto. Per ulteriori informazioni sulle impostazioni personalizzabili degli eventi, consulta la sezione Opzioni.
L’evento viene attivato al termine del contenuto multimediale. Per ulteriori informazioni sulle impostazioni personalizzabili degli eventi, consulta la sezione Opzioni.
L’evento viene attivato quando vengono caricati dati di file multimediali. Per ulteriori informazioni sulle impostazioni personalizzabili degli eventi, consulta la sezione Opzioni.
L’evento si attiva quando il contenuto multimediale viene messo in pausa. Per ulteriori informazioni sulle impostazioni personalizzabili degli eventi, consulta la sezione Opzioni.
L’evento si attiva durante la riproduzione del contenuto multimediale. Per ulteriori informazioni sulle impostazioni personalizzabili degli eventi, consulta la sezione Opzioni.
L’evento si attiva se il contenuto multimediale si arresta. Per ulteriori informazioni sulle impostazioni personalizzabili degli eventi, consulta la sezione Opzioni.
L’evento si attiva se il contenuto multimediale viene riprodotto per un periodo di tempo specificato. Per attivare l’evento è necessario specificare la durata della riproduzione del file multimediale. Per ulteriori informazioni sulle impostazioni personalizzabili degli eventi, consulta la sezione Opzioni.
L’evento si attiva se il volume viene alzato o abbassato. Per ulteriori informazioni sulle impostazioni personalizzabili degli eventi, consulta la sezione Opzioni.
L’evento si attiva se cambia l’orientamento del dispositivo. Per attivare l’evento è necessario specificare la durata di modifica dell’orientamento. Non sono disponibili impostazioni per questo tipo di evento.
L’evento si attiva se l’utente utilizza la funzione zoom. Non sono disponibili impostazioni per questo tipo di evento.
L’evento si attiva se l’utente seleziona l’elemento specificato (facendo clic). Facoltativamente, puoi specificare valori di proprietà che devono risultare true per l'elemento prima che l'evento venga attivato.
Se l’elemento è un tag di ancoraggio (<a>
) per collegare il contenuto, puoi anche specificare se posticipare la navigazione per un periodo di tempo. Questo può essere utile se la regola richiede un tempo supplementare per essere eseguita e non viene normalmente completata prima che venga eseguita la navigazione nelle pagine.
Quest’opzione deve essere utilizzata con estrema cautela a causa delle potenziali conseguenze negative che provoca all’esperienza utente se utilizzata in modo errato.
Quando utilizzi il ritardo dei collegamenti, Platform impedisce al browser di spostarsi fuori dalla pagina. Successivamente, esegue un reindirizzamento JavaScript alla destinazione originale dopo il timeout specificato. Ciò è particolarmente pericoloso se il markup della pagina contiene tag <a>
la cui funzionalità prevista non fa uscire l’utente dalla pagina. Se non è possibile risolvere il problema in altro modo, è necessario essere estremamente precisi nella definizione del selettore, in modo che questo evento venga attivato esattamente dove necessario e in nessun altro punto.
Il valore predefinito del ritardo del collegamento è 100 millisecondi. Tieni presente che i tag attenderanno sempre il tempo specificato e non sarà in alcun modo collegato all’esecuzione delle azioni della regola. È possibile che il ritardo obblighi l’utente ad aspettare più tempo del necessario e che il ritardo non sia sufficiente per il completamento di tutte le azioni della regola. I ritardi più lunghi forniscono più tempo per l’esecuzione delle regole, ma peggiorano anche l’esperienza utente.
Per attivare il ritardo è necessario fornire sia l’elemento selezionato che attiva l’evento, sia la quantità specifica di tempo prima che l’evento venga attivato.
Per ulteriori informazioni sulle opzioni avanzate, consulta la sezione Opzioni.
L’evento si attiva se l’utente passa col cursore sopra un elemento specificato. Inoltre, devi configurare se la regola viene attivata immediatamente o dopo un numero specificato di millisecondi. Per ulteriori informazioni sulle impostazioni personalizzabili degli eventi, consulta la sezione Opzioni.
L’evento si attiva se si verifica un tipo di evento personalizzato. Le funzioni JavaScript denominate definite altrove nel codebase possono essere utilizzate come tipo di evento personalizzato. Specifica il nome del tipo di evento personalizzato, quindi configura le altre impostazioni come descritto nella sezione Opzioni di seguito.
L’evento si attiva se un elemento dati specificato cambia. È necessario specificare un nome per l’elemento dati. Puoi selezionare l’elemento dati digitandone il nome nel campo di testo o selezionando l’icona dell’elemento dati sul lato destro del campo di testo e scegliendo da un elenco fornito all’interno della finestra di dialogo visualizzata.
Un evento di chiamata diretta bypassa i sistemi di rilevamento degli eventi e di ricerca. Le regole di chiamata diretta sono ideali per le situazioni in cui desideri comunicare al sistema esattamente ciò che sta accadendo. Inoltre, sono ideali quando il sistema non è in grado di rilevare un evento nel DOM.
Quando definisci un evento di chiamata diretta, devi specificare una stringa che fungerà da identificatore dell’evento. Se un attiva azione di chiamata diretta contenente lo stesso identificatore viene attivato, verranno eseguite tutte le regole di evento di chiamata diretta in ascolto di tale identificatore.
L’evento si attiva se è presente un elemento specificato. Per ulteriori informazioni sulle impostazioni personalizzabili degli eventi, consulta la sezione Opzioni.
Attiva l’evento se l’utente immette un riquadro di visualizzazione specificato. Devi fornire un selettore CSS come criterio per eseguire il targeting degli elementi corrispondenti. È inoltre necessario configurare se la regola viene attivata immediatamente o dopo un numero specificato di millisecondi e se l’evento deve essere attivato ogni volta che si verifica o solo la prima volta.
Per ulteriori informazioni sulle impostazioni personalizzabili degli eventi, consulta la sezione Opzioni.
L’evento viene attivato se si verifica un evento pushState o hashchange. Non sono disponibili impostazioni per questo tipo di evento.
L’evento viene attivato se l’utente rimane sulla pagina per un numero specificato di secondi. Specifica quanti secondi devono trascorrere prima che l’evento venga attivato.
L’evento viene attivato quando il DOM è pronto e l’utente può interagire con la pagina. Non sono disponibili impostazioni per questo tipo di evento.
L’evento viene attivato non appena viene caricata la libreria di tag. Non sono disponibili impostazioni per questo tipo di evento.
L’evento viene attivato una volta chiamato _satellite.pageBottom();
. Quando la libreria di tag viene caricata in modo asincrono, questo tipo di evento non deve essere utilizzato. Non sono disponibili impostazioni per questo tipo di evento.
L’evento si attiva quando onLoad viene chiamato dal browser e la pagina è stata completamente caricata. Non sono disponibili impostazioni per questo tipo di evento.
Ogni tipo di evento modulo utilizza le impostazioni seguenti:
Inserisci il selettore CSS che identifica gli elementi che attivano l'evento.
Se selezioni questa opzione, diventano disponibili i seguenti parametri:
property=value
Specifica il valore della proprietà
Regex
Attiva se property=value
è un'espressione regolare.
Add
Aggiungi un'altra coppia property=value
.
In questa sezione sono descritti i tipi di condizioni disponibili nell’estensione core. Questi tipi di condizioni possono essere utilizzati con il tipo di logica regolare o d’eccezione.
Specifica il nome e il valore del cookie che devono esistere affinché un evento attivi un'azione.
Specifica un codice personalizzato che deve esistere come condizione dell'evento.
JavaScript ES6+ è ora supportato nel codice personalizzato. Alcuni browser meno recenti non supportano ES6+. Per comprendere l’impatto dell’utilizzo delle funzioni ES6+, esegui il test su tutti i browser web che dovrebbero essere supportati.
Utilizza l'editor di codice incorporato per inserire il codice personalizzato:
Una variabile denominata event
sarà automaticamente disponibile; potrai fare riferimento a essa all'interno del codice personalizzato. L'oggetto event
conterrà informazioni utili sull'evento che ha attivato la regola. Il modo più semplice per determinare quali dati evento sono disponibili è accedere event
alla console dall'interno del codice personalizzato:
console.log(event);
return true;
Esegui la regola in un browser ed esamina l'oggetto evento registrato nella console del browser. Una volta raccolte le informazioni disponibili è possibile usarle per prendere decisioni programmatiche all’interno del codice personalizzato.
Sequenza delle condizioni
Quando l’opzione "Esegui componenti regola in sequenza" dalle impostazioni di proprietà è abilitata, è possibile che i componenti regola successivi siano in attesa mentre la condizione esegue un’attività asincrona.
Quando la condizione restituisce una promessa, la condizione successiva nella regola non viene eseguita finché la promessa restituita non è risolta. Se la promessa viene rifiutata, i tag considerano tale condizione come non riuscita e non verranno eseguite ulteriori condizioni o azioni da quella regola.
Esempio di condizione che restituisce una promessa:
return new Promise(function(resolve, reject) {
setTimeout(function() {
if (new Date().getDay() === 5) {
resolve();
} else {
reject();
}
}, 1000);
});
Confronta due valori per determinare se questa condizione restituisce true.
Se disponi di una regola con più condizioni, è possibile che questa condizione restituisca true, ma la regola non viene comunque attivata perché le altre condizioni restituiscono false o una delle eccezioni restituisce true.
Sono disponibili i seguenti operatori di confronto dei valori:
Equal: La condizione restituisce true se i due valori sono uguali utilizzando un confronto non rigoroso (in JavaScript, == operator). I valori possono essere di qualsiasi tipo. Quando digiti una parola come true, false, null o undefined in un campo value, la parola viene confrontata come stringa e non viene convertita nel relativo equivalente JavaScript.
Does Not Equal: La condizione restituisce true se i due valori non sono equalizzati con un confronto non rigoroso (in JavaScript il != operatore). I valori possono essere di qualsiasi tipo. Quando digiti una parola come true, false, null o undefined in un campo value, la parola viene confrontata come stringa e non viene convertita nel relativo equivalente JavaScript.
Contains: La condizione restituisce true se il primo valore contiene il secondo valore. I numeri vengono convertiti in stringhe. Qualsiasi valore diverso da un numero o una stringa fa sì che la condizione restituisca false.
Does Not Contain: La condizione restituisce true se il primo valore non contiene il secondo valore. I numeri vengono convertiti in stringhe. Qualsiasi valore diverso da un numero o una stringa fa sì che la condizione restituisca true.
Starts With: La condizione restituisce true se il primo valore inizia con il secondo valore. I numeri vengono convertiti in stringhe. Qualsiasi valore diverso da un numero o una stringa fa sì che la condizione restituisca false.
Does Not Start With: La condizione restituisce true se il primo valore non inizia con il secondo valore. I numeri vengono convertiti in stringhe. Se utilizzi un valore diverso da un numero o una stringa, la condizione restituisce true.
Ends With: La condizione restituisce true se il primo valore termina con il secondo valore. I numeri vengono convertiti in stringhe. Qualsiasi valore diverso da un numero o una stringa fa sì che la condizione restituisca false.
Does Not End With: La condizione restituisce true se il primo valore non termina con il secondo valore. I numeri vengono convertiti in stringhe. Se utilizzi un valore diverso da un numero o una stringa, la condizione restituisce true.
Matches Regex: La condizione restituisce true se il primo valore corrisponde all'espressione regolare. I numeri vengono convertiti in stringhe. Qualsiasi valore diverso da un numero o una stringa fa sì che la condizione restituisca false.
Does Not Match Regex: La condizione restituisce true se il primo valore non corrisponde all'espressione regolare. I numeri vengono convertiti in stringhe. Se utilizzi un valore diverso da un numero o una stringa, la condizione restituisce true.
Is Less Than: La condizione restituisce true se il primo valore è minore del secondo valore. Le stringhe che rappresentano i numeri sono convertite in numeri. Qualsiasi valore diverso da un numero o una stringa convertibile fa sì che la condizione restituisca false.
Is Less Than Or Equal To: La condizione restituisce true se il primo valore è minore o uguale al secondo valore. Le stringhe che rappresentano i numeri sono convertite in numeri. Qualsiasi valore diverso da un numero o una stringa convertibile fa sì che la condizione restituisca false.
Is Greater Than: La condizione restituisce true se il primo valore è maggiore del secondo valore. Le stringhe che rappresentano i numeri sono convertite in numeri. Qualsiasi valore diverso da un numero o una stringa convertibile fa sì che la condizione restituisca false.
Is Greater Than Or Equal To: La condizione restituisce true se il primo valore è maggiore o uguale al secondo valore. Le stringhe che rappresentano i numeri sono convertite in numeri. Qualsiasi valore diverso da un numero o una stringa convertibile fa sì che la condizione restituisca false.
Is True: La condizione restituisce true se il valore è booleano con il valore true. Il valore fornito non viene convertito in booleano se è di qualsiasi altro tipo. Un valore diverso da un valore booleano con valore true restituisce false.
Is Truthy: La condizione restituisce true se il valore è true dopo essere stato convertito in booleano. Per esempi di valori truthy consulta documentazione Truthy di MDN.
Is False: La condizione restituisce true se il valore è booleano con il valore di false. Il valore fornito non viene convertito in booleano se è di qualsiasi altro tipo. Se un valore diverso da un valore booleano con valore false restituisce false, restituisce false.
Is Falsy: La condizione restituisce true se il valore è false dopo essere stato convertito in booleano. Per esempi di valori falsy consulta documentazione Falsy di MDN.
Specifica il nome e il valore della variabile JavaScript esistenti affinché un evento attivi un'azione.
Specifica la pagina a cui l'utente deve accedere per attivare l'evento.
Specifica se il visitatore deve essere un nuovo visitatore o un visitatore di ritorno per attivare un'azione.
Seleziona una delle seguenti opzioni:
Configura il numero di volte in cui il visitatore deve visualizzare la pagina prima che l'azione venga attivata.
Attiva l'azione se il numero di sessioni dell'utente soddisfa i criteri specificati.
Attiva l'azione se il numero di sessioni dell'utente soddisfa i criteri specificati.
Configura per quanto tempo il visitatore deve trovarsi sul sito prima che l'azione venga attivata.
Attiva l'azione se il numero di sessioni dell'utente soddisfa i criteri specificati.
Specifica l'origine del traffico del visitatore che deve essere true per attivare l'azione.
Seleziona il browser che il visitatore deve usare per attivare l'azione.
Seleziona uno o più browser seguenti:
Seleziona il tipo di dispositivo che il visitatore deve usare per attivare l'azione.
Seleziona uno o più dei seguenti tipi di dispositivi:
Seleziona il sistema operativo che il visitatore deve utilizzare per attivare l'azione.
Seleziona uno o più dei seguenti sistemi operativi:
Seleziona la risoluzione dello schermo che i visitatori devono usare sui propri dispositivi per attivare l'azione.
Seleziona la dimensione della finestra che i visitatori devono usare sui propri dispositivi per attivare l'azione.
Specifica il dominio del visitatore.
Specifica uno o più pattern di hash che devono esistere nell'URL.
I pattern di hash multipli sono collegati da un operatore OR.
Specifica uno o più percorsi che devono esistere nell’URL. Questo include il percorso e la stringa query.
Più percorsi sono collegati da un operatore OR.
Specifica uno o più percorsi che devono esistere nell’URL. Questo include il percorso ma non la stringa query.
Più percorsi sono collegati da un operatore OR.
Specifica il protocollo utilizzato nell'URL.
Seleziona una delle seguenti opzioni:
Specifica il parametro URL utilizzato nell'URL.
Specifica uno o più domini che devono esistere nell'URL.
Più domini secondari sono collegati da un operatore OR.
Specifica un intervallo di date. Scegli la data e l'ora in cui si verifica l'evento, la data in cui si è verificato prima e il fuso orario.
Specifica il numero massimo di volte che la condizione restituisce true. Puoi scegliere una delle opzioni seguenti:
Se la condizione di frequenza massima per sessione è pari a 1, vengono confrontati questi due elementi localStorage
. Se visitorTracking.sessionCount
è maggiore del valore di maxFrequency.session
, la condizione di campionamento è true. Se i due valori sono uguali, la condizione è false.
sessionCount
è un elemento visitorTracking
, pertanto affinché la condizione di campionamento funzioni deve essere abilitata l’API visitatore.
Specifica la percentuale di tempo restituita dalla condizione.
In questa sezione sono descritti i tipi di azioni disponibili nell'estensione core.
JavaScript ES6+ è ora supportato nel codice personalizzato. Alcuni browser meno recenti non supportano ES6+. Per comprendere l’impatto dell’utilizzo delle funzioni ES6+, esegui il test su tutti i browser web che dovrebbero essere supportati.
Fornisci il codice che viene eseguito dopo l'attivazione dell'evento e le condizioni vengono valutate.
Quando JavaScript è selezionato come linguaggio, sarà automaticamente disponibile una variabile denominata event
a cui è possibile fare riferimento all'interno del codice personalizzato. L'oggetto event
conterrà informazioni utili sull'evento che ha attivato la regola. Il modo più semplice per determinare quali dati evento sono disponibili è accedere event
alla console dall'interno del codice personalizzato:
console.log(event);
Esegui la regola in un browser ed esamina l'oggetto evento registrato nella console del browser. Dopo aver compreso le informazioni disponibili, potrai utilizzarle per le decisioni programmate all'interno del codice personalizzato, inviare una parte dell'oggetto event
a un server e così via.
L’estensione Core, disponibile per tutti gli utenti di Adobe Experience Platform, contiene un’azione Custom Code per l’esecuzione di JavaScript o HTML fornito dall’utente. Spesso è utile che gli utenti possano capire in che modo vengono elaborate le regole con le azioni Custom Code.
Il codice da azioni personalizzate è incorporato nella libreria di tag principale. Il codice viene scritto nel documento utilizzando document.write. Se una regola include più azioni Custom Code, il codice viene scritto nell'ordine configurato nella regola.
Un codice da azioni personalizzate viene caricato dal server e scritto sul documento utilizzando Postscribe. Se una regola include più azioni Custom Code, il codice viene caricato in parallelo dal server, ma scritto nell'ordine configurato nella regola.
L'utilizzo di a document.write dopo il caricamento di una pagina comporterebbe in genere problemi, ma non si tratta di un problema per il codice fornito tramite azioni Custom Code. Puoi utilizzare document.write nelle azioni Custom Code indipendentemente da quando verrà eseguito il codice.
La convalida utilizzata nell’editor di codice tag è progettata per individuare eventuali problemi nel codice scritto dallo sviluppatore. Un codice che è passato attraverso un processo di minimizzazione, come il codice AppMeasurement.js scaricato dal Code Manager, potrebbe essere falsamente segnalato come problematico dal validatore, che di solito può essere ignorato.
Quando l’opzione "Esegui componenti regola in sequenza" dalle impostazioni di proprietà è abilitata, è possibile che i componenti regola successivi siano in attesa mentre l’azione esegue un’attività asincrona. Questo avviene diversamente per i codici personalizzati JavaScript e HTML.
JavaScript
Quando si crea un’azione di codice personalizzato JavaScript, è possibile restituire una promessa dall’azione. L’azione successiva nella regola viene eseguita solo quando la promessa restituita è stata risolta. Se la promessa viene rifiutata, le azioni successive della regola non vengono eseguite.
Questo avviene solo quando il codice JavaScript non è impostato per l’esecuzione a livello globale. Se esegui l’azione del codice personalizzato nell’ambito globale, i tag intenderanno la promessa risolta immediatamente e passeranno all’elemento successivo nella coda di elaborazione.
Esempio di azione di un codice personalizzato JavaScript che restituisce una promessa:
return new Promise(function(resolve, reject) {
setTimeout(function() {
if (new Date().getDay() === 5) {
resolve();
} else {
reject();
}
}, 1000);
});
HTML
Quando si crea un’azione di codice personalizzato HTML, una funzione denominata onCustomCodeSuccess()
è disponibile per l’uso all’interno del codice personalizzato. È possibile chiamare questa funzione per indicare che il codice personalizzato è stato completato e che i tag possono continuare l’esecuzione delle azioni successive. Se invece per qualche motivo il codice personalizzato genera un errore, è possibile chiamare onCustomCodeFailure()
. In questo modo i tag non eseguiranno le azioni successive da quella regola.
Un esempio di azione di un codice personalizzato HTML che utilizza i nuovi callback:
<script>
setTimeout(function() {
if (new Date().getDay() === 5) {
onCustomCodeSuccess();
} else {
onCustomCodeFailure();
}
}, 1000);
</script>
Questa azione attiva tutte le regole che utilizzano un evento di chiamata diretta. Durante la configurazione dell’azione, devi fornire la stringa di identificazione per l’evento di chiamata diretta che desideri attivare. Facoltativamente, puoi anche trasmettere i dati all’evento di chiamata diretta tramite una detail
oggetto, che può contenere un set personalizzato di coppie chiave-valore.
L’azione viene mappata direttamente su track
metodo nel satellite
, accessibile tramite codice lato client.
I tipi di elementi dati sono determinati dall'estensione. Non vi sono limiti ai tipi che è possibile creare.
Nelle sezioni seguenti sono descritti i tipi di elementi dati disponibili nell'estensione Core. Altre estensioni utilizzano altri tipi di elementi dati.
A qualsiasi cookie di dominio può essere fatto riferimento nel campo del nome del cookie.
cookieName
Qualsiasi valore di stringa costante a cui è possibile fare riferimento in azioni o condizioni.
string
JavaScript ES6+ è ora supportato nel codice personalizzato. Alcuni browser meno recenti non supportano ES6+. Per comprendere l’impatto dell’utilizzo delle funzioni ES6+, esegui il test su tutti i browser web che dovrebbero essere supportati.
JavaScript personalizzato può essere inserito nell'interfaccia utente facendo clic su Open Editor e inserendo il codice nella finestra dell’editor.
Nella finestra dell'editor è necessaria un'istruzione return per indicare il valore da utilizzare come valore dell'elemento dati. Se un'istruzione return non è inclusa o il valore null
o undefined
viene restituito, il valore predefinito dell'elemento dati sarà utilizzato come valore dell'elemento dati.
Esempio:
var pageType = $('div.page-wrapper').attr('class').split('')[1];
if (window.location.pathname == '/') {
return 'homepage';
} else {
return pageType;
}
Se l'elemento dati del codice personalizzato viene recuperato come parte di un'esecuzione di una regola, una variabile chiamata event
diventa automaticamente disponibile; potrai fare riferimento a essa all'interno del codice personalizzato. L'oggetto event
conterrà informazioni utili sull'evento che ha attivato la regola. Il modo più semplice per determinare quali dati evento sono disponibili è accedere event
alla console dall'interno del codice personalizzato:
console.log(event);
return true;
Esegui la regola in un browser ed esamina l'oggetto evento registrato nella console del browser. Una volta comprese le informazioni disponibili in base alle varie regole che possono utilizzare l'elemento dati, potrai utilizzarle per le decisioni di programmazione all'interno del codice personalizzato o restituire un elemento dell'oggetto event
come valore dell'elemento dati.
Qualsiasi valore di elemento può essere recuperato, ad esempio un tag div o H1.
CSS Selector Chain:
id#dc logo img
Ottieni il valore di:
src
È possibile fare riferimento a qualsiasi oggetto o variabile JavaScript disponibile utilizzando il campo path.
Gli elementi dati di tag possono essere utilizzati per acquisire le variabili JavaScript di markup o le proprietà degli oggetti. Questi valori possono quindi essere utilizzati all’interno di estensioni o regole personalizzate mediante riferimento agli elementi dati dei tag. Se l’origine dei dati cambia, è necessario solo aggiornare il riferimento all’origine.
Nell’esempio seguente, il markup contiene una variabile JavaScript denominata Page_Name
.
<script>
//data layer
var Page_Name = "Homepage"
</script>
Quando crei l'elemento dati , fornisci semplicemente il percorso di tale variabile.
Se utilizzi un oggetto raccolta dati come parte del livello dati, utilizza la notazione del punto nel percorso per fare riferimento all'oggetto e alla proprietà che desideri acquisire nell'elemento dati, come _myData.pageName
, o digitalData.pageName
e così via.
window.document.title
Immetti il nome dell'elemento di memorizzazione locale nel campo Local Storage Item Name.
La memorizzazione locale offre ai browser un modo per memorizzare informazioni da pagina a pagina (https://www.w3schools.com/html/html5_webstorage.asp). La memorizzazione locale funziona in modo simile ai cookie, ma è molto più grande e flessibile.
Utilizza il campo fornito per specificare il valore creato per un elemento di archiviazione locale, ad esempio lastProductViewed.
Seleziona più elementi dati che forniranno ciascuno un oggetto. Questi oggetti verranno uniti in profondità (in modo ricorsivo) per produrre un nuovo oggetto. Gli oggetti di origine non verranno modificati. Se una proprietà viene trovata nella stessa posizione su più oggetti sorgente, verrà utilizzato il valore di quest'ultimo oggetto. Se il valore di una proprietà di origine è undefined
, non sostituisce un valore di un oggetto sorgente precedente. Se si trovano array nella stessa posizione su più oggetti sorgente, gli array vengono concatenati.
Ad esempio, supponiamo di selezionare un elemento dati che fornisce il seguente oggetto:
{
"sport": {
"name": "tennis"
},
"dessert": "ice cream",
"fruits": [
"apple",
"banana"
]
}
Supponiamo di selezionare anche un altro elemento dati che fornisce il seguente oggetto:
{
"sport": {
"name": "volleyball"
},
"dessert": undefined,
"pet": "dog",
"instrument": undefined,
"fruits": [
"cherry",
"duku"
]
}
Il risultato dell'elemento dati Oggetti uniti è il seguente oggetto:
{
"sport": {
"name": "volleyball"
},
"dessert": "ice cream",
"pet": "dog",
"instrument": undefined,
"fruits": [
"apple",
"banana",
"cherry",
"duku"
]
}
Usa questi punti dati per acquisire informazioni di pagina da utilizzare nella logica della regola o per inviare informazioni ad Analytics o a sistemi di tracciamento esterni.
Puoi selezionare uno dei seguenti attributi di pagina da utilizzare nell'elemento dati:
Specifica un parametro URL singolo nel campo URL Parameter.
È necessaria solo la sezione name ed eventuali designatori speciali come "?" o “=” devono essere omessi.
contentType
Utilizza questo elemento dati per generare un numero casuale. Viene spesso utilizzato per campionare dati o creare ID, ad esempio un Hit ID. Il numero casuale può essere usato per oscurare o conservare i dati sensibili. Alcuni esempi possono includere:
Specifica i valori minimo e massimo per il numero casuale.
Valori predefiniti:
Minimo: 0
Massimo: 1000000000
Immetti il nome dell'elemento di archiviazione sessione nel campo Session Storage Item Name.
L'archiviazione della sessione è simile all'archiviazione locale, fatta eccezione per i dati che vengono eliminati al termine della sessione, mentre l'archiviazione locale o un cookie potrebbero conservare i dati.
Simile a Informazioni pagina, questo elemento dati utilizza tipi di comportamento comuni per arricchire una logica all’interno di regole e altre soluzioni Platform.
Seleziona uno dei seguenti attributi di comportamento dei visitatori:
Alcuni casi d'uso comuni includono:
Un wrapper per Value Comparison condizione. In base al risultato del confronto, restituirà uno dei due valori disponibili nel modulo. Può quindi gestire "If… Allora… Altrimenti…" senza la necessità di ulteriori regole.
Consente di selezionare una delle seguenti variabili:
_satellite.environment.stage
differenziare gli ambienti di sviluppo/staging/produzione.turbine.buildInfo.buildDate
che contiene lo stesso valore come _satellite.buildInfo.buildDate
._satellite.property.name
per ottenere il nome della proprietà Launch._satellite.property.id
per ottenere l’ID della proprietà Launchevent.$rule.name
contenente il nome della regola eseguita.event.$rule.id
contenente l’ID della regola eseguita.event.$type
contenente il tipo di evento che ha attivato la regola.event.detail
contenente il payload di un evento personalizzato o di una regola di chiamata diretta.event.identifier
contenente l’identificatore di una regola di chiamata diretta.Restituisce uno dei seguenti attributi del dispositivo visitatore:
È un wrapper per le operazioni JavaScript più comuni. Riceve un elemento dati come input. Restituisce il risultato di una delle seguenti trasformazioni del valore dell’elemento dati: