DocumentazioneExperience PlatformTutorial su Web SDK

Creare regole di tag

Last update: Thu Jul 31 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Principiante
  • Intermedio
  • Sviluppatore

Scopri come inviare eventi all’Edge Network di Adobe Experience Platform con l’oggetto XDM utilizzando le regole di tag. Una regola di tag è una combinazione di eventi, condizioni e azioni che indica alla proprietà tag di eseguire un'operazione. Con Platform Web SDK, le regole vengono utilizzate per inviare eventi a Platform Edge Network con i dati corretti.

Obiettivi di apprendimento

Alla fine di questa lezione, sarai in grado di:

  • Utilizza una convenzione di denominazione per gestire le regole all’interno dei tag
  • Inviare un evento con campi XDM utilizzando le azioni Aggiorna variabile e Invia evento
  • Sovrapponi più set di campi XDM in più regole
  • Mappare singoli o interi elementi di dati array all’oggetto XDM
  • Pubblicare una regola di tag in una libreria di sviluppo

Prerequisiti

Conosci i tag di raccolta dati e il sito di dimostrazione Luma e hai completato le lezioni precedenti nell’esercitazione:

Convenzioni di denominazione

Per gestire le regole nei tag, si consiglia di seguire una convenzione di denominazione standard. Questa esercitazione utilizza una convenzione di denominazione in cinque parti:

  • [posizione] - [evento] - [scopo] - [ordine]

dove;

  1. posizione è la pagina o le pagine del sito in cui viene attivata la regola
  2. event è il trigger per la regola
  3. scopo è l'azione principale eseguita dalla regola
  4. order è l'ordine in cui attivare la regola in relazione ad altre regole

Creare regole di tag

Nei tag, le regole vengono utilizzate per eseguire azioni (chiamate di attivazione) in varie condizioni. L’estensione dei tag di Platform Web SDK include due azioni utilizzate in questa lezione:

  • Aggiorna variabile associa gli elementi dati alle proprietà in un oggetto XDM
  • Invia evento invia l'oggetto XDM ad Experience Platform Edge Network

Nel resto di questa lezione:

  1. Crea una regola con l'azione Aggiorna variabile per definire una "configurazione globale" dei campi XDM.

  2. Crea regole aggiuntive con l'azione Aggiorna variabile che sostituiscono la "configurazione globale" e contribuiscono con campi XDM aggiuntivi in determinate condizioni (ad esempio, l'aggiunta di dettagli prodotto nelle pagine dei prodotti).

  3. Crea un'altra regola con l'azione Invia evento, che invierà l'oggetto XDM completo a Adobe Experience Platform Edge Network.

Tutte queste regole verranno sequenziate correttamente utilizzando l'opzione "order".

Questo video offre una panoramica del processo:

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

Campi di configurazione globali

Per creare una regola di tag per i campi XDM globali:

  1. Apri la proprietà tag utilizzata per questa esercitazione

  2. Vai a Regole nel menu di navigazione a sinistra

  3. Seleziona il pulsante Crea nuova regola

    Crea una regola

  4. Denomina la regola all pages - library loaded - set global variables - 1

  5. Nella sezione Eventi, seleziona Aggiungi

    Denomina la regola e aggiungi un evento

  6. Utilizza l'Estensione core e seleziona Libreria caricata (parte superiore della pagina) come Tipo evento

  7. Seleziona il menu a discesa Avanzate e immetti 1 come Ordine

    note note
    NOTE
    Minore è il numero d'ordine, prima viene eseguito. Pertanto, alla nostra "configurazione globale" viene assegnato un numero d'ordine basso.

  8. Seleziona Mantieni modifiche per tornare alla schermata della regola principale
    Seleziona trigger caricato dalla libreria

  9. Nella sezione Azioni, seleziona Aggiungi

  10. Come Estensione, seleziona Adobe Experience Platform Web SDK

  11. Come Tipo azione, seleziona Aggiorna variabile

  12. Come elemento dati, seleziona xdm.variable.content creato nella lezione Creare elementi dati

    Aggiorna schema variabile

Ora, mappa i elementi dati con lo schema utilizzato dall'oggetto XDM. È possibile eseguire il mapping a singole proprietà o a interi oggetti. In questo esempio, esegui il mapping a singole proprietà:

  1. Individuare il campo eventType e selezionarlo

  2. Immettere il valore web.webpagedetails.pageViews

    note tip
    TIP
    Per capire quali valori compilare nel campo eventType, è necessario passare alla pagina dello schema e selezionare il campo eventType per visualizzare i valori suggeriti nella barra a destra. Se necessario, puoi anche immettere un nuovo valore.
    valori suggeriti da eventType nella pagina degli schemi

  3. Individuare quindi l'oggetto identityMap nello schema e selezionarlo

  4. Mappa all'elemento dati identityMap.loginID

    Aggiorna mappa identità variabile

    note tip
    TIP
    I campi XDM non verranno inclusi nella richiesta di rete se l’elemento dati è nullo. Pertanto, quando l'utente non è autenticato e l'elemento dati identityMap.loginID è null, l'oggetto identityMap non verrà inviato. Per questo possiamo definirla nella nostra "configurazione globale".

  5. Scorri verso il basso fino a raggiungere l'oggetto web

  6. Seleziona per aprirlo

  7. Mappa i seguenti elementi dati alle corrispondenti web variabili XDM

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

  8. Imposta web.webPageDetials.pageViews.value su 1.

    Aggiorna contenuto variabile

    note tip
    TIP
    Sebbene non sia necessario eventType impostato su web.webpagedetails.pageViews né web.webPageDetails.pageViews.value per consentire ad Adobe Analytics di elaborare un beacon come visualizzazione di pagina, è utile disporre di un modo standard per indicare una visualizzazione di pagina per altre applicazioni a valle.

  9. Seleziona Mantieni modifiche, quindi Salva la regola nella schermata successiva per completare la creazione della regola

Campi pagina prodotto

Ora, inizia a utilizzare Aggiorna variabile in regole aggiuntive in sequenza per arricchire l'oggetto XDM prima di inviarlo a Platform Edge Network.

TIP
L'ordine delle regole determina quale regola viene eseguita per prima quando viene attivato un evento. Se due regole hanno lo stesso tipo di evento, viene eseguito per primo quello con il numero più basso.

Per iniziare, monitora le visualizzazioni del prodotto nella pagina dei dettagli del prodotto di Luma:

  1. Seleziona Aggiungi regola

  2. Denomina ecommerce - library loaded - set product details variables - 20

  3. Seleziona il simbolo + in Evento per aggiungere un nuovo trigger

  4. In Estensione, seleziona Core

  5. In Tipo evento, seleziona Libreria caricata (parte superiore della pagina)

  6. Seleziona per aprire Opzioni avanzate, digita in 20. Questo valore dell'ordine assicura l'esecuzione della regola dopo di all pages - library loaded - set global variables - 1 che imposta la configurazione globale.

  7. Seleziona Mantieni modifiche

    Regole XDM per Analytics

  8. In Condizioni, seleziona Aggiungi

  9. Lascia Tipo di logica come Normale

  10. Lascia Estensione come Core

  11. Seleziona Tipo condizione come Percorso senza stringa di query

  12. A destra, attiva Regex

  13. In path è uguale a set /products/. Per il sito di dimostrazione Luma, assicura che la regola venga attivata solo sulle pagine dei prodotti

  14. Seleziona Mantieni modifiche

    Regole XDM per Analytics

  15. In Azioni selezionare Aggiungi

  16. Seleziona estensione Adobe Experience Platform Web SDK

  17. Seleziona Tipo azione come Aggiorna variabile

  18. Seleziona xdm.variable.content come elemento dati

  19. Scorri verso il basso fino all'oggetto commerce

  20. Apri l'oggetto productViews e imposta value su 1

    imposta visualizzazione prodotto

    note tip
    TIP
    L'impostazione di commerce.productViews.value=1 in XDM viene mappata automaticamente all'evento prodView in Analytics

  21. Scorri verso il basso fino a eventType e impostalo su commerce.productViews

    note note
    NOTE
    Poiché questa regola ha un ordine più alto, sovrascriverà eventType impostato nella regola di "configurazione globale". eventType può contenere un solo valore e si consiglia di impostarlo con l'evento di maggior valore.

  22. Scorri verso il basso fino a e seleziona productListItems array

  23. Seleziona Fornisci singoli elementi

  24. Seleziona Aggiungi elemento

    Impostazione dellevento di visualizzazione prodotto

    note caution
    CAUTION
    productListItems è un tipo di dati array e prevede che i dati vengano inseriti come raccolta di elementi. A causa della struttura del livello dati del sito di dimostrazione Luma e poiché è possibile visualizzare un solo prodotto alla volta sul sito Luma, puoi aggiungere elementi singolarmente. Quando implementi sul tuo sito web, a seconda della struttura del livello dati, potresti essere in grado di fornire un intero array.

  25. Seleziona per aprire Elemento 1

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

    Variabile oggetto XDM SKU prodotto

  27. Seleziona Mantieni modifiche

  28. Seleziona Salva per salvare la regola

Campi carrello

Puoi mappare l’intero array a un oggetto XDM, purché l’array corrisponda al formato dello schema XDM. L’elemento dati del codice personalizzato cart.productInfo creato in precedenza esegue un ciclo nell’oggetto livello dati digitalData.cart.cartEntries su Luma e lo traduce nel formato richiesto dell’oggetto productListItems dello schema XDM.

Per illustrare, consulta il confronto seguente del livello dati del sito Luma (a sinistra) con l’elemento dati tradotto (a destra):

Formato array di oggetti XDM

Confrontare l'elemento dati con la struttura productListItems (suggerimento, dovrebbe corrispondere).

IMPORTANT
Si noti come le variabili numeriche vengono convertite, con valori stringa nel livello dati come price e qty riformattati in numeri nell'elemento dati. Questi requisiti di formato sono importanti per l'integrità dei dati in Platform e vengono determinati durante il passaggio configura schemi. Nell'esempio, quantity utilizza il tipo di dati Integer.
​> Tipo di dati dello schema XDM

Ora associamo il nostro array all’oggetto XDM:

  1. Crea una nuova regola denominata ecommerce - library loaded - set shopping cart variables - 20

  2. Seleziona il simbolo + in Evento per aggiungere un nuovo trigger

  3. In Estensione, seleziona Core

  4. In Tipo evento, seleziona Libreria caricata (parte superiore della pagina)

  5. Seleziona per aprire Opzioni avanzate, digita in 20

  6. Seleziona Mantieni modifiche

    Regole XDM per Analytics

  7. In Condizioni, seleziona Aggiungi

  8. Lascia Tipo di logica come Normale

  9. Lascia Estensioni come Core

  10. Seleziona Tipo condizione come Percorso senza stringa di query

  11. A destra, do not abilita l'interruttore Regex

  12. In path è uguale a set /content/luma/us/en/user/cart.html. Per il sito di dimostrazione Luma, assicura che la regola venga attivata solo sulla pagina del carrello

  13. Seleziona Mantieni modifiche

    Regole XDM per Analytics

  14. In Azioni selezionare Aggiungi

  15. Seleziona estensione Adobe Experience Platform Web SDK

  16. Seleziona Tipo azione come Aggiorna variabile

  17. Seleziona xdm.variable.content come elemento dati

  18. Scorrere verso il basso fino all'oggetto commerce e selezionare per aprirlo.

  19. Apri l'oggetto productListViews e imposta value su 1

    imposta visualizzazione prodotto

    note tip
    TIP
    L'impostazione di commerce.productListViews.value=1 in XDM viene mappata automaticamente all'evento scView in Analytics

  20. Seleziona eventType e imposta su commerce.productListViews

  21. Scorri verso il basso fino a e seleziona l'array productListItems

  22. Seleziona Fornisci intero array

  23. Mappa a cart.productInfo elemento dati

  24. Seleziona Mantieni modifiche

  25. Seleziona Salva per salvare la regola

Crea altre due regole per il pagamento e l’acquisto seguendo lo stesso pattern con le seguenti differenze:

Nome regola: ecommerce - library loaded - set checkout variables - 20

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

  2. Imposta eventType su commerce.checkouts.

  3. Imposta commerce.checkout.value su 1.

    note tip
    TIP
    Equivale a impostare l'evento scCheckout in Analytics

Nome regola: ecommerce - library loaded - set purchase variables - 20

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

  2. Imposta eventType su commerce.purchases.

  3. Imposta commerce.purchases.value su 1.

    note tip
    TIP
    Equivale a impostare l'evento purchase in Analytics

  4. Imposta commerce.order.purchaseID sull'elemento dati cart.orderId

  5. Imposta commerce.order.currencyCode sul valore hardcoded USD

    Impostazione purchaseID per Analytics

    note tip
    TIP
    Equivale a impostare le variabili s.purchaseID e s.currencyCode in Analytics

  6. Scorri verso il basso fino a e seleziona l'array productListItems

  7. Seleziona Fornisci intero array

  8. Mappa a cart.productInfo.purchase elemento dati

  9. Seleziona Mantieni modifiche

  10. Seleziona Salva

Al termine dell’operazione, dovresti vedere che sono state create le seguenti regole.

Regole XDM per Analytics

Invia regola evento

Dopo aver impostato le variabili, puoi creare la regola per inviare l'oggetto XDM completo a Platform Edge Network con l'azione Invia evento.

  1. A destra, seleziona Aggiungi regola per creare un'altra regola

  2. Denomina la regola all pages - library loaded - send event - 50

  3. Nella sezione Eventi, seleziona Aggiungi

  4. Utilizza l'estensione Core e seleziona Library Loaded (Page Top) come Tipo evento

  5. Seleziona il menu a discesa Avanzate e immetti 50 in Ordine. Questa regola verrà attivata dopo tutte le altre regole configurate (che avevano 1 o 20 come Ordine).

  6. Seleziona Mantieni modifiche per tornare alla schermata della regola principale
    Seleziona trigger caricato dalla libreria

  7. Nella sezione Azioni, seleziona Aggiungi

  8. Come Estensione, seleziona Adobe Experience Platform Web SDK

  9. Come Tipo azione, seleziona Invia evento

  10. Come XDM, seleziona l'elemento dati xdm.variable.content creato nella lezione precedente

  11. Seleziona Mantieni modifiche per tornare alla schermata della regola principale

    Aggiungi azione Invia evento

  12. Seleziona Salva per salvare la regola

    Salva la regola

Pubblicare le regole in una libreria

Successivamente, pubblica la regola nell'ambiente di sviluppo in modo da poterne verificare il funzionamento.

Per creare una libreria:

  1. Vai a Flusso di pubblicazione nel menu di navigazione a sinistra

  2. Seleziona Aggiungi libreria

    Seleziona Aggiungi libreria

  3. Per Name, immetti Luma Web SDK Tutorial

  4. Per l'ambiente, selezionare Development

  5. Seleziona Aggiungi tutte le risorse modificate

    note note
    NOTE
    Dovresti visualizzare tutti i componenti tag creati nelle lezioni precedenti. L’estensione Core contiene il JavaScript di base richiesto da tutte le proprietà dei tag web.

  6. Seleziona Salva e genera per sviluppo

    Crea e genera la libreria

La creazione della libreria potrebbe richiedere alcuni minuti e al termine viene visualizzato un punto verde a sinistra del nome della libreria:

Build completata

Come puoi vedere nella schermata Flusso di pubblicazione, il processo di pubblicazione richiede molto di più, il che va oltre l'ambito di questa esercitazione. Questo tutorial utilizza una sola libreria nell’ambiente di sviluppo.

Ora puoi convalidare i dati nella richiesta utilizzando Adobe Experience Platform Debugger.

NOTE
Grazie per aver dedicato tempo all'apprendimento di Adobe Experience Platform Web SDK. Se hai domande, vuoi condividere commenti generali o suggerimenti su contenuti futuri, condividili in questo post di discussione della community Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4