DokumentationExperience PlatformSjälvstudiekurs om webb-SDK

Skapa taggregler

Last update: Sat Feb 15 2025 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 ditt XDM-objekt med hjälp av 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örhandskrav

Du är bekant med datainsamlingstaggar och Luma demo-webbplatsen 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 fem 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

Skapa taggregler

I taggar används regler för att utföra åtgärder (brandanrop) under olika förhållanden. Platsens SDK-taggtillägg innehåller två åtgärder som används i den här lektionen:

  • Update variable mappar dataelement till egenskaper i ett XDM-objekt
  • Send Event skickar XDM-objektet till Experience Platform Edge Network

I resten av lektionen:

  1. Skapa en regel med åtgärden Update variable för att definiera en"global konfiguration" av XDM-fält.

  2. Skapa ytterligare regler med åtgärden Update variable som åsidosätter vår"globala konfiguration" och som bidrar till ytterligare XDM-fält under vissa villkor (till exempel lägger till produktinformation på produktsidor).

  3. Skapa en annan regel med åtgärden Send Event som skickar hela XDM-objektet 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:

video poster

https://video.tv.adobe.com/v/3427710/?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 - library loaded - set global variables - 1

  5. I avsnittet Events väljer du Add

    Namnge regeln och lägg till en händelse

  6. Använd Core Extension och välj Library Loaded (Page Top) 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. Välj Keep Changes för att återgå till huvudregelskärmen
    Välj inläst utlösare för bibliotek

  9. I avsnittet Actions väljer du Add

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

  11. Som Action Type väljer du Update variable

  12. Som Data element väljer du xdm.variable.content som du skapade i lektionen Skapa dataelement

    Uppdatera variabelschema

Mappa data elements till schema som används av XDM-objektet. Du kan mappa till enskilda egenskaper eller hela objekt. I det här exemplet mappar du till enskilda egenskaper:

  1. Sök efter fältet eventType och markera det

  2. Ange värdet web.webpagedetails.pageViews

    note tip
    TIP
    För att förstå vilka värden som ska fyllas i i fältet eventType måste du gå till schemasidan och välja fältet eventType för att visa de föreslagna värdena på den högra listen. Du kan också ange ett nytt värde om det behövs.
    eventType föreslår värden på schemasidan

  3. Leta sedan reda på objektet identityMap i schemat och markera det

  4. Mappa till dataelementet identityMap.loginID

    Uppdatera variabelidentitetskarta

    note tip
    TIP
    XDM-fält inkluderas inte i nätverksbegäran om dataelementet är null. Därför skickas inte identityMap-objektet när användaren inte är autentiserad och dataelementet identityMap.loginID är null. Därför kan vi definiera den i vår"globala konfiguration".

  5. Bläddra nedåt tills du når objektet web

  6. Markera för att öppna den

  7. Mappa följande dataelement till motsvarande web XDM-variabler

    • web.webPageDetials.name till %page.pageInfo.pageName%
    • web.webPageDetials.server till %page.pageInfo.server%
    • web.webPageDetials.siteSection till %page.pageInfo.hierarchie1%

  8. Ange web.webPageDetials.pageViews.value till 1

    Uppdatera variabelinnehåll

    note tip
    TIP
    Även om varken eventType är inställt på web.webpagedetails.pageViews eller web.webPageDetails.pageViews.value krävs för att Adobe Analytics ska kunna bearbeta en fyr som en sidvy, är det användbart att ha ett standardsätt att indikera en sidvy för andra program längre fram i kedjan.

  9. Välj Keep Changes och sedan Save regeln på nästa skärm för att slutföra skapandet av 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 den med det lägsta talet först.

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

  1. Välj Add Rule

  2. Ge den namnet ecommerce - library loaded - 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 Core

  5. Under Event Type väljer du Library Loaded (Page Top)

  6. Välj att öppna Advanced Options, skriv in 20. Det här ordningsvärdet garanterar att regeln körs efter all pages - library loaded - set global variables - 1 som anger den globala konfigurationen.

  7. Välj Keep changes

    Analyserar XDM-regler

  8. Under Conditions väljer du att Add

  9. Lämna Logic Type som Regular

  10. Lämna Extension som Core

  11. Välj Condition Type som Path Without Query String

  12. Aktivera alternativet Regex till höger

  13. Under path equals, ange /products/. För demonstrationswebbplatsen Luma säkerställer den att regeln endast aktiveras på produktsidor

  14. Välj Keep Changes

    Analyserar XDM-regler

  15. Under Actions väljer du Add

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

  17. Välj Action Type som Update variable

  18. Välj xdm.variable.content som Data element

  19. Bläddra nedåt till objektet commerce

  20. Öppna objektet productViews och ange value till 1

    Konfigurera produktvy

    note tip
    TIP
    Om du anger commerce.productViews.value=1 i XDM mappas automatiskt till händelsen prodView i Analytics

  21. Bläddra ned till eventType och ställ in den på commerce.productViews

    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.

  22. Bläddra nedåt till och välj productListItems-matris

  23. Välj Provide individual items

  24. Välj Add Item

    Anger produktvyhändelse

    note caution
    CAUTION
    productListItems är en array-datatyp, så data förväntas komma in som en samling element. På grund av Luma-demonstrationswebbplatsens datalagerstruktur och eftersom det bara är möjligt att visa en produkt i taget på Luma-webbplatsen, lägger du till objekt individuellt. När du implementerar på din egen webbplats, beroende på din datalagerstruktur, kanske du kan tillhandahålla en hel array.

  25. Markera för att öppna Item 1

  26. Mappa productListItems.item1.SKU till %product.productInfo.sku%

    Produkt-SKU-XDM-objektvariabel

  27. Välj Keep Changes

  28. Välj Save om du vill spara regeln

Kundvagnsfält

Du kan mappa hela arrayen till ett XDM-objekt, förutsatt att arrayen matchar formatet för XDM-schemat. Det anpassade kodelementet cart.productInfo som du skapade tidigare slingor genom datalagret digitalData.cart.cartEntries på Luma 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).

IMPORTANT
Observera hur numeriska variabler översätts, med strängvärden i datalagret som price och qty omformaterade till tal i dataelementet. Dessa formatkrav är viktiga för dataintegriteten i Platform och bestäms under steget Konfigurera scheman. I exemplet använder quantity datatypen Integer.
XDM-schemadatatyp

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

  1. Skapa en ny regel med namnet ecommerce - library loaded - set shopping 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 Core

  4. Under Event Type väljer du Library Loaded (Page Top)

  5. Välj att öppna Advanced Options, skriv in 20

  6. Välj Keep Changes

    Analyserar XDM-regler

  7. Under Conditions väljer du att Add

  8. Lämna Logic Type som Regular

  9. Lämna Extensions som Core

  10. Välj Condition Type som Path Without Query String

  11. aktivera inte-växeln Regex till höger

  12. Under path equals, ange /content/luma/us/en/user/cart.html. För Luma demo-webbplatsen säkerställer det att regeln endast aktiveras på kundvagnssidan

  13. Välj Keep Changes

    Analyserar XDM-regler

  14. Under Actions väljer du Add

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

  16. Välj Action Type som Update variable

  17. Välj xdm.variable.content som Data element

  18. Bläddra ned till objektet commerce och välj att öppna det.

  19. Öppna objektet productListViews och ange value till 1

    Konfigurera produktvy

    note tip
    TIP
    Om du ställer in commerce.productListViews.value=1 i XDM mappas automatiskt till händelsen scView i Analytics

  20. Välj eventType och ange till commerce.productListViews

  21. Bläddra nedåt till och välj productListItems-matris

  22. Välj Provide entire array

  23. Mappa till cart.productInfo-dataelement

  24. Välj Keep Changes

  25. Välj Save om du vill spara regeln

Skapa ytterligare två regler för utcheckning och köp enligt samma mönster med skillnaderna nedan:

Regelnamn: ecommerce - library loaded - set checkout variables - 20

  1. Condition: /content/luma/us/en/user/checkout.html

  2. Ange eventType till commerce.checkouts

  3. Ange commerce.checkout.value till 1

    note tip
    TIP
    Detta motsvarar att ställa in scCheckout-händelsen i Analytics

Regelnamn: ecommerce - library loaded - set purchase variables - 20

  1. Condition: /content/luma/us/en/user/checkout/order/thank-you.html

  2. Ange eventType till commerce.purchases

  3. Ange commerce.purchases.value till 1

    note tip
    TIP
    Detta motsvarar att ställa in purchase-händelsen i Analytics

  4. Ange commerce.order.purchaseID till dataelementet cart.orderId

  5. Ange commerce.order.currencyCode till det hårdkodade värdet USD

    Anger purchaseID för Analytics

    note tip
    TIP
    Detta motsvarar att ställa in s.purchaseID och s.currencyCode variabler i Analytics

  6. Bläddra nedåt till och välj productListItems-matris

  7. Välj Provide entire array

  8. Mappa till cart.productInfo.purchase-dataelement

  9. Välj Keep Changes

  10. Välj Save

När du är klar bör du se följande regler som skapats.

Analyserar XDM-regler

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. Till höger väljer du Add Rule för att skapa en annan regel

  2. Namnge regeln all pages - library loaded - send event - 50

  3. I avsnittet Events väljer du Add

  4. Använd Core Extension och välj Library Loaded (Page Top) som Event Type

  5. Välj Advanced och ange 50 i Order. Detta garanterar att den här regeln aktiveras efter alla andra regler som du har konfigurerat (som hade 1 eller 20 som Order).

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

  7. I avsnittet Actions väljer du Add

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

  9. Som Action Type väljer du Send event

  10. Som XDM väljer du dataelementet xdm.variable.content som skapades i föregående lektion

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

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

  12. Välj Save om du vill spara regeln

    Spara regeln

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 Luma Web SDK Tutorial för Name

  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.

Nästa

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