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à:
- Develop
- Manage extensions
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 experience.adobe.com utilizzando le credenziali Adobe ID.
- Passa a Data Collection > Schemas.
- Seleziona Create schema.
- Seleziona Experience Event, quindi seleziona Next.
- Assegnare allo schema un nome desiderato, quindi selezionare Finish.
- (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 Data Collection > Datastreams.
- Seleziona New datastream.
- Assegnare allo stream di dati un nome desiderato e selezionare lo schema creato di recente in Mapping schema.
- Seleziona Save.
Creare una proprietà tag
Dopo aver creato uno schema e un flusso di dati, puoi creare e configurare una proprietà tag.
- Passa a Data Collection > Tags.
- Seleziona New property.
- Assegna alla proprietà tag il nome e il dominio desiderati, quindi seleziona Save.
Installare l’estensione tag
L'estensione tag Web SDK viene installata in una determinata proprietà tag.
- Passa a Data Collection > Tags > Extensions.
- Seleziona la scheda Catalog.
- Utilizzare la ricerca per individuare l'estensione Adobe Experience Platform Web SDK.
- Seleziona la scheda dell'estensione, quindi fai clic su Install 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. Impostare le impostazioni di configurazione desiderate, quindi selezionare Save.
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 Data Collection > Tags.
-
Seleziona la proprietà tag desiderata.
-
Selezionare Data elements > Create new data element.
-
Assegna all'elemento dati le seguenti proprietà a sinistra:
- Name: qualsiasi nome desiderato
- Extension: Adobe Experience Platform Web SDK
- Data element type: Variable
-
Imposta le seguenti proprietà a destra:
Tipo di variabile: XDM
Sandbox: la sandbox in cui hai creato lo schema
Schema: lo schema desiderato -
Seleziona Save.
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 Data Collection > Tags.
-
Seleziona la proprietà tag desiderata.
-
Selezionare Rules > Add rule.
-
Assegna alla regola un nome desiderato.
-
Selezionare l'icona '
+' accanto a Events. -
Attribuisci all’evento le seguenti impostazioni:
- Extension: Core
- Event type: Library loaded (page top)
-
Seleziona Keep changes.
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 Actions. -
Assegna all’azione le seguenti impostazioni a sinistra:
- Extension: Adobe Experience Platform Web SDK
- Action type: Send event
-
Imposta i seguenti campi a destra:
- XDM: elemento dati della variabile XDM
-
Seleziona Keep changes.
Pubblicazione
La proprietà tag contiene tutti i componenti necessari per inviare dati ad Edge Network.
- Passa a Data Collection > Publishing flow.
- Seleziona Add library.
- Assegna alla libreria un nome desiderato. Considerare questo nome simile al nome di un commit quando si utilizza il software di controllo delle versioni.
- Impostare il menu a discesa dell'ambiente su Development.
- Seleziona Add all changed resources.
- Seleziona Save & build to Development.
Le modifiche ora vengono implementate nell'ambiente di sviluppo.
- Passa a Data Collection > Environments.
- 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, è possibile utilizzare l'interfaccia Publishing flow 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.