Uppdatera till Adobe Audience Manager DIL version 8.0 (eller senare) updating-to-adobe-audience-manager-s-dil-version-or-greater

I den här artikeln beskrivs steg och rekommendationer för hur du uppdaterar Adobe Audience Manager (AAM) Data Integration Library (DIL) till version 8.0 eller senare. Det handlar om implementering på klientsidan, inte vidarebefordran av Adobe Analytics-data på serversidan, och omfattar DTM, Launch by Adobe och implementeringar utan tagghanterarlösning för Adobe.

Översikt overview

Audience Manager Data Integration Library (DIL) kan du implementera AAM på din webbplats*. Vid implementering av tidigare versioner av DIL krävdes inte att Adobe's Experience Cloud ID Service (ECID) implementerades (även om det var en mycket bra idé). Från och med DIL version 8.0 finns ett starkt beroende av ECID version 3.3 eller senare. Om du implementerar DIL 8.0 eller senare utan ECID 3.3, eller med en tidigare version, får du ett felmeddelande som inte fungerar. Eftersom du kan implementera AAM på flera olika sätt har vi skapat den här sidan för att ge dig några steg att gå igenom samt några rekommendationer. Här nedan hittar du de här stegen och rekommendationerna uppdelade efter plattform/implementeringsmetod. Mer information om DIL finns i dokumentation.

  • Som framgår av beskrivningen av den här sidan omfattar detta endast implementeringar på klientsidan av DIL som används av AAM som inte har Adobe Analytics. Om du har Adobe Analytics bör du använda metoden för vidarebefordran på serversidan för att implementera AAM. Den här metoden beskrivs i dokumentation.

Duplicera och ta bort element och metoder duplicate-and-deprecated-elements-and-methods

I tidigare versioner av DIL och ECID fanns det dubbleringsmetoder (metoder som gör samma funktion i både DIL och ECID), som orsakade förvirring om vilken som användes. Vanligtvis behövde ni använda båda och matcha dem, och det budskapet förmedlades inte på ett bra sätt till våra kunder. Från och med DIL 8.0 har dessa dubblettmetoder och -element tagits bort i DIL och du bör använda ECID-versionen.

Exempel:

  • När du använder DIL.create, har några element tagits bort och du bör använda ECID-elementen i stället. Dessa element anropas i DIL.create dokumentation.
  • The idSync instansnivåmetoden har också tagits bort, vilket anropas i metodens dokumentation.

ID-synkronisering med ett kund-ID id-syncing-with-a-customer-id

I AAM kan du synkronisera ditt UUID (anonymt unikt användar-ID) på datorn med ett kund-ID, så att du kan överföra offlinedata om den kunden och koppla dem till deras onlinebeteende för att få en bättre förståelse för dina kunder. Tidigare har detta gjorts på ett av två sätt:

  • The idSync instansnivåmetod
  • The declaredId element i DIL.create

Om du har använt någon av dessa äldre metoder för att synkronisera med ett kund-ID rekommenderar vi att du uppdaterar till med setCustomerIDs som ingår i ECID-tjänsten. Mer information om setCustomerIDs finns i metodens dokumentation.

Snabbtips: När du tidigare använde någon av metoderna ovan refererade du till AAM Data Source med Data Source ID (AKA the "DPID"). Vid uppdatering till setCustomerIDsmåste du använda AAM Data Source's "Integration Code" istället. Det pekar fortfarande på samma Data Source men är bara en annan identifierare. Detta visas i videon nedan.

I följande avsnitt listas steg och rekommendationer för uppdatering till DIL 8.0 baserat på din implementeringsmetod:

Uppdatera till DIL 8.0 i Adobe Experience Platform-taggar updating-to-dil-in-experience-platform-launch

Grundläggande steg för uppdatering till DIL 8.0

  1. Om du använder före 8.0 DIL innan du uppgraderar går du till DIL-konfigurationen i AAM och noterar eventuella avancerade alternativ som du använder (som ska användas i ett senare steg).

  2. Uppdatera AAM till version 8.0 eller senare.

  3. Kontrollera att Experience Cloud ID-tjänsttillägget är version 3.3.0 eller senare.

  4. För alla borttagna metoder/element (som disableIDSyncs) som fanns i ditt tillägg för version 8.0 AAM eller i anpassad kod för DIL, aktiverar du ECID-metoderna i ECID-tillägget.

    1. (DIL) disableDestinationPublishingIframe -> (ECID) disableIdSyncs
    2. (DIL) disableIDSyncs -> (ECID) disableIdSyncs
    3. (DIL) iframeAkamaiHTTPS -> (ECID) dSyncSSLUseAkamai
    4. (DIL) declaredId -> (ECID) setCustomerIDs
  5. Publicera ändringarna.

Uppdatera till DIL 8.0 i Adobe DTM updating-to-dil-in-adobe-dtm

  1. Uppdatera AAM till version 8.0 eller senare. Den här versionsinställningen finns under avsnittet Allmänt i AAM.
  2. För alla borttagna metoder/element (som disableIDSyncs) som fanns i din AAM för version 8.0 för DIL, notera dem (så att du kan lägga till dem i ECID-verktyget) och sedan ta bort dem från den anpassade DIL code i AAM.
  3. Uppdatera Experience Cloud ID-tjänsttillägget till version 3.3.0 eller senare
  4. Lägg till de avancerade alternativen i ECID-verktyget som du har tagit bort från AAM kod.
  5. Publicera ändringarna

Uppdatera till DIL 8.0 utan Adobe Tag Management-lösning additional-resources

Om du uppdaterar koden direkt på sidan kan du ersätta äldre objekt med nyare objekt, förutom när du behöver flytta metoder/element från DIL till ECID, vilket beskrivs ovan. I så fall ersätter du helt enkelt den gamla metoden/elementet på DIL-platsen med ECID-metoden/-elementet på ECID-platsen.

Detsamma gäller tagghanterare som inte är Adobe. Oavsett var du har de gamla versionerna i tagghanteringslösningen ersätter du den med den nya koden enligt beskrivningen i följande steg.

  1. Uppdatera ditt DIL-bibliotek till den senaste versionen (8.0 eller senare) - Du måste få den senaste DIL-koden från Adobe Consulting eller Adobe Customer Care, eftersom den för närvarande inte är tillgänglig på en offentlig plats. Ersätt sedan den gamla DIL-bibliotekskoden med den nya DIL-bibliotekskoden och gå vidare till nästa steg (stanna inte nu, annars får du problem).

  2. Installera ECID Service eller uppdatera till 3.3.0 eller senare. Du kan hämta den senaste versionen av Experience Cloud ID-tjänsten från vår GitHub-sida. Om du behöver hjälp med detta kan du läsa dokumentation eller prata med en konsult på Adobe.

  3. Kontrollera att alla föråldrade metoder eller element i din anpassade kod för DIL flyttas till ECID-metoderna:

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

      Dokumentation

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

      Dokumentation

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

      Dokumentation

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

      Dokumentation

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