Integrazione con Gestione tag dinamica dei Adobi

Integra Gestione tag dinamica dei Adobi con AEM in modo da poter utilizzare le proprietà Web di Gestione tag dinamica per tenere traccia AEM siti. Gestione tag dinamica consente ai professionisti del marketing di gestire i tag per la raccolta dei dati e la distribuzione dei dati tra i sistemi di marketing digitale. Ad esempio, utilizzate Gestione tag dinamica per raccogliere i dati di utilizzo per il sito Web AEM e distribuire i dati per l'analisi in Adobe Analytics o Adobe Target.

Prima di effettuare l’integrazione, è necessario creare la proprietà Web Gestione tag dinamica per tenere traccia del dominio del sito AEM. Le opzioni di hosting della proprietà Web devono essere configurate in modo da poter configurare AEM per accedere alle librerie Gestione tag dinamica.

Dopo aver configurato l’integrazione, le modifiche apportate agli strumenti e alle regole di distribuzione Gestione tag dinamica non richiedono la modifica della configurazione Gestione tag dinamica in AEM. Le modifiche sono automaticamente disponibili per AEM.

Nota

Se utilizzi Gestione dinamica dei tag con una configurazione proxy personalizzata, devi configurare sia le configurazioni proxy del client HTTP che alcune funzionalità di AEM utilizzano le API 3.x, sia quelle di 4.x:

Opzioni di distribuzione

Le seguenti opzioni di distribuzione influiscono sulla configurazione dell'integrazione con Gestione tag dinamica.

Hosting Gestione tag dinamica

AEM supporta la gestione tag dinamica ospitata nel cloud o ospitata in AEM.

  • In hosting sul cloud: Le librerie JavaScript di Gestione tag dinamica sono memorizzate nel cloud e le pagine AEM vi fanno riferimento direttamente.
  • AEM: Gestione tag dinamica genera librerie JavaScript. AEM utilizza un modello di flusso di lavoro per ottenere e installare le librerie.

Il tipo di hosting utilizzato dall'implementazione determina alcune delle attività di configurazione e implementazione che esegui. Per informazioni sulle opzioni di hosting, consultate Hosting - Embed Tab (Hosting - Embed Tab) nella guida di Gestione tag dinamica.

Libreria produzione e gestione temporanea

Decidete se l'istanza di autore AEM utilizza il codice di staging o di produzione Gestione tag dinamica.

In genere l’istanza di creazione utilizza le librerie di staging Gestione tag dinamica e l’istanza di produzione utilizza le librerie di produzione. Questo scenario consente di utilizzare l’istanza di creazione per testare le configurazioni di Gestione tag dinamica non approvate.

Se necessario, l’istanza di creazione può usare le librerie di produzione. Sono disponibili plug-in per browser Web che consentono di passare dall'utilizzo di librerie di staging a scopo di test quando le librerie sono ospitate nel cloud.

Utilizzo del gruppo di distribuzione Gestione tag dinamica

Quando AEM ospita le librerie Gestione tag dinamica, puoi utilizzare il servizio gancio di distribuzione Gestione tag dinamica per inviare automaticamente gli aggiornamenti della libreria a AEM. Gli aggiornamenti della libreria vengono inviati in push quando vengono apportate modifiche alle librerie, ad esempio quando vengono modificate le proprietà Web di Gestione tag dinamica.

Per utilizzare il gancio di distribuzione, Gestione tag dinamica deve essere in grado di connettersi all'istanza AEM che ospita le librerie. È necessario abilitare l'accesso a AEM per i server Gestione tag dinamica.

In alcune circostanze AEM irraggiungibile, ad esempio quando AEM si trova dietro un firewall. In questi casi, potete utilizzare l'opzione Importazione polling AEM per recuperare periodicamente le librerie. Un'espressione di processo cron imposta la pianificazione per i download della libreria.

Abilitazione dell'accesso al servizio del gruppo di distribuzione

Abilita il servizio gancio di distribuzione Gestione tag dinamica per accedere ai AEM in modo che il servizio possa aggiornare le librerie AEM ospitate. Specificate l'indirizzo IP dei server Gestione tag dinamica che aggiornano le librerie di staging e produzione come richiesto:

  • Staging: 107.21.99.31
  • Produzione: 23.23.225.112 e 204.236.240.48

Perform the configuration using either the Web Console or a sling:OsgiConfig node:

  • Nella console Web, utilizza l’elemento di configurazione del gruppo di distribuzione DTM di Adobe nella pagina Configurazione.
  • Per una configurazione OSGi, il servizio PID è com.adobe.cq.dtm.impl.servlets.DTMDeployHookServlet.

Nella tabella seguente sono descritte le proprietà da configurare.

Console Web, proprietà OSGi, proprietà Descrizione
Gestione dinamica dei tag - Elenco bianco IP dtm.staging.ip.whitelist Indirizzo IP del server Gestione tag dinamica che aggiorna le librerie di staging.
Elenco bianco IP DTM produzione dtm.production.ip.whitelist L'indirizzo IP del server Gestione tag dinamica che aggiorna le librerie di produzione.

Creazione della configurazione Gestione tag dinamica

Create una configurazione cloud in modo che l'istanza AEM possa autenticarsi con Gestione tag dinamica e interagire con la vostra proprietà Web.

Nota

Evitate di includere codici di monitoraggio Adobe Analytics sulle pagine quando la proprietà Web di Gestione dinamica dei tag include lo strumento Adobe Analytics e state utilizzando anche Content Insight. Nella configurazione cloudAdobe Analytics, selezionate l'opzione Non includere il codice di tracciamento.

Impostazioni generali

Proprietà Descrizione
Token API Il valore della proprietà Token API dell'account utente Gestione tag dinamica. AEM utilizza questa proprietà per l'autenticazione con Gestione tag dinamica.
Azienda Società a cui è associato l’ID di accesso.
Proprietà Nome della proprietà Web creata per la gestione dei tag per il sito AEM.
Includi codice di produzione per Autore

Selezionate questa opzione per fare in modo che le istanze di creazione e pubblicazione AEM utilizzino la versione di produzione delle librerie Gestione tag dinamica.

Se questa opzione non è selezionata, le impostazioni di gestione temporanea vengono applicate all’istanza di creazione e le impostazioni di produzione vengono applicate all’istanza di pubblicazione.

Proprietà di hosting autonomo - Produzione e allestimento

Le seguenti proprietà della configurazione Gestione tag dinamica consentono AEM ospitare le librerie Gestione tag dinamica. Le proprietà consentono AEM scaricare e installare le librerie. Facoltativamente, puoi aggiornare automaticamente le librerie per assicurarti che riflettano eventuali modifiche apportate nell’applicazione Gestione tag dinamica.

Alcune proprietà utilizzano i valori ottenuti dalla sezione Download libreria della scheda Incorpora per la proprietà Web Gestione tag dinamica. Per ulteriori informazioni, consulta Download della libreria nella guida di Gestione tag dinamica.

Nota

Quando ospitate il bundle Gestione tag dinamica su AEM, prima di creare la configurazione è necessario abilitare il download della libreria in Gestione tag dinamica. Inoltre, Akamai deve essere abilitato perché Akamai fornisce le librerie per il download.

Quando si ospitano le librerie Gestione tag dinamica su AEM, AEM configura automaticamente alcune proprietà della proprietà Web in base alla configurazione. Vedere le descrizioni nella tabella seguente.

Proprietà Descrizione
Usa hosting autonomo Seleziona quando ospitare il file di libreria Gestione tag dinamica su AEM. Selezionando questa opzione vengono visualizzate le altre proprietà della tabella.
URL bundle DTM L'URL da utilizzare per scaricare la libreria Gestione tag dinamica. Ottenete questo valore dalla sezione Download URL della pagina Download libreria di Gestione tag dinamica. Per motivi di sicurezza, questo valore deve essere configurato manualmente.
Flusso di lavoro per download

Modello di flusso di lavoro da utilizzare per scaricare e installare la libreria Gestione tag dinamica. Il modello predefinito è Download DTM Bundle predefinito. Utilizzare questo modello a meno che non sia stato creato un modello personalizzato.

Il flusso di lavoro predefinito per il download attiva automaticamente le librerie al momento del download.

Suggerimento dominio

(Facoltativo) Il dominio del server AEM che ospita la libreria Gestione tag dinamica. Specificate un valore per ignorare il dominio predefinito configurato per il servizio Esternalizzatore collegamento CQDay.

Quando è connesso a Gestione tag dinamica, AEM utilizza questo valore per configurare il Percorso HTTP temporaneo o il Percorso HTTP di produzione delle proprietà Download della libreria per la proprietà Web Gestione tag dinamica.

Suggerimento dominio sicuro

(Facoltativo) Il dominio del server AEM che ospita la libreria Gestione tag dinamica tramite HTTPS. Specificate un valore per ignorare il dominio predefinito configurato per il servizio Esternalizzatore collegamento CQDay.

Quando è connesso a Gestione tag dinamica, AEM utilizza questo valore per configurare il Percorso HTTPS di gestione temporanea o il Percorso HTTPS di produzione delle proprietà Download della libreria per la proprietà Web Gestione tag dinamica.

Segreto condiviso

(Facoltativo) Il segreto condiviso da utilizzare per decrittografare il download. Ottenete questo valore dal campo Segreto condiviso della pagina Download della libreria di Gestione tag dinamica.

Nota: Nel computer in cui è installato AEM devono essere installate le librerie OpenSSL , in modo che AEM decrittografare le librerie scaricate.

Abilita importazione polling

(Facoltativo) Selezionare questa opzione per scaricare e installare periodicamente la libreria Gestione tag dinamica per verificare di utilizzare una versione aggiornata. Se questa opzione è selezionata, Gestione tag dinamica non invia richieste di POST HTTP all’URL del gruppo di distribuzione.

AEM automaticamente la proprietà Deploy Hook URL (Distribuisci URL gruppo) delle proprietà Library Download (Download libreria) per la proprietà Web Gestione tag dinamica. Quando è selezionata, la proprietà è configurata senza alcun valore. Se non è selezionata, la proprietà viene configurata con l'URL della configurazione Gestione tag dinamica.

Abilita Polling Importer quando l’hook di distribuzione Gestione tag dinamica non è in grado di connettersi a AEM, ad esempio quando AEM è protetto da un firewall.

Espressione di pianificazione (Viene visualizzato ed è richiesto se è selezionata l’opzione Abilita Importazione polling). Espressione cron che controlla quando vengono scaricate le librerie di gestione tag dinamica.

chlimage_1-352

Proprietà hosting cloud - Produzione e gestione temporanea

Quando la configurazione della gestione tag dinamica è in hosting sul cloud, puoi configurare le seguenti proprietà per la configurazione della gestione tag dinamica.

Proprietà Descrizione
Usa hosting autonomo Deselezionate questa opzione quando il file di libreria Gestione tag dinamica è in hosting nel cloud.
Codice intestazione

Il codice dell'intestazione per l'area di gestione dei tag dinamici ottenuto da Gestione tag dinamica per l'host. Questo valore viene popolato automaticamente quando ci si connette a Gestione tag dinamica.

Per visualizzare il codice in Gestione tag dinamica, fai clic sulla scheda Incorpora, quindi fai clic sul nome host. Espandete la sezione del codice di intestazione e fate clic su Copia codice da incorporare del codice di incorporamento temporaneo o, se necessario, sull'area del codice da incorporare produzione.

Codice piè di pagina

Il codice piè di pagina per l'area di visualizzazione che viene ottenuto da Gestione tag dinamica per l'host. Questo valore viene popolato automaticamente quando ci si connette a Gestione tag dinamica.

Per visualizzare il codice in Gestione tag dinamica, fai clic sulla scheda Incorpora, quindi fai clic sul nome host. Espandete la sezione Codici piè di pagina e fate clic su Copia codice da incorporare del codice di incorporamento temporaneo o sull’area Codice da incorporare produzione, a seconda delle necessità.

chlimage_1-353

La procedura seguente utilizza l’interfaccia touch per configurare l’integrazione con Gestione tag dinamica.

  1. Nella barra laterale, fate clic su Strumenti > Operazioni > Cloud > Cloud Services.

  2. Nell’area Gestione tag dinamica viene visualizzato uno dei seguenti collegamenti per l’aggiunta di una configurazione:

    • Fate clic su Configura ora se si tratta della prima configurazione che state aggiungendo.
    • Fate clic su Show Configurations (Mostra configurazioni), quindi fate clic sul collegamento + accanto a Available Configurations (Configurazioni disponibili) se sono state create una o più configurazioni.

    chlimage_1-354

  3. Digitate un titolo per la configurazione e fate clic su Crea.

  4. Nel campo Token API, immettete il valore della proprietà Token API dell'account utente Gestione tag dinamica.

    Per ottenere il valore del token API, contatta l'assistenza clienti DTM.

    Nota

    Il token API scade solo se l'utente di Gestione tag dinamica lo richiede esplicitamente.

    chlimage_1-355

  5. Fate clic su Connetti a Gestione dinamica dei tag. AEM esegue l'autenticazione con Gestione tag dinamica e recupera l'elenco delle società a cui è associato l'account.

  6. Selezionate la Società, quindi selezionate la Proprietà che state utilizzando per tenere traccia del sito AEM.

  7. Se utilizzate il codice di staging nell’istanza di creazione, deselezionate Includi codice produzione sull’autore.

  8. Immettete i valori per le proprietà nelle schede Impostazioni di gestione temporanea e Impostazioni produzione, se necessario, quindi fate clic su OK.

Download manuale della libreria Gestione tag dinamica

Scarica manualmente le librerie Gestione tag dinamica per aggiornarle immediatamente su AEM. Ad esempio, scaricate manualmente quando desiderate testare una libreria aggiornata prima che venga pianificato il download automatico della libreria da parte di Importazione polling.

  1. Nella barra laterale, fate clic su Strumenti > Operazioni > Cloud > Cloud Services.

  2. Nell'area Gestione tag dinamica, fai clic su Mostra configurazioni, quindi fai clic sulla configurazione.

  3. Nell'area Impostazioni di gestione temporanea o Impostazioni di produzione, fate clic sul pulsante Attiva flusso di lavoro per scaricare e distribuire il bundle della libreria.

    chlimage_1-356

Nota

I file scaricati sono memorizzati in /etc/clientlibs/dtm/my config/companyID/propertyID/servertype.

I seguenti elementi sono tratti direttamente dalla configurazione diGestione dinamica dei tag.

  • myconfig
  • companyID
  • propertyID
  • servertype

Associazione di una configurazione di gestione tag dinamica al sito

Associate la configurazione Gestione tag dinamica alle pagine del sito Web in modo che AEM aggiunga lo script richiesto alle pagine. Associate la pagina principale del sito alla configurazione. Tutti i discendenti di tale pagina ereditano l'associazione. Se necessario, è possibile ignorare l'associazione in una pagina discendente.

Utilizzate la procedura seguente per associare una pagina e i discendenti a una configurazione Gestione tag dinamica.

  1. Aprite la pagina principale del sito nell’interfaccia classica.

  2. Utilizzare la barra laterale per aprire le proprietà della pagina.

  3. Nella scheda Cloud Services, fate clic su Aggiungi servizio, selezionate Gestione tag dinamica, quindi fate clic su OK.

    chlimage_1-357

  4. Utilizzate il menu a discesa Gestione tag dinamica per selezionare la configurazione, quindi fate clic su OK.

Per ignorare l’associazione di configurazione ereditata per una pagina, attenersi alla procedura descritta di seguito. L’override influisce sulla pagina e su tutti i discendenti della pagina.

  1. Aprite la pagina nell’interfaccia classica.

  2. Utilizzare la barra laterale per aprire le proprietà della pagina.

  3. Nella scheda Cloud Services, fare clic sull'icona lucchetto accanto alla proprietà Ereditato da, quindi fare clic su Sì nella finestra di dialogo di conferma.

    chlimage_1-358

  4. Rimuovete o selezionate una configurazione di gestione tag dinamica diversa, quindi fate clic su OK.

In questa pagina