Type voorwaarde voor randextensies
In een labelregel wordt een voorwaarde geëvalueerd nadat een gebeurtenis heeft plaatsgevonden. Alle voorwaarden moeten waar terugkeren opdat de regel verder verwerkt. Voorwaardetypen worden geleverd door extensies en evalueren of iets waar of onwaar is en een booleaanse waarde retourneert.
Een extensie kan bijvoorbeeld een voorwaardetype 'viewport contains' weergeven waarin de gebruiker een CSS-kiezer kan opgeven. Wanneer de voorwaarde op de website van de cliënt wordt geëvalueerd, zou de uitbreiding elementen kunnen vinden die de CSS selecteur aanpassen en terugkeren of om het even welk van hen binnen viewport van de gebruiker bevat.
In dit document wordt beschreven hoe u voorwaardetypen voor een randextensie in Adobe Experience Platform definieert.
Voorwaardetypen bestaan gewoonlijk uit het volgende:
- Een mening die binnen UI van het Experience Platform en UI van de Inzameling van Gegevens wordt getoond die gebruikers toestaat om montages voor de voorwaarde te wijzigen.
- Een bibliotheekmodule die in de tagruntime-bibliotheek wordt uitgestraald om de instellingen te interpreteren en een voorwaarde te evalueren.
Als u bijvoorbeeld wilt beoordelen of de gebruiker zich op de host bevindt example.com
, ziet uw module er mogelijk als volgt uit.
module.exports = (context) => {
const URL = context.arc.event.xdm.web.webpageDetails.URL;
return URL.endsWith("adobelaunch.com");
};
Als u de hostnaam door de gebruiker configureerbaar wilt maken om de invoer van een hostnaam toe te staan en deze op te slaan naar het instellingenobject, ziet het object er mogelijk hetzelfde uit als dit voorbeeld.
{
"hostname": "example.com"
}
Om op user-defined hostname te werken, zou uw module aan dit moeten veranderen:
module.exports = (context) => {
const URL = context.arc.event.xdm.web.webpageDetails.URL;
return URL.endsWith(settings.hostname);
};
Voorwaarderesultaat
Het resultaat dat door een voorwaardenmodule wordt geretourneerd, kan een van de volgende zijn:
- Een booleaanse waarde (
true
offalse
). - A beloftedie een booleaanse waarde eens terugkeert opgelost.
Context van de module Bibliotheek
Alle voorwaardemodules hebben toegang tot een variabele context
die wordt verstrekt wanneer de module wordt geroepen. U kunt meer hierleren.