Voorwaardetypen voor randextensies

Last update: Wed Sep 28 2022 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:

Gemaakt voor:

Ontwikkelaar

NOTE

Adobe Experience Platform Launch is omgedoopt tot een reeks technologieën voor gegevensverzameling in Adobe Experience Platform. Diverse terminologische wijzigingen zijn als gevolg hiervan in de productdocumentatie doorgevoerd. Raadpleeg het volgende document voor een geconsolideerde referentie van de terminologische wijzigingen.

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 er een booleaanse waarde wordt geretourneerd.

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.

IMPORTANT

Als u een webextensie ontwikkelt, raadpleegt u de handleiding op voorwaardetypen voor webextensies in plaats daarvan.

In dit document wordt ook aangenomen dat u bekend bent met bibliotheekmodules en hoe deze zijn geïntegreerd in randextensies. Als u een inleiding nodig hebt, raadpleegt u het overzicht over Opmaak van de module Bibliotheek voordat u terugkeert naar deze handleiding.

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, kan uw module er zo uitzien.

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 of false).
A beloven die een Booleaanse waarde retourneert nadat deze is omgezet.

Context van de module Bibliotheek

Alle voorwaardemodules hebben toegang tot een context variabele die wordt verstrekt wanneer de module wordt geroepen. Meer informatie hier.

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743