Collegare un codice DTM da incorporare

NOTA

Adobe Experience Platform Launch viene riclassificato come una suite di tecnologie di raccolta dati nell’Experience Platform. Queste modifiche verranno implementate in tutta la documentazione del prodotto nelle prossime settimane. Fare riferimento al seguente documento per un riferimento consolidato delle modifiche terminologiche.

Il collegamento dei codici da incorporare si applica principalmente agli utenti di Dynamic Tag Management (DTM) e di Adobe Experience Platform Launch che utilizzano l’hosting Akamai incorporato. Se hai optato per il self-hosting, consulta la sezione self-hosting alla fine dell'articolo.

Codice di incorporamento

Un codice di incorporamento di DTM è un tag <script> che incorpori nell'HTML della pagina Web.

Questo tag <script> recupera un file JavaScript pubblicato da DTM e lo carica sulla pagina. Questo file è il file di libreria DTM, comunemente denominato tag contenitore. Questo tag contenitore contiene tutti gli strumenti, le definizioni degli elementi dati, la logica delle regole e il codice definito all'interno di DTM.

DTM pubblica questo file tag contenitore all'host Web specificato, che è una posizione di Akamai o una posizione FTP personalizzata. Il codice da incorporare fornito da DTM è basato su questa posizione host.

Quando un utente visita il sito in un browser, il browser richiede il file DTM da questo server, utilizzando il codice incorporato e lo carica.

Nel diagramma seguente, il passaggio 1 mostra il DTM che pubblica il tag contenitore su un host Web specifico. Nel passaggio 2, il browser richiede il tag contenitore, utilizzando il codice incorporato, e l'host risponde con il file pubblicato.

Collegamento dei codici da incorporare

Il processo di collegamento consente di inserire il codice di produzione DTM da incorporare, con la posizione host corrispondente, e di usare lo stesso codice incorporato nell’ambiente di produzione Platform Launch.

In tal caso, DTM e Platform Launch condividono la posizione del server e il nome del file del tag contenitore.

Quando si pubblica in Platform Launch , il file di tag contenitore di Platform Launch sovrascrive il file DTM, quindi quando il browser richiede il file dal server viene restituito il file Platform Launch.

Nel diagramma seguente, il passaggio 3 rappresenta Platform Launch che pubblica il tag contenitore sopra il tag contenitore DTM (dal passaggio 1). Al passaggio 2, il browser ottiene il tag contenitore Platform Launch.

IMPORTANTE

Questa sovrascrittura funziona in entrambe le direzioni. Se pubblichi Platform Launch e successivamente pubblichi da DTM, il tag contenitore DTM sovrascrive quello di Platform Launch. Sono presenti due sistemi che pubblicano nella stessa posizione. Questo significa che non devi modificare il codice sulla pagina, ma anche che devi prestare attenzione quando pubblichi. Ti consigliamo di disabilitare la proprietà DTM per evitare questa situazione.

Collegamento prerequisiti

Prima di collegare il codice da incorporare:

  • L’azienda DTM deve essere collegata alla stessa organizzazione Experience Cloud di Platform Launch.
  • L’account utente deve disporre delle autorizzazioni per la gestione degli ambienti in Platform Launch e le autorizzazioni amministratore in DTM.
  • La proprietà DTM non deve essere già collegata a un’altra proprietà Platform Launch.
  1. In Platform Launch , apri la scheda Ambienti .
  2. Crea un nuovo ambiente di produzione.
  3. Assegna un nome all'ambiente.
  4. Attiva l'opzione Collega codice di incorporamento DTM.
  5. Incolla il codice da incorporare di produzione DTM nel campo Codice da incorporare DTM in Platform Launch .
  6. Completa la configurazione dell'ambiente di produzione Platform Launch (configurazione archivio, ecc.).
  7. Seleziona Salva.

Platform Launch convalida una serie di elementi e indica se il collegamento è stato eseguito correttamente.

IMPORTANTE

In Platform Launch è disponibile un solo ambiente Produzione. Se ne hai già creato uno su questa proprietà, devi eliminarlo in modo da poter creare un nuovo ambiente collegato. Il nuovo ambiente non ha lo stesso codice da incorporare del vecchio, quindi non cercare di incorporarlo a meno che tu non abbia familiarità con il processo.

Se utilizzi il collegamento del codice da incorporare, il processo è sostanzialmente lo stesso, ma con alcune differenze:

  1. Crea la tua proprietà, installa un’estensione, crea elementi dati e crea regole in Platform Launch , come faresti normalmente.
  2. Crea normalmente gli ambienti di sviluppo e staging in Platform Launch.
  3. Crea un ambiente di produzione collegato come descritto in precedenza.
  4. Crea la libreria in Platform Launch come di consueto.
  5. Esegui il test in Sviluppo, invialo, verificalo in Staging e approvalo normalmente.
  6. Pubblica. Il tag contenitore di Platform Launch sovrascrive il quello di DTM e qualsiasi browser con questo codice da incorporare recupera il tag contenitore di Platform Launch.
  7. Disattiva la proprietà DTM per evitare di pubblicare accidentalmente il file DTM sopra al file di Platform Launch.

Il passaggio 7 può essere eseguito in qualsiasi momento dopo l'esecuzione del Passaggio 3.

Hosting autonomo

DTM supporta anche il self-hosting del file di tag contenitore DTM. Esistono due metodi per eseguire questa operazione:

  • Trasmissione FTP
  • Download libreria

In entrambi i casi, non ha molto senso migrare il codice da incorporare. Se provi, non danneggerai nulla. Ti consigliamo di non utilizzare questa opzione e di configurare manualmente gli host e gli ambienti.

Trasmissione FTP

A causa delle differenze nella configurazione tra FTP e SFTP, DTM e Platform Launch non possono eseguire migrazioni automatizzate di queste impostazioni.

Se utilizzi questo metodo per la trasmissione del tag contenitore, ti consigliamo di passare a SFTP in Platform Launch. Puoi creare un host SFTP e usarlo per qualsiasi ambiente scelto.

Download libreria

In Platform Launch , il download della libreria non esiste più come opzione separata. Se usi un download della libreria in DTM, ti consigliamo di saltare la migrazione dei codici da incorporare e di configurare l'ambiente di produzione con un host gestito da Adobe e l'archiviazione abilitata.

Puoi continuare a usare lo stesso codice da incorporare con DTM, ma sei tenuto a spostare la libreria sui tuoi server con il nome file corretto.

In questa pagina