Implementazione di Analytics in un ambiente di sviluppo
Dopo aver creato e configurato una proprietà tag, le librerie sono pronte per essere distribuite e il codice implementato sul sito.
Prerequisiti
Creare e configurare una proprietà tag per Adobe Analytics: accedi allo strumento e crea uno spazio per l’implementazione di Analytics.
Creare adattatori e ambienti
I tag consentono di gestire molti flussi di lavoro organizzativi durante la distribuzione del codice. Per creare i componenti minimi necessari per un’implementazione di Analytics, segui la procedura riportata di seguito. In qualità di amministratore di tag, puoi lavorare all’interno della tua organizzazione per stabilire il flusso di lavoro corretto per la distribuzione di soluzioni Adobe.
- Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
- Fai clic sulla proprietà tag che intendi implementare sul sito.
- Fai clic su Hosts, quindi su Add Host.
- Assegna un nome
"Adobe managed", e seleziona Managed by Adobe nell'elenco a discesa tipo. Fai clic su Salva. - Accedi a Environments, quindi fai clic su Add Environment.
- Seleziona Development, denominalo
"Dev Environment", quindi seleziona l’host gestito dell’Adobe dall’elenco a discesa. Fai clic su Save (Usa modello di attribuzione non predefinito). - Viene visualizzata una finestra modale con le istruzioni di installazione Web. Torneremo a questa finestra in un secondo momento; fai clic su Close per ora.
- Clic Add Environment, seleziona Staging, denominalo
"Staging Environment", quindi seleziona l’host gestito dell’Adobe. Clic Create, quindi chiudere la finestra modale di istruzioni di installazione. - Clic Add Environment di nuovo, seleziona Production, denominalo
"Production Environment", quindi seleziona l’host gestito dell’Adobe. Clic Create, quindi chiudere la finestra modale di istruzioni di installazione.
Creare una libreria di sviluppo
Nonostante tutte le modifiche e le configurazioni apportate finora, non è stato effettivamente pubblicato alcun codice. La creazione di una libreria, tradotta approssimativamente come una raccolta di modifiche, consente la pubblicazione di codice da utilizzare sul sito.
- Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
- Fai clic sulla proprietà tag che intendi implementare sul sito.
- Fai clic su Publishing Flow , quindi fai clic su Add Library. Consulta Panoramica sulla pubblicazione nella documentazione sui tag per ulteriori informazioni su questa pagina.
- Denomina la libreria
'Initial changes'e seleziona il tuo ambiente di sviluppo. - Clic Add All Changed Resources, che elenca automaticamente Adobe Analytics, Identity Service e Core.
- Fai clic su Save (Usa modello di attribuzione non predefinito).
- Torna alla schermata del flusso di lavoro di pubblicazione, fai clic sull’elenco a discesa accanto alla nuova libreria e fai clic su Build for Development. Dopo alcuni secondi, il punto giallo sulla libreria diventa verde, a indicare che la build è stata eseguita correttamente.
- Accedi a Environments, quindi fai clic sull’icona installa a destra dell’ambiente di sviluppo. Questa azione apre nuovamente la finestra modale Istruzioni di installazione Web.
- Copia i blocchi di codice e forniscili ai proprietari del sito web della tua organizzazione.
Installare i tag nell’ambiente di sviluppo del sito web
Se controlli il codice del sito web, implementa ogni blocco di codice nella rispettiva posizione:
- Il tag principale appartiene al
<head>sul sito. - Se scegli di caricare i tag in modo sincrono, devi includere anche un secondo blocco di codice appena sotto il tag di chiusura
</body>sul sito. Puoi scegliere di caricare i tag della libreria in modo sincrono attivando/disattivando Load Library Asynchronously nelle istruzioni di installazione Web.
Il codice di tag viene in genere inserito nel modello generale del sito. Una pagina vuota contenente solo il codice di implementazione avrà l'aspetto seguente:
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Example page</title>
<script src="//assets.adobedtm.com/launch-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-development.min.js"></script>
</head>
<body>
<p>This is a test page.</p>
<!-- Only include this extra code if you load tags synchronously -->
<script type="text/javascript">_satellite.pageBottom();</script>
</body>
</html>
Risoluzione dei problemi
Tentativo di generazione non riuscito.
Un motivo comune è che gli elementi esistono già in altre librerie inviate allo staging o alla produzione. Durante la creazione iniziale delle librerie, accertati che solo le risorse modificate vengano aggiunte alla libreria.
Passaggi successivi
Convalidare l’implementazione di Analytics e pubblicare in produzione: inizia a ottenere valore da Adobe Analytics.