Aggiornamento a Adobe Audience Manager’s DIL versione 8.0 (o successiva)

Ultimo aggiornamento: 2023-05-20
  • Creato per:
  • Intermediate
    Developer

Il presente articolo illustra i passaggi e le raccomandazioni per l’aggiornamento di Adobe Audience Manager (AAM) Data Integration Library (DIL) alla versione 8.0 o successiva. Questo si riferisce all’implementazione DIL "lato client", non all’inoltro lato server dei dati Adobe Analytics, e riguarderà DTM, Launch by Adobe e le implementazioni senza alcuna soluzione Adobe di gestione tag.

Panoramica

Audience Manager Data Integration Library (DIL) consente di implementare AAM sul sito Web*. Durante l’implementazione delle versioni precedenti di DIL, non era necessario implementare anche il servizio ID Experience Cloud (ECID) di Adobe (anche se era un’idea molto buona). A partire da DIL versione 8.0, esiste una forte dipendenza dalla versione 3.3 o successiva di ECID. Se implementi DIL 8.0 o versione successiva senza ECID 3.3 o con una versione precedente, verrà visualizzato un errore e non funzionerà. Poiché esistono diversi modi per implementare l’AAM, abbiamo creato questa pagina per fornire alcuni passaggi da seguire e alcuni consigli. Di seguito sono riportati i passaggi e le raccomandazioni suddivisi per piattaforma/metodo di implementazione. Ulteriori informazioni su DIL sono disponibili nel documentazione.

  • Come indicato nella descrizione di questa pagina, questo riguarderà solo le implementazioni DIL "lato client", utilizzate dai clienti AAM che non dispongono di Adobe Analytics. Se disponi di Adobe Analytics, utilizza il metodo di inoltro lato server per implementare l’AAM. Questo metodo è descritto nel documentazione.

Metodi ed elementi duplicati e obsoleti

Nelle versioni precedenti di DIL ed ECID, esistevano metodi duplicativi (metodi che svolgono la stessa funzione sia in DIL che in ECID), che causavano confusione riguardo a quale utilizzare. In genere, era necessario utilizzarli entrambi e abbinarli, e quel messaggio non era ben comunicato ai nostri clienti. A partire da DIL 8.0, questi metodi ed elementi duplicati sono stati dichiarati obsoleti in DIL ed è consigliabile utilizzare la versione ECID.

Ad esempio:

  • Quando si utilizza DIL.createTuttavia, alcuni elementi sono stati dichiarati obsoleti. Al loro posto, utilizza gli elementi ECID. Questi elementi vengono richiamati nel DIL.create documentazione.
  • Il idSync anche il metodo a livello di istanza è stato dichiarato obsoleto, come indicato nel documentazione.

Sincronizzazione ID con un ID cliente

In AAM, puoi sincronizzare il tuo UUID (ID utente univoco anonimo) sul computer con un ID cliente, in modo da poter caricare dati offline su quel cliente e collegarli al suo comportamento online, per comprendere meglio i tuoi clienti. In passato, ciò è stato fatto in uno dei due modi seguenti:

  • Il idSync metodo a livello di istanza
  • Il declaredId elemento in DIL.create

Se utilizzi uno di questi metodi meno recenti per la sincronizzazione con un ID cliente, ti consigliamo vivamente di eseguire l’aggiornamento a utilizzando setCustomerIDs , che fa parte del servizio ECID. Ulteriori informazioni su setCustomerIDs è disponibile nel file documentazione.

Suggerimento: Quando in precedenza utilizzavi uno dei metodi di cui sopra, hai fatto riferimento all’AAM Data Source con Data Source ID (o "DPID"). Durante l’aggiornamento a setCustomerIDs, dovrà usare l’AAM Data Source""Integration Code" invece. Punta ancora allo stesso Data Source ma è solo un identificatore diverso. Questo è mostrato nel video seguente.

Nelle sezioni seguenti sono elencati i passaggi e le raccomandazioni per l’aggiornamento a DIL 8.0 in base al metodo di implementazione:

Aggiornamento a DIL 8.0 nei tag Adobe Experience Platform

Passaggi di base per l’aggiornamento a DIL 8.0

  1. Se utilizzi una versione precedente alla 8.0 di DIL, prima di eseguire l’aggiornamento passa alla configurazione DIL nell’estensione AAM e prendi nota di tutte le opzioni avanzate in uso (da utilizzare in un passaggio successivo).

  2. Aggiorna l’estensione AAM alla versione 8.0 o successiva.

  3. Verifica che la versione dell'estensione del servizio ID Experience Cloud sia 3.3.0 o successiva.

  4. Per tutti i metodi/elementi obsoleti (come disableIDSyncs) presenti nell’estensione AAM precedente alla versione 8.0 o nel codice personalizzato per DIL, abilita i metodi ECID nell’estensione ECID.

    1. (DIL) disableDestinationPublishingIframe -> (ECID) disableIdSyncs
    2. (DIL) disableIDSyncs -> (ECID) disableIdSyncs
    3. (DIL) iframeAkamaiHTTPS -> (ECID) dSyncSSLUseAkamai
    4. (DIL) declaredId -> (ECID) setCustomerIDs
  5. Pubblica le modifiche.

Aggiornamento a DIL 8.0 in Adobe DTM

  1. Aggiorna lo strumento AAM alla versione 8.0 o successiva. Questa impostazione della versione si trova nella sezione "Generale" dello strumento AAM.
  2. Per tutti i metodi/elementi obsoleti (come disableIDSyncs) presenti nel codice personalizzato DIL dello strumento AAM precedente alla versione 8.0, annotali (in modo da poterli aggiungere allo strumento ECID) e quindi rimuoverli dal file personalizzato DIL code nello strumento AAM.
  3. Aggiornare l’estensione del servizio ID Experience Cloud alla versione 3.3.0 o successiva
  4. Aggiungi le opzioni avanzate allo strumento ECID che hai rimosso dal codice personalizzato dello strumento AAM.
  5. Pubblicare le modifiche

Aggiornamento a DIL 8.0 senza alcuna soluzione Tag Management Adobe

Se aggiorni il codice direttamente sulla pagina, puoi semplicemente sostituire gli elementi meno recenti con quelli più recenti, tranne quando devi spostare metodi/elementi da DIL a ECID, come descritto in precedenza. In tal caso, si sostituirà semplicemente il metodo/elemento precedente nella posizione DIL con il metodo/elemento ECID nella posizione ECID.

Lo stesso vale per i gestori di tag non Adobi. Ovunque siano presenti le versioni precedenti di tale soluzione di gestione tag, sostituiscila con il nuovo codice come descritto nei passaggi seguenti.

  1. Aggiorna la libreria DIL alla versione più recente (8.0 o successiva): dovrai ottenere il codice DIL più recente da Adobe Consulting o Adobe Customer Care, in quanto non è attualmente disponibile in una posizione pubblica. Quindi sostituisci semplicemente il vecchio codice della libreria DIL con il nuovo codice della libreria DIL e passa al passaggio successivo (non fermarti ora o riscontrerai problemi, ha).

  2. Installa ECID Service o aggiorna la versione esistente alla versione 3.3.0 o successiva. Scarica la versione più recente del servizio ID Experience Cloud dalla nostra pagina GitHub. Se hai bisogno di assistenza, consulta documentazione o rivolgiti a un Consulente Adobe.

  3. Verifica che tutti i metodi o gli elementi obsoleti presenti nel codice personalizzato per DIL vengano spostati nei metodi ECID:

    1. (DIL) disableDestinationPublishingIframe -> (ECID) disableIdSyncs

      Documentazione

    2. (DIL) disableIDSyncs -> (ECID) disableIdSyncs

      Documentazione

    3. (DIL) iframeAkamaiHTTPS -> (ECID) idSyncSSLUseAkamai

      Documentazione

    4. (DIL) declaredId -> (ECID) setCustomerIDs

      Documentazione

In questa pagina