Ambienti

NOTA

Adobe Experience Platform Launch è stato classificato come una suite di tecnologie di raccolta dati in Adobe Experience Platform. Di conseguenza, sono state introdotte diverse modifiche terminologiche nella documentazione del prodotto. Consulta questo documento come riferimento consolidato delle modifiche terminologiche.

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.

Questo documento descrive come installare, configurare e creare ambienti diversi nell’interfaccia utente di Raccolta dati.

Tipi di ambiente

I tag supportano tre diversi tipi di ambiente, ciascuno corrispondente a uno stato diverso nel flusso di lavoro di pubblicazione:

Tipo di ambiente Descrizione
Sviluppo Questo ambiente corrisponde alla colonna Development nel flusso di lavoro di pubblicazione.
Staging Questo ambiente corrisponde alle colonne Submitted e Approved nel flusso di lavoro di pubblicazione.
Produzione Questo ambiente corrisponde alla colonna Published nel flusso di lavoro di pubblicazione.

Possono esistere diversi artefatti di in ciascun ambiente. Ciò ti consente di testare librerie diverse in ambienti diversi mentre le sottoponi al flusso di lavoro di pubblicazione.

NOTA

A ogni ambiente può essere assegnata una sola build della libreria alla volta. Tuttavia, è previsto che nel corso del tempo un singolo ambiente contenga diverse build man mano che esse vengono spostate nel flusso di lavoro di pubblicazione e che le build vengano ridistribuite tra gli ambienti in base alle esigenze.

Installazione

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.

IMPORTANTE

Ogni tipo di ambiente dispone delle relative istruzioni di installazione. A seconda dell’ambiente in uso, è necessario assicurarsi di utilizzare le dipendenze e/o i codici di incorporamento corrispondenti corretti.

Ad esempio, il codice di incorporamento di produzione per una proprietà web supporta la memorizzazione in cache del browser, mentre i codici di incorporamento di sviluppo e di staging no lo supportano. Pertanto, è preferibile non utilizzare i codici di incorporamento di sviluppo e di staging in contesti di produzione o di traffico elevato.

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

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 nell’interfaccia utente di raccolta dati, consulta la panoramica sugli host.

Impostazione di archiviazione

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:

  1. Utilizzi l’hosting autonomo per la libreria ma non vuoi impostare un host SFTP per la consegna.
  2. Prima della distribuzione devi eseguire l’analisi del codice sulla build.
  3. Vuoi solamente esaminare i contenuti della build per vedere cosa comprendono.

Codice di incorporamento

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 devi 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. Questa impostazione non è permanente e non riflette il modo in cui i tag sono stati implementati sul sito. La sua funzione è quella di mostrare come installare l’ambiente nel modo giusto.

AVVERTENZA

A seconda del contenuto della libreria di tag, il comportamento delle regole e di altri elementi può variare tra la distribuzione sincrona e asincrona. È quindi importante verificare accuratamente tutte le modifiche apportate.

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 ed esegue tale operazione 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.
AVVERTENZA

Quando il codice di incorporamento di un ambiente tag cambia, devi aggiornare manualmente i codici di incorporamento nel codice HTML. Per evitare costi di manutenzione, è necessario aggiornare i codici di incorporamento solo se assolutamente necessario.

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.

In questa pagina