DocumentatieExperience PlatformTutorial voor Web SDK

Tagregels maken

Last update: Thu Mar 05 2026 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 verzendt met behulp 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 Platform Edge Network 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 labelregel publiceren naar een ontwikkelingsbibliotheek

Vereisten

U bent vertrouwd met de markeringen van de Inzameling van Gegevens en de ​ demowebsite van de Luma ​ en 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 vier 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 die de zelfde gebeurtenis delen

Extensie Adobe Client Data Layer toevoegen

De Luma-website gebruikt een gebeurtenisgestuurde gegevenslaag met de naam Adobe Client Data Layer (ACDL). Wanneer een gebeurtenis in een gegevenslaag plaatsvindt, wordt deze in de array adobeDataLayer geduwd. In deze zelfstudie wordt de extensie Adobe Client Data Layer gebruikt om eenvoudig op deze gebeurtenissen te tikken om onze regels samen te stellen.

De extensie toevoegen:

  1. Ga naar Extensions

  2. Filteren naar Adobe Client Data Layer

  3. Selecteren Install

    voeg de uitbreiding van de Laag van de Gegevens van de Cliënt van Adobe toe

  4. De standaardinstellingen behouden

  5. Selecteren Save

NOTE
Het is niet noodzakelijk om de Laag van Gegevens van de Cliënt van Adobe te gebruiken om het Web SDK van Experience Platform uit te voeren. Vele andere soorten gebeurtenissen worden algemeen gebruikt in markeringen implementaties (Bibliotheek Geladen, Klaar DOM, Venster Geladen, etc.) aan brandregels.

Tagregels maken

In labels worden regels gebruikt om handelingen uit te voeren, zoals het instellen van variabelen en het afvuren van netwerkaanroepen onder verschillende omstandigheden. De Experience Platform Web SDK tagextensie bevat twee handelingen die in regels worden gebruikt:

  • Update variable wijst gegevenselementen aan uw XDM of gegevensvariabelen toe
  • Send Event roept het netwerk op om gegevens naar Experience Platform Edge Network te verzenden

In de rest van deze les:

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

  2. Gebruik de handeling Update variable nogmaals om onze "globale configuratie" te negeren en extra XDM-velden onder bepaalde omstandigheden bij te dragen (bijvoorbeeld door productdetails op productpagina's toe te voegen).

  3. Gebruik de handeling Send Event om de gegevens naar Adobe Experience Platform Edge Network te verzenden.

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/3454033/?captions=dut&learn=on&enablevpops

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 - adobeDataLayer push - set global variables - 1

  5. Selecteer in de sectie Events de optie Add

    Naam de regel en voeg een gebeurtenis toe

  6. Gebruik de extensie Adobe Client Data Layer en selecteer Data Pushed 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. Luisteren naar All Events

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

  10. Selecteer in de sectie Actions de optie Add

  11. Als Extension selecteert u Adobe Experience Platform Web SDK

  12. Als Action Type selecteert u Update variable

  13. Als Data element, selecteer XDM Variable u in ​ creeerde gegevenselementen ​ les

    veranderlijk Schema van de Update

  14. Geef nu de XDM-velden op door deze aan de juiste waarden toe te wijzen:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    XDM-veld Toewijzen aan
    eventType Web Webpagedetails Page Views (typ eerst de gesuggereerde waarden)
    identityMap Identity Map data-element
    web.webPageDetails.name Page Name data-element
    web.webPageDetails.pageViews.value 1
    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 Identity Map null is, wordt het object identityMap dus niet verzonden. Daarom kunnen we het veilig definiëren in onze "mondiale configuratie".
    note tip
    TIP
    Het plaatsen web.webPageDetails.pageViews.value verstrekt een standaardmanier om op een paginamening voor andere stroomafwaartse toepassingen te wijzen. Adobe Analytics hoeft een netwerkaanroep niet als paginaweergave te verwerken.

  15. Als u klaar bent, ziet uw XDM Variable er ongeveer zo uit. Let op hoe de gevulde en gedeeltelijk gevulde velden worden aangeduid met de blauwe cirkels:
    Variabele XDM

  16. Selecteer Keep Changes en Save de regel

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 het zelfde gebeurtenistype hebben, eerst loopt de regel met het laagste orderaantal.

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

  1. Selecteren Add Rule

  2. Naam geven product detail pages - adobeDataLayer push - set product details variables - 20

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

  4. Onder Extension selecteert u Adobe Client Data Layer

  5. Onder Event Type selecteert u Data Pushed

  6. Selecteer deze optie om Advanced Options te openen en typ in 20 . Deze ordewaarde verzekert de regellooppas na de globale veranderingsregel.

  7. Luisteren naar een Specific Event

  8. Voer productView in als de Event / Key to register for

  9. Selecteren Keep changes

    de regels van Analytics XDM

  10. Onder Actions select Add

  11. Extensie Adobe Experience Platform Web SDK selecteren

  12. Action Type selecteren als Update variable

  13. Selecteer XDM Variable als de Data element

  14. Deze XDM-velden toewijzen aan de juiste waarden:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    XDM-veld Toewijzen aan
    eventType Commerce Product Views (typ eerst de gesuggereerde waarden)
    commerce.productViews.value 1
    productListItems.name Ecommerce Product Name data-element (eerst selecteren Provide individual items en Add Item )
    productListItems.sku Ecommerce Product Id data-element

  15. Selecteren Keep Changes

  16. Selecteer Save om de regel op te slaan

    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.
    note tip
    TIP
    Als u commerce.productViews.value=1 instelt in XDM, wordt automatisch toegewezen aan de gebeurtenis prodView in Analytics

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 Ecommerce Cart Products dat u eerder hebt gemaakt, doorloopt het adobeDataLayer.ecommerce.cart.items gegevenslaagobject op de Luma-website 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).

NOTE
U kunt _satellite.getVar('Ecommerce Cart Products') nu niet uitvoeren in de zelfstudie.
IMPORTANT
Wanneer het in kaart brengen van gebieden van uw gegevenslaag aan XDM, zorg ervoor de gebieden het gegevenstype van het XDM gebied aanpassen. In het bovenstaande voorbeeld moeten quantity en priceTotal gehele getallen zijn, anders wordt de record niet opgenomen in Platform.
Gegevenstype XDM-schema ​

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

  1. Een nieuwe regel maken met de naam cart page - adobeDataLayer push - set cart variables - 20

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

  3. Onder Extension selecteert u Adobe Client Data Layer

  4. Onder Event Type selecteert u Data Pushed

  5. Selecteer deze optie om Advanced Options te openen en typ in 20 . Deze ordewaarde verzekert de regellooppas na de globale veranderingsregel.

  6. Luisteren naar een Specific Event

  7. Voer cartView in als de Event / Key to register for

  8. Selecteren Keep Changes

    Gebeurtenis voor de regel van de Kar

  9. Onder Actions select Add

  10. Extensie Adobe Experience Platform Web SDK selecteren

  11. Action Type selecteren als Update variable

  12. Selecteer XDM Variable als de Data element

  13. Deze XDM-velden toewijzen aan de juiste waarden:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    XDM-veld Toewijzen aan
    eventType Commerce Product List (Cart) Views (typ eerst de gesuggereerde waarden)
    commerce.productListViews.value 1
    productListItems Ecommerce Cart Products data-element (eerst selecteren Provide entire array )
    note tip
    TIP
    Door commerce.productListViews.value=1 in XDM in te stellen, wordt automatisch toegewezen aan de gebeurtenis scView in Analytics

  14. Selecteren Keep Changes

  15. Selecteer Save om de regel op te slaan

Bevestigingsvelden bestellen

Maak een andere regel voor aankoopgebeurtenissen:

  1. Een nieuwe regel maken met de naam order confirmation - adobeDataLayer push - set purchase variables - 20

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

  3. Onder Extension selecteert u Adobe Client Data Layer

  4. Onder Event Type selecteert u Data Pushed

  5. Selecteer deze optie om Advanced Options te openen en typ in 20 . Deze ordewaarde verzekert de regellooppas na de globale veranderingsregel.

  6. Luisteren naar een Specific Event

  7. Voer purchase in als de Event / Key to register for

  8. Selecteren Keep Changes

  9. Onder Actions select Add

  10. Extensie Adobe Experience Platform Web SDK selecteren

  11. Action Type selecteren als Update variable

  12. Selecteer XDM Variable als de Data element

  13. Deze XDM-velden toewijzen aan de juiste waarden:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
    XDM-veld Toewijzen aan
    eventType Commerce Purchases (typ eerst de gesuggereerde waarden)
    commerce.productListViews.value 1
    commerce.order.purchaseID Ecommerce Purchase Id data-element
    commerce.order.currencyCode USD
    productListItems Ecommerce Cart Products data element(Select Provide entire array first)
    note tip
    TIP
    Als u commerce.productListViews.value instelt op 1 , commerce.order.purchaseID en commerce.order.currencyCode in XDM, worden automatisch de variabelen purchase , s.purchaseID en s.currencyCode in Analytics toegewezen.

  14. Selecteren Keep Changes

  15. Selecteren Save

Gebeurtenisregel verzenden

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

  1. Een nieuwe regel maken met de naam all pages - adobeDataLayer push - send event - 50

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

  3. Onder Extension selecteert u Adobe Client Data Layer

  4. Onder Event Type selecteert u Data Pushed

  5. Selecteer deze optie om Advanced Options te openen en typ in 50 (dit is waarschijnlijk de standaardinstelling). Deze ordewaarde verzekert de regellooppas na veranderlijk-plaatsende regels.

  6. Luisteren naar een All Events

  7. Selecteren Keep Changes

  8. Onder Actions select Add

  9. Extensie Adobe Experience Platform Web SDK selecteren

  10. Action Type selecteren als Send Event variable

  11. Als Action Type selecteert u Send event

  12. Als XDM selecteert u het gegevenselement XDM Variable dat in de vorige les is gemaakt

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

    voeg de Send actie van de Gebeurtenis toe

  14. Selecteer Save om de regel op te slaan

    sparen de regel

U zou de volgende regels in uw bezit moeten hebben:

verifieer lijst van regels

De regels in een bibliotheek publiceren

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 Environment voor Development

  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 de Adobe Experience Platform Debugger.

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