DokumentationExperience PlatformSjälvstudiekurs om webb-SDK

Skapa taggregler

Last update: Thu Mar 05 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Nybörjare
  • Mellanliggande
  • Utvecklare

Lär dig hur du skickar händelser till Adobe Experience Platform Edge Network med taggregler. En taggregel är en kombination av händelser, villkor och åtgärder som instruerar taggegenskapen att göra något. Med Platform Web SDK används regler för att skicka händelser till Platform Edge Network med rätt data.

Utbildningsmål

När lektionen är slut kan du:

  • Använd en namnkonvention för att hantera regler i taggar
  • Skicka en händelse med XDM-fält med åtgärderna Uppdatera variabel och Skicka händelse
  • Stapla flera uppsättningar XDM-fält över flera regler
  • Mappa enskilda eller hela arraydataelement till XDM-objektet
  • Publicera en taggregel i ett utvecklingsbibliotek

Förutsättningar

Du är bekant med datainsamlingstaggar och webbplatsen Luma demo och har slutfört föregående lektioner i självstudiekursen:

Namnkonventioner

Om du vill hantera regler i taggar bör du följa en standardnamnkonvention. I den här självstudiekursen används en namnkonvention med fyra delar:

  • [location] - [event] - [purpose] - [order]

där

  1. plats är sidan eller sidorna på webbplatsen där regeln utlöses
  2. event är utlösaren för regeln
  3. purpose är den huvudåtgärd som utförs av regeln
  4. order är den ordning i vilken regeln ska utlösas i relation till andra regler som delar samma händelse

Lägg till Adobe Client Data Layer-tillägg

Lumas webbplats använder ett händelsestyrt datalager som kallas Adobe Client Data Layer (ACDL). När en datalagerhändelse inträffar, överförs den till arrayen adobeDataLayer. I den här självstudiekursen används ett taggtillägg som kallas Adobe Client Data Layer för att enkelt utnyttja dessa händelser för att skapa våra regler.

Så här lägger du till tillägget:

  1. Gå till Extensions

  2. Filtrera till Adobe Client Data Layer

  3. Välj Install

    Lägg till Adobe Client Data Layer-tillägg

  4. Lämna standardinställningarna

  5. Välj Save

NOTE
Du behöver inte använda Adobe Client Data Layer för att implementera Experience Platform Web SDK. Många andra typer av händelser används ofta i taggimplementeringar (biblioteksinläsning, DOM-klart, fönsterinläsning och så vidare) för att utlösa regler.

Skapa taggregler

I taggar används regler för att utföra åtgärder som att ställa in variabler och köra nätverksanrop under olika förhållanden. Experience Platform Web SDK-taggtillägget innehåller två åtgärder som används i regler:

  • Update variable mappar dataelement till din XDM eller datavariabler
  • Send Event gör nätverksanropet för att skicka data till Experience Platform Edge Network

I resten av lektionen:

  1. Använd åtgärden Update variable för att definiera en"global konfiguration" för XDM-fält.

  2. Använd åtgärden Update variable igen om du vill åsidosätta den globala konfigurationen och bidra med ytterligare XDM-fält under vissa villkor (till exempel lägga till produktinformation på produktsidor).

  3. Använd åtgärden Send Event för att skicka data till Adobe Experience Platform Edge Network.

Alla dessa regler kommer att ordnas korrekt med alternativet order.

Den här videon ger en översikt över processen:

https://video.tv.adobe.com/v/3454031/?captions=swe&learn=on&enablevpops

Globala konfigurationsfält

Så här skapar du en taggregel för de globala XDM-fälten:

  1. Öppna taggegenskapen som du använder för den här självstudien

  2. Gå till Rules i den vänstra navigeringen

  3. Markera knappen Create New Rule

    Skapa en regel

  4. Namnge regeln all pages - adobeDataLayer push - set global variables - 1

  5. I avsnittet Events väljer du Add

    Namnge regeln och lägg till en händelse

  6. Använd tillägget Adobe Client Data Layer och välj Data Pushed som Event Type

  7. Välj listrutan Advanced och ange 1 som Order

    note note
    NOTE
    Ju lägre ordernummer, desto tidigare körs det. Därför ger vi vår"globala konfiguration" ett lågt ordernummer.

  8. Lyssna på All Events

  9. Välj Keep Changes för att återgå till huvudregelskärmen
    Välj inläst utlösare för bibliotek

  10. I avsnittet Actions väljer du Add

  11. Som Extension väljer du Adobe Experience Platform Web SDK

  12. Som Action Type väljer du Update variable

  13. Som Data element väljer du XDM Variable som du skapade i lektionen Skapa dataelement

    Uppdatera variabelschema

  14. Ange nu XDM-fälten genom att mappa dem till lämpliga värden:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    XDM-fält Mappa till
    eventType Web Webpagedetails Page Views (börja skriva för att se de föreslagna värdena)
    identityMap Identity Map dataelement
    web.webPageDetails.name Page Name dataelement
    web.webPageDetails.pageViews.value 1
    note tip
    TIP
    XDM-fält inkluderas inte i nätverksbegäran om dataelementet är null. Därför skickas inte Identity Map-objektet när användaren inte är autentiserad och dataelementet identityMap är null. Därför kan vi definiera den säkert i vår"globala konfiguration".
    note tip
    TIP
    Inställningen web.webPageDetails.pageViews.value är ett standardsätt att ange en sidvy för andra program längre fram i kedjan. Adobe Analytics behöver inte behandla ett nätverksanrop som en sidvy.

  15. När du är klar ser din XDM Variable ut ungefär så här. Observera hur de ifyllda och delvis ifyllda fälten markeras med de blå cirklarna:
    XDM-variabel

  16. Välj Keep Changes och sedan Save regeln

Produktsidesfält

Börja nu använda Update variable i ytterligare sekvensregler för att berika XDM-objektet innan du skickar det till Platform Edge Network.

TIP
Regelordningen bestämmer vilken regel som körs först när en händelse utlöses. Om två regler har samma händelsetyp körs regeln med det lägsta ordernumret först.

Börja med att spåra produktvyer på Lumas produktinformationssida:

  1. Välj Add Rule

  2. Ge den namnet product detail pages - adobeDataLayer push - set product details variables - 20

  3. Välj symbolen + under Händelse för att lägga till en ny utlösare

  4. Under Extension väljer du Adobe Client Data Layer

  5. Under Event Type väljer du Data Pushed

  6. Välj att öppna Advanced Options, skriv in 20. Det här ordningsvärdet garanterar att regeln kör efter den globala variabelregeln.

  7. Lyssna på en Specific Event

  8. Ange productView som Event / Key to register for

  9. Välj Keep changes

    Analyserar XDM-regler

  10. Under Actions väljer du Add

  11. Välj tillägget Adobe Experience Platform Web SDK

  12. Välj Action Type som Update variable

  13. Välj XDM Variable som Data element

  14. Mappa dessa XDM-fält till lämpliga värden:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    XDM-fält Mappa till
    eventType Commerce Product Views (börja skriva för att se de föreslagna värdena)
    commerce.productViews.value 1
    productListItems.name Ecommerce Product Name dataelement (Markera Provide individual items och Add Item först)
    productListItems.sku Ecommerce Product Id dataelement

  15. Välj Keep Changes

  16. Välj Save om du vill spara regeln

    note note
    NOTE
    Eftersom den här regeln har en högre ordning skriver den över uppsättningen eventType i regeln för global konfiguration. eventType kan bara innehålla ett värde och vi rekommenderar att du ställer in det med den mest värdefulla händelsen.
    note tip
    TIP
    Om du anger commerce.productViews.value=1 i XDM mappas automatiskt till händelsen prodView i Analytics

Kundvagnsfält

Du kan mappa hela arrayen till ett XDM-objekt, förutsatt att arrayen matchar formatet för XDM-schemat. Det anpassade kodelementet Ecommerce Cart Products som du skapade tidigare slingor genom datalagret adobeDataLayer.ecommerce.cart.items på Luma-webbplatsen och översätter det till det format som krävs för objektet productListItems i XDM-schemat.

Se jämförelsen nedan av Luma-webbplatsens datalager (vänster) till det översatta dataelementet (höger) för att illustrera:

XDM-objektmatrisformat

Jämför dataelementet med productListItems-strukturen (tips, det ska matcha).

NOTE
Du kommer inte att kunna köra _satellite.getVar('Ecommerce Cart Products') just nu i självstudien.
IMPORTANT
När du mappar fält från datalagret till XDM kontrollerar du att fälten matchar datatypen för XDM-fältet. I exemplet ovan måste quantity och priceTotal vara heltal, annars importeras inte posten till Platform.
XDM-schemadatatyp ​

Låt oss mappa vår array till XDM-objektet:

  1. Skapa en ny regel med namnet cart page - adobeDataLayer push - set cart variables - 20

  2. Välj symbolen + under Händelse för att lägga till en ny utlösare

  3. Under Extension väljer du Adobe Client Data Layer

  4. Under Event Type väljer du Data Pushed

  5. Välj att öppna Advanced Options, skriv in 20. Det här ordningsvärdet garanterar att regeln kör efter den globala variabelregeln.

  6. Lyssna på en Specific Event

  7. Ange cartView som Event / Key to register for

  8. Välj Keep Changes

    Händelse för kundvagnsregel

  9. Under Actions väljer du Add

  10. Välj tillägget Adobe Experience Platform Web SDK

  11. Välj Action Type som Update variable

  12. Välj XDM Variable som Data element

  13. Mappa dessa XDM-fält till lämpliga värden:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    XDM-fält Mappa till
    eventType Commerce Product List (Cart) Views (börja skriva för att se de föreslagna värdena)
    commerce.productListViews.value 1
    productListItems Ecommerce Cart Products dataelement (markera Provide entire array först)
    note tip
    TIP
    Om du ställer in commerce.productListViews.value=1 i XDM mappas automatiskt till händelsen scView i Analytics

  14. Välj Keep Changes

  15. Välj Save om du vill spara regeln

Bekräftelsefält för order

Skapa en annan regel för inköpshändelser:

  1. Skapa en ny regel med namnet order confirmation - adobeDataLayer push - set purchase variables - 20

  2. Välj symbolen + under Händelse för att lägga till en ny utlösare

  3. Under Extension väljer du Adobe Client Data Layer

  4. Under Event Type väljer du Data Pushed

  5. Välj att öppna Advanced Options, skriv in 20. Det här ordningsvärdet garanterar att regeln kör efter den globala variabelregeln.

  6. Lyssna på en Specific Event

  7. Ange purchase som Event / Key to register for

  8. Välj Keep Changes

  9. Under Actions väljer du Add

  10. Välj tillägget Adobe Experience Platform Web SDK

  11. Välj Action Type som Update variable

  12. Välj XDM Variable som Data element

  13. Mappa dessa XDM-fält till lämpliga värden:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
    XDM-fält Mappa till
    eventType Commerce Purchases (börja skriva för att se de föreslagna värdena)
    commerce.productListViews.value 1
    commerce.order.purchaseID Ecommerce Purchase Id dataelement
    commerce.order.currencyCode USD
    productListItems Ecommerce Cart Products dataelement (Markera Provide entire array först)
    note tip
    TIP
    Om du anger commerce.productListViews.value till 1, commerce.order.purchaseID och commerce.order.currencyCode i XDM mappas automatiskt variablerna purchase, s.purchaseID och s.currencyCode i Analytics.

  14. Välj Keep Changes

  15. Välj Save

Skicka händelseregel

Nu när du har angett variablerna kan du skapa regeln för att skicka hela XDM-objektet till Platform Edge Network med åtgärden Send event.

  1. Skapa en ny regel med namnet all pages - adobeDataLayer push - send event - 50

  2. Välj symbolen + under Händelse för att lägga till en ny utlösare

  3. Under Extension väljer du Adobe Client Data Layer

  4. Under Event Type väljer du Data Pushed

  5. Välj om du vill öppna Advanced Options, skriv 50 (som förmodligen är standard). Det här ordningsvärdet garanterar att regeln kör efter reglerna för variabelinställning.

  6. Lyssna på en All Events

  7. Välj Keep Changes

  8. Under Actions väljer du Add

  9. Välj tillägget Adobe Experience Platform Web SDK

  10. Välj Action Type som Send Event variable

  11. Som Action Type väljer du Send event

  12. Som XDM väljer du dataelementet XDM Variable som skapades i föregående lektion

  13. Välj Keep Changes för att återgå till huvudregelskärmen

    Lägg till åtgärden Skicka händelse

  14. Välj Save om du vill spara regeln

    Spara regeln

Du bör ha följande regler i din egenskap:

Verifiera lista över regler

Publicera reglerna i ett bibliotek

Publicera sedan regeln i utvecklingsmiljön så att du kan verifiera att den fungerar.

Så här skapar du ett bibliotek:

  1. Gå till Publishing Flow i den vänstra navigeringen

  2. Välj Add Library

    Välj Lägg till bibliotek

  3. Ange Name för Luma Web SDK Tutorial

  4. För Environment väljer du Development

  5. Välj Add All Changed Resources

    note note
    NOTE
    Du bör se alla taggkomponenter som har skapats i tidigare lektioner. Tillägget Core innehåller den bas-JavaScript som krävs för alla webbtaggegenskaper.

  6. Välj Save & Build for Development

    Skapa och skapa biblioteket

Det kan ta några minuter att skapa biblioteket och när det är klart visas en grön punkt till vänster om biblioteksnamnet:

Skapandet är klart

Som du ser på skärmen Publishing Flow finns det mycket mer i publiceringsprocessen, som ligger utanför den här självstudiekursen. I den här självstudiekursen används bara ett bibliotek i din utvecklingsmiljö.

Nu kan du validera data i begäran med Adobe Experience Platform Debugger.

NOTE
Tack för att du har lagt ned din tid på att lära dig om Adobe Experience Platform Web SDK. Om du har frågor, vill dela allmän feedback eller har förslag på framtida innehåll kan du dela dem i det här Experience League diskussionsgruppsinlägget
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4