Panoramica dell’estensione Core

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.

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

Tab Blur

Attiva l'azione quando una scheda perde lo stato attivo.

Non sono disponibili impostazioni per questo tipo di evento.

Tab Focus

Attiva l'azione quando una scheda diventa attiva.

Non sono disponibili impostazioni per questo tipo di evento.

Modulo

Blur

Attiva l'azione quando un modulo perde lo stato attivo.

Consulta la sezione Opzioni qui di seguito.

Focus

Attiva l'azione quando un modulo diventa attivo.

Consulta la sezione Opzioni qui di seguito.

Submit

Attiva l'azione quando viene inviato un modulo.

Consulta la sezione Opzioni qui di seguito.

Tastiera

Key Press

Attiva l'evento quando viene premuto un tasto.

Consulta la sezione Opzioni qui di seguito.

Media

Media Ended

Attiva l'evento al termine della riproduzione del contenuto multimediale.

Consulta la sezione Opzioni qui di seguito.

Media Loaded Data

Attiva l'evento quando i dati vengono caricati.

Consulta la sezione Opzioni qui di seguito.

Media Pause

Attiva l'evento quando il contenuto multimediale viene messo in pausa.

Consulta la sezione Opzioni qui di seguito.

Media Play

Attiva l'evento durante la riproduzione del contenuto multimediale.

Consulta la sezione Opzioni qui di seguito.

Media Stalled

Attiva l'evento se i contenuti multimediali si bloccano.

Consulta la sezione Opzioni qui di seguito.

Media Time Played

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.

Media Volume Changed

Attiva l'evento se il volume viene alzato o abbassato.

Consulta la sezione Opzioni qui di seguito.

Dispositivi mobili

Orientation Change

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.

Zoom Change

Attiva l'evento se l'utente utilizza la funzione zoom.

Non sono disponibili impostazioni per questo tipo di evento.

Mouse

Click

Attiva l'evento 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 collegamento (un tag <a>), 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.

Quando si utilizza il ritardo del collegamento, Platform Launch impedisce al browser di uscire dalla pagina, quindi 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. Platform Launch attenderà 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 abbastanza lungo per consentire il completamento di tutte le azioni della regola. I ritardi più lunghi forniscono più tempo per l’esecuzione delle regole, a scapito però dell’esperienza utente.

Inoltre, specifica che l'evento viene attivato dopo un periodo di tempo specificato.

Per opzioni avanzate, consulta Opzioni di seguito.

Hover

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

Custom Event

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.

Data Element Changed

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.

Direct Call

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.

Element Exists

Attiva l'evento se è presente un elemento specificato.

Consulta la sezione Opzioni qui di seguito.

Enters Viewport

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.

History Change

Attiva l'evento se si verifica un pushState o un hashchange.

Non sono disponibili impostazioni per questo tipo di evento.

Time Spent on Page

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.

Library Loaded (Page Top)

Attiva l’evento non appena viene caricata la libreria Platform 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 Platform Launch in modo asincrono, questo tipo di evento non deve essere utilizzato.

Non sono disponibili impostazioni per questo tipo di evento.

Window Loaded

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:

Specific Elements | Any Element

• Se scegli Elementi specifici, vengono visualizzate le opzioni per selezionare gli elementi e i valori della proprietà.
• Se scegli Qualsiasi elemento, non sono necessarie ulteriori opzioni per limitare gli elementi.

Elements matching the CSS selector

Inserisci il selettore CSS che identifica gli elementi che attivano l'evento.

And having certain property values

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.

Advanced options (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. Questi tipi di condizioni possono essere utilizzati con il tipo di logica regolare o d’eccezione.

Dati

Cookie

Specifica il nome e il valore del cookie che devono esistere affinché un evento attivi un'azione.

1. Specifica un nome per il cookie.
2. Inserisci il valore che deve esistere nel cookie se desideri che l'evento attivi un'azione.
3. (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.

Custom Code

Specifica un codice personalizzato che deve esistere come condizione dell'evento. Utilizza l'editor di codice incorporato per inserire il codice personalizzato.

1. Selezionare Apri editor.
2. Digita il codice personalizzato.
3. Seleziona Salva.

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);
});

Value Comparison

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.

1. Immetti un valore.
2. Seleziona l'operatore. Per ulteriori dettagli, consulta l'elenco degli operatori di confronto dei valori.
3. (Se necessario) Seleziona se il confronto deve non essere sensibile alle maiuscole/minuscole.
4. Immetti un altro valore per il confronto.

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.

Variable

Specifica il nome e il valore della variabile JavaScript esistenti affinché un evento attivi un'azione.

1. Specifica il nome della variabile JavaScript.
2. Specifica il valore della variabile che deve esistere come condizione per l'evento.
3. (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.

Coinvolgimento

Landing Page

Specifica la pagina a cui l'utente deve accedere per attivare l'evento.

1. Specifica la pagina di destinazione.
2. (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.

New/Returning Visitor

Specifica se il visitatore deve essere un nuovo visitatore o un visitatore di ritorno per attivare un'azione.

Seleziona una delle seguenti opzioni:

• New Visitor
• Returning Visitor

Page Views

Configura il numero di volte in cui il visitatore deve visualizzare la pagina prima che l'azione venga attivata.

1. Seleziona se il numero di visualizzazioni di pagina deve essere maggiore di, uguale o inferiore al valore specificato.
2. Specifica il numero di visualizzazioni di pagina che determinano se la condizione è soddisfatta.
3. Configura quando le visualizzazioni di pagina vengono conteggiate selezionando una delle seguenti opzioni:
   • Lifetime
   • Current Session

Sessions

Attiva l’azione se il numero di sessioni dell’utente soddisfa i criteri specificati.

1. Seleziona se il numero di sessioni deve essere maggiore di, uguale o inferiore al valore specificato.
2. Specifica il numero di sessioni che determinano se la condizione è soddisfatta.

Time On Site

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.

1. Seleziona se il numero di minuti sul sito deve essere maggiore di, uguale o inferiore al valore specificato.
2. Specifica il numero di minuti che determinano se la condizione è soddisfatta.

Traffic Source

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.

1. Specificate l'origine del traffico.
2. (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.

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

Device Type

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

Operating System

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

Screen Resolution

Seleziona la risoluzione dello schermo che i visitatori devono usare sui propri dispositivi per attivare l'azione.

1. Seleziona se la larghezza della risoluzione dello schermo del dispositivo dell’utente deve essere maggiore, uguale o inferiore rispetto al valore specificato.
2. Specifica il numero di pixel richiesti per la larghezza della risoluzione dello schermo.
3. Seleziona se l’altezza della risoluzione dello schermo del dispositivo dell’utente deve essere maggiore, uguale o inferiore rispetto al valore specificato.
4. Specifica il numero di pixel necessari per l'altezza della risoluzione dello schermo.

Window Size

Seleziona la dimensione della finestra che i visitatori devono usare sui propri dispositivi per attivare l'azione.

1. Seleziona se la larghezza della finestra del dispositivo dell’utente deve essere maggiore, uguale o inferiore rispetto al valore specificato.
2. Specifica il numero di pixel richiesti per la larghezza della finestra.
3. Seleziona se l’altezza della finestra del dispositivo dell’utente deve essere maggiore, uguale o inferiore rispetto al valore specificato.
4. Specifica il numero di pixel necessari per l'altezza della finestra.

URL

Domain

Specifica il dominio del visitatore.

Hash

Specifica uno o più pattern di hash che devono esistere nell'URL.

1. Specifica il pattern di hash.
2. (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
3. Aggiungi altri pattern di hash.

Path And Quest String

Specifica uno o più percorsi che devono esistere nell’URL. Questo include il percorso e la stringa query.

1. Specifica il percorso.
2. (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
3. Aggiungi altri percorsi.

Path Without Query String

Specifica uno o più percorsi che devono esistere nell’URL. Questo include il percorso ma non la stringa query.

1. Specifica il percorso.
2. (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
3. Aggiungi altri percorsi.

Protocol

Specifica il protocollo utilizzato nell'URL.

Seleziona una delle seguenti opzioni:

• HTTP
• HTTPS

Query String Parameter

Specifica il parametro URL utilizzato nell'URL.

1. Specifica il nome di un parametro URL.
2. Specifica il valore utilizzato per il parametro URL.
3. (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.

Subdomain

Specifica uno o più domini che devono esistere nell'URL.

1. Specifica il sottodominio.
2. (Facoltativo) Se si tratta di un'espressione regolare, abilita Regex.
3. Aggiungi altri domini.

Altro

Date Range

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.

Max Frequency

Specifica il numero massimo di volte che la condizione restituisce true. Puoi scegliere una delle opzioni seguenti:

• Page view
• Sessioni
• Visitor
• Seconds
• Minutes
• Days
• Weeks
• Months

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.

Sampling

Specifica la percentuale di tempo restituita dalla condizione.

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.

1. Denomina il codice dell'azione.
2. Seleziona la lingua utilizzata per definire l'azione:
   • JavaScript
   • HTML
3. Seleziona se eseguire il codice dell'azione a livello globale.
4. Selezionare Apri editor.
5. Modifica il codice, quindi seleziona 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 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.

Elaborazione azione Custom Code

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.

Regole che utilizzano gli eventi nella parte superiore o inferiore della pagina

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.

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 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.

Convalida Custom Code

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.

Sequenza delle azioni

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>

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

Custom Code

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 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.

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 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.

Esempio:

window.document.title

Local storage

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
• Hostname
• Pathname
• Protocollo
• Referrer
• Title

Query String Parameter

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

Session storage

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:

• Landing page
• Traffic source
• Minutes on site
• Session count
• Session page view count
• Lifetime page view count
• Is new visitor

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