Overzicht van kernextensies

De extensie van de tag Core is de standaardextensie die wordt vrijgegeven met Adobe Experience Platform.

Dit document bevat informatie over de beschikbare opties wanneer u de extensie Core gebruikt om een regel te maken.

Gebeurtenistypen van de kernextensie core-extension-event-types

Dit onderwerp beschrijft de gebeurtenistypen beschikbaar in de uitbreiding van de Kern. Voor informatie over de opties die voor verschillende gebeurtenistypen kunnen worden ingesteld, raadpleegt u de Opties sectie.

Gebeurtenissen op basis van browser

Tab vervagen

De gebeurtenis tab-blur activeert de handeling wanneer een tab de focus verliest. Er zijn geen instellingen voor dit gebeurtenistype.

Tabfocus

De gebeurtenis tab-focus activeert de actie wanneer een tab de focus krijgt. Er zijn geen instellingen voor dit gebeurtenistype.

Formulier

Vervagen

De gebeurtenis blur activeert de actie wanneer een formulier de focus verliest. Zie de Opties voor meer informatie over aanpasbare gebeurtenisinstellingen.

Focus

De focusgebeurtenis activeert de actie wanneer een formulier de focus krijgt. Zie de Opties voor meer informatie over aanpasbare gebeurtenisinstellingen.

Verzenden

De verzendgebeurtenis activeert de actie wanneer een formulier wordt verzonden. Zie de Opties voor meer informatie over aanpasbare gebeurtenisinstellingen.

Keyboard-gebeurtenissen

Toetsdruk

De gebeurtenis wordt geactiveerd wanneer op een toets wordt gedrukt. Zie de Opties voor meer informatie over aanpasbare gebeurtenisinstellingen.

Gebeurtenissen op basis van media

Media beëindigd

De gebeurtenis wordt geactiveerd wanneer het medium wordt beëindigd. Zie de Opties voor meer informatie over aanpasbare gebeurtenisinstellingen.

Gegevens die met media zijn geladen

De gebeurtenis wordt geactiveerd wanneer de media gegevens laden. Zie de Opties voor meer informatie over aanpasbare gebeurtenisinstellingen.

Media pauzeren

De gebeurtenis wordt geactiveerd wanneer het medium wordt gepauzeerd. Zie de Opties voor meer informatie over aanpasbare gebeurtenisinstellingen.

Media afspelen

De gebeurtenis wordt geactiveerd wanneer de media wordt afgespeeld. Zie de Opties voor meer informatie over aanpasbare gebeurtenisinstellingen.

Media geïnstalleerd

De gebeurtenis wordt geactiveerd wanneer de media stagneren. Zie de Opties voor meer informatie over aanpasbare gebeurtenisinstellingen.

Media-tijd afgespeeld

De gebeurtenis wordt geactiveerd wanneer de media gedurende een bepaalde periode wordt afgespeeld. U moet de duur opgeven waarvoor de media moeten worden afgespeeld om de gebeurtenis te activeren. Zie de Opties voor meer informatie over aanpasbare gebeurtenisinstellingen.

Gewijzigd media-volume

De gebeurtenis wordt geactiveerd als het volume wordt verhoogd of verlaagd. Zie de Opties voor meer informatie over aanpasbare gebeurtenisinstellingen.

Mobiel-apparaatgeoriënteerde gebeurtenissen

Wijziging van richting

De gebeurtenis wordt geactiveerd als de oriëntatie van het apparaat verandert. U moet de duur opgeven waarvoor de oriëntatie moet worden gewijzigd om de gebeurtenis te activeren. Er zijn geen instellingen voor dit gebeurtenistype.

Zoomwijziging

De gebeurtenis wordt geactiveerd wanneer de gebruiker in- of uitzoomt. Er zijn geen instellingen voor dit gebeurtenistype.

Gebeurtenissen met muisbediening

Klikken

De gebeurtenis wordt geactiveerd als het opgegeven element is geselecteerd (erop geklikt). U kunt ook eigenschapswaarden opgeven die waar moeten zijn voor het element voordat de gebeurtenis wordt geactiveerd.

Als het element een ankertag is (<a>) aan gekoppelde inhoud, kunt u ook opgeven of de navigatie gedurende een bepaalde periode moet worden vertraagd. Dit kan handig zijn als uw regel extra tijd nodig heeft om uit te voeren en normaal gesproken niet zou zijn voltooid voordat paginanavigatie plaatsvindt.

