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
Crea e configura 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.
- Denominarlo
"Adobe managed"e selezionare Managed by Adobe nell'elenco a discesa Tipo. Fai clic su Salva. - Passare a Environments, quindi fare clic su Add Environment.
- Selezionare Development, denominarlo
"Dev Environment", quindi selezionare l'Adobe di host gestito dall'elenco a discesa. Fai clic su Save. - Viene visualizzata una finestra modale con le istruzioni di installazione Web. Torneremo a questa finestra in un secondo momento; per ora fai clic su Close.
- Fare clic su Add Environment, selezionare Staging, denominarlo
"Staging Environment", quindi selezionare l'Adobe di host gestito. Fare clic su Create, quindi chiudere la finestra modale delle istruzioni di installazione. - Fare di nuovo clic su Add Environment, selezionare Production, denominarlo
"Production Environment", quindi selezionare l'host gestito dell'Adobe. Fare clic su Create, quindi chiudere la finestra modale delle 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.
- Fare clic sulla scheda Publishing Flow, quindi su Add Library. Per ulteriori informazioni su questa pagina, consulta Panoramica sulla pubblicazione nella documentazione dei tag.
- Assegnare un nome alla libreria
'Initial changes'e selezionare l'ambiente di sviluppo. - Fai clic su Add All Changed Resources, che elenca automaticamente Adobe Analytics, Identity Service e Core.
- Fai clic su Save.
- Tornando alla schermata del flusso di lavoro di pubblicazione, fare clic sull'elenco a discesa accanto alla nuova raccolta e quindi fare clic su Build for Development. Dopo alcuni secondi, il punto giallo sulla libreria diventa verde, a indicare che la build è stata eseguita correttamente.
- Passa 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 tag
<head>sul tuo 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. È possibile scegliere di caricare i tag della libreria in modo sincrono impostando l'opzione 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 compilazione 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
Convalida l'implementazione di Analytics e pubblica in produzione: inizia a trarre valore da Adobe Analytics.