Guida introduttiva all’estensione tag Web SDK
Utilizza i tag di Adobe Experience Platform (precedentemente Launch) per inviare i dati dell’evento dal tuo sito Web alle soluzioni Edge Network e Adobe a valle.
Prima di seguire questi passaggi, assicurati di poter accedere ai seguenti diritti di proprietà:
- Sviluppa
- Gestione estensioni
Inoltre, assicurati di disporre di tutte le autorizzazioni nelle seguenti categorie:
- Modellazione dati
- Identità
Creare uno schema XDM schema
Experience Data Model (XDM) è una specifica open-source che fornisce strutture e definizioni comuni per i dati sotto forma di schemi. La configurazione di uno schema è vivamente consigliata per l’invio di dati ad Edge Network.
- Accedi a CX Enterprise utilizzando le credenziali Adobe ID.
- Passa a Raccolta dati > Schemi.
- Seleziona Crea schema.
- Seleziona Experience Event, quindi seleziona Next.
- Assegna allo schema un nome desiderato, quindi seleziona Fine.
- (Facoltativo) Puoi aggiungere altri campi o gruppi di campi per qualsiasi dato aggiuntivo che desideri raccogliere.
Creare un flusso di dati datastream
Un Datastream è una configurazione che indica all’Edge Network come gestire i dati inviati. Quando configuri un flusso di dati per inviare dati a un determinato prodotto, il flusso di dati trasmette automaticamente i dati rilevanti a ciascun prodotto in modo comprensibile per il prodotto specifico.
- Passa a Raccolta dati > Flussi dati.
- Seleziona Nuovo flusso di dati.
- Assegna allo stream di dati un nome desiderato e seleziona lo schema creato di recente in Schema di mappatura.
- Seleziona Salva.
Creare una proprietà tag
Dopo aver creato uno schema e un flusso di dati, puoi creare e configurare una proprietà tag.
- Passa a Raccolta dati > Tag.
- Seleziona Nuova proprietà.
- Assegna alla proprietà tag il nome e il dominio desiderati, quindi seleziona Salva.
Installare l’estensione tag
L’estensione tag Web SDK viene installata in una determinata proprietà tag.
- Passa a Raccolta dati > Tag > Estensioni.
- Selezionare la scheda Catalogo.
- Utilizzare la ricerca per individuare l’estensione Adobe Experience Platform Web SDK.
- Seleziona la scheda dell’estensione, quindi fai clic su Installa a destra.
Configurare l’estensione tag
Quando si installa l’estensione tag Web SDK, viene automaticamente visualizzata la pagina Configurazione.
- Nella sezione Datastreams, seleziona lo stream di dati desiderato per ogni ambiente.
Tutte le altre impostazioni di configurazione vengono compilate automaticamente o sono facoltative. Imposta le impostazioni di configurazione desiderate, quindi seleziona Salva.
Creare un elemento dati variabile
Adobe consiglia di utilizzare gli elementi dati Variable per memorizzare il payload da inviare ad Adobe. Anche gli oggetti XDM sono elementi di dati disponibili, ma sono più vecchi e più limitati nei casi di utilizzo applicabili.
-
Passa a Raccolta dati > Tag.
-
Seleziona la proprietà tag desiderata.
-
Seleziona Elementi dati > Crea nuovo elemento dati.
-
Assegna all’elemento dati le seguenti proprietà a sinistra:
- Nome: qualsiasi nome desiderato
- Estensione: Adobe Experience Platform Web SDK
- Tipo di elemento dati: Variabile
-
Imposta le seguenti proprietà a destra:
Tipo di variabile: XDM
Sandbox: la sandbox in cui hai creato lo schema
Schema: lo schema desiderato -
Seleziona Salva.
Creare una regola
Le regole determinano quando attivare qualcosa o impostare variabili. La creazione di una regola che viene eseguita ogni volta che viene caricata la libreria consente di popolare facilmente le variabili che desideri contengano un valore su ogni pagina.
-
Passa a Raccolta dati > Tag.
-
Seleziona la proprietà tag desiderata.
-
Seleziona Regole > Aggiungi regola.
-
Assegna alla regola un nome desiderato.
-
Selezionare l’icona ‘
+’ accanto a Eventi. -
Attribuisci all’evento le seguenti impostazioni:
- Estensione: Core
- Tipo evento: Libreria caricata (parte superiore della pagina)
-
Seleziona Mantieni modifiche.
I passaggi precedenti stabiliscono la parte dei criteri della regola, che viene attivata una volta caricata la libreria. Le seguenti misure stabiliscono l’azione da intraprendere quando tale criterio è soddisfatto.
-
Selezionare l’icona ‘
+’ accanto a Azioni. -
Assegna all’azione le seguenti impostazioni a sinistra:
- Estensione: Adobe Experience Platform Web SDK
- Tipo azione: Invia evento
-
Imposta i seguenti campi a destra:
- XDM: elemento dati della variabile XDM
-
Seleziona Mantieni modifiche.
Pubblicazione
La proprietà tag contiene tutti i componenti necessari per inviare dati ad Edge Network.
- Passa a Raccolta dati > Flusso di pubblicazione.
- Seleziona Aggiungi libreria.
- Assegna alla libreria un nome desiderato. Considerare questo nome simile al nome di un commit quando si utilizza il software di controllo delle versioni.
- Imposta il menu a discesa dell’ambiente su Sviluppo.
- Selezionare Aggiungi tutte le risorse modificate.
- Seleziona Salva e genera in sviluppo.
Le modifiche ora vengono implementate nell’ambiente di sviluppo.
- Passa a Raccolta dati > Ambienti.
- Seleziona l’icona Installa accanto all’ambiente di sviluppo.
- Installa il codice da incorporare in una pagina web di prova sul sito.
Dopo aver verificato che il tag funziona nell’ambiente di sviluppo, puoi utilizzare l’interfaccia Flusso di pubblicazione per pubblicare la libreria nell’ambiente di staging e infine in produzione.
- Aggiungi l’estensione e la regola a una Libreria, generala in un Ambiente e installa il codice di incorporamento sul tuo sito.
- Convalida con Adobe Experience Platform Debugger.
Ora disponi di una configurazione snella che acquisisce gli eventi e li invia ad Edge Network. Ora puoi rafforzare ulteriormente l’implementazione aggiungendo campi allo schema, prodotti a un flusso di dati o elementi di dati alla proprietà tag.