Wanneer u koppelingsvertraging gebruikt, voorkomt Platform eigenlijk browser van de pagina te navigeren. Vervolgens wordt er een JavaScript-omleiding uitgevoerd naar de oorspronkelijke bestemming na de opgegeven time-out. Dit is vooral gevaarlijk wanneer de paginamarkering <a> -tags waarop de gebruiker niet werkelijk van de pagina af kan navigeren vanwege de bedoelde functionaliteit. Als u uw probleem niet op een andere manier kunt oplossen, zou u met uw selecteursdefinitie uiterst nauwkeurig moeten zijn zodat deze gebeurtenis precies teweegbrengt waar u het nodig hebt en nergens anders.

De standaardwaarde voor de vertraging van de koppeling is 100 milliseconden. Tags wachten altijd op de opgegeven tijd en houden op geen enkele manier verband met de uitvoering van de handelingen van de regel. Het is mogelijk dat de vertraging de gebruiker zal dwingen langer te wachten dan noodzakelijk is, en ook dat de vertraging niet lang genoeg zal zijn voor alle acties van de regel met succes te voltooien. Langere vertragingen verstrekken meer tijd voor regeluitvoering maar ook verslechteren de gebruikerservaring.

Om de vertraging in te voeren is het nodig om zowel het geselecteerde element te verstrekken dat de gebeurtenis teweegbrengt, als de specifieke hoeveelheid tijd alvorens de gebeurtenis wordt teweeggebracht.

Voor de geavanceerde opties raadpleegt u de Opties voor meer informatie.

Hover

De gebeurtenis wordt geactiveerd wanneer de gebruiker de muisaanwijzer op een opgegeven element plaatst. U moet ook vormen of de regel onmiddellijk of na een gespecificeerd aantal milliseconden wordt teweeggebracht. Zie de Opties voor meer informatie over aanpasbare gebeurtenisinstellingen.

Andere gebeurtenissen

Aangepaste gebeurtenis

De gebeurtenis wordt geactiveerd als een aangepast gebeurtenistype optreedt. Benoemde JavaScript-functies die elders in de codebase zijn gedefinieerd, kunnen worden gebruikt als een aangepast gebeurtenistype. U moet de naam van het type van douanegebeurtenis specificeren en andere montages vormen zoals die in worden beschreven Opties hieronder.

Gegevenselement gewijzigd

De gebeurtenis wordt geactiveerd wanneer een opgegeven gegevenselement verandert. U moet een naam opgeven voor het gegevenselement. U kunt het gegevenselement selecteren door de naam ervan in het tekstveld te typen of door het pictogram voor het gegevenselement rechts van het tekstveld te selecteren en een keuze te maken in een lijst in het dialoogvenster dat verschijnt.

Directe oproep direct-call-event

Een directe vraaggebeurtenis mijdt gebeurtenisopsporing en raadplegingssystemen. De directe vraagregels zijn ideaal voor situaties waar u het systeem precies wilt vertellen wat gebeurt. Bovendien zijn deze ideaal wanneer het systeem geen gebeurtenis in het DOM kan detecteren.

Wanneer u een directe aanroepgebeurtenis definieert, moet u een tekenreeks opgeven die als id van deze gebeurtenis fungeert. Indien een directe aanroepactie activeren die het zelfde herkenningsteken bevatten wordt in brand gestoken, dan zullen om het even welke directe regels die van de vraaggebeurtenis luisteren naar dat herkenningsteken lopen.

Element bestaat

De gebeurtenis activeert of een opgegeven element bestaat. Zie de Opties voor meer informatie over aanpasbare gebeurtenisinstellingen.

Viewport invoeren

De gebeurtenis wordt geactiveerd als de gebruiker een opgegeven viewport invoert. U moet een CSS-kiezer opgeven als criteria om overeenkomende elementen als doel in te stellen. U moet ook vormen of de regel onmiddellijk of na een gespecificeerd aantal milliseconden wordt teweeggebracht, en of de gebeurtenis zou moeten teweegbrengen telkens als de gebeurtenis of slechts de eerste keer voorkomt.

Zie de Opties voor meer informatie over aanpasbare gebeurtenisinstellingen.

Geschiedeniswijziging

De gebeurtenis wordt geactiveerd als een pushState- of hashchange-gebeurtenis plaatsvindt. Er zijn geen instellingen voor dit gebeurtenistype.

Tijd besteed op pagina

De gebeurtenis wordt geactiveerd wanneer de gebruiker gedurende een opgegeven aantal seconden op de pagina blijft. U moet het aantal seconden opgeven dat moet worden doorgegeven voordat de gebeurtenis wordt geactiveerd.

Gebeurtenissen bij laden van pagina

gereed voor DOM

De gebeurtenis wordt geactiveerd wanneer het DOM gereed is en de gebruiker kan communiceren met de pagina. Er zijn geen instellingen voor dit gebeurtenistype.

Bibliotheek geladen (pagina boven) library-loaded-page-top

De gebeurtenis wordt gestart zodra de tagbibliotheek is geladen. Er zijn geen instellingen voor dit gebeurtenistype.

Pagina onder page-bottom

De gebeurtenis wordt eenmaal geactiveerd _satellite.pageBottom(); is opgeroepen. Wanneer de tagbibliotheek asynchroon wordt geladen, mag dit gebeurtenistype niet worden gebruikt. Er zijn geen instellingen voor dit gebeurtenistype.

Venster geladen

De gebeurtenis wordt geactiveerd wanneer onLoad wordt aangeroepen door de browser en de pagina klaar is met laden. Er zijn geen instellingen voor dit gebeurtenistype.

Opties options

Voor elk type formuliergebeurtenis worden de volgende instellingen gebruikt:

Specifieke elementen | Willekeurig element

Elementen die overeenkomen met de CSS-kiezer

Voer de CSS-kiezer in die de elementen identificeert die de gebeurtenis activeren.

En met bepaalde eigenschapswaarden

Als u deze optie selecteert, worden de volgende parameters beschikbaar:

Geavanceerde opties (bloggen)

Voorkeurstypen van kernextensie

In deze sectie worden de voorwaardetypen beschreven die beschikbaar zijn in de extensie Core. Deze voorwaardetypes kunnen met of het regelmatige of type van uitzonderingslogica worden gebruikt.

Gegevens

Cookie

Geef de naam en waarde van het cookie op die moeten bestaan voordat een gebeurtenis een handeling activeert.

Aangepaste code

Geef aangepaste code op die als voorwaarde voor de gebeurtenis moet bestaan.

Gebruik de ingebouwde code-editor om de aangepaste code in te voeren:

Een variabele met de naam event wordt automatisch beschikbaar, waarnaar u kunt verwijzen in uw aangepaste code. De event Het object bevat nuttige informatie over de gebeurtenis die de regel heeft geactiveerd. De eenvoudigste manier om te bepalen welke gebeurtenisgegevens beschikbaar zijn, is door te loggen event naar de console vanuit uw aangepaste code:

console.log(event);
return true;

Voer de regel in een browser uit en inspecteer het geregistreerde gebeurtenisobject in de browserconsole. Zodra u begrijpt welke informatie beschikbaar is, kunt u het voor programmatic beslissing binnen uw douanecode gebruiken.

Voorwaardenvolgorde

Wanneer de optie "Regelcomponenten in volgorde uitvoeren" van eigenschapinstellingen is ingeschakeld, kunt u volgende regelcomponenten laten wachten terwijl uw voorwaarde een asynchrone taak uitvoert.

Wanneer de voorwaarde een beloften, zal de volgende voorwaarde in de regel niet uitvoeren tot de teruggekeerde belofte wordt opgelost. Als de belofte wordt verworpen, zijn de markeringen van mening dat de voorwaarde ontbroken en geen verdere voorwaarden of acties van die regel zullen worden uitgevoerd.

Een voorbeeld van een voorwaarde die een belofte terugkeert:

return new Promise(function(resolve, reject) {
  setTimeout(function() {
    if (new Date().getDay() === 5) {
      resolve();
    } else {
      reject();
    }
  }, 1000);
});

Waardevergelijking value-comparison

Vergelijkt twee waarden om te bepalen of deze voorwaarde waar terugkeert.

Als u een regel met veelvoudige voorwaarden hebt, is het mogelijk dat deze voorwaarde waar zal terugkeren, maar de regel zal nog niet in brand steken omdat de andere voorwaarden als vals evalueren of één van de uitzonderingen als waar evalueert.

De volgende vergelijkingsoperatoren voor waarden zijn beschikbaar:

Gelijk: De voorwaarde retourneert true als de twee waarden gelijk zijn via een niet-strikte vergelijking (in JavaScript, de == operator). De waarden kunnen van elk type zijn. Als u een woord typt als true, false, null, of ongedefinieerd in een waardeveld wordt het woord vergeleken als een tekenreeks en wordt het niet omgezet in het JavaScript-equivalent ervan.

Niet gelijk: De voorwaarde retourneert true als de twee waarden niet gelijk zijn aan een niet-strikte vergelijking (in JavaScript, de != operator). De waarden kunnen van elk type zijn. Als u een woord typt als true, false, null, of ongedefinieerd in een waardeveld wordt het woord vergeleken als een tekenreeks en wordt het niet omgezet in het JavaScript-equivalent ervan.

Bevat: De voorwaarde retourneert true als de eerste waarde de tweede waarde bevat. Getallen worden omgezet in tekenreeksen. Elke andere waarde dan een getal of tekenreeks resulteert in de voorwaarde die false retourneert.

Bevat niet: De voorwaarde retourneert true als de eerste waarde niet de tweede waarde bevat. Getallen worden omgezet in tekenreeksen. Elke andere waarde dan een getal of tekenreeks resulteert in de voorwaarde die true retourneert.

Begint met: De voorwaarde retourneert true als de eerste waarde begint met de tweede waarde. Getallen worden omgezet in tekenreeksen. Elke andere waarde dan een getal of tekenreeks resulteert in de voorwaarde die false retourneert.

Begint niet met: De voorwaarde retourneert true als de eerste waarde niet begint met de tweede waarde. Getallen worden omgezet in tekenreeksen. Elke andere waarde dan een getal of tekenreeks resulteert in de voorwaarde die true retourneert.

Eindigt met: De voorwaarde retourneert true als de eerste waarde eindigt met de tweede waarde. Getallen worden omgezet in tekenreeksen. Elke andere waarde dan een getal of tekenreeks resulteert in de voorwaarde die false retourneert.

Eindigt niet met: De voorwaarde retourneert true als de eerste waarde niet eindigt met de tweede waarde. Getallen worden omgezet in tekenreeksen. Elke andere waarde dan een getal of tekenreeks resulteert in de voorwaarde die true retourneert.

Komt overeen met Regex: De voorwaarde retourneert true als de eerste waarde overeenkomt met de reguliere expressie. Getallen worden omgezet in tekenreeksen. Elke andere waarde dan een getal of tekenreeks resulteert in de voorwaarde die false retourneert.

Komt niet overeen met Regex: De voorwaarde retourneert true als de eerste waarde niet overeenkomt met de reguliere expressie. Getallen worden omgezet in tekenreeksen. Elke andere waarde dan een getal of tekenreeks resulteert in de voorwaarde die true retourneert.

is kleiner dan: De voorwaarde retourneert true als de eerste waarde kleiner is dan de tweede waarde. Tekenreeksen die getallen vertegenwoordigen, worden omgezet in getallen. Een andere waarde dan een getal of een convertibele tekenreeks resulteert in de voorwaarde die false retourneert.

is kleiner dan of gelijk aan: De voorwaarde retourneert true als de eerste waarde kleiner dan of gelijk is aan de tweede waarde. Tekenreeksen die getallen vertegenwoordigen, worden omgezet in getallen. Een andere waarde dan een getal of een convertibele tekenreeks resulteert in de voorwaarde die false retourneert.

Is groter dan: De voorwaarde retourneert true als de eerste waarde groter is dan de tweede waarde. Tekenreeksen die getallen vertegenwoordigen, worden omgezet in getallen. Een andere waarde dan een getal of een convertibele tekenreeks resulteert in de voorwaarde die false retourneert.

is groter dan of gelijk aan: De voorwaarde retourneert true als de eerste waarde groter dan of gelijk is aan de tweede waarde. Tekenreeksen die getallen vertegenwoordigen, worden omgezet in getallen. Een andere waarde dan een getal of een convertibele tekenreeks resulteert in de voorwaarde die false retourneert.

Is waar: De voorwaarde retourneert true als de waarde een booleaanse waarde is met de waarde true. De waarde die u opgeeft, wordt niet omgezet in een Booleaanse waarde als het een ander type betreft. Elke andere waarde dan een booleaanse waarde met de waarde true resulteert in de voorwaarde die false retourneert.

Is waar: De voorwaarde retourneert true als de waarde waar is nadat deze is omgezet in een Booleaanse waarde. Zie Truthy-documentatie van MDN voor voorbeelden van waarheidswaarden.

Is onwaar: De voorwaarde retourneert true als de waarde een booleaanse waarde is met de waarde false. De waarde die u opgeeft, wordt niet omgezet in een Booleaanse waarde als het een ander type betreft. Elke andere waarde dan een booleaanse waarde met de waarde false resulteert in de voorwaarde die false retourneert.

Is false: De voorwaarde retourneert true als de waarde false is na de conversie naar een Booleaanse waarde. Zie Falsy-documentatie van MDN voor voorbeelden van ongeldige waarden.

Variabele

Geef de naam en waarde van de JavaScript-variabele op die moeten bestaan voordat een gebeurtenis een handeling activeert.

Betrokkenheid

Openingspagina

Geef de pagina op waarop de gebruiker moet landen om de gebeurtenis te activeren.

Nieuwe/Terugkerende bezoeker

Geef op of de bezoeker een nieuwe bezoeker of een terugkerende bezoeker moet zijn voor een gebeurtenis om een actie te activeren.

Selecteer een van de volgende opties:

Paginaweergaven

Configureer het aantal keren dat de bezoeker de pagina moet weergeven voordat de actie wordt geactiveerd.

Sessies

Trigger de actie als het aantal zittingen van de gebruiker aan de gespecificeerde criteria voldoet.

Tijd op de site

Trigger de actie als het aantal zittingen van de gebruiker aan de gespecificeerde criteria voldoet.

Configureer hoe lang de bezoeker op de site moet zijn voordat de handeling wordt gestart.

verkeersbron

Trigger de actie als het aantal zittingen van de gebruiker aan de gespecificeerde criteria voldoet.

Geef de bron van het verkeer van de bezoeker op die waar moet zijn om de actie te activeren.

Technologie

Browser

Selecteer de browser die de bezoeker moet gebruiken om de actie te activeren.

Selecteer een of meer van de volgende browsers:

Apparaattype

Selecteer het apparaattype dat de bezoeker moet gebruiken om de actie te activeren.

Selecteer een of meer van de volgende apparaattypen:

Besturingssysteem

Selecteer het besturingssysteem dat de bezoeker moet gebruiken om de actie te activeren.

Selecteer een of meer van de volgende besturingssystemen:

Schermresolutie

Selecteer de schermresolutie die bezoekers op hun apparaten moeten gebruiken om de actie te activeren.

Venstergrootte

Selecteer de venstergrootte die bezoekers op hun apparaten moeten gebruiken om de actie te activeren.

URL

Domein

Geef het domein van de bezoeker op.

Hash

Geef een of meer hashpatronen op die in de URL moeten voorkomen.

Pad- en queryreeks

Geef een of meer paden op die in de URL moeten voorkomen. Dit omvat de weg en het vraagkoord.

Pad zonder queryreeks

Geef een of meer paden op die in de URL moeten voorkomen. Dit omvat de weg, maar omvat niet het vraagkoord.

Protocol

Geef het protocol op dat in de URL wordt gebruikt.

Selecteer een van de volgende opties:

Parameter querytekenreeks

Geef de URL-parameter op die in de URL wordt gebruikt.

Subdomein

Geef een of meer subdomeinen op die in de URL moeten voorkomen.

Overige

Datumbereik

Geef een datumbereik op. Kies de datum en het tijdstip waarop de gebeurtenis zich na, de datum vóór en de tijdzone voordoet.

Max. frequentie

Geef het maximale aantal keren op dat de voorwaarde true retourneert. U kunt uit de volgende opties selecteren:

Voor de voorwaarde maximale frequentie 1 per sessie: deze twee localStorage objecten worden vergeleken. Als de visitorTracking.sessionCount is groter dan de maxFrequency.session telling, dan is de steekproefvoorwaarde waar. Als ze gelijk zijn, is de voorwaarde onwaar.

sessionCount is een visitorTracking -item, zodat de bezoeker-API moet zijn ingeschakeld om de samplingvoorwaarde te laten werken.

Bemonstering

Geef het percentage op van de tijd waarop de voorwaarde true retourneert.

Typen handelingen voor kernextensies

Deze sectie beschrijft de actietypes beschikbaar in de uitbreiding van de Kern.

Aangepaste code

Geef de code op die wordt uitgevoerd nadat de gebeurtenis is geactiveerd en de voorwaarden zijn geëvalueerd.

Wanneer JavaScript als taal wordt geselecteerd, een variabele genoemd event wordt automatisch beschikbaar, waarnaar u kunt verwijzen in uw aangepaste code. De event Het object bevat nuttige informatie over de gebeurtenis die de regel heeft geactiveerd. De eenvoudigste manier om te bepalen welke gebeurtenisgegevens beschikbaar zijn, is door te loggen event naar de console vanuit uw aangepaste code:

console.log(event);

Voer de regel in een browser uit en inspecteer het geregistreerde gebeurtenisobject in de browserconsole. Nadat u begrijpt welke informatie beschikbaar is, kunt u het voor programmatic besluit binnen uw douanecode gebruiken, een stuk van verzenden event -object naar een server enzovoort.

Verwerking van aangepaste code

De Core-extensie, die beschikbaar is voor alle Adobe Experience Platform-gebruikers, bevat een aangepaste code-actie voor het uitvoeren van door de gebruiker opgegeven JavaScript of HTML. Het is vaak nuttig voor gebruikers om te begrijpen hoe de regels met de acties van de Code van de Douane worden verwerkt.

Regels die gebeurtenissen boven of onder op de pagina gebruiken

Code uit aangepaste handelingen wordt ingesloten in de hoofdtagbibliotheek. De code wordt naar het document geschreven met document.write. Als een regel veelvoudige acties van de Code van de Douane heeft, wordt de code geschreven in de orde die in de regel wordt gevormd.

Regels voor elke andere gebeurtenis dan de boven- of onderzijde van de pagina

Code van aangepaste handelingen wordt vanaf de server geladen en naar het document geschreven met Postscript. Als een regel veelvoudige acties van de Code van de Douane heeft, wordt de code geladen parallel van de server, maar in de orde geschreven die in de regel wordt gevormd.

Tijdens het gebruik van document.write nadat een pagina is geladen, zouden er doorgaans problemen optreden. Dit is echter geen probleem voor code die via aangepaste code-handelingen wordt geleverd. U kunt document.write binnen acties van de Code van de Douane ongeacht gebruiken wanneer de code zal worden uitgevoerd.

Aangepaste codevalidatie

De validator die in de tagcode-editor wordt gebruikt, is ontworpen om problemen met door ontwikkelaars geschreven code te identificeren. De code die door een minificatieproces-zoals code AppMeasurement.js is gegaan die van de Manager van de Code wordt gedownload - zou verkeerd kunnen worden gemarkeerd zoals hebbend kwesties door validator, die gewoonlijk kan worden genegeerd.

Handelingvolgorde

Wanneer de optie "Regelcomponenten in volgorde uitvoeren" van eigenschapinstellingen is ingeschakeld, kunt u volgende regelcomponenten laten wachten terwijl uw handeling een asynchrone taak uitvoert. Dit werkt anders voor JavaScript- en HTML-aangepaste code.

JavaScript

Wanneer u een aangepaste JavaScript-code maakt, kunt u een beloften uit uw handeling. De volgende actie in de regel zal slechts worden uitgevoerd wanneer de teruggekeerde belofte wordt opgelost. Als de belofte wordt verworpen, zullen de volgende acties van de regel niet worden uitgevoerd.

Een voorbeeld van een aangepaste JavaScript-codehandeling die een belofte retourneert:

return new Promise(function(resolve, reject) {
  setTimeout(function() {
    if (new Date().getDay() === 5) {
      resolve();
    } else {
      reject();
    }
  }, 1000);
});

HTML

Bij het maken van een aangepaste HTML-codehandeling, een functie met de naam onCustomCodeSuccess() is beschikbaar voor gebruik in uw aangepaste code. U kunt deze functie aanroepen om aan te geven dat de aangepaste code is voltooid en dat tags kunnen worden toegepast bij het uitvoeren van volgende handelingen. Als uw aangepaste code echter op een of andere manier is mislukt, kunt u onCustomCodeFailure(). Hiermee wordt aangegeven dat tags de volgende handelingen uit die regel niet mogen uitvoeren.

Een voorbeeld van een actie van de HTML douanecode die nieuwe callbacks gebruikt:

<script>
setTimeout(function() {
  if (new Date().getDay() === 5) {
    onCustomCodeSuccess();
  } else {
    onCustomCodeFailure();
  }
}, 1000);
</script>

Rechtstreekse oproep activeren direct-call-action

Deze handeling activeert alle regels die een specifieke directe call, gebeurtenis. Wanneer het vormen van de actie, moet u het herkenningstekenkoord voor de directe vraaggebeurtenis verstrekken u wilt teweegbrengen. U kunt optioneel ook gegevens doorgeven aan de directe aanroepgebeurtenis via een detail -object, dat een aangepaste set sleutel-waardeparen kan bevatten.

De handeling wordt rechtstreeks toegewezen aan de track methode in de satellite -object, dat kan worden benaderd door code op de client.

Gegevenstelelementtypen van de kernextensie

Gegevenselementen worden bepaald door de extensie. Er is geen limiet aan de typen die kunnen worden gemaakt.

De volgende secties beschrijven de types van gegevenselementen beschikbaar in de uitbreiding van de Kern. Andere extensies gebruiken andere typen gegevenselementen.

Cookie

In het veld cookie naam kan naar een beschikbaar domeincookie worden verwezen.

Voorbeeld:

cookieName

Constante

Elke constante tekenreekswaarde waarnaar vervolgens in handelingen of voorwaarden kan worden verwezen.

Voorbeeld:

string

Aangepaste code

U kunt aangepaste JavaScript invoeren in de gebruikersinterface door Editor openen te selecteren en code in het editorvenster in te voegen.

Een terugkeerverklaring is noodzakelijk in het redacteursvenster om erop te wijzen welke waarde als waarde van het gegevenselement zou moeten worden gebruikt. Als een instructie return niet is opgenomen of als de waarde null of undefined wordt geretourneerd, wordt de standaardwaarde van het gegevenselement gebruikt als de waarde van het gegevenselement.

Voorbeeld:

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

Als het element van de douanecodegegevens als deel van een regeluitvoering wordt teruggewonnen, een genoemde variabele event wordt automatisch beschikbaar, waarnaar u kunt verwijzen in uw aangepaste code. De event Het object bevat nuttige informatie over de gebeurtenis die de regel heeft geactiveerd. De eenvoudigste manier om te bepalen welke gebeurtenisgegevens beschikbaar zijn, is door te loggen event naar de console vanuit uw aangepaste code:

console.log(event);
return true;

Voer de regel in een browser uit en inspecteer het geregistreerde gebeurtenisobject in de browserconsole. Zodra u begrijpt welke informatie onder de diverse regels beschikbaar is die uw gegevenselement kunnen gebruiken, kunt u het voor programmatic besluit binnen uw douanecode gebruiken of een stuk van het terugkeren event -object als waarde van het gegevenselement.

DOM-kenmerk

Elke elementwaarde kan worden opgehaald, zoals een div- of H1-tag.

Voorbeeld:

CSS-selectieketen:

id#dc logo img

Hiermee wordt de waarde opgehaald van:

src

JavaScript-variabele

Met behulp van het padveld kan naar elk beschikbaar JavaScript-object of -variabele worden verwezen.

Taggegevenselementen kunnen worden gebruikt om uw opmaak van JavaScript-variabelen of objecteigenschappen vast te leggen. Deze waarden kunnen vervolgens worden gebruikt binnen uw extensies of aangepaste regels door te verwijzen naar de elementen met taggegevens. Als de bron van de gegevens verandert, is het alleen nodig om de verwijzing naar de bron bij te werken.

In het onderstaande voorbeeld bevat de markering een JavaScript-variabele met de naam Page_Name.

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

Wanneer u het gegevenselement maakt, geeft u gewoon het pad naar die variabele op.

Als u een gegevensverzamelingsobject gebruikt als onderdeel van uw gegevenslaag, gebruikt u puntnotatie in het pad om te verwijzen naar het object en de eigenschap die u in het gegevenselement wilt vastleggen, zoals _myData.pageName, of digitalData.pageName, enzovoort.

Voorbeeld:

window.document.title

Lokale opslag

Geef de naam van uw lokale opslagitem op in het veld Itemnaam lokale opslag.

Met lokale opslag kunnen browsers gegevens van pagina tot pagina opslaan (https://www.w3schools.com/html/html5_webstorage.asp). Lokale opslag werkt veel zoals cookies, maar is veel groter en flexibeler.

Gebruik het opgegeven veld om de waarde op te geven die u voor een lokaal opslagitem hebt gemaakt, zoals lastProductViewed.

Samengevoegde objecten

Selecteer meerdere gegevenselementen die elk een object leveren. Deze objecten worden diep (recursief) samengevoegd om een nieuw object te maken. De bronobjecten worden niet gewijzigd. Als een eigenschap op dezelfde locatie op meerdere bronobjecten wordt gevonden, wordt de waarde van het laatste object gebruikt. Als de waarde van een broneigenschap undefined, wordt een waarde uit een eerder bronobject niet overschreven. Als arrays op dezelfde locatie op meerdere bronobjecten worden gevonden, worden de arrays samengevoegd.

Stel bijvoorbeeld dat u een gegevenselement selecteert dat het volgende object biedt:

{
  "sport": {
    "name": "tennis"
  },
  "dessert": "ice cream",
  "fruits": [
    "apple",
    "banana"
  ]
}

Stel dat u ook een ander gegevenselement selecteert dat het volgende object biedt:

{
  "sport": {
    "name": "volleyball"
  },
  "dessert": undefined,
  "pet": "dog",
  "instrument": undefined,
  "fruits": [
    "cherry",
    "duku"
  ]
}

Het resultaat van het gegevenselement Samengevoegde objecten is het volgende object:

{
  "sport": {
    "name": "volleyball"
  },
  "dessert": "ice cream",
  "pet": "dog",
  "instrument": undefined,
  "fruits": [
    "apple",
    "banana",
    "cherry",
    "duku"
  ]
}

Pagina-info

Gebruik deze gegevenspunten om pagina-info vast te leggen voor gebruik in uw regellogica of om informatie te verzenden naar Analytics of externe volgsystemen.

U kunt een van de volgende paginakenmerken selecteren voor gebruik in het gegevenselement:

Tekenreeksparameter van query

Geef één URL-parameter op in het veld URL-parameter.

Alleen de naamsectie is nodig en speciale aanduidingen zoals "?" of "=" moet worden weggelaten

Voorbeeld:

contentType

Willekeurig getal

Gebruik dit gegevenselement om een willekeurig getal te genereren. Deze wordt vaak gebruikt voor het nemen van monsters van gegevens of het maken van id's, zoals een Actief-id. Het willekeurige getal kan ook worden gebruikt om vertrouwelijke of salt-gevoelige gegevens te verkrijgen. Voorbeelden hiervan zijn:

Geef de minimum- en maximumwaarden voor het willekeurige getal op.

Standaardwaarden:

Minimaal: 0

Maximaal: 1000000000

Sessieopslag

Geef de naam van het opslagitem voor de sessie op in het veld Naam opslagitem voor sessie.

Sessieopslag is vergelijkbaar met lokale opslag, behalve dat de gegevens worden verwijderd nadat de sessie is beëindigd, terwijl lokale opslag of een cookie de gegevens kan behouden.

Bezoekergedrag

Vergelijkbaar met Pagina Info, gebruikt dit gegevenselement gemeenschappelijke gedragstypes om logica binnen regels en andere oplossingen van het Platform te verrijken.

Selecteer een van de volgende kenmerken voor bezoekersgedrag:

Enkele gangbare gebruiksgevallen zijn:

Voorwaardelijke waarde

Een omslag voor de Waardevergelijking voorwaarde. Op basis van het resultaat van de vergelijking wordt een van de twee beschikbare waarden in het formulier geretourneerd. Kan hiermee "if… Dan… Anders…" scenario's zonder de behoefte aan extra regels.

Runtimeomgeving

Hiermee kunt u een van de volgende variabelen selecteren:

Apparaatkenmerken

Retourneert een van de volgende kenmerken van het bezoekersapparaat:

JavaScript-functies

Dit is een omslag voor veelvoorkomende JavaScript-bewerkingen. Het ontvangt een gegevenselement als input. Het keert het resultaat van één van de volgende transformaties van de waarde van het gegevenselement terug: