L’estensione Core è l’estensione predefinita rilasciata con Adobe Experience Platform Launch.
Utilizza questo riferimento per informazioni sulle opzioni disponibili quando utilizzi questa estensione 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 Opzioni.
Attiva l'azione quando una scheda perde lo stato attivo.
Non sono disponibili impostazioni per questo tipo di evento.
Attiva l'azione quando una scheda diventa attiva.
Non sono disponibili impostazioni per questo tipo di evento.
Attiva l'azione quando un modulo perde lo stato attivo.
Consulta la sezione Opzioni qui di seguito.
Attiva l'azione quando un modulo diventa attivo.
Consulta la sezione Opzioni qui di seguito.
Attiva l'azione quando viene inviato un modulo.
Consulta la sezione Opzioni qui di seguito.
Attiva l'evento quando viene premuto un tasto.
Consulta la sezione Opzioni qui di seguito.
Attiva l'evento al termine della riproduzione del contenuto multimediale.
Consulta la sezione Opzioni qui di seguito.
Attiva l'evento quando i dati vengono caricati.
Consulta la sezione Opzioni qui di seguito.
Attiva l'evento quando il contenuto multimediale viene messo in pausa.
Consulta la sezione Opzioni qui di seguito.
Attiva l'evento durante la riproduzione del contenuto multimediale.
Consulta la sezione Opzioni qui di seguito.
Attiva l'evento se i contenuti multimediali si bloccano.
Consulta la sezione Opzioni qui di seguito.
Attiva l'evento se il contenuto multimediale viene riprodotto per un periodo di tempo specificato.
Consulta la sezione Opzioni qui di seguito.
Inoltre, specifica che l'evento viene attivato dopo un periodo di tempo specificato.
Attiva l'evento se il volume viene alzato o abbassato.
Consulta la sezione Opzioni qui di seguito.
Attiva l’evento se cambia l’orientamento del dispositivo.
Non sono disponibili impostazioni per questo tipo di evento.
Inoltre, specifica che l'evento viene attivato dopo un periodo di tempo specificato.
Attiva l'evento se l'utente utilizza la funzione zoom.
Non sono disponibili impostazioni per questo tipo di evento.
Attiva l’evento se l’elemento specificato è selezionato (su cui è stato fatto clic).
Facoltativamente, puoi specificare valori di proprietà che devono risultare true per l'elemento prima che l'evento venga attivato.
Puoi anche specificare di posticipare la navigazione finché la regola non viene eseguita se l'elemento è un collegamento. Quando si seleziona la casella di controllo, si apre un campo in cui è possibile immettere il ritardo desiderato, in millisecondi. Specifica per quanto tempo il lancio piattaforma attende che i tag vengano attivati sui collegamenti selezionati prima di passare alla pagina successiva. Il valore predefinito è 100 millisecondi. Ritardi più lunghi migliorano l'accuratezza del tracciamento. Adobe consiglia un ritardo di 500 millisecondi o meno, impercettibile per l'utente. Platform Launch attenderà per l’intervallo di tempo specificato, ma se il beacon viene attivato prima, il ritardo viene interrotto. (L’utente dunque non aspetterà sempre per l’intera durata del ritardo.)
Inoltre, specifica che l'evento viene attivato dopo un periodo di tempo specificato.
Per opzioni avanzate, consulta Opzioni di seguito.
Attiva l'evento se l'utente passa col cursore sopra un elemento specificato.
Consulta la sezione Opzioni qui di seguito.
Inoltre, configura se la regola viene attivata immediatamente o dopo un numero specificato di millisecondi.
Attiva l'evento se si verifica un tipo di evento personalizzato.
Puoi nominare una funzione JavaScript già definita altrove e usarla per l’evento.
Specifica il nome del tipo di evento personalizzato, quindi configura le altre impostazioni come descritto in Opzioni, qua di seguito.
Attiva l'evento se un elemento dati specificato cambia.
Immetti il nome dell'elemento dati. Per selezionare l'elemento dati da un elenco, seleziona l'icona e quindi l'elemento dati.
Progettato per bypassare i sistemi di rilevamento eventi e ricerca.
Le regole di chiamata diretta sono ideali per le situazioni in cui desideri comunicare a Platform Launch esattamente ciò che sta accadendo. Inoltre, sono ideali quando Platform Launch non è in grado di rilevare un evento nel DOM, ad esempio con Adobe Flash.
Specificate la stringa _satellite.track
.
Attiva l'evento se è presente un elemento specificato.
Consulta la sezione Opzioni qui di seguito.
Attiva l'evento se l'utente immette un riquadro di visualizzazione specificato.
Consulta la sezione Opzioni qui di seguito.
Inoltre, configura se la regola viene attivata immediatamente o dopo un numero specificato di millisecondi.
Attiva l'evento se si verifica un pushState o un hashchange.
Non sono disponibili impostazioni per questo tipo di evento.
Attiva l'evento se l'utente rimane sulla pagina per un numero specificato di secondi.
Specifica quanti secondi devono trascorrere prima che l'evento venga attivato.
Attiva quando il DOM è pronto e l'utente può interagire con la pagina
Non sono disponibili impostazioni per questo tipo di evento.
Attiva l’evento non appena viene caricata la libreria Platform Launch.
Non sono disponibili impostazioni per questo tipo di evento.
Attiva l'evento una volta chiamato _satellite.pageBottom();
. Quando si carica la libreria Platform Launch in modo asincrono, questo tipo di evento non deve essere utilizzato.
Non sono disponibili impostazioni per questo tipo di evento.
Attiva l'evento quando onLoad viene chiamato dal browser e la pagina ha terminato il caricamento.
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. 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 e controlla l’oggetto evento a cui hai avuto accesso 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 è abilitata l’opzione “Run rule components in sequence” dalle impostazioni di proprietà, è possibile che dei componenti della 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, Platform Launch considera 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. Consulta la documentazione Truthy di MDN per esempi di valori truthy.
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. Consulta la documentazione Falsy di MDN per esempi di valori falsy.
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 dev’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.
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 e controlla l’oggetto evento a cui hai avuto accesso 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 Platform Launch, 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 principale Platform Launch. 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 di Platform Launch è concepita per identificare i problemi con il codice scritto da sviluppatori. 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 è abilitata l’opzione “Run rule components in sequence” dalle impostazioni di proprietà, è possibile che dei componenti della 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.
Nota: 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, Platform Launch considera la promessa risolta immediatamente e passa 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 Platform Launch può continuare l’esecuzione delle azioni successive. Se invece per qualche motivo il codice personalizzato genera un errore, è possibile chiamare onCustomCodeFailure()
. In questo modo Platform Launch non eseguirà 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>
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
È possibile inserire JavaScript personalizzato nell'interfaccia utente selezionando Apri 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 viene inclusa o viene restituito il valore null
o undefined
, il valore predefinito dell’elemento dati viene 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 e controlla l’oggetto evento a cui hai avuto accesso nella console del browser. Una volta ottenute le informazioni disponibili nelle varie regole che possono utilizzare l’elemento dati, è possibile usarle per prendere decisioni programmatiche all’interno del codice personalizzato o restituire una parte 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.
Se nel markup sono presenti delle variabili JavaScript o proprietà di oggetto e se desideri raccogliere tali valori in Platform Launch per utilizzarli con le estensioni o le regole, uno dei modi per acquisire tali valori è utilizzare elementi dati in Platform Launch. In questo modo, puoi fare riferimento all’elemento dati in tutte le regole e, se l’origine dei dati dovesse cambiare, devi solo modificare il riferimento all’origine (l’elemento dati) in un’unica posizione in Platform Launch.
Ad esempio, supponiamo che il markup contenga una variabile JavaScript denominata Page_Name
, come segue:
<script>
//data layer
var Page_Name = "Homepage"
</script>
Quando crei l’elemento dati in Platform Launch, fornisci semplicemente il percorso di tale variabile.
Se utilizzi un oggetto raccolta dati come parte del livello dati, è sufficiente utilizzare la notazione del punto nel percorso per fare riferimento all’oggetto e alla proprietà che desideri acquisire nell’elemento dati, come _myData.pageName
, digitalData.pageName
, ecc.
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.
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. Spesso viene 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 o raccolta dati.
Seleziona uno dei seguenti attributi di comportamento dei visitatori:
Alcuni casi d'uso comuni includono: