Dataelement

Dataelement är byggstenarna för dataordlistan (eller datamappningen). Använd dataelement för att samla in, ordna och leverera data över marknadsförings- och annonseringsteknologier.

Ett enskilt dataelement är en variabel vars värde kan mappas till frågesträngar, URL:er, cookie-värden, JavaScript-variabler osv. Du kan referera till det här värdet genom dess variabelnamn i hela Adobe Experience Platform. Den här samlingen dataelement blir en ordbok med definierade data som du kan använda för att skapa regler (händelser, villkor och åtgärder). Den här dataordlistan delas mellan taggar och kan användas med alla tillägg som du har lagt till i egenskapen.

Använd dataelement i så stor omfattning som möjligt genom hela regelskapandet för att konsolidera definitionen av dynamiska data och förbättra effektiviteten i taggningsprocessen. Du definierar dataregler en gång och använder dem sedan på flera ställen.

Begreppet återanvändbara dataelement är mycket kraftfullt och du bör använda dem som bästa praxis.

Om det till exempel finns ett visst sätt att referera till sidnamn eller produkt-ID:n eller hämta information från frågesträngsparametrar från en filialmarknadsföringslänk eller från AdWords och så vidare, kan du skapa en dataordlista (dataelement) genom att hämta information från dess källa och sedan använda dessa data i olika taggregler.

Anta att du använder ett visst sidnamn som exempel genom att referera till ett datalager, document.title-element eller en rubriktagg på webbplatsen. Med taggar i Adobe Experience Platform kan du skapa ett dataelement som en enda referenspunkt för den aktuella datapunkten. Du kan sedan använda det här dataelementet i alla regler som behöver referera till sidnamnet. Om du av någon anledning i framtiden bestämmer dig för att ändra sättet som du refererar till sidnamnet (du har t.ex. refererat till document.title men nu vill referera till ett visst datalager), behöver du inte redigera många olika regler för att ändra den referensen. Du ändrar bara referensen en gång i dataelementet och alla regler som refererar till det dataelementet uppdateras automatiskt.

Dataelement fylls i med data när de används i regler eller när de anropas manuellt i ett skript. På en hög nivå:

Användning av dataelement

I regler

Du kan använda dataelement i redigeringsgränssnittet för regler genom att använda sökrutan för att hitta dataelementets namn.

I anpassat skript

Du kan använda dataelement i egna skript med objektsyntaxen _satellite:

_satellite.getVar('data element name');

Skapa ett dataelement create-a-data-element

Dataelement är byggstenarna för regler. Med dataelement kan du skapa ett datalexikon (eller datamappning) med vanliga objekt på en sida, oavsett varifrån de kommer (frågesträngar, URL:er eller cookie-värden) för alla objekt som finns på webbplatsen.

När du skapar eller redigerar element kan du spara och skapa i ditt aktiva bibliotek. Ändringen sparas omedelbart i biblioteket och en bygge körs. Byggets status visas. Du kan också skapa ett nytt bibliotek från listrutan Active Library.

Typer av dataelement types-of-data-elements

I följande avsnitt beskrivs de typer av dataelement som är tillgängliga i Core-tillägget. Andra tillägg använder andra typer av dataelement.

Cookie

Alla tillgängliga domäncookies kan refereras i fältet för cookie-namn.

Exempel:

cookieName

Egen kod

Du kan ange anpassade JavaScript-filer i användargränssnittet genom att markera Open Editor och infoga kod i redigeringsfönstret.

En return-programsats krävs i redigeringsfönstret för att ange vilket värde som ska anges som dataelementvärde. Om ingen retursats ingår tolkas dataelementet till undefined. Detta utlöser reservkontrollen för att leta efter ett lagrat värde och sedan ett standardvärde om det inte finns något lagrat värde.

Exempel:

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

Anpassad kod kan acceptera objektet event från anropsregeln som ett argument. Detta gör att koden kan läsa värdet där.

Exempel:

// `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

Du kan sedan använda detta i egna skript med objektsyntaxen _satellite:

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

När du använder procentsyntax (%) behöver du bara ange dataelementets namn. Du behöver inte ange event.

%data element name%

DOM-attribut

Alla elementvärden kan hämtas, till exempel en div- eller H1-tagg.

Exempel:

CSS-väljarkedja:

id#dc logo img

Hämta värdet för:

src

JavaScript-variabel

Alla tillgängliga JavaScript-objekt eller -variabler kan refereras med sökvägsfältet.

Om du vill samla in JavaScript-variabler eller objektegenskaper i koden och använda dem med något av dina tillägg eller regler, kan dataelement användas för att hämta dessa värden. På så sätt kan du referera till dataelementet i alla regler, och om datakällan ändras behöver du bara ändra referensen till källan (dataelementet) på ett ställe.

Anta att din kod innehåller en JavaScript-variabel som heter Page_Name, så här:

<script>
  //data layer
  var Page_Name = "Homepage"
</script>

Du måste ange sökvägen till variabeln när du skapar dataelementet.

Om du använder ett datainsamlarobjekt som en del av datalagret använder du bara punktnotation i sökvägen för att referera till objektet och egenskapen som du vill hämta till dataelementet, till exempel _myData.pageName eller digitalData.pageName.

Exempel:

window.document.title

Lokal lagring

Ange namnet på ditt lokala lagringsobjekt i fältet Local Storage Item Name.

Med hjälp av det lokala lagringsutrymmet kan webbläsare lagra information från sida till sida (https://www.w3schools.com/html/html5_webstorage.asp). Lokal lagring fungerar mycket som cookies, men är mycket större och mer flexibel.

Använd det angivna fältet för att ange värdet som du skapade för ett lokalt lagringsobjekt, till exempel lastProductViewed.

Sidinformation

Använd dessa datapunkter för att hämta sidinformation som kan användas i regellogiken eller för att skicka information till Analytics eller externa spårningssystem.

Du kan välja något av följande sidattribut som ska användas i dataelementet:

Frågesträngsparameter

Ange en enda URL-parameter i fältet URL Parameter.

Endast namnavsnittet är nödvändigt och alla specialdesigners som "?" eller "=" ska utelämnas

Exempel:

contentType

Slumpmässigt tal

Använd det här dataelementet för att generera ett slumpmässigt tal. Det används ofta för att ta prov på data eller skapa ID:n, till exempel ett träff-ID. Det slumpmässiga talet kan också användas för att dölja eller salta känsliga data. Exempel:

Ange minimi- och maximivärden för det slumpmässiga talet.

Standardvärden:

Minst: 0

Maximum: 100000000

Sessionslagring

Ange namnet på sessionslagringsobjektet i fältet Session Storage Item Name.

Sessionslagring liknar lokal lagring, förutom att data tas bort efter att sessionen har avslutats, medan lokala lager eller en cookie kan behålla data.

Beteende för besökare

På liknande sätt som i Sidinformation använder det här dataelementet vanliga beteendetyper för att utöka logiken i regler eller andra plattformslösningar.

Välj ett av följande attribut för besökarbeteende:

Några vanliga användningsområden:

Inbyggda dataelement

Du måste skapa ytterligare anpassade dataelement om du tidigare har använt något av följande dataelement: