Voorwaardetypen voor webextensies

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. Gelieve te verwijzen naar het volgende documentvoor een geconsolideerde verwijzing van de terminologieveranderingen.

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.

NOTE
Als u een randuitbreiding ontwikkelt, zie de gids op voorwaardetypen voor randuitbreidingenin plaats daarvan.
In dit document wordt ervan uitgegaan dat u bekend bent met bibliotheekmodules en hoe deze zijn geïntegreerd in webextensies. Als u een inleiding vereist, zie het overzicht op het formatteren van de bibliotheekmodulealvorens aan deze gids terug te keren.

Voorwaardetypen bestaan gewoonlijk uit het volgende:

  1. A meninggetoond binnen het Experience Platform UI en de Inzameling UI van Gegevens die gebruikers toestaat om montages voor de voorwaarde te wijzigen.
  2. Een bibliotheekmodule die in de tagruntime-bibliotheek wordt uitgestraald om de instellingen te interpreteren en een voorwaarde te evalueren.

Een voorwaardetype bibliotheekmodule heeft één doel: evalueer of iets waar of vals 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 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
};

Het event -object moet de volgende eigenschappen bevatten:

Eigenschap
Beschrijving
$type
Een tekenreeks die de naam van de extensie en de gebeurtenis beschrijft en waaraan een punt is toegevoegd. Bijvoorbeeld youtube.play .
$rule

Een object dat informatie bevat over de regel die momenteel wordt uitgevoerd. Het object moet de volgende subeigenschappen bevatten:

  • id: De id van de regel die momenteel wordt uitgevoerd.
  • name: De naam van de regel die momenteel wordt uitgevoerd.

De extensie die het gebeurtenistype opgeeft dat de regel heeft geactiveerd, kan eventueel andere nuttige informatie toevoegen aan dit event -object.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743