DocumentatieExperience PlatformTutorial voor Web SDK

Tagregels maken

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Beginner
  • tussenpersoon
  • Ontwikkelaar

Leer hoe u gebeurtenissen naar de Adobe Experience Platform-Edge Network kunt verzenden met uw XDM-object aan de hand van tagregels. Een labelregel is een combinatie van gebeurtenissen, voorwaarden en handelingen die de eigenschap van de tag opgeeft iets te doen. Met het Web SDK van het Platform, worden de regels gebruikt om gebeurtenissen naar de Edge Network van het Platform met de juiste gegevens te verzenden.

Leerdoelstellingen

Aan het einde van deze les kunt u het volgende doen:

  • Een naamgevingsconventie gebruiken voor het beheer van regels binnen tags
  • Een gebeurtenis verzenden met XDM-velden met de acties Variabele bijwerken en Gebeurtenis verzenden
  • Meerdere sets XDM-velden stapelen over meerdere regels
  • Afzonderlijke of volledige arraygegevenselementen toewijzen aan het XDM-object
  • Een tagregel Publish aan een ontwikkelingsbibliotheek koppelen

Vereisten

U bent vertrouwd met de markeringen van de Inzameling van Gegevens en de de demomoeplaats van de Lumaen hebt de vorige lessen in het leerprogramma voltooid:

Naamgevingsconventies

Als u regels in tags wilt beheren, kunt u het beste een standaardnaamgevingsconventie volgen. In deze zelfstudie wordt een naamgevingsconventie gebruikt die uit vijf delen bestaat:

  • [plaats] - [gebeurtenis] - [doel] - [orde]

waar;

  1. plaats is de pagina of de pagina's op de plaats waar de regel in brand steekt
  2. gebeurtenis is de trekker voor de regel
  3. doel is de belangrijkste actie die door de regel wordt uitgevoerd
  4. orde is de orde waarin de regel met betrekking tot andere regels zou moeten in brand steken

Tagregels maken

In tags worden regels gebruikt om handelingen (aanroepen naar brand) onder verschillende omstandigheden uit te voeren. De de etikettenuitbreiding van SDK van het Web van het Platform omvat twee acties die in deze les worden gebruikt:

  • Update variable wijst gegevenselementen toe aan eigenschappen in een XDM-object
  • Send Event verzendt het XDM-object naar de Edge Network Experience Platform

In de rest van deze les:

  1. Maak een regel met de handeling Update variable om een "globale configuratie" van XDM-velden te definiëren.

  2. Maak aanvullende regels met de handeling Update variable die onze "globale configuratie" overschrijven en onder bepaalde voorwaarden aanvullende XDM-velden leveren (bijvoorbeeld door productdetails op productpagina's toe te voegen).

  3. Maak een andere regel met de handeling Send Event , die het volledige XDM-object naar de Adobe Experience Platform-Edge Network verzendt.

Al deze regels zullen behoorlijk gebruikend de "order"optie worden gesequenced.

Deze video geeft een overzicht van het proces:

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

Algemene configuratievelden

Een labelregel maken voor de globale XDM-velden:

  1. Open de eigenschap tag die u voor deze zelfstudie gebruikt

  2. Ga naar Rules in de linkernavigatie

  3. Selecteer de knop Create New Rule

    creeer een regel

  4. Naam van de regel all pages - library loaded - set global variables - 1

  5. Selecteer in de sectie Events de optie Add

    Naam de regel en voeg een gebeurtenis toe

  6. Gebruik Core Extension en selecteer Library Loaded (Page Top) als Event Type

  7. Selecteer Advanced vervolgkeuzelijst en voer 1 in als de Order

    note note
    NOTE
    Hoe lager de volgordenummer, des te eerder de waarde wordt uitgevoerd. Daarom geven wij onze "globale configuratie"een laag orde aantal.

  8. Selecteer Keep Changes om terug te keren naar het hoofdregelscherm
    Uitgezochte Bibliotheek Geladen Trekker

  9. Selecteer in de sectie Actions de optie Add

  10. Als Extension selecteert u Adobe Experience Platform Web SDK

  11. Als Action Type selecteert u Update variable

  12. Als Data element, selecteer xdm.variable.content u in creeerde gegevenselementenles

    veranderlijk Schema van de Update

Wijs nu de data elements toe aan de schema die door uw XDM-object wordt gebruikt. U kunt toewijzen aan afzonderlijke eigenschappen of volledige objecten. In dit voorbeeld koppelt u de eigenschappen aan individuele eigenschappen:

  1. Het veld eventType zoeken en selecteren

  2. Voer de waarde in web.webpagedetails.pageViews

    note tip
    TIP
    Als u wilt weten welke waarden in het veld eventType moeten worden ingevuld, gaat u naar de schemapagina en selecteert u het veld eventType om de voorgestelde waarden op de rechterrails weer te geven. U kunt desgewenst ook een nieuwe waarde invoeren.
    eventType stelde waarden op de schema's pagina voor

  3. Zoek vervolgens het identityMap -object in het schema en selecteer het.

  4. Toewijzen aan het gegevenselement identityMap.loginID

    veranderlijke identiteitskaart van de Update kaart

    note tip
    TIP
    XDM gebieden zullen niet in het netwerkverzoek worden omvat als het gegevenselement ongeldig is. Wanneer de gebruiker niet wordt geverifieerd en het gegevenselement identityMap.loginID null is, wordt het object identityMap dus niet verzonden. Daarom kunnen we het definiëren in onze "mondiale configuratie".

  5. Omlaag schuiven totdat u het object web bereikt

  6. Selecteren om te openen

  7. Wijs de volgende gegevenselementen toe aan de overeenkomstige web XDM-variabelen

    • web.webPageDetials.name t/m %page.pageInfo.pageName%
    • web.webPageDetials.server t/m %page.pageInfo.server%
    • web.webPageDetials.siteSection t/m %page.pageInfo.hierarchie1%

  8. web.webPageDetials.pageViews.value instellen op 1

    Update veranderlijke inhoud

    note tip
    TIP
    Hoewel Adobe Analytics een baken niet hoeft te verwerken als paginaweergave als eventType is ingesteld op web.webpagedetails.pageViews of web.webPageDetails.pageViews.value , is het handig om over een standaardmanier te beschikken om een paginaweergave aan te geven voor andere downstreamtoepassingen.

  9. Selecteer Keep Changes en Save vervolgens de regel in het volgende scherm om het maken van de regel te voltooien

Productpaginavelden

Start nu Update variable in extra, gerangschikte regels om het XDM-object te verrijken voordat u het naar Platform Edge Network verzendt.

TIP
De regelvolgorde bepaalt welke regel het eerst wordt uitgevoerd wanneer een gebeurtenis wordt geactiveerd. Als twee regels hetzelfde gebeurtenistype hebben, wordt eerst de regel met het laagste getal uitgevoerd.

Eerst volgt u de productweergaven op de pagina met productdetails van Luma:

  1. Selecteren Add Rule

  2. Naam geven ecommerce - library loaded - set product details variables - 20

  3. Selecteer het +-symbool onder Gebeurtenis om een nieuwe trigger toe te voegen

  4. Onder Extension selecteert u Core

  5. Onder Event Type selecteert u Library Loaded (Page Top)

  6. Selecteer deze optie om Advanced Options te openen en typ in 20 . Deze ordewaarde verzekert de regellooppas na all pages - library loaded - set global variables - 1 die de globale configuratie plaatst.

  7. Selecteren Keep changes

    de regels van Analytics XDM

  8. Onder Conditions selecteert u Add

  9. Logic Type behouden als Regular

  10. Extension behouden als Core

  11. Condition Type selecteren als Path Without Query String

  12. Schakel rechts de schakeloptie Regex in

  13. Onder path equals set /products/ . Voor de Luma-demo-site zorgt deze ervoor dat de regel alleen op productpagina's wordt geactiveerd

  14. Selecteren Keep Changes

    de regels van Analytics XDM

  15. Onder Actions select Add

  16. Extensie Adobe Experience Platform Web SDK selecteren

  17. Action Type selecteren als Update variable

  18. Selecteer xdm.variable.content als de Data element

  19. Omlaag schuiven naar het commerce -object

  20. Open het object productViews en stel value in op 1

    de Mening van het opstellingsProduct

    note tip
    TIP
    Als u commerce.productViews.value=1 instelt in XDM, wordt automatisch toegewezen aan de gebeurtenis prodView in Analytics

  21. Omlaag schuiven naar eventType en instellen op commerce.productViews

    note note
    NOTE
    Omdat deze regel een hogere volgorde heeft, overschrijft deze de eventType die is ingesteld in de regel "globale configuratie". eventType kan slechts één waarde bevatten en we raden u aan deze waarde in te stellen met de meest waardevolle gebeurtenis.

  22. Omlaag schuiven naar en array selecteren productListItems

  23. Selecteren Provide individual items

  24. Selecteren Add Item

    Plaatsende gebeurtenis van de productmening

    note caution
    CAUTION
    productListItems is een array gegevenstype zodat het verwacht dat gegevens worden ingevoerd als een verzameling elementen. Vanwege de gegevenslaagstructuur van de demo-site van Luma en omdat het alleen mogelijk is om één product tegelijk weer te geven op de Luministsite, voegt u afzonderlijke items toe. Afhankelijk van de structuur van de gegevenslaag kunt u bij de implementatie op uw eigen website mogelijk een volledige array opgeven.

  25. Selecteren om te openen Item 1

  26. Toewijzen productListItems.item1.SKU aan %product.productInfo.sku%

    de objectenVariabele van het Product SKU XDM

  27. Selecteren Keep Changes

  28. Selecteer Save om de regel op te slaan

Kaarten weergeven

U kunt een volledige array toewijzen aan een XDM-object, mits de array overeenkomt met de indeling van het XDM-schema. Het aangepaste element met codegegevens cart.productInfo dat u eerder hebt gemaakt, doorloopt het digitalData.cart.cartEntries gegevenslaagobject op Luma en zet dit om in de vereiste indeling van het productListItems -object van het XDM-schema.

Zie de vergelijking hieronder van de gegevenslaag van de Luminasite (links) met het vertaalde gegevenselement (rechts) voor illustratie:

XDM voorwerp matrixformaat

Vergelijk het gegevenselement met de productListItems -structuur (hint, it should match).

IMPORTANT
Numerieke variabelen worden omgezet met tekenreekswaarden in de gegevenslaag, zoals price en qty , die opnieuw worden opgemaakt naar getallen in het gegevenselement. Deze formaatvereisten zijn belangrijk voor gegevensintegriteit in Platform en worden bepaald tijdens vormen schema'sstap. In het voorbeeld gebruikt quantity het gegevenstype Integer .
Gegevenstype XDM-schema

Laten we nu onze array toewijzen aan het XDM-object:

  1. Een nieuwe regel maken met de naam ecommerce - library loaded - set shopping cart variables - 20

  2. Selecteer het +-symbool onder Gebeurtenis om een nieuwe trigger toe te voegen

  3. Onder Extension selecteert u Core

  4. Onder Event Type selecteert u Library Loaded (Page Top)

  5. Selecteren om Advanced Options te openen, typ in 20

  6. Selecteren Keep Changes

    de regels van Analytics XDM

  7. Onder Conditions selecteert u Add

  8. Logic Type behouden als Regular

  9. Extensions behouden als Core

  10. Condition Type selecteren als Path Without Query String

  11. Op het recht, laat niet Regex knevel toe

  12. Onder path equals set /content/luma/us/en/user/cart.html . Voor de demo-site Luma zorgt deze optie ervoor dat de regel alleen triggers op de cartpagina bevat

  13. Selecteren Keep Changes

    de regels van Analytics XDM

  14. Onder Actions select Add

  15. Extensie Adobe Experience Platform Web SDK selecteren

  16. Action Type selecteren als Update variable

  17. Selecteer xdm.variable.content als de Data element

  18. Schuif omlaag naar het commerce -object en selecteer dit om het te openen.

  19. Open het object productListViews en stel value in op 1

    de Mening van het opstellingsProduct

    note tip
    TIP
    Door commerce.productListViews.value=1 in XDM in te stellen, wordt automatisch toegewezen aan de gebeurtenis scView in Analytics

  20. Selecteren eventType en instellen op commerce.productListViews

  21. Omlaag schuiven naar en array selecteren productListItems

  22. Selecteren Provide entire array

  23. Toewijzen aan gegevenselement cart.productInfo

  24. Selecteren Keep Changes

  25. Selecteer Save om de regel op te slaan

Maak twee andere regels voor afhandeling en aankoop volgens hetzelfde patroon, met de onderstaande verschillen:

Naam van de Regel: ecommerce - library loaded - set checkout variables - 20

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

  2. eventType instellen op commerce.checkouts

  3. commerce.checkout.value instellen op 1

    note tip
    TIP
    Dit is gelijk aan het instellen van de gebeurtenis scCheckout in Analytics

Naam van de Regel: ecommerce - library loaded - set purchase variables - 20

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

  2. eventType instellen op commerce.purchases

  3. commerce.purchases.value instellen op 1

    note tip
    TIP
    Dit is gelijk aan het instellen van de gebeurtenis purchase in Analytics

  4. commerce.order.purchaseID instellen op het gegevenselement cart.orderId

  5. Stel commerce.order.currencyCode in op de hardcoded waarde USD

    Plaatsende purchaseID voor Analytics

    note tip
    TIP
    Dit is gelijk aan het instellen van s.purchaseID - en s.currencyCode -variabelen in Analytics

  6. Omlaag schuiven naar en array selecteren productListItems

  7. Selecteren Provide entire array

  8. Toewijzen aan gegevenselement cart.productInfo.purchase

  9. Selecteren Keep Changes

  10. Selecteren Save

Als u klaar bent, worden de volgende regels gemaakt.

de regels van Analytics XDM

Gebeurtenisregel verzenden

Nu u de variabelen hebt ingesteld, kunt u de regel maken om het volledige XDM-object naar de Edge Network Platform te verzenden met de handeling Send event .

  1. Selecteer aan de rechterkant Add Rule om een andere regel te maken

  2. Naam van de regel all pages - library loaded - send event - 50

  3. Selecteer in de sectie Events de optie Add

  4. Gebruik Core Extension en selecteer Library Loaded (Page Top) als Event Type

  5. Selecteer Advanced dropdown en ga 50 in Order in. Zo zorgt u ervoor dat deze regel wordt geactiveerd na alle andere regels die u hebt geconfigureerd (met 1 of 20 als hun Order ).

  6. Selecteer Keep Changes om terug te keren naar het hoofdregelscherm
    Uitgezochte Bibliotheek Geladen Trekker

  7. Selecteer in de sectie Actions de optie Add

  8. Als Extension selecteert u Adobe Experience Platform Web SDK

  9. Als Action Type selecteert u Send event

  10. Als XDM selecteert u het gegevenselement xdm.variable.content dat in de vorige les is gemaakt

  11. Selecteer Keep Changes om terug te keren naar het hoofdregelscherm

    voeg de Send actie van de Gebeurtenis toe

  12. Selecteer Save om de regel op te slaan

    sparen de regel

Publish the rules in a library

Vervolgens publiceert u de regel naar de ontwikkelomgeving, zodat u kunt controleren of deze werkt.

Een bibliotheek maken:

  1. Ga naar Publishing Flow in de linkernavigatie

  2. Selecteren Add Library

    Uitgezocht voeg Bibliotheek toe

  3. Voer bij Name Luma Web SDK Tutorial in

  4. Selecteer Development voor Environment

  5. Selecteren Add All Changed Resources

    note note
    NOTE
    Alle tagcomponenten die in vorige lessen zijn gemaakt, worden weergegeven. De extensie Core bevat de basis-JavaScript die door alle eigenschappen van webtags wordt vereist.

  6. Selecteren Save & Build for Development

    creeer en bouwt de bibliotheek

Het kan enkele minuten duren voordat de bibliotheek is gemaakt en wanneer deze is voltooid, wordt links van de naam van de bibliotheek een groene stip weergegeven:

bouwt volledig

Zoals u op het Publishing Flow scherm kunt zien, is er veel meer aan het het publiceren proces, dat voorbij het werkingsgebied van deze zelfstudie is. Deze zelfstudie gebruikt slechts één bibliotheek in uw ontwikkelomgeving.

U kunt nu de gegevens in de aanvraag valideren met het Adobe Experience Platform Debugger.

Volgende

NOTE
Bedankt dat u tijd hebt geïnvesteerd in het leren over de SDK van Adobe Experience Platform Web. Als u vragen hebt, algemene terugkoppelen wilt delen, of suggesties over toekomstige inhoud hebben, gelieve hen op deze Communautaire besprekingspost van de Experience League te delen
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4