Ambienti
Gli ambienti di tag definiscono diversi aspetti chiave delle build della libreria che distribuisci sul sito web o sull’app:
- Il nome file della build.
- Il dominio e il percorso della build, a seconda dell’host assegnato dell’ambiente.
- Il formato del file della build, a seconda dell’opzione di archiviazione scelta.
Quando crei una build della libreria, devi assegnarla a un ambiente. Le estensioni, le regole e gli elementi dati della build vengono quindi compilati e inseriti nell’ambiente assegnato. Ogni ambiente fornisce un codice di incorporamento univoco che consente di integrare la build assegnata nel sito.
In ciascun ambiente possono esistere artefatti di diversi. In questo modo è possibile sottoporre a test librerie diverse in ambienti diversi quando vengono trasmesse tramite il flusso di lavoro.
In questo documento sono descritti i passaggi necessari per installare, configurare e creare diversi ambienti nell’interfaccia utente di Data Collection.
Tipi di ambiente
I tag supportano tre tipi di ambiente diversi, ciascuno corrispondente a uno stato diverso nel flusso di lavoro di pubblicazione:
In ciascun ambiente possono esistere artefatti di diversi. Ciò ti consente di testare librerie diverse in ambienti diversi mentre le sottoponi al flusso di lavoro di pubblicazione.
Installazione installation
Ogni ambiente presenta una serie di istruzioni per connettersi all’applicazione. Per le proprietà web, queste istruzioni forniscono codici di incorporamento. Per le proprietà mobili, tali istruzioni forniscono il codice necessario per creare istanze delle librerie in uso e recuperare la configurazione in fase di esecuzione.
Per accedere alle istruzioni di installazione per un ambiente, esplora la scheda Ambienti della proprietà, quindi seleziona l’icona Installa dell’ambiente in questione.
Se utilizzi una proprietà web, riceverai un codice di incorporamento da utilizzare nel tag <head>
del documento. Avrai inoltre la possibilità di distribuire i file della libreria in modo sincrono o asincrono in fase di esecuzione. A seconda dell’impostazione scelta, le istruzioni di installazione visualizzate saranno diverse. I codici di incorporamento sono descritti più avanti in questo documento.
Se utilizzi una proprietà mobile, riceverai istruzioni separate per l’installazione delle dipendenze per Android (tramite Gradle) e iOS (tramite CocoaPods).
Configurazione dispositivi mobili
Per le proprietà dei dispositivi mobili, puoi visualizzare le opzioni di configurazione per un ambiente selezionandole dall’elenco. Da qui è possibile cambiare il nome dell’ambiente. Al momento, per gli ambienti mobili è possibile utilizzare solo host gestiti da Adobe.
Per ulteriori informazioni, consulta la panoramica sugli host.
Configurazione web
Le impostazioni dell’ambiente assegnato determinano quanto segue per le proprietà web:
- Host: il percorso del server in cui desideri distribuire la build.
- Impostazione di archiviazione: indica se il sistema restituisce un set di file distribuibili o se comprime i file in un formato di archiviazione.
- Codice di incorporamento: il codice
<script>
da incorporare nell’HTML delle pagine del sito web, utilizzato per distribuire la build della libreria in fase di esecuzione.
Nella scheda Ambienti, seleziona uno degli ambienti elencati per visualizzare i relativi comandi di configurazione.
Host host
Seleziona Host per scegliere dal menu a discesa un host preconfigurato per l’ambiente.
Quando viene creata una build, questa viene consegnata alla posizione specificata per l’host assegnato. Per informazioni su come creare e configurare gli host tag, consulta la panoramica sugli host.
Impostazione di archiviazione archive
La maggior parte delle build consiste in più file. Le build con più file contengono un file di libreria principale (collegato nel codice di incorporamento) contenente riferimenti interni agli altri file, che vengono recuperati a seconda delle necessità.
Il pulsante Crea archivio consente di attivare/disattivare l’impostazione di archiviazione dell’ambiente. Per impostazione predefinita, l’opzione di archiviazione è disattivata e la build viene consegnata in un formato che viene eseguito così com’è (JavaScript per le proprietà web e JSON per le proprietà mobili).
Se scegli di attivare l’impostazione di archiviazione, verranno mostrate ulteriori impostazioni di configurazione nell’interfaccia utente con cui puoi scegliere di crittografare il file di archivio e definire un percorso per la libreria se utilizzi l’hosting autonomo.
Il percorso può essere un URL completo o un percorso relativo che può essere utilizzato in più domini. Questo è importante, in quanto la maggior parte delle build hanno più file che contengono riferimenti interni gli uni agli altri.
Se utilizzi l’opzione di archiviazione, tutti i file della build vengono consegnati come un file ZIP. Questo può risultare utile se:
- Utilizzi l’hosting autonomo per la libreria ma non vuoi impostare un host SFTP per la consegna.
- Prima della distribuzione devi eseguire l’analisi del codice sulla build.
- Vuoi solamente esaminare i contenuti della build per vedere cosa comprendono.
Codice di incorporamento embed-code
Un codice di incorporamento è un tag <script>
che deve essere inserito nelle sezioni <head>
delle pagine del sito web per caricare ed eseguire il codice generato. Ogni configurazione dell’ambiente genera automaticamente il proprio codice di incorporamento, pertanto è necessario solo copiarlo e incollarlo nel sito, sulle pagine in cui desideri che vengano eseguiti i tag.
Quando visualizzi le istruzioni di installazione, puoi scegliere se fare in modo che lo script carichi i file della libreria in modo sincrono o asincrono. L’impostazione non è permanente e non riflette il modo in cui i tag sono stati effettivamente implementati sul sito. La sua funzione è quella di mostrare come installare l’ambiente nel modo giusto.
Implementazione asincrona
La distribuzione asincrona consente al browser di continuare a caricare il resto della pagina mentre viene recuperata la libreria. Quando utilizzi questa impostazione, è disponibile un solo codice di incorporamento, che deve essere inserito nella sezione <head>
del documento.
Per ulteriori informazioni su questa impostazione, consulta la guida alla distribuzione asincrona.
Distribuzione sincrona
Quando il browser legge un codice di incorporamento utilizzando la distribuzione sincrona, recupera la libreria di tag e la esegue prima di continuare a caricare la pagina.
I codici di incorporamento sincroni sono costituiti da due tag <script>
che devono essere inseriti all’interno dell’HTML del sito web. Un tag <script>
va inserito nella sezione <head>
del documento, mentre l’altro deve essere posizionato immediatamente prima del tag </body>
di chiusura.
Aggiornamenti del codice di incorporamento
Poiché i codici di incorporamento vengono generati in base alle configurazioni dell’ambiente, alcune modifiche alla configurazione aggiorneranno automaticamente il codice di incorporamento per l’ambiente in questione. Queste modifiche includono:
- Il passaggio da un host gestito da Adobe a un host SFTP, o viceversa.
- La modifica dell’impostazione di archiviazione.
- L’aggiornamento del campo percorso se l’impostazione di archiviazione è abilitata.
Creare un ambiente
Tre ambienti vengono assegnati automaticamente a una proprietà quando questa viene creata: sviluppo, staging e produzione. Questo è sufficiente per eseguire il flusso di lavoro di pubblicazione. Tuttavia, se lo desideri, puoi aggiungere altri ambienti di sviluppo. Ciò può essere particolarmente utile per i team più grandi, dove più sviluppatori lavorano contemporaneamente a progetti diversi.
Nella scheda Ambienti della proprietà, seleziona Aggiungi ambiente.
Nella schermata successiva, seleziona l’opzione Sviluppo.
La schermata successiva consente di denominare il nuovo ambiente, selezionare un host e scegliere un’impostazione di archiviazione. Al termine, seleziona Salva per creare l’ambiente.
Viene visualizzata nuovamente la scheda Ambienti con le istruzioni di installazione per il nuovo ambiente.
Passaggi successivi
Dopo aver letto questo documento, avrai acquisito conoscenze pratiche per configurare gli ambienti nell’interfaccia utente e installarli nel sito web o nell’app. Ora puoi iniziare a pubblicare le build della libreria.
Man mano che pubblichi le iterazioni della libreria, potresti avere la necessità di monitorare e archiviare le build precedenti per la risoluzione dei problemi e il ripristino. Per ulteriori informazioni, consulta la guida alla ripubblicazione di librerie precedenti.