Voorwaardetypen voor webextensies

In de context van een regel wordt een voorwaarde geëvalueerd nadat een gebeurtenis heeft plaatsgevonden. Alle voorwaarden moeten waar terugkeren opdat de regel verder verwerkt. De uitzondering is wanneer de gebruikers uitdrukkelijk voorwaarden in een "uitzondering"emmer plaatsen, in welk geval alle voorwaarden binnen het emmertje vals voor de regel moeten terugkeren om verwerking voort te zetten.

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 webextensie in Adobe Experience Platform definieert.

Voorwaardetypen bestaan gewoonlijk uit het volgende:

Een voorwaardetype bibliotheekmodule heeft één doel: evalueren of iets waar of onwaar is. Wat het evalueert, is aan jou.

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 = function(settings) {
  return document.location.hostname === 'example.com';
};

Nu, overweeg een situatie waarin u hostname door de gebruiker van Adobe Experience Platform configureerbaar wilt maken. U kunt toestaan dat de gebruiker een hostnaam invoert en vervolgens de hostnaam in het instellingenobject opslaat. Het object kan er ongeveer als volgt uitzien:

{
  "hostname": "example.com"
}

Om op user-defined hostname te werken, zou uw module aan dit moeten veranderen:

module.exports = function(settings) {
  return document.location.hostname === settings.hostname;
};

Contextafhankelijke gebeurtenisgegevens

Een tweede argument wordt overgegaan tot uw module die contextafhankelijke informatie betreffende de gebeurtenis bevat die de regel in werking stelde. Het kan in bepaalde gevallen nuttig zijn en kan als volgt worden benaderd:

module.exports = function(settings, event) {
  // event contains information regarding the event that fired the rule
};

De event object moet de volgende eigenschappen bevatten:

De uitbreiding die het gebeurtenistype verstrekt dat de regel teweegbracht kan andere nuttige informatie aan dit optioneel toevoegen event object.