Dataelementtyper i edge-tillägg

NOTE
Adobe Experience Platform Launch har omklassificerats som en serie datainsamlingstekniker i Adobe Experience Platform. Som ett resultat av detta har flera terminologiska förändringar införts i produktdokumentationen. Se följande dokument för en konsoliderad hänvisning till terminologiska förändringar.

I taggar är dataelement alias för datadelar på en webb- eller mobilsida, oavsett var dessa data finns i händelsen som servern tar emot. Ett dataelement kan refereras av regler och fungerar som en abstraktion för att komma åt dessa datadelar. När platsen för data ändras i framtiden (till exempel när händelsenyckeln som innehåller värdet ändras) kan ett enskilt dataelement konfigureras om medan alla regler som refererar till det dataelementet kan förbli oförändrade.

Dataelementtyperna tillhandahålls av tillägg och tilläggsförfattaren bestämmer hur informationen hämtas. Du kan t.ex. använda en dataelementtyp för att tillåta Adobe Experience Platform-användare att hämta data från XDM-lagret eller deras anpassade datalager.

Det här dokumentet beskriver hur du definierar dataelementtyper för ett kanttillägg i Adobe Experience Platform.

IMPORTANT
Om du utvecklar ett webbtillägg läser du i handboken dataelementtyper för webbtillägg i stället.
I det här dokumentet förutsätts även att du känner till biblioteksmoduler och hur de är integrerade i kanttillägg. Om du behöver en introduktion kan du se översikten på formatering av biblioteksmodul innan du återgår till den här guiden.

Dataelementtyper består vanligtvis av följande:

  1. En vy som visas i användargränssnittet för Experience Platform och datainsamling där användare kan ändra inställningar för dataelementet.
  2. En biblioteksmodul som skickas i taggens körningsbibliotek för att tolka inställningarna och hämta data.

Om du vill att användarna ska kunna hämta data från det anpassade datalagret kan modulen se ut som i det här exemplet.

module.exports = (context) => {
  const productName = context.arc.event.data.productName;
  return productName;
};

Om du vill att de data som returneras för datalagret ska kunna konfigureras av Adobe Experience Platform-användaren, kan du tillåta att användaren anger ett nyckelnamn och sedan spara namnet på settings -objekt. Objektet kan se ut ungefär så här.

{
  keyName: "campaignId"
}

Om du vill använda det användardefinierade lokala lagringsobjektnamnet måste modulen ändras till följande:

module.exports = (context) => {
  const data = context.arc.event.data;
  return data[keyName];
};

Kontext för modulen Bibliotek

Alla dataelementmoduler har åtkomst till en context variabel som anges när modulen anropas. Du kan lära dig mer här.

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