ARGOMENTI×
Estensione core
Estensione core è l'estensione predefinita rilasciata con Launch.
Utilizza questo riferimento per informazioni sulle opzioni disponibili quando utilizzi questa estensione per creare una regola.
Tipi di eventi dell'estensione core
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
.
Browser
Sfocatura scheda
Attiva l'azione quando una scheda perde lo stato attivo.
Non sono disponibili impostazioni per questo tipo di evento.
Messa a fuoco scheda
Attiva l'azione quando una scheda diventa attiva.
Non sono disponibili impostazioni per questo tipo di evento.
Tastiera
Pressione tasti
Attiva l'evento quando viene premuto un tasto.
Consulta la sezione
Opzioni
qui di seguito.
Media
Contenuti multimediali terminati
Attiva l'evento al termine della riproduzione del contenuto multimediale.
Consulta la sezione
Opzioni
qui di seguito.
Dati caricati da contenuti multimediali
Attiva l'evento quando i dati vengono caricati.
Consulta la sezione
Opzioni
qui di seguito.
Pausa contenuti multimediali
Attiva l'evento quando il contenuto multimediale viene messo in pausa.
Consulta la sezione
Opzioni
qui di seguito.
Riproduzione file multimediali
Attiva l'evento durante la riproduzione del contenuto multimediale.
Consulta la sezione
Opzioni
qui di seguito.
File multimediali bloccati
Attiva l'evento se i contenuti multimediali si bloccano.
Consulta la sezione
Opzioni
qui di seguito.
Tempo di riproduzione dei contenuti multimediali
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.
Volume multimediale modificato
Attiva l'evento se il volume viene alzato o abbassato.
Consulta la sezione
Opzioni
qui di seguito.
Dispositivi mobili
Modifica orientamento
Attiva l'evento se l'orientamento del dispositivo cambia.
Non sono disponibili impostazioni per questo tipo di evento.
Inoltre, specifica che l'evento viene attivato dopo un periodo di tempo specificato.
Modifica zoom
Attiva l'evento se l'utente utilizza la funzione zoom.
Non sono disponibili impostazioni per questo tipo di evento.
Mouse
Fai clic su
Attiva l'evento se l'utente fa clic sull'elemento specificato.
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 fai clic sulla casella di controllo, viene visualizzato un campo in cui puoi inserire il ritardo desiderato in millisecondi. Questo specifica quanto tempo Launch attende per l'attivazione dei tag sui collegamenti con clic 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. Launch attenderà per l'intervallo di tempo specificato, ma se il beacon viene attivato prima, il ritardo viene interrotto. (Ossia, l'utente non deve sempre attendere 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.
Passaggio del mouse
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.
Altro
Evento personalizzato
Attiva l'evento se si verifica un tipo di evento personalizzato.
È possibile denominare una funzione JavaScript definita altrove e utilizzarla per l'evento.
Specifica il nome del tipo di evento personalizzato, quindi configura le altre impostazioni come descritto in
Opzioni
, qua di seguito.
Elemento dati modificato
Attiva l'evento se un elemento dati specificato cambia.
Immetti il nome dell'elemento dati. Per selezionare l'elemento dati da un elenco, fai clic sull'icona e seleziona l'elemento dati.
Chiamata diretta
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 Launch esattamente ciò che sta accadendo. Inoltre, sono ideali quando Launch non è in grado di rilevare un evento nel DOM, ad esempio con Adobe Flash.
Specificate la stringa
_satellite.track
.
Presenza elemento
Attiva l'evento se è presente un elemento specificato.
Consulta la sezione
Opzioni
qui di seguito.
Immissione riquadro di visualizzazione
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.
Modifica cronologia
Attiva l'evento se si verifica un pushState o un hashchange.
Non sono disponibili impostazioni per questo tipo di evento.
Tempo trascorso sulla pagina
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.
Caricamento pagina
DOM Ready
Attiva quando il DOM è pronto e l'utente può interagire con la pagina
Non sono disponibili impostazioni per questo tipo di evento.
Libreria caricata (parte superiore della pagina)
Attiva l'evento non appena viene caricata la libreria Launch.
Non sono disponibili impostazioni per questo tipo di evento.
Page Bottom
Attiva l'evento una volta chiamato
_satellite.pageBottom();
. Quando si carica la libreria Launch in modo asincrono, questo tipo di evento non deve essere utilizzato.
Non sono disponibili impostazioni per questo tipo di evento.
Finestra caricata
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.
Opzioni
Ogni tipo di evento modulo utilizza le impostazioni seguenti:
Elementi specifici \| Qualsiasi elemento
- Se selezioni Specific Elements , vengono visualizzate le opzioni per selezionare gli elementi e i valori della proprietà.
- Se selezioni Any Element , non vi sono ulteriori opzioni necessarie per limitare gli elementi.
Elementi che corrispondono al selettore CSS
Inserisci il selettore CSS che identifica gli elementi che attivano l'evento.
Essendo presenti determinati valori delle proprietà
Se selezioni questa opzione, diventano disponibili i seguenti parametri:
- property=valueSpecifica il valore della proprietà
- RegexAttiva se property=value è un'espressione regolare.
- AggiungiAggiungi un'altra coppia property=value .
Opzioni avanzate (Bubbling)
- Esegui questa regola anche quando l'evento ha origine da un elemento discendente
- Consenti l'esecuzione di questa regola anche se l'evento ha già attivato una regola riferita a un elemento discendente
- Una volta eseguita la regola, impedisci all'evento di attivare elementi di targeting di regole
Tipi di condizione dell'estensione core
In questa sezione sono descritti i tipi di condizioni disponibili nell'estensione core.
Dati
Cookie
Specifica il nome e il valore del cookie che devono esistere affinché un evento attivi un'azione.
- Specifica un nome per il cookie.
- Inserisci il valore che deve esistere nel cookie se desideri che l'evento attivi un'azione.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
Rinuncia ai cookie
Specifica se l'utente ha rinunciato ai cookie.
Specifica se l'utente accetta i cookie.
Codice personalizzato
Specifica un codice personalizzato che deve esistere come condizione dell'evento. Utilizza l'editor di codice incorporato per inserire il codice personalizzato.
- Fai clic su Open Editor .
- Digita il codice personalizzato.
- Fai clic su Save .
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 comprese le informazioni disponibili, potrai utilizzarle per le decisioni programmate all'interno del codice personalizzato.
Confronto dei valori
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.
- Immetti un valore.
- Seleziona l'operatore. Per ulteriori dettagli, consulta l'elenco degli operatori di confronto dei valori.
- (Se necessario) Seleziona se il confronto deve non essere sensibile alle maiuscole/minuscole.
- Immetti un altro valore per il confronto.
Sono disponibili i seguenti operatori di confronto dei valori:
Uguale:
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.
Contiene:
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.
Non contiene:
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.
Inizia con:
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.
Non inizia con:
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.
Termina con:
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.
Non termina con:
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.
Corrisponde a 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.
Non corrisponde 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.
È minore di:
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.
È minore di o uguale a:
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.
È maggiore di:
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.
Maggiore di o uguale a:
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.
È 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.
È 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
.
È 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.
È 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
.
Variabile
Specifica il nome e il valore della variabile JavaScript esistenti affinché un evento attivi un'azione.
- Specifica il nome della variabile JavaScript.
- Specifica il valore della variabile che deve esistere come condizione per l'evento.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
Coinvolgimento
Pagina di destinazione
Specifica la pagina a cui l'utente deve accedere per attivare l'evento.
- Specifica la pagina di destinazione.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
Visitatore nuovo/di ritorno
Specifica se il visitatore deve essere un nuovo visitatore o un visitatore di ritorno per attivare un'azione.
Seleziona una delle seguenti opzioni:
- Nuovo visitatore
- Visitatore di ritorno
Visualizzazioni pagina
Configura il numero di volte in cui il visitatore deve visualizzare la pagina prima che l'azione venga attivata.
- Seleziona se il numero di visualizzazioni di pagina deve essere maggiore di, uguale o inferiore al valore specificato.
- Specifica il numero di visualizzazioni di pagina che determinano se la condizione è soddisfatta.
- Configura quando le visualizzazioni di pagina vengono conteggiate selezionando una delle seguenti opzioni:
- A vita
- Sessione corrente
Sessioni
Attiva l'azione se il numero di sessioni dell'utente soddisfa i criteri specificati.
- Seleziona se il numero di sessioni deve essere maggiore di, uguale o inferiore al valore specificato.
- Specifica il numero di sessioni che determinano se la condizione è soddisfatta.
Tempo sul sito
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.
- Seleziona se il numero di minuti sul sito deve essere maggiore di, uguale o inferiore al valore specificato.
- Specifica il numero di minuti che determinano se la condizione è soddisfatta.
Origine traffico
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.
- Specificate l'origine del traffico.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
Altro
Intervallo date
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.
Frequenza massima
Specifica il numero massimo di volte che la condizione restituisce true. Puoi scegliere una delle opzioni seguenti:
- Visualizzazione pagina
- Sessioni
- Visitatore
- Secondi
- Minuti
- Giorni
- Settimane
- Mesi
Campionamento
Specifica la percentuale di tempo restituita dalla condizione.
Tecnologia
Browser
Seleziona il browser che il visitatore deve usare per attivare l'azione.
Seleziona uno o più browser seguenti:
- Chrome
- Firefox
- Internet Explorer/Edge
- Internet Explorer Mobile
- Mobile Safari
- OmniWeb
- Opera
- Opera Mini
- Opera Mobile
- Safari
Tipo di dispositivo
Seleziona il tipo di dispositivo che il visitatore deve usare per attivare l'azione.
Seleziona uno o più dei seguenti tipi di dispositivi:
- Android
- Blackberry
- Desktop
- iPad
- iPhone
- iPod
- Nokia
- Windows Phone
Sistema operativo
Seleziona il sistema operativo che il visitatore deve utilizzare per attivare l'azione.
Seleziona uno o più dei seguenti sistemi operativi:
- Android
- Blackberry
- iOS
- Linux
- MacOS
- Maemo
- Symbian OS
- Unix
- Windows
Risoluzione dello schermo
Seleziona la risoluzione dello schermo che i visitatori devono usare sui propri dispositivi per attivare l'azione.
- Seleziona se la larghezza della risoluzione dello schermo del dispositivo del visitatore deve essere maggiore di, uguale o inferiore al valore specificato.
- Specifica il numero di pixel richiesti per la larghezza della risoluzione dello schermo.
- Seleziona se l'altezza della risoluzione dello schermo del dispositivo del visitatore deve essere maggiore di, uguale o inferiore al valore specificato.
- Specifica il numero di pixel necessari per l'altezza della risoluzione dello schermo.
Dimensioni finestra
Seleziona la dimensione della finestra che i visitatori devono usare sui propri dispositivi per attivare l'azione.
- Seleziona se la larghezza della finestra del dispositivo del visitatore deve essere maggiore di, uguale o inferiore al valore specificato.
- Specifica il numero di pixel richiesti per la larghezza della finestra.
- Seleziona se l'altezza della finestra del dispositivo del visitatore deve essere maggiore di, uguale o inferiore al valore specificato.
- Specifica il numero di pixel necessari per l'altezza della finestra.
URL
Dominio
Specifica il dominio del visitatore.
Hash
Specifica uno o più pattern di hash che devono esistere nell'URL.
I pattern di hash multipli sono collegati da un operatore OR.
- Specifica il pattern di hash.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
- Aggiungi altri pattern di hash.
Percorso
Specifica uno o più percorsi che devono esistere nell'URL.
Più percorsi sono collegati da un operatore OR.
- Specifica il percorso.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
- Aggiungi altri percorsi.
Protocollo
Specifica il protocollo utilizzato nell'URL.
Seleziona una delle seguenti opzioni:
- HTTP
- HTTPS
Sottodominio
Specifica uno o più domini che devono esistere nell'URL.
Più domini secondari sono collegati da un operatore OR.
- Specifica il sottodominio.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
- Aggiungi altri domini.
Parametro URL
Specifica il parametro URL utilizzato nell'URL.
- Specifica il nome di un parametro URL.
- Specifica il valore utilizzato per il parametro URL.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
Tipi di eccezioni dell'estensione core
In questa sezione sono descritti i tipi di eccezioni disponibili nell'estensione core.
Dati
Cookie
Specifica il nome e il valore dei cookie che non possono essere presenti secondo un evento per attivare un'azione.
- Specifica un nome per il cookie.
- Immetti il valore che non deve esistere nel cookie affinché l'evento attivi un'azione.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
Rinuncia ai cookie
Specifica se l'utente ha rinunciato ai cookie.
Specifica se l'utente accetta i cookie.
Codice personalizzato
Specifica un codice personalizzato che deve esistere come condizione dell'evento. Utilizza l'editor di codice incorporato per inserire il codice personalizzato.
- Fai clic su Open Editor .
- Digita il codice personalizzato.
- Fai clic su Save .
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 comprese le informazioni disponibili, potrai utilizzarle per le decisioni programmate all'interno del codice personalizzato.
Confronto dei valori
Confronta due valori per determinare se questa eccezione 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.
- Immetti un valore.
- Seleziona l'operatore. Per ulteriori dettagli, consulta l'elenco degli operatori di confronto dei valori.
- (Se necessario) Seleziona se il confronto deve non essere sensibile alle maiuscole/minuscole.
- Immetti un altro valore per il confronto.
Sono disponibili i seguenti operatori di confronto dei valori:
Uguale:
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.
Contiene:
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.
Non contiene:
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.
Inizia con:
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.
Non inizia con:
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.
Termina con:
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.
Non termina con:
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.
Corrisponde a 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.
Non corrisponde 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.
È minore di:
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.
È minore di o uguale a:
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.
È maggiore di:
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.
Maggiore di o uguale a:
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.
È 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.
È 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
.
È 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.
È 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
.
Variabile
Specifica il nome e il valore della variabile JavaScript che non devono esistere affinché un evento attivi un'azione.
- Specifica il nome della variabile JavaScript.
- Specifica il valore della variabile che non deve esistere come condizione per l'evento.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
Coinvolgimento
Pagina di destinazione
Specifica la pagina sulla quale l'utente non deve passare per attivare l'evento.
- Specifica la pagina di destinazione.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
Visitatore nuovo/di ritorno
Specifica se il visitatore non deve essere un nuovo visitatore o un visitatore di ritorno per attivare un'azione.
Seleziona una delle seguenti opzioni:
- Nuovo visitatore
- Visitatore di ritorno
Visualizzazioni pagina
Configura il numero di volte in cui il visitatore deve visualizzare la pagina per evitare che l'azione venga attivata.
- Seleziona se il numero di visualizzazioni di pagina deve essere maggiore di, uguale o inferiore al valore specificato.
- Specifica il numero di visualizzazioni di pagina che determinano se l'eccezione è soddisfatta.
- Configura quando le visualizzazioni di pagina vengono conteggiate selezionando una delle seguenti opzioni:
- A vita
- Sessione corrente
Sessioni
Non attivare l'azione se il numero di sessioni dell'utente soddisfa i criteri specificati.
- Seleziona se il numero di sessioni deve essere maggiore di, uguale o inferiore al valore specificato.
- Specifica il numero di sessioni che determinano se la condizione è soddisfatta.
Tempo sul sito
Configura per quanto tempo il visitatore deve trovarsi sul sito per evitare che l'azione venga attivata.
- Seleziona se il numero di minuti sul sito deve essere maggiore di, uguale o inferiore al valore specificato.
- Specifica il numero di minuti che determinano se la condizione è soddisfatta.
Origine traffico
Specifica l'origine del traffico del visitatore che deve essere true per impedire che l'azione venga attivata.
- Specificate l'origine del traffico.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
Altro
Intervallo date
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.
Frequenza massima
Specifica il numero massimo di volte che la condizione restituisce true. Puoi scegliere una delle opzioni seguenti:
- Visualizzazione pagina
- Sessioni
- Visitatore
- Secondi
- Minuti
- Giorni
- Settimane
- Mesi
Campionamento
Specifica la percentuale di tempo restituita dalla condizione.
Tecnologia
Browser
Seleziona il browser che il visitatore non deve usare per attivare l'azione.
Seleziona uno o più browser seguenti:
- Chrome
- Firefox
- Internet Explorer/Edge
- Internet Explorer Mobile
- Mobile Safari
- OmniWeb
- Opera
- Opera Mini
- Opera Mobile
- Safari
Tipo di dispositivo
Seleziona il tipo di dispositivo che il visitatore non deve usare per l'azione da attivare.
Seleziona uno o più dei seguenti tipi di dispositivi:
- Android
- Blackberry
- Desktop
- iPad
- iPhone
- iPod
- Nokia
- Windows Phone
Sistema operativo
Seleziona il sistema operativo che il visitatore non deve usare per attivare l'azione.
Seleziona uno o più dei seguenti sistemi operativi:
- Android
- Blackberry
- iOS
- Linux
- MacOS
- Maemo
- Symbian OS
- Unix
- Windows
Risoluzione dello schermo
Seleziona la risoluzione dello schermo che i visitatori non devono usare sui propri dispositivi per attivare l'azione.
- Seleziona se la larghezza della risoluzione dello schermo del dispositivo del visitatore deve essere maggiore di, uguale o inferiore al valore specificato.
- Specifica il numero di pixel richiesti per la larghezza della risoluzione dello schermo.
- Seleziona se l'altezza della risoluzione dello schermo del dispositivo del visitatore deve essere maggiore di, uguale o inferiore al valore specificato.
- Specifica il numero di pixel necessari per l'altezza della risoluzione dello schermo.
Dimensioni finestra
Seleziona le dimensioni della finestra che i visitatori non devono usare sui propri dispositivi per attivare l'azione.
- Seleziona se la larghezza della finestra del dispositivo del visitatore deve essere maggiore di, uguale o inferiore al valore specificato.
- Specifica il numero di pixel richiesti per la larghezza della finestra.
- Seleziona se l'altezza della finestra del dispositivo del visitatore deve essere maggiore di, uguale o inferiore al valore specificato.
- Specifica il numero di pixel necessari per l'altezza della finestra.
URL
Dominio
Specifica il dominio del visitatore che impedirà l'attivazione dell'azione.
Hash
Specifica uno o più pattern di hash che non devono essere presenti nell'URL.
I pattern di hash multipli sono collegati da un operatore OR.
- Specifica il pattern di hash.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
- Aggiungi altri pattern di hash.
Percorso
Specifica uno o più percorsi che non devono esistere nell'URL.
Più percorsi sono collegati da un operatore OR.
- Specifica il percorso.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
- Aggiungi altri percorsi.
Protocollo
Specifica il protocollo che non può essere utilizzato nell'URL.
Seleziona una delle seguenti opzioni:
- HTTP
- HTTPS
Sottodominio
Specifica uno o più domini secondari che non devono esistere nell'URL.
Più domini secondari sono collegati da un operatore OR.
- Specifica il sottodominio.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
- Aggiungi altri domini.
Parametro URL
Specifica il parametro URL che non può essere usato nell'URL.
- Specifica il nome di un parametro URL.
- Specifica il valore utilizzato per il parametro URL.
- (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
Tipi di azione dell'estensione core
In questa sezione sono descritti i tipi di azioni disponibili nell'estensione core.
Codice personalizzato
Fornisci il codice che viene eseguito dopo l'attivazione dell'evento e le condizioni vengono valutate.
- Denomina il codice dell'azione.
- Seleziona la lingua utilizzata per definire l'azione:
- JavaScript
- HTML
- Seleziona se eseguire il codice dell'azione a livello globale.
- Fai clic su Open editor.
- Modifica il codice, quindi fai clic su Salva.
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.
Elaborazione azione Codice personalizzato
Estensione core, disponibile per tutti gli utenti Launch, contiene un'azione Codice personalizzato 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 Codice personalizzato.
Regole che utilizzano gli eventi nella parte superiore o inferiore della pagina
Il codice da azioni personalizzate è incorporato nella libreria principale Launch. Il codice viene scritto nel documento utilizzando document.write. Se una regola include più azioni Codice personalizzato, il codice viene scritto nell'ordine configurato nella regola.
Regole che utilizzano un evento diverso dalla pagina superiore o dalla pagina inferiore
Un codice da azioni personalizzate viene caricato dal server e scritto sul documento utilizzando
Postscribe
. Se una regola include più azioni Codice personalizzato, 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 Codice personalizzato. Puoi utilizzare document.write nelle azioni Codice personalizzato indipendentemente da quando verrà eseguito il codice.
Convalida codice personalizzato
La convalida utilizzata nell'editor di codice di Launch è concepita per identificare i problemi con il codice scritto da sviluppatori. Un codice che ha superato un processo di contenimento (come il codice AppMeasurement.js scaricato da Code Manager) potrebbe essere segnalato come se avesse problemi con la convalida di Launch, che in genere può essere ignorata.
Tipi di elementi di dati dell'estensione core
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.
Cookie
A qualsiasi cookie di dominio può essere fatto riferimento nel campo del nome del cookie.
Esempio:
cookieName
Costante
Qualsiasi valore di stringa costante a cui è possibile fare riferimento in azioni o condizioni.
Esempio:
string
Codice personalizzato
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.
DOM attribute
Qualsiasi valore di elemento può essere recuperato, ad esempio un tag div o H1.
Esempio:
CSS Selector Chain:
id#dc logo img
Ottieni il valore di:
src
Variabile JavaScript
È 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 Launch per utilizzarli con le estensioni o le regole, uno dei modi per acquisire tali valori è utilizzare Data Elements in Launch. In questo modo, puoi fare riferimento a Data Element in tutte le tue regole e, se l'origine dei dati dovesse mai cambiare, devi solo modificare il riferimento all'origine (Data Element) in un'unica posizione in 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 il Data Element in 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
, o
digitalData.pageName
, ecc.
Esempio:
window.document.title
Archiviazione locale
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.
Informazioni pagina
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:
- URL
- Nome host
- Nome percorso
- Protocollo
- Referrer
- Titolo
Parametro stringa query
Specifica un parametro URL singolo nel campo URL Parameter.
È necessaria solo la sezione name ed eventuali designatori speciali come "?" o " =" devono essere omessi
Esempio:
contentType
Numero casuale
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:
- Generare un Hit ID
- Concatenare il numero a un token utente o a una marca temporale per garantire l'univocità
- Eseguire un hash unidirezionale sui dati PII
- Decidere in modo casuale quando visualizzare una richiesta sondaggio sul sito
Specifica i valori minimo e massimo per il numero casuale.
Valori predefiniti:
Minimo: 0
Massimo: 1000000000
Archiviazione sessione
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.
Comportamento dei visitatori
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:
- Pagina di destinazione
- Origine traffico
- Minuti sul sito
- Numero sessione
- Conteggio visualizzazione pagina sessione
- Conteggio visualizzazioni pagina a vita
- È un nuovo visitatore
Alcuni casi d'uso comuni includono:
- Mostra un sondaggio dopo che un visitatore è stato sul sito per cinque minuti
- Se si tratta della pagina di destinazione della visita, compila una metrica Analytics
- Mostra una nuova offerta al visitatore dopo X conteggi delle sessioni
- Visualizza una newsletter per la prima volta, se si tratta di un nuovo visitatore