DocumentazioneExperience PlatformTutorial su Web SDK

Creare regole di tag

Last update: Sat Jun 01 2024 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 all’Edge Network di Platform 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 la Sito di dimostrazione Luma e hanno 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. evento è il trigger della regola
  3. scopo è l’azione principale eseguita dalla regola
  4. ordine è l'ordine in cui la regola deve essere attivata 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 mappa gli elementi dati alle proprietà in un oggetto XDM
  • Invia evento invia l'oggetto XDM ad Experienci Platform Edge Network

Nel resto di questa lezione:

  1. Creare una regola con Aggiorna variabile azione per definire una "configurazione globale" di campi XDM.

  2. Creare regole aggiuntive con Aggiorna variabile azione che sovrascrive la "configurazione globale" e contribuisce con campi XDM aggiuntivi in determinate condizioni (ad esempio, l’aggiunta di dettagli del prodotto nelle pagine dei prodotti).

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

Tutte queste regole saranno sequenziate correttamente utilizzando il comando "ordine".

Questo video offre una panoramica del processo:

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

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 la Crea nuova regola pulsante

    Creare una regola

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

  5. In Eventi sezione, seleziona Aggiungi

    Denomina la regola e aggiungi un evento

  6. Utilizza il Estensione core e seleziona Library Loaded (Page Top) come Tipo di evento

  7. Seleziona Avanzate a discesa e immettere 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 principale delle regole
    Seleziona attivatore caricato dalla libreria

  9. In Azioni sezione, seleziona Aggiungi

  10. Come Estensione, seleziona Adobe Experience Platform Web SDK

  11. Come Tipo di azione, seleziona Aggiorna variabile

  12. Come Elemento dati, seleziona la xdm.variable.content creato in Creare elementi dati lezione

    Aggiorna schema variabile

Ora, mappa il tuo elementi dati al 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. Inserisci il valore web.webpagedetails.pageViews

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

  3. Quindi, trova il identityMap nello schema e selezionarlo

  4. Mappa su identityMap.loginID elemento dati

    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 il identityMap.loginID l'elemento dati è nullo, l' identityMap l'oggetto non verrà inviato. Per questo possiamo definirla nella nostra "configurazione globale".

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

  6. Seleziona per aprirlo

  7. Mappa i seguenti elementi dati al corrispondente web Variabili XDM

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

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

    Aggiorna contenuto variabile

    note tip
    TIP
    Mentre nessuno dei due eventType imposta su web.webpagedetails.pageViews né web.webPageDetails.pageViews.value sono necessari affinché Adobe Analytics possa elaborare un beacon come visualizzazione di pagina; è utile disporre di una modalità standard per indicare una visualizzazione di pagina per altre applicazioni a valle.

  9. Seleziona Mantieni modifiche e poi 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 Edge Network piattaforma.

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. Assegna un nome ecommerce - library loaded - set product details variables - 20

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

  4. Sotto Estensione, seleziona Core

  5. Sotto Tipo di evento, seleziona Library Loaded (Page Top)

  6. Seleziona per aprire Opzioni avanzate, digitare 20. Questo valore dell’ordine garantisce l’esecuzione della regola dopo il all pages - library loaded - set global variables - 1 che imposta la configurazione globale.

  7. Seleziona Mantieni modifiche

    Regole XDM per Analytics

  8. Sotto Condizioni, seleziona per Aggiungi

  9. Esci Tipo di logica as Normale

  10. Esci Estensione as Core

  11. Seleziona Tipo di condizione as Percorso senza stringa di query

  12. A destra, abilita Regex attivare/disattivare

  13. Sotto 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. Sotto Azioni seleziona Aggiungi

  16. Seleziona Adobe Experience Platform Web SDK estensione

  17. Seleziona Tipo di azione as Aggiorna variabile

  18. Seleziona xdm.variable.content come Elemento dati

  19. Scorri verso il basso fino a commerce oggetto

  20. Apri productViews oggetto e set valore a 1

    configurare la visualizzazione prodotto

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

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

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

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

  23. Seleziona Fornisci singoli elementi

  24. Seleziona Aggiungi elemento

    Impostazione dell’evento di visualizzazione prodotto

    note caution
    CAUTION
    Il productListItems è un array tipo di dati in modo che preveda che i dati vengano inseriti come una 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 del 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. Elemento dati del codice personalizzato cart.productInfo sono stati creati cicli precedenti in digitalData.cart.cartEntries oggetto livello dati su Luma e lo traduce nel formato richiesto del productListItems oggetto 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

Confronta l’elemento dati con productListItems struttura (suggerimento, deve corrispondere).

IMPORTANT
Nota come le variabili numeriche vengono tradotte, con valori stringa nel livello dati come price e qty viene riformattato in numeri nell’elemento dati. Questi requisiti di formato sono importanti per l’integrità dei dati in Platform e vengono determinati durante configurare gli schemi passaggio. Nell’esempio, quantità utilizza Intero tipo di dati.
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 la simbolo + in Evento per aggiungere un nuovo trigger

  3. Sotto Estensione, seleziona Core

  4. Sotto Tipo di evento, seleziona Library Loaded (Page Top)

  5. Seleziona per aprire Opzioni avanzate, digitare 20

  6. Seleziona Mantieni modifiche

    Regole XDM per Analytics

  7. Sotto Condizioni, seleziona per Aggiungi

  8. Esci Tipo di logica as Normale

  9. Esci Estensioni as Core

  10. Seleziona Tipo di condizione as Percorso senza stringa di query

  11. Sulla destra, non abilita Regex attivare/disattivare

  12. Sotto 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. Sotto Azioni seleziona Aggiungi

  15. Seleziona Adobe Experience Platform Web SDK estensione

  16. Seleziona Tipo di azione as Aggiorna variabile

  17. Seleziona xdm.variable.content come Elemento dati

  18. Scorri verso il basso fino a commerce e selezionare per aprirlo.

  19. Apri productListViews oggetto e set valore a 1

    configurare la visualizzazione prodotto

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

  20. Seleziona eventType e impostato su commerce.productListViews

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

  22. Seleziona Fornire l'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 all'impostazione scCheckout evento 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 all'impostazione purchase evento in Analytics

  4. Imposta commerce.order.purchaseID al cart.orderId elemento dati

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

    Impostazione purchaseID per Analytics

    note tip
    TIP
    Equivale all'impostazione s.purchaseID e s.currencyCode variabili in Analytics

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

  7. Seleziona Fornire l'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 all’Edge Network di Platform con Invia evento azione.

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

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

  3. In Eventi sezione, seleziona Aggiungi

  4. Utilizza il Estensione core e seleziona Library Loaded (Page Top) come Tipo di evento

  5. Seleziona Avanzate a discesa e immettere 50 in Ordine. Questo assicurerà che questa regola venga attivata dopo tutte le altre regole configurate (che avevano 1 o 20 come loro Ordine).

  6. Seleziona Mantieni modifiche per tornare alla schermata principale delle regole
    Seleziona attivatore caricato dalla libreria

  7. In Azioni sezione, seleziona Aggiungi

  8. Come Estensione, seleziona Adobe Experience Platform Web SDK

  9. Come Tipo di azione, seleziona Invia evento

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

  11. Seleziona Mantieni modifiche per tornare alla schermata principale delle regole

    Aggiungere l’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 Nome, immetti Luma Web SDK Tutorial

  4. Per Ambiente, seleziona 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

    Creare e generare la libreria

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

Compilazione completata

Come è possibile vedere sul Flusso di pubblicazione , il processo di pubblicazione offre molto di più, 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 l’Adobe Experience Platform Debugger.

Next

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