DokumentationExperience PlatformSjälvstudiekurs om webb-SDK

Skapa taggregler

Last update: Fri Apr 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Beginner
  • Intermediate
  • Developer

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örutsättningar

Du känner till datainsamlingstaggar och Luma demo site och har avslutat tidigare 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:

  • [plats] - [event] - [syfte] - [beställa]

där

  1. plats är den eller de sidor på webbplatsen där regeln utlöses
  2. event är utlösaren för regeln
  3. syfte är huvudåtgärden som utförs av regeln
  4. beställa är den ordning i vilken regeln ska utlösas i förhållande till andra regler

Skapa taggregler

I taggar används regler för att utföra åtgärder (brandanrop) under olika förhållanden. Tillägget Platform Web SDK-taggar 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 Update variable åtgärd för att definiera en"global konfiguration" av XDM-fält.

  2. Skapa ytterligare regler med Update variable åtgärd som åsidosätter vår"globala konfiguration" och bidrar till ytterligare XDM-fält under vissa förhållanden (t.ex. genom att lägga till produktinformation på produktsidor).

  3. Skapa en annan regel med Send Event som skickar hela XDM-objektet till Adobe Experience Platform Edge Network.

Alla dessa regler kommer att ordnas korrekt med hjälp avorder".

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

https://video.tv.adobe.com/v/3427710/?learn=on

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 till vänster navigering

  3. Välj Create New Rule knapp

    Skapa en regel

  4. Namnge regeln all pages - library loaded - set global variables - 1

  5. I Events avsnitt, markera Add

    Namnge regeln och lägg till en händelse

  6. Använd Core Extension och markera Library Loaded (Page Top) som Event Type

  7. Välj Advanced listruta 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 huvudlinjeraster
    Välj utlösare för inläst bibliotek

  9. I Actions avsnitt, markera Add

  10. Som Extension, markera Adobe Experience Platform Web SDK

  11. Som Action Type, markera Update variable

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

    Uppdatera variabelschema

Kartlägg dina data elements till schema används av ditt XDM-objekt. 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
    Så här förstår du vilka värden som ska fyllas i eventType måste du gå till schemasidan och välja eventType om du vill 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öreslagna värden på schemasidan

  3. Gå till identityMap objekt i schemat och markera det

  4. Mappa till identityMap.loginID dataelement

    Uppdatera variabelidentitetskarta

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

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

  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
    Medan ingen eventType ange till 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 praktiskt att ha ett standardsätt att indikera en sidvy för andra program i senare led.

  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 använda nu Update variable i ytterligare sekvensregler för att berika XDM-objektet innan det skickas 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.
rule-order

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

  1. Välj Add Rule

  2. Ge den ett namn ecommerce - library loaded - set product details variables - 20

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

  4. Under Extension, markera Core

  5. Under Event Type, markera Library Loaded (Page Top)

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

    XDM-regler för analyser

  7. Under Conditions, välj Add

  8. Lämna Logic Type as Regular

  9. Lämna Extension as Core

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

  11. Till höger aktiverar du Regex växla

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

  13. Välj Keep Changes

    XDM-regler för analyser

  14. Under Actions välj Add

  15. Välj Adobe Experience Platform Web SDK extension

  16. Välj Action Type as Update variable

  17. Bläddra nedåt till commerce object

  18. Öppna productViews objekt och ange value till 1

    konfigurera produktvy

    note tip
    TIP
    Setting commerce.productViews.value=1 in XDM mappar automatiskt till prodView händelse i Analytics

  19. Bläddra nedåt till eventType och ange commerce.productViews

    note note
    NOTE
    Eftersom den här regeln har en högre ordning skrivs den över eventType anges i regeln "global konfiguration". eventType kan bara innehålla ett värde, och vi rekommenderar att du ställer in det med händelsen för det högsta värdet.

  20. Bläddra nedåt till och markera productListItems array

  21. Välj Provide individual items

  22. Välj Add Item

    Anger produktvisningshändelse

    note caution
    CAUTION
    The productListItems är en array datatyp så att 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.

  23. Markera för att öppna Item 1

  24. Karta productListItems.item1.SKU till %product.productInfo.sku%

    Produktens SKU XDM-objektsvariabel

  25. Välj Keep Changes

  26. Välj Save för att spara regeln

Kundvagnsfält

Du kan mappa hela arrayen till ett XDM-objekt, förutsatt att arrayen matchar formatet för XDM-schemat. Elementet med anpassade koddata cart.productInfo du skapade tidigare slingor genom digitalData.cart.cartEntries datalagerobjekt på Luma och översätter det till det format som krävs för productListItems XDM-schemats objekt.

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 struktur (tips, det ska matcha).

IMPORTANT
Observera hur numeriska variabler översätts, med strängvärden i datalagret som price och qty formateras om till tal i dataelementet. Dessa formatkrav är viktiga för dataintegriteten i plattformar och fastställs under konfigurera scheman steg. I exemplet quantity använder Integer datatyp.
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 + symbol under Händelse för att lägga till en ny utlösare

  3. Under Extension, markera Core

  4. Under Event Type, markera Library Loaded (Page Top)

  5. Markera för att öppna Advanced Options, skriva in 20

  6. Välj Keep Changes

    XDM-regler för analyser

  7. Under Conditions, välj Add

  8. Lämna Logic Type as Regular

  9. Lämna Extensions as Core

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

  11. Till höger, inte aktivera Regex växla

  12. Under path equals set /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

    XDM-regler för analyser

  14. Under Actions välj Add

  15. Välj Adobe Experience Platform Web SDK extension

  16. Välj Action Type as Update variable

  17. Bläddra nedåt till commerce och väljer att öppna det.

  18. Öppna productListViews objekt och ange value till 1

    konfigurera produktvy

    note tip
    TIP
    Setting commerce.productListViews.value=1 in XDM mappar automatiskt till scView händelse i Analytics

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

  20. Bläddra nedåt till och markera productListItems array

  21. Välj Provide entire array

  22. Mappa till cart.productInfo dataelement

  23. Välj Keep Changes

  24. Välj Save för att 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
    Det här motsvarar inställningen scCheckout händelse 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
    Det här motsvarar inställningen purchase händelse i Analytics

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

  5. Ange commerce.order.currencyCode till hårdkodat värde USD

    Ange purchaseID för Analytics

    note tip
    TIP
    Det här motsvarar inställningen s.purchaseID och s.currencyCode variabler i Analytics

  6. Bläddra nedåt till och markera productListItems array

  7. Välj Provide entire array

  8. Mappa till cart.productInfo.purchase dataelement

  9. Välj Save

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

XDM-regler för analyser

Skicka händelseregel

Nu när du har ställt in variablerna kan du skapa en regel som skickar hela XDM-objektet till Platform Edge Network med Send event åtgärd.

  1. Välj till höger Add Rule för att skapa en annan regel

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

  3. I Events avsnitt, markera Add

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

  5. Välj Advanced listruta och ange 50 in Order. Detta garanterar att den andra regeln aktiveras efter den första regeln som du anger som utlösare 1.

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

  7. I Actions avsnitt, markera Add

  8. Som Extension, markera Adobe Experience Platform Web SDK

  9. Som Action Type, markera Send event

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

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

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

  12. Välj Save för att 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 till vänster navigering

  2. Välj Add Library

    Välj Lägg till bibliotek

  3. För Name, ange Luma Web SDK Tutorial

  4. För Environment, markera 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 det grundläggande JavaScript som krävs för alla egenskaper för webbtaggar.

  6. Välj Save & Build for Development

    Skapa och bygg 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:

Bygget är klart

Som du kan se på Publishing Flow på skärmen finns det mycket mer i publiceringsprocessen, som ligger utanför kursens räckvidd. 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 lade 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 med dig av dem om detta Experience League diskussionsinlägg
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4