DocumentazioneAudience ManagerTutorial su Audience Manager

Aggiornamento a Adobe Audience Manager’s DIL versione 8.0 (o successiva) updating-to-adobe-audience-manager-s-dil-version-or-greater

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Intermedio
  • Sviluppatore

Questo articolo fornisce passaggi e raccomandazioni per l'aggiornamento del codice 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 overview

Il codice di Audience Manager Data Integration Library (DIL) ti consente di implementare AAM sul tuo 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 nella 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 nella documentazione.

Metodi ed elementi duplicati e obsoleti duplicate-and-deprecated-elements-and-methods

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:

  • Durante l'utilizzo di DIL.create, alcuni elementi sono stati dichiarati obsoleti ed è consigliabile utilizzare gli elementi ECID. Questi elementi vengono richiamati nella DIL.create documentazione.
  • Anche il metodo a livello di istanza idSync è stato dichiarato obsoleto, come indicato nella documentazione del metodo.

Sincronizzazione ID con un ID cliente id-syncing-with-a-customer-id

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 metodo a livello di istanza idSync
  • Elemento declaredId in DIL.create

Se utilizzi uno di questi metodi meno recenti per la sincronizzazione con un ID cliente, ti consigliamo di eseguire l'aggiornamento a utilizzando il metodo setCustomerIDs, che fa parte del servizio ECID. Ulteriori informazioni su setCustomerIDs sono disponibili nella documentazione del metodo.

Suggerimento rapido: quando in precedenza si utilizzava uno dei metodi di cui sopra, si faceva riferimento all'AAM Data Source con l'ID Data Source (ovvero "DPID"). Durante l'aggiornamento a setCustomerIDs, sarà necessario utilizzare il "Integration Code" dell'AAM Data Source. Punta ancora allo stesso Data Source ma è solo un identificatore diverso. Questo è mostrato nel video seguente.

https://video.tv.adobe.com/v/326670/?quality=12&captions=ita

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 updating-to-dil-in-experience-platform-launch

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. Publish le modifiche.

https://video.tv.adobe.com/v/326671/?quality=12&captions=ita

Aggiornamento a DIL 8.0 in Adobe DTM updating-to-dil-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 eventuali metodi/elementi obsoleti (come disableIDSyncs) presenti nel codice personalizzato per DIL dello strumento AAM precedente alla versione 8.0, annotali (in modo da poterli aggiungere allo strumento ECID) e rimuoverli dalla DIL code personalizzata 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. Publish le modifiche

Aggiornamento a DIL 8.0 senza alcuna soluzione Tag Management Adobe additional-resources

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, il metodo/elemento precedente nella posizione DIL verrà semplicemente sostituito 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). Sarà necessario 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. Puoi scaricare l'ultima versione del servizio ID Experience Cloud dalla nostra pagina GitHub. Se hai bisogno di assistenza, consulta la 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

recommendation-more-help
468cbaa0-07ce-4354-9a38-4f23b645a466