Komma igång med taggtillägget Web SDK
Använd Adobe Experience Platform tags (tidigare Launch) för att skicka händelsedata från din webbplats till Edge Network och efterföljande Adobe-lösningar.
Innan du utför följande steg bör du kontrollera att du har åtkomst till följande egenskapsrättigheter:
- Develop
- Manage extensions
Kontrollera dessutom att du har alla behörigheter under följande kategorier:
- Datamodellering
- Identiteter
Skapa ett XDM-schema schema
Experience Data Model (XDM) är en öppen källkodsspecifikation som innehåller gemensamma strukturer och definitioner för data i form av scheman. Vi rekommenderar att du konfigurerar ett schema när du skickar data till Edge Network.
- Logga in på experience.adobe.com med dina Adobe ID-inloggningsuppgifter.
- Navigera till Data Collection > Schemas.
- Välj Create schema.
- Välj Experience Event och sedan Next.
- Ge schemat ett önskat namn och välj sedan Finish.
- (Valfritt) Du kan lägga till fler fält eller fältgrupper för ytterligare data som du vill samla in.
Skapa ett datastream datastream
En datastream är en konfiguration som anger för Edge Network hur data som du skickar ska hanteras. När du konfigurerar en datastream att skicka data till en viss produkt, skickar datastream automatiskt relevanta data till varje enskild produkt på ett sätt som den specifika produkten förstår.
- Navigera till Data Collection > Datastreams.
- Välj New datastream.
- Ge datastream ett önskat namn och välj det nyligen skapade schemat under Mapping schema.
- Välj Save.
Skapa en taggegenskap
När du har skapat ett schema och ett datastream kan du skapa och konfigurera en taggegenskap.
- Navigera till Data Collection > Tags.
- Välj New property.
- Ge taggegenskapen önskat namn och domän och välj sedan Save.
Installera taggtillägget
Webbtaggtillägget för SDK installeras på en viss taggegenskap.
- Navigera till Data Collection > Tags > Extensions.
- Klicka på fliken Catalog.
- Sök efter tillägget Adobe Experience Platform Web SDK med hjälp av sökfunktionen.
- Markera tilläggskortet och välj sedan Install till höger.
Konfigurera taggtillägget
När du installerar taggtillägget Web SDK dirigeras du automatiskt till sidan Konfiguration .
- Under Datastreams-avsnittet väljer du önskat datastream för varje miljö.
Alla andra konfigurationsinställningar är antingen ifyllda åt dig eller valfria. Ange önskade konfigurationsinställningar och välj sedan Save.
Skapa ett variabelt dataelement
Adobe rekommenderar att dataelementen Variabel används för att lagra nyttolasten som du vill skicka till Adobe. XDM-objekt är också tillgängliga dataelement, men är äldre och mer begränsade i tillämpliga fall.
-
Navigera till Data Collection > Tags.
-
Välj önskad taggegenskap.
-
Välj Data elements > Create new data element.
-
Ge dataelementet följande egenskaper till vänster:
- Name: Alla önskade namn
- Extension: Adobe Experience Platform Web SDK
- Data element type: Variable
-
Ange följande egenskaper till höger:
Variabeltyp: XDM
Sandbox: Sandlådan som du skapade ditt schema i
Schema: Det önskade schemat -
Välj Save.
Skapa en regel
Regler bestämmer när du vill utlösa något eller ange variabler. Om du skapar en regel som körs när biblioteket har lästs in kan du enkelt fylla i variabler som du vill ha ett värde på varje sida.
-
Navigera till Data Collection > Tags.
-
Välj önskad taggegenskap.
-
Välj Rules > Add rule.
-
Ge regeln ett namn.
-
Välj ikonen
+bredvid Events. -
Ge händelsen följande inställningar:
- Extension: Core
- Event type: Library loaded (page top)
-
Välj Keep changes.
Ovanstående steg utgör villkorsdelen av regeln, som aktiveras när biblioteket har lästs in. Följande steg anger vilka åtgärder som ska vidtas när dessa villkor är uppfyllda.
-
Välj ikonen
+bredvid Actions. -
Ge funktionsmakrot följande inställningar till vänster:
- Extension: Adobe Experience Platform Web SDK
- Action type: Send event
-
Ange följande fält till höger:
- XDM: XDM-variabeldataelementet
-
Välj Keep changes.
Publicera
Taggegenskapen innehåller alla komponenter som behövs för att skicka data till Edge Network.
- Navigera till Data Collection > Publishing flow.
- Välj Add library.
- Ge biblioteket ett önskat namn. Tänk på det här namnet som liknar ett implementeringsnamn när du arbetar i programvara för versionskontroll.
- Ställ in listrutan för miljön på Development.
- Välj Add all changed resources.
- Välj Save & build to Development.
Ändringarna är nu distribuerade till din utvecklingsmiljö.
- Navigera till Data Collection > Environments.
- Välj installationsikonen bredvid utvecklingsmiljön
- Installera inbäddningskoden på en testwebbsida på webbplatsen.
När du har verifierat att taggen fungerar i din utvecklingsmiljö kan du använda gränssnittet Publishing flow för att publicera biblioteket till mellanlagring och sedan till produktion.
- Lägg till tillägget och regeln i ett bibliotek, bygg det i en miljö och installera inbäddningskoden på din plats.
- Validera med Adobe Experience Platform Debugger.
Nu har du en tunn konfiguration som fångar upp händelser och skickar dem till Edge Network. Du kan nu bygga vidare på implementeringen genom att lägga till fält i ditt schema, lägga till produkter i ett datastream eller lägga till dataelement i taggegenskapen.