Gegevenselementstypen voor webextensies

In gegevensverzamelingstags zijn gegevenselementen in feite aliassen van gegevens op een pagina. Deze gegevens zijn te vinden in parameters van queryreeksen, cookies, DOM-elementen of andere locaties. Een gegevenselement kan door regels worden van verwijzingen voorzien en als abstractie voor de toegang tot van deze stukken van gegevens dienst doen.

Gegevenselementen worden verstrekt door uitbreidingen, en laten gebruikers toe om gegevenselementen te vormen om tot stukken van gegevens op een bepaalde manier toegang te hebben. Een extensie kan bijvoorbeeld een gegevenstype ‘lokaal opslagitem’ leveren waarin de gebruiker een naam voor een lokaal opslagitem kan opgeven. Wanneer het gegevenselement door een regel van verwijzingen wordt voorzien, zou de uitbreiding de waarde van het lokale opslagpunt kunnen omhoog kijken door de lokale naam van het opslagpunt te gebruiken die de gebruiker had verstrekt toen het vormen van het gegevenselement.

In dit document wordt beschreven hoe u gegevenselematypen voor een webextensie in Adobe Experience Platform definieert.

Gegevenselementen bestaan gewoonlijk uit de volgende elementen:

Overweeg een situatie waarin u gebruikers wilt toestaan om gegevens op te halen uit een lokaal opslagitem met de naam productName. Uw module kan als volgt kijken:

module.exports = function(settings) {
  return localStorage.getItem('productName');
}

Als u de naam van het lokale opslagitem configureerbaar wilt maken voor de Adobe Experience Platform-gebruiker, kunt u toestaan dat de gebruiker een naam invoert en de naam vervolgens in de settings object. Het object kan er ongeveer als volgt uitzien:

{
  itemName: "campaignId"
}

Als u wilt werken met de door de gebruiker gedefinieerde naam van het lokale opslagitem, moet u de module als volgt wijzigen:

module.exports = function(settings) {
  return localStorage.getItem(settings.itemName);
}

Ondersteuning van standaardwaarden

Houd er rekening mee dat gebruikers de optie hebben om een standaardwaarde voor elk gegevenselement te configureren. Als de bibliotheekmodule voor gegevenselementen een waarde retourneert van undefined of null, wordt deze automatisch vervangen door de standaardwaarde die de gebruiker voor het gegevenselement heeft geconfigureerd.

Contextafhankelijke gebeurtenisgegevens

Als het gegevenselement als resultaat van een regel wordt teruggewonnen die (bijvoorbeeld, gegevenselementen worden gebruikt in de voorwaarden en de acties van de regel), zal een tweede argument worden overgegaan tot uw module die contextuele informatie betreffende de gebeurtenis bevat die de regel in brand stak. 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.