Gegevenselementen 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:
- A meninggetoond binnen het Experience Platform UI en de Inzameling UI van Gegevens die gebruikers toestaat om montages voor het gegevenselement te wijzigen.
- Een bibliotheekmodule die in de tagruntimebibliotheek wordt uitgestraald om de instellingen te interpreteren en gegevens op te halen.
Neem bijvoorbeeld een situatie waarin u gebruikers wilt toestaan 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 opslaat in het 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 de waarde undefined
of null
retourneert, 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
};
Het event
-object moet de volgende eigenschappen bevatten:
$type
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.