Översikt över Core Extension
Core-taggtillägget är standardtillägget som släpps med Adobe Experience Platform.
Det här dokumentet innehåller information om de alternativ som är tillgängliga när du använder Core-tillägget för att skapa en regel.
Huvudtilläggshändelsetyper core-extension-event-types
I det här avsnittet beskrivs de händelsetyper som är tillgängliga i Core-tillägget. Mer information om alternativen som kan anges för flera olika händelsetyper finns i avsnittet Alternativ .
Webbläsarbaserade händelser
Tabboskärpa
Händelsen tab-blur utlöser åtgärden när en flik förlorar fokus. Det finns inga inställningar för den här händelsetypen.
Flikfokus
Händelsen tab-focus utlöser åtgärden när en flik får fokus. Det finns inga inställningar för den här händelsetypen.
Formulär
Oskärpa
Oskärpehändelsen utlöser åtgärden när ett formulär förlorar fokus. Mer information om anpassningsbara händelseinställningar finns i avsnittet Alternativ .
Fokus
Fokushändelsen utlöser åtgärden när ett formulär får fokus. Mer information om anpassningsbara händelseinställningar finns i avsnittet Alternativ .
Skicka
Skicka-händelsen utlöser åtgärden när ett formulär skickas. Mer information om anpassningsbara händelseinställningar finns i avsnittet Alternativ .
Tangentbordskontrollerade händelser
Tryck på tangenten
Händelsen utlöses när en tangent trycks ned. Mer information om anpassningsbara händelseinställningar finns i avsnittet Alternativ .
Mediebaserade händelser
Media avslutad
Händelsen utlöses när mediet avslutas. Mer information om anpassningsbara händelseinställningar finns i avsnittet Alternativ .
Medieladdade data
Händelsen utlöses när mediet läser in data. Mer information om anpassningsbara händelseinställningar finns i avsnittet Alternativ .
Pausa media
Händelsen utlöses när mediet pausas. Mer information om anpassningsbara händelseinställningar finns i avsnittet Alternativ .
Media Play
Händelsen utlöses när mediet spelas upp. Mer information om anpassningsbara händelseinställningar finns i avsnittet Alternativ .
Media är installerade
Händelsen utlöses om mediet stannar. Mer information om anpassningsbara händelseinställningar finns i avsnittet Alternativ .
Media-Time Play
Händelsen utlöses om mediet spelas upp under en viss tid. Du måste ange hur länge mediet måste spelas upp för att händelsen ska kunna utlösas. Mer information om anpassningsbara händelseinställningar finns i avsnittet Alternativ .
Media-Volume har ändrats
Händelsen utlöses om volymen höjs eller sänks. Mer information om anpassningsbara händelseinställningar finns i avsnittet Alternativ .
Mobilorienterade händelser
Orienteringsändring
Händelsen utlöses om enhetens orientering ändras. Du måste ange hur länge orienteringen måste ändras för att händelsen ska kunna utlösas. Det finns inga inställningar för den här händelsetypen.
Zoomändring
Händelsen utlöses om användaren zoomar in eller ut. Det finns inga inställningar för den här händelsetypen.
Musstyrda händelser
Klicka på
Händelsen utlöses om det angivna elementet är markerat (klickat). Du kan också ange egenskapsvärden som måste vara true för elementet innan händelsen aktiveras.
Om elementet är en ankartagg (<a>
) för länkat innehåll kan du även ange om navigeringen ska fördröjas under en tidsperiod. Detta kan vara användbart om regeln kräver extra tid för att köras och vanligtvis inte skulle slutföras innan sidnavigeringen utförs.
När du använder fördröjning av länkar förhindrar Plattform faktiskt webbläsaren från att navigera utanför sidan. Därefter omdirigeras JavaScript till det ursprungliga målet efter den angivna tidsgränsen. Detta är särskilt farligt när sidmarkeringen har <a>
-taggar där den avsedda funktionen inte navigerar användaren från sidan. Om du inte kan lösa problemet på något annat sätt bör du vara mycket exakt med väljardefinitionen så att den här händelsen utlöses exakt där du behöver den och inte någon annanstans.
Standardvärdet för fördröjning av länkar är 100 millisekunder. Observera att taggar alltid väntar på den angivna tiden och inte är kopplade till körningen av regelns åtgärder på något sätt. Det är möjligt att fördröjningen tvingar användaren att vänta längre än nödvändigt och även att fördröjningen inte är tillräckligt lång för att alla regelåtgärder ska kunna slutföras. Längre fördröjningar ger mer tid för regelkörning men försämrar även användarupplevelsen.
För att aktivera fördröjningen måste du ange både det valda elementet som utlöser händelsen och den specifika tiden innan händelsen utlöses.
Avsnittet Alternativ innehåller mer information om de avancerade alternativen.
Hovra
Händelsen utlöses om användaren hovrar över ett angivet element. Du måste också konfigurera om regeln aktiveras omedelbart eller efter ett visst antal millisekunder. Mer information om anpassningsbara händelseinställningar finns i avsnittet Alternativ .
Andra händelser
Egen händelse
Händelsen utlöses om en anpassad händelsetyp inträffar. Namngivna JavaScript-funktioner som definieras någon annanstans i kodbasen kan användas som en anpassad händelsetyp. Du måste ange namnet på den anpassade händelsetypen och konfigurera eventuella andra inställningar enligt beskrivningen i avsnittet Alternativ nedan.
Dataelement ändrat
Händelsen utlöses om ett angivet dataelement ändras. Du måste ange ett namn för dataelementet. Du kan markera dataelementet genom att antingen skriva dess namn i textfältet eller genom att markera dataelementsikonen till höger om textfältet och välja i en lista som finns i dialogrutan som visas.
Direktsamtal direct-call-event
En direktanropshändelse kringgår system för händelsidentifiering och sökning. Regler för direktsamtal är idealiska för situationer där du vill tala om för systemet exakt vad som händer. De är också idealiska när systemet inte kan identifiera någon händelse i DOM.
När du definierar en direktanropshändelse måste du ange en sträng som ska fungera som händelseidentifierare. Om en utlösande direktanropsåtgärd som innehåller samma identifierare utlöses, kommer alla regler för direktanropshändelser som lyssnar efter den identifieraren att köras.
Elementet finns
Händelsen utlöses om ett angivet element finns. Mer information om anpassningsbara händelseinställningar finns i avsnittet Alternativ .
Enters Viewport
Händelsen utlöses om användaren anger en angiven visningsruta. Du måste ange en CSS-väljare som ett villkor för att kunna ange matchande element som mål. Du måste också konfigurera om regeln aktiveras omedelbart eller efter ett visst antal millisekunder, och om händelsen ska utlösas varje gång händelsen inträffar eller endast första gången.
Mer information om anpassningsbara händelseinställningar finns i avsnittet Alternativ .
Historikändring
Händelsen utlöses om en pushState- eller hashchange-händelse inträffar. Det finns inga inställningar för den här händelsetypen.
Tidsåtgång på sidan
Händelsen utlöses om användaren finns kvar på sidan under ett visst antal sekunder. Du måste ange hur många sekunder som måste skickas innan händelsen aktiveras.
Sidladdningshändelser
DOM-klart
Händelsen utlöses när DOM är klar och användaren kan interagera med sidan. Det finns inga inställningar för den här händelsetypen.
Bibliotek inläst (sidan ovanpå) library-loaded-page-top
Händelsen utlöses så snart som taggbiblioteket har lästs in. Det finns inga inställningar för den här händelsetypen.
Sidan nederst page-bottom
Händelseutlösarna när _satellite.pageBottom();
har anropats. När du läser in taggbiblioteket asynkront bör den här händelsetypen inte användas. Det finns inga inställningar för den här händelsetypen.
Fönster inläst
Händelsen utlöses när onLoad anropas av webbläsaren och sidan har lästs in. Det finns inga inställningar för den här händelsetypen.
Alternativ options
Var och en av formulärhändelsetyperna använder följande inställningar:
Specifika element | Alla element
- Om du väljer Specific Elements visas alternativen för att välja element och egenskapsvärden.
- Om du väljer Any Element behövs inga fler alternativ för att begränsa elementen.
Element som matchar CSS-väljaren
Ange CSS-väljaren som identifierar elementen som utlöser händelsen.
Och har vissa egenskapsvärden
Om du väljer det här alternativet blir följande parametrar tillgängliga:
-
property=value
Ange värdet för egenskapen
-
Regex
Aktivera om
property=value
är ett vanligt uttryck. -
Lägg till
Lägg till ytterligare ett
property=value
-par.
Avancerade alternativ (Bubbling)
- Kör den här regeln även när händelsen kommer från ett underordnat element
- Tillåt att den här regeln körs även om händelsen redan har utlöst en regel som riktar sig till ett underordnat element
- När regeln har körts kan du förhindra att händelsen utlöser regler som riktar sig mot överordnade element
Villkorstyper för kärntillägg
I det här avsnittet beskrivs de villkorstyper som finns i Core-tillägget. Dessa villkorstyper kan användas med antingen den vanliga typen eller undantagstypen av logik.
Data
Cookie
Ange det cookie-namn och värde som måste finnas för att en händelse ska kunna utlösa en åtgärd.
- Ange ett cookie-namn.
- Ange det värde som måste finnas i cookien om händelsen ska utlösa en åtgärd.
- (Valfritt) Aktivera Regex om det här är ett reguljärt uttryck.
Egen kod
Ange eventuell anpassad kod som måste finnas som villkor för händelsen.
Använd den inbyggda kodredigeraren för att ange egen kod:
- Välj Open Editor.
- Skriv den anpassade koden.
- Välj Save.
En variabel med namnet event
blir automatiskt tillgänglig, som du kan referera till inifrån din anpassade kod. Objektet event
innehåller användbar information om händelsen som utlöste regeln. Det enklaste sättet att avgöra vilka händelsedata som är tillgängliga är att logga event
till konsolen inifrån din anpassade kod:
console.log(event);
return true;
Kör regeln i en webbläsare och inspektera det loggade händelseobjektet i webbläsarens konsol. När du förstår vilken information som är tillgänglig kan du använda den för programmatisk beslutsfattande i din anpassade kod.
Villkorssekvenser
När alternativet Kör regelkomponenter i sekvens från egenskapsinställningarna är aktiverat kan efterföljande regelkomponenter vänta medan villkoret utför en asynkron åtgärd.
När villkoret returnerar ett löfte kommer nästa villkor i regeln inte att köras förrän det returnerade löftet har lösts. Om löftet avvisas anser taggarna att villkoret är misslyckat och inga ytterligare villkor eller åtgärder från den regeln kommer att utföras.
Ett exempel på ett villkor som returnerar ett löfte:
return new Promise(function(resolve, reject) {
setTimeout(function() {
if (new Date().getDay() === 5) {
resolve();
} else {
reject();
}
}, 1000);
});
Värdejämförelse value-comparison
Jämför två värden för att avgöra om villkoret returnerar true.
Om du har en regel med flera villkor är det möjligt att det här villkoret returnerar true, men regeln utlöses inte eftersom de andra villkoren utvärderas som false eller ett av undantagen utvärderas som sant.
- Ange ett värde.
- Markera operatorn. Mer information finns i listan över operatorer för värdejämförelse nedan.
- (Om det behövs) Välj om jämförelsen ska vara skiftlägeskänslig.
- Ange ett annat värde för jämförelsen.
Följande värdejämförelseoperatorer är tillgängliga:
Lika: Villkoret returnerar true om de två värdena är lika med en icke-strikt jämförelse (i JavaScript ==-operatorn). Värdena kan vara av alla typer. När du skriver ett ord som true, false, null eller undefined i ett värdefält jämförs ordet som en sträng och konverteras inte till sin JavaScript-motsvarighet.
Är inte lika med: Villkoret returnerar true om de två värdena inte är lika med en icke-strikt jämförelse (i JavaScript returneras != operator). Värdena kan vara av alla typer. När du skriver ett ord som true, false, null eller undefined i ett värdefält jämförs ordet som en sträng och konverteras inte till sin JavaScript-motsvarighet.
Innehåller: Villkoret returnerar true om det första värdet innehåller det andra värdet. Tal konverteras till strängar. Alla värden utom ett tal eller en sträng resulterar i att villkoret returnerar false.
Innehåller inte: Villkoret returnerar true om det första värdet inte innehåller det andra värdet. Tal konverteras till strängar. Alla värden förutom tal och strängar resulterar i att villkoret returnerar true.
Börjar med: Villkoret returnerar true om det första värdet börjar med det andra värdet. Tal konverteras till strängar. Alla värden utom ett tal eller en sträng resulterar i att villkoret returnerar false.
Börjar inte med: Villkoret returnerar true om det första värdet inte börjar med det andra värdet. Tal konverteras till strängar. Alla värden utom ett tal eller en sträng resulterar i att villkoret returnerar true.
Slutar med: Villkoret returnerar true om det första värdet slutar med det andra värdet. Tal konverteras till strängar. Alla värden utom ett tal eller en sträng resulterar i att villkoret returnerar false.
Slutar inte med: Villkoret returnerar true om det första värdet inte slutar med det andra värdet. Tal konverteras till strängar. Alla värden utom ett tal eller en sträng resulterar i att villkoret returnerar true.
Matchar Regex: Villkoret returnerar true om det första värdet matchar det reguljära uttrycket. Tal konverteras till strängar. Alla värden utom ett tal eller en sträng resulterar i att villkoret returnerar false.
Matchar inte Regex: Villkoret returnerar true om det första värdet inte matchar det reguljära uttrycket. Tal konverteras till strängar. Alla värden utom ett tal eller en sträng resulterar i att villkoret returnerar true.
Är mindre än: Villkoret returnerar true om det första värdet är mindre än det andra värdet. Strängar som representerar tal konverteras till tal. Alla värden utom ett tal eller en konvertibel sträng resulterar i att villkoret returnerar false.
Är mindre än eller lika med: Villkoret returnerar true om det första värdet är mindre än eller lika med det andra värdet. Strängar som representerar tal konverteras till tal. Alla värden utom ett tal eller en konvertibel sträng resulterar i att villkoret returnerar false.
Är större än: Villkoret returnerar true om det första värdet är större än det andra värdet. Strängar som representerar tal konverteras till tal. Alla värden utom ett tal eller en konvertibel sträng resulterar i att villkoret returnerar false.
Är större än eller lika med: Villkoret returnerar true om det första värdet är större än eller lika med det andra värdet. Strängar som representerar tal konverteras till tal. Alla värden utom ett tal eller en konvertibel sträng resulterar i att villkoret returnerar false.
Är sant: Villkoret returnerar true om värdet är booleskt och har värdet true. Värdet som du anger konverteras inte till ett booleskt värde om det är någon annan typ. Alla värden utom ett booleskt värde med värdet true returnerar villkoret false.
Är sann: Villkoret returnerar true om värdet är true efter att det har konverterats till ett booleskt värde. Se MDN:s sanna dokumentation för exempel på sanna värden.
Är falskt: Villkoret returnerar true om värdet är booleskt och har värdet false. Värdet som du anger konverteras inte till ett booleskt värde om det är någon annan typ. Alla värden utom ett booleskt värde med värdet false resulterar i att villkoret returnerar false.
Är falskt: Villkoret returnerar true om värdet är false efter att det har konverterats till ett booleskt värde. Se MDN:s Falsy-dokumentation för exempel på felaktiga värden.
Variabel
Ange det JavaScript-variabelnamn och -värde som måste finnas för att en händelse ska kunna utlösa en åtgärd.
- Ange variabelnamnet för JavaScript.
- Ange det variabelvärde som måste finnas som villkor för händelsen.
- (Valfritt) Aktivera Regex om det här är ett reguljärt uttryck.
Engagemang
Landningssida
Ange den sida som användaren måste logga in på för att utlösa händelsen.
- Ange landningssidan.
- (Valfritt) Aktivera Regex om det här är ett reguljärt uttryck.
Ny/återkommande besökare
Ange om besökaren ska vara en ny besökare eller en återkommande besökare för en händelse som ska utlösa en åtgärd.
Välj något av följande:
- Ny besökare
- Returnerande besökare
Sidvyer
Konfigurera det antal gånger besökaren måste visa sidan innan åtgärden aktiveras.
-
Välj om antalet sidvyer måste vara större än, lika med eller mindre än det angivna värdet.
-
Ange antalet sidvisningar som avgör om villkoret är uppfyllt eller inte.
-
Konfigurera när sidvyerna ska räknas genom att välja något av följande:
- Livstid
- Aktuell session
Sessioner
Utlös åtgärden om användarens antal sessioner uppfyller de angivna villkoren.
- Välj om antalet sessioner måste vara större än, lika med eller mindre än det angivna värdet.
- Ange antalet sessioner som avgör om villkoret är uppfyllt eller inte.
Tid på plats
Utlös åtgärden om användarens antal sessioner uppfyller de angivna villkoren.
Konfigurera hur länge besökaren måste vara på platsen innan åtgärden aktiveras.
- Ange om antalet minuter som besökaren finns på platsen måste vara större än, lika med eller mindre än det angivna värdet.
- Ange antalet minuter som avgör om villkoret är uppfyllt.
Traffic Source
Utlös åtgärden om användarens antal sessioner uppfyller de angivna villkoren.
Ange källan för besökarens trafik som måste vara true för att åtgärden ska aktiveras.
- Ange trafikkällan.
- (Valfritt) Aktivera Regex om det här är ett reguljärt uttryck.
Teknik
Webbläsare
Välj den webbläsare som besökaren måste använda för att åtgärden ska aktiveras.
Välj en eller flera av följande webbläsare:
- Chrome
- Firefox
- Internet Explorer/Edge
- Internet Explorer Mobile
- Mobile Safari
- OmniWeb
- Opera
- Opera Mini
- Opera Mobile
- Safari
Enhetstyp
Välj den enhetstyp som besökaren måste använda för att åtgärden ska aktiveras.
Välj en eller flera av följande enhetstyper:
- Android
- Blackberry
- Skrivbord
- iPad
- iPhone
- iPod
- Nokia
- Windows Phone
Operativsystem
Välj det operativsystem som besökaren måste använda för att åtgärden ska aktiveras.
Välj ett eller flera av följande operativsystem:
- Android
- Blackberry
- iOS
- Linux
- MacOS
- Maemo
- Symbian OS
- Unix
- Windows
Skärmupplösning
Välj den skärmupplösning besökarna måste använda på sina enheter för att åtgärden ska aktiveras.
- Välj om skärmupplösningsbredden för besökarens enhet måste vara större än, lika med eller mindre än det angivna värdet.
- Ange antalet pixlar som krävs för skärmupplösningens bredd.
- Välj om skärmupplösningshöjden för besökarens enhet måste vara större än, lika med eller mindre än det angivna värdet.
- Ange antalet pixlar som krävs för skärmupplösningshöjden.
Fönsterstorlek
Välj den fönsterstorlek besökarna måste använda på sina enheter för att åtgärden ska aktiveras.
- Välj om fönsterstorleksbredden för besökarens enhet måste vara större än, lika med eller mindre än det angivna värdet.
- Ange antalet pixlar som krävs för fönstrets storleksbredd.
- Välj om fönsterstorlekshöjden för besökarens enhet måste vara större än, lika med eller mindre än det angivna värdet.
- Ange antalet pixlar som krävs för fönstrets storlekshöjd.
URL
Domän
Ange besökarens domän.
Hash
Ange ett eller flera hash-mönster som måste finnas i URL:en.
- Ange hash-mönstret.
- (Valfritt) Aktivera Regex om det här är ett reguljärt uttryck.
- Lägg till andra hash-mönster.
Sökväg och frågesträng
Ange en eller flera sökvägar som måste finnas i URL:en. Detta inkluderar sökvägen och frågesträngen.
- Ange sökvägen.
- (Valfritt) Aktivera Regex om det här är ett reguljärt uttryck.
- Lägg till andra sökvägar.
Sökväg utan frågesträng
Ange en eller flera sökvägar som måste finnas i URL:en. Detta inkluderar sökvägen, men inkluderar inte frågesträngen.
- Ange sökvägen.
- (Valfritt) Aktivera Regex om det här är ett reguljärt uttryck.
- Lägg till andra sökvägar.
Protokoll
Ange det protokoll som används i URL:en.
Välj något av följande:
- HTTP
- HTTPS
Frågesträngsparameter
Ange URL-parametern som används i URL:en.
- Ange ett URL-parameternamn.
- Ange det värde som används för URL-parametern.
- (Valfritt) Aktivera Regex om det här är ett reguljärt uttryck.
Underdomän
Ange en eller flera underdomäner som måste finnas i URL:en.
- Ange underdomänen.
- (Valfritt) Aktivera Regex om det här är ett reguljärt uttryck.
- Lägg till andra underdomäner.
Övriga
Datumintervall
Ange ett datumintervall. Välj det datum och den tidpunkt som händelsen inträffar efter, det datum den inträffar före och tidszonen.
Maximal frekvens
Ange det maximala antalet gånger som villkoret returnerar true. Du kan välja mellan följande alternativ:
- Sidvy
- Sessioner
- Besökare
- Sekunder
- Minuter
- Dagar
- Veckor
- Månader
För villkorets maximala frekvens 1 per session jämförs dessa två localStorage
objekt. Om visitorTracking.sessionCount
är större än antalet maxFrequency.session
är samplingsvillkoret sant. Om de är lika är villkoret false.
sessionCount
är ett visitorTracking
-objekt, så du måste aktivera besökar-API:t för att samplingsvillkoret ska fungera.
Provtagning
Ange hur många procent av tiden som villkoret returnerar true.
Åtgärdstyper för kärntillägg
I det här avsnittet beskrivs de åtgärdstyper som finns i Core-tillägget.
Egen kod
Ange koden som körs när händelsen har utlösts och villkoren utvärderas.
-
Namnge åtgärdskoden.
-
Välj det språk som ska användas för att definiera åtgärden:
- JavaScript
- HTML
-
Välj om åtgärdskoden ska köras globalt.
-
Välj Open Editor.
-
Redigera koden och välj sedan Save.
När JavaScript väljs som språk blir variabeln event
automatiskt tillgänglig, som du kan referera till inifrån din anpassade kod. Objektet event
innehåller användbar information om händelsen som utlöste regeln. Det enklaste sättet att avgöra vilka händelsedata som är tillgängliga är att logga event
till konsolen inifrån din anpassade kod:
console.log(event);
Kör regeln i en webbläsare och inspektera det loggade händelseobjektet i webbläsarens konsol. När du har förstått vilken information som är tillgänglig kan du använda den för programmatisk beslutsfattande i din anpassade kod, skicka en del av event
-objektet till en server och så vidare.
Bearbetning av anpassad kodåtgärd
Tillägget Core, som är tillgängligt för alla Adobe Experience Platform-användare, innehåller en anpassad kodsåtgärd för att köra JavaScript eller HTML som tillhandahålls av användare. Det är ofta användbart för användare att förstå hur regler med anpassade kodåtgärder behandlas.
Regler som använder händelserna top eller page bottom
Kod från anpassade åtgärder bäddas in i huvudtaggbiblioteket. Koden skrivs till dokumentet med document.write. Om en regel har flera åtgärder för anpassad kod, skrivs koden i den ordning som konfigurerats i regeln.
Regler som använder någon annan händelse än sidans överkant eller sidans nederkant
Kod från anpassade åtgärder läses in från servern och skrivs till dokumentet med Postscribe. Om en regel har flera åtgärder för anpassad kod läses koden in parallellt från servern, men skrivs i den ordning som konfigurerats i regeln.
När du använder document.write efter att en sida har lästs in uppstår vanligtvis problem, men det här är inte något problem för kod som tillhandahålls via anpassade kodåtgärder. Du kan använda åtgärderna document.write i Custom Code oavsett när koden kommer att köras.
Anpassad kodvalidering
Valideraren som används i kodredigeraren för taggar är utformad för att identifiera problem med kod som skrivits av utvecklare. Kod som har genomgått en miniatyrprocess, t.ex. AppMeasurement.js-koden som har hämtats från kodhanteraren, kan felaktigt flaggas som att valideraren har problem som vanligtvis kan ignoreras.
Åtgärdssekvenser
När alternativet Kör regelkomponenter i sekvens från egenskapsinställningarna är aktiverat kan efterföljande regelkomponenter vänta medan åtgärden utför en asynkron åtgärd. Detta fungerar annorlunda för JavaScript och HTML.
JavaScript
När du skapar en anpassad JavaScript-kodsåtgärd kan du returnera ett löfte från åtgärden. Nästa åtgärd i regeln kommer endast att utföras när det returnerade löftet är löst. Om löftet avvisas kommer nästa åtgärd från regeln inte att utföras.
Ett exempel på en anpassad JavaScript-kodsåtgärd som returnerar ett löfte:
return new Promise(function(resolve, reject) {
setTimeout(function() {
if (new Date().getDay() === 5) {
resolve();
} else {
reject();
}
}, 1000);
});
HTML
När du skapar en anpassad kodsåtgärd för HTML kan du använda funktionen onCustomCodeSuccess()
i din anpassade kod. Du kan anropa den här funktionen för att ange att din egen kod har slutförts och att taggarna kan fortsätta att köra efterföljande åtgärder. Om din anpassade kod däremot misslyckades på något sätt kan du anropa onCustomCodeFailure()
. Detta informerar taggar om att inte köra efterföljande åtgärder från den regeln.
Ett exempel på en anpassad kodåtgärd för HTML som använder de nya återanropen:
<script>
setTimeout(function() {
if (new Date().getDay() === 5) {
onCustomCodeSuccess();
} else {
onCustomCodeFailure();
}
}, 1000);
</script>
Utlös direktanrop direct-call-action
Den här åtgärden utlöser alla regler som använder en specifik direktanropshändelse. När du konfigurerar åtgärden måste du ange identifierarsträngen för den direktanropshändelse som du vill utlösa. Du kan också skicka data till en direktanropshändelse via ett detail
-objekt, som kan innehålla en anpassad uppsättning nyckelvärdepar.
Åtgärden mappar direkt till track
-metodeni satellite
-objektet, som kan nås av kod på klientsidan.
Dataelementtyper för kärntillägg
Dataelementtyperna bestäms av tillägget. Det finns ingen begränsning för de typer som kan skapas.
I följande avsnitt beskrivs de typer av dataelement som finns 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
Konstant
Alla konstanta strängvärden som sedan kan refereras i åtgärder eller villkor.
Exempel:
string
Egen kod
Du kan ange anpassade JavaScript-filer i användargränssnittet genom att välja Öppna redigerare och infoga kod i redigeringsfönstret.
En return-programsats krävs i redigeringsfönstret för att ange vilket värde som ska användas som dataelementvärde. Om en retursats inte ingår eller om värdet null
eller undefined
returneras, används dataelementets standardvärde som dataelementvärde.
Exempel:
var pageType = $('div.page-wrapper').attr('class').split('')[1];
if (window.location.pathname == '/') {
return 'homepage';
} else {
return pageType;
}
Om det anpassade kodelementet hämtas som en del av en regelkörning blir en variabel med namnet event
automatiskt tillgänglig, som du kan referera till inifrån den anpassade koden. Objektet event
innehåller användbar information om händelsen som utlöste regeln. Det enklaste sättet att avgöra vilka händelsedata som är tillgängliga är att logga event
till konsolen inifrån din anpassade kod:
console.log(event);
return true;
Kör regeln i en webbläsare och inspektera det loggade händelseobjektet i webbläsarens konsol. När du förstår vilken information som är tillgänglig under de olika regler som kan använda ditt dataelement, kan du använda den för programmatisk beslutsfattande inom din anpassade kod eller returnera en del av event
-objektet som dataelementets värde.
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.
Element med märkordsdata kan användas för att hämta JavaScript-variabler eller objektegenskaper för märkord. Dessa värden kan sedan användas i tilläggen eller anpassade regler genom att referera till taggdataelementen. Om datakällan ändras är det bara nödvändigt att uppdatera referensen till källan.
I exemplet nedan innehåller koden en JavaScript-variabel med namnet Page_Name
.
<script>
//data layer
var Page_Name = "Homepage"
</script>
När du skapar dataelementet anger du bara sökvägen till variabeln.
Om du använder ett datainsamlarobjekt som en del av datalagret använder du 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å det lokala lagringsobjektet i fältet Namn på lokal lagringsobjekt.
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 ungefär 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.
Sammanfogade objekt
Markera flera dataelement som vart och ett ska ge ett objekt. Objekten sammanfogas i hög grad (rekursivt) för att skapa ett nytt objekt. Källobjekten ändras inte. Om en egenskap hittas på samma plats på flera källobjekt används värdet från det senare objektet. Om ett källegenskapsvärde är undefined
åsidosätter det inte ett värde från ett tidigare källobjekt. Om arrayer finns på samma plats på flera källobjekt sammanfogas arrayerna.
Anta till exempel att du väljer ett dataelement som innehåller följande objekt:
{
"sport": {
"name": "tennis"
},
"dessert": "ice cream",
"fruits": [
"apple",
"banana"
]
}
Anta också att du väljer ett annat dataelement som innehåller följande objekt:
{
"sport": {
"name": "volleyball"
},
"dessert": undefined,
"pet": "dog",
"instrument": undefined,
"fruits": [
"cherry",
"duku"
]
}
Resultatet av dataelementet för sammanfogade objekt blir följande objekt:
{
"sport": {
"name": "volleyball"
},
"dessert": "ice cream",
"pet": "dog",
"instrument": undefined,
"fruits": [
"apple",
"banana",
"cherry",
"duku"
]
}
Sidinformation
Använd dessa datapunkter för att samla in 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:
- URL
- Värdnamn
- Bannamn
- Protokoll
- Referent
- Titel
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 användas till att dölja eller salta känsliga data. Exempel:
- Generera ett träff-ID
- Sammanfoga numret till en användartoken eller tidsstämpel för att säkerställa unikhet
- Gör en enkelriktad hash av PII-data
- Bestäm slumpmässigt när en undersökningsförfrågan ska visas på webbplatsen
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 Namn på sessionslagringsobjekt.
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 och andra plattformslösningar.
Välj ett av följande attribut för besökarbeteende:
- Landningssida
- Trafikkälla
- Minuter på plats
- Antal sessioner
- Antal sessionssidesvisningar
- Antal sidvisningar under livstid
- Är ny besökare
Några vanliga användningsområden:
- Visa en enkät när en besökare har varit på webbplatsen i fem minuter
- Om det här är landningssidan för besöket fyller du i en analysmätning
- Visa ett nytt erbjudande till besökaren efter X antal sessioner
- Visa ett nyhetsbrev om detta är en första besökare
Villkorligt värde
En wrapper för villkoret Värdejämförelse. Baserat på resultatet av jämförelsen returnerar ett av de två tillgängliga värdena i formuläret. Kan därigenom hantera "If… Sedan… Annars…" utan extra regler.
Körningsmiljö
Gör att du kan välja en av följande variabler:
- Miljöfas - Returnerar
_satellite.environment.stage
för att skilja mellan utvecklings-, mellanlagrings-/produktionsmiljöer. - Bygge bibliotek - Returnerar
turbine.buildInfo.buildDate
som innehåller samma värde som_satellite.buildInfo.buildDate
. - Egenskapsnamn - Returnerar
_satellite.property.name
för att hämta namnet på Launch-egenskapen. - Egenskaps-ID - Returnerar
_satellite.property.id
för att hämta ID:t för Launch-egenskapen - Regelnamn - Returnerar
event.$rule.name
som innehåller den körda regelns namn. - Regel-ID - Returnerar
event.$rule.id
som innehåller ID:t för den körda regeln. - Händelsetyp - Returnerar
event.$type
som innehåller den typ av händelse som utlöste regeln. - Nyttolast för händelseinformation - Returnerar
event.detail
som innehåller nyttolasten för en anpassad händelse eller regel för direktanrop. - Identifierare för direktanrop - Returnerar
event.identifier
som innehåller identifieraren för en regel för direktanrop.
Enhetsattribut
Returnerar ett av följande attribut för besökarenhet:
- Storlek på webbläsarfönster
- Skärmstorlek
JavaScript Tools
Det är en wrapper för vanliga JavaScript-åtgärder. Den tar emot ett dataelement som indata. Den returnerar resultatet av en av följande omformningar av dataelementvärdet:
- Grundläggande strängändring (ersätt, delsträng, regex-matchning, första och sista indexvärdet, dela, segment)
- Grundläggande matrisåtgärder (segment, join, pop, shift)
- Grundläggande universella åtgärder (segment, längd)