Villkorstyper för kanttillägg
I en taggregel utvärderas ett villkor efter att en händelse har inträffat. Alla villkor måste returnera true för att regeln ska kunna fortsätta bearbetningen. Villkorstyper tillhandahålls av tillägg och utvärderar om något är sant eller falskt, vilket returnerar ett booleskt värde.
Ett tillägg kan till exempel innehålla villkorstypen "viewport contains", där användaren kan ange en CSS-väljare. När villkoret utvärderas på klientens webbplats kan tillägget hitta element som matchar CSS-väljaren och returnera om något av dem finns i användarens visningsruta.
I det här dokumentet beskrivs hur du definierar villkorstyper för ett kanttillägg i Adobe Experience Platform.
Villkorstyperna består vanligtvis av följande:
- En vy som visas i användargränssnittet för Experience Platform och datainsamling där användarna kan ändra inställningarna för villkoret.
- En biblioteksmodul som skickas inom taggens körningsbibliotek för att tolka inställningarna och utvärdera ett villkor.
Om du till exempel vill utvärdera om användaren finns på värden example.com
kan din modul se ut så här.
module.exports = (context) => {
const URL = context.arc.event.xdm.web.webpageDetails.URL;
return URL.endsWith("adobelaunch.com");
};
Om du vill göra värdnamnet konfigurerbart av användaren för att tillåta indata för ett värdnamn och spara det i inställningsobjektet, kan objektet se ut ungefär som i det här exemplet.
{
"hostname": "example.com"
}
Om du vill använda det användardefinierade värdnamnet måste modulen ändras till följande:
module.exports = (context) => {
const URL = context.arc.event.xdm.web.webpageDetails.URL;
return URL.endsWith(settings.hostname);
};
Villkorsresultat
Resultatet som returneras av en villkorsmodul kan vara något av följande:
- Ett booleskt värde (
true
ellerfalse
). - A löfte som returnerar ett booleskt värde när det lösts.
Kontext för modulen Bibliotek
Alla villkorsmoduler har åtkomst till en context
variabel som anges när modulen anropas. Du kan lära dig mer här.