Elementi dati

Gli elementi dati sono i blocchi costitutivi per il dizionario dati (o mappa dati). Utilizza elementi dati per raccogliere, organizzare e distribuire dati in tutta la tecnologia marketing e pubblicitaria.

Un singolo elemento dati è una variabile il cui valore può essere mappato alle stringhe di query, agli URL, ai valori dei cookie, alle variabili JavaScript e così via. Puoi fare riferimento a questo valore per mezzo del suo nome variabile attraverso Adobe Experience Platform. Questa raccolta di elementi dati diventa il dizionario dati definiti che è possibile utilizzare per creare le regole (eventi, condizioni e azioni). Questo dizionario dati viene condiviso tra diversi tag in modo che possa essere utilizzato con altre estensioni aggiunte alla proprietà.

Durante la creazione di regole è possibile utilizzare gli elementi dati il più possibile per consolidare la definizione dei dati dinamici e migliorare l'efficienza dei processi di gestione dei tag. Puoi definire le regole dati una volta e poi utilizzarle in più posizioni.

Il concetto di elementi dati riutilizzabili è molto potente e dovrebbe essere utilizzato come best practice.

Ad esempio, se usi un modo particolare per fare riferimento a nomi di pagina o ID prodotti, oppure per acquisire informazioni dai parametri delle stringhe query da un collegamento di affiliate marketing o da AdWords e così via, puoi creare un dizionario dati (elementi dati) ottenendo informazioni da origini diverse e quindi utilizzare tali dati in varie regole di tag.

Utilizzando il nome della pagina come esempio, supponi di utilizzare uno schema specifico per il nome della pagina facendo riferimento a un livello di dati, un elemento document.title o un tag titolo all'interno del sito Web. I tag in Adobe Experience Platform consentono di creare un elemento dati come singolo punto di riferimento per quel particolare punto di dati. Puoi quindi utilizzare questo elemento dati in qualsiasi regola che debba fare riferimento al nome della pagina. Se per qualche motivo decidi di cambiare il modo in cui si fa riferimento al nome della pagina (ad esempio, finora hai fatto riferimento a document.title, ma adesso vuoi farlo a un particolare livello di dati), non è necessario cambiare molte regole diverse per modificare tale riferimento. È sufficiente modificare il riferimento una volta nell'elemento dati e tutte le regole che fanno riferimento a tale elemento dati vengono aggiornate automaticamente.

Gli elementi dati sono compilati con dati quando sono utilizzati in regole o se vengono chiamati manualmente in uno script. A un livello avanzato:

Uso degli elementi dati

Nelle regole

Puoi utilizzare elementi dati nell'interfaccia di modifica delle regole utilizzando la casella di ricerca per trovare il nome dell'elemento dati.

Nello script personalizzato

Puoi utilizzare gli elementi dati negli script personalizzati utilizzando la sintassi dell'oggetto _satellite:

_satellite.getVar('data element name');

Creare un elemento dati create-a-data-element

Gli elementi dati sono i blocchi di creazione per le regole. Gli elementi dati consentono di creare un dizionario dati (o mappa dati) degli elementi comunemente utilizzati su una pagina, indipendentemente da dove si trovano (stringhe, URL o valori cookie) per qualsiasi oggetto contenuto sul sito.

Quando crei o modifichi elementi, puoi salvarli e generarli nella libreria attiva. In questo modo la tua libreria viene salvata immediatamente e viene eseguita una build. Viene visualizzato lo stato della build. Puoi anche creare una nuova libreria dal menu a discesa Libreria attiva.

Tipi di elementi dati types-of-data-elements

Nelle sezioni seguenti sono descritti i tipi di elementi dati disponibili in 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

Custom Code

Per inserire nell’interfaccia utente un codice JavaScript personalizzato, fai clic su Apri editor e inserisci il codice nella finestra dell’editor.

Nella finestra dell'editor è necessaria un'istruzione return per indicare quale valore deve essere impostato come valore dell'elemento dati. Se non è inclusa un’istruzione return, l’elemento dati viene risolto con undefined. In questo modo viene attivato il fallback per cercare un valore memorizzato e quindi un valore predefinito, qualora non sia presente alcun valore memorizzato.

Esempio:

var pageType = $('div.page-wrapper').attr('class').split('')[1];
if (window.location.pathname == '/') {
  return 'homepage';
} else {
  return pageType;
}

Il codice personalizzato può accettare l’oggetto event dalla regola chiamante come argomento. Il codice potrà quindi leggerne il valore.

Esempio:

// `event` is the default object provided by the rule
var eventType = event.$type;
return eventType; // if this data element is called from a "DOM Ready" event, then `core.dom-ready` is returned

Puoi utilizzarlo negli script personalizzati con la sintassi dell’oggetto _satellite:

// event refers to the calling rule's event
var rule = _satellite.getVar('return event rule', event);

Quando si utilizza la percentuale (%), è sufficiente specificare il nome dell’elemento dati. Non c’è bisogno di specificare event.

%data element name%

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 desideri raccogliere variabili JavaScript o proprietà di oggetto nel markup e utilizzarle con una delle tue estensioni o regole, puoi utilizzare elementi dati per acquisire questi valori. In questo modo, puoi fare riferimento all’elemento dati in tutte le tue regole e, se l’origine dei dati dovesse mai cambiare, devi modificare il riferimento all’origine (l’elemento dati) in un’unica posizione.

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, devi fornire 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

Local storage

Immetti il nome dell’elemento di archiviazione locale nel campo Nome elemento di archiviazione locale.

La memorizzazione locale offre ai browser un modo per memorizzare informazioni da pagina a pagina (https://www.w3schools.com/html/html5_webstorage.asp). L’archiviazione 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

Utilizza questi punti dati per acquisire informazioni di pagina da utilizzare nella logica della regola o per inviare informazioni a Analytics sistemi di tracciamento esterni.

Puoi selezionare uno dei seguenti attributi di pagina da utilizzare nell'elemento dati:

Query String Parameter

Specifica un parametro URL singolo nel campo Parametro URL.

È 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. Viene spesso utilizzato per campionare dati o creare ID, ad esempio un Hit ID. Il numero casuale può essere usato per oscurare o alterare i dati sensibili. Alcuni esempi possono includere:

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 Nome elemento di archiviazione sessione

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 altre soluzioni Platform.

Seleziona uno dei seguenti attributi di comportamento dei visitatori:

Alcuni casi d'uso comuni includono:

Elementi dati incorporati

Devi creare elementi dati personalizzati aggiuntivi se in precedenza hai utilizzato uno dei seguenti elementi dati: