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)-kod till version 8.0 eller senare. Det handlar om"klientimplementering" av DIL, inte vidarebefordran av Adobe Analytics-data på serversidan, och kommer att omfatta DTM, Launch från Adobe och implementeringar utan någon Adobe tagghanterarlösning.
Översikt overview
Med Audience Manager Data Integration Library (DIL)-kod kan du implementera AAM på din webbplats*. När man implementerade tidigare versioner av DIL behövde man inte heller ha Adobe Experience Cloud ID Service (ECID) implementerat (ä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 dokumentationen.
- Som framgår av beskrivningen av denna sida omfattar detta endast DIL-implementeringar på klientsidan som används av AAM-kunder som inte har Adobe Analytics. Om du har Adobe Analytics bör du använda serversidans vidarebefordringsmetod för att implementera AAM. Den här metoden beskrivs i dokumentationen.
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 väl 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 dokumentationen.
- Metoden idSync på förekomstnivå 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:
- Metoden idSync på förekomstnivå
- Elementet declaredId 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 metoden 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:t (AKA:t "DPID"). När du uppdaterar till setCustomerIDs måste du använda AAM Data Source i stället. Integration Code Den pekar fortfarande på samma Data Source, men är bara en annan identifierare. Detta visas i videon nedan.
I följande avsnitt visas steg och rekommendationer för att uppdatera till DIL 8.0 baserat på 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
-
Om du använder DIL före 8.0 går du till DIL-konfigurationen i AAM-tillägget innan du uppgraderar och noterar eventuella avancerade alternativ som du använder (kommer att användas i ett senare steg).
-
Uppdatera ditt AAM-tillägg till version 8.0 eller senare.
-
Kontrollera att ditt Experience Cloud ID Service-tillägg är version 3.3.0 eller senare.
-
Aktivera ECID-metoderna i ECID-tillägget för alla borttagna metoder och element (som
disableIDSyncs) som fanns i ditt AAM-tillägg före 8.0 eller i anpassad kod för DIL.- (DIL)
disableDestinationPublishingIframe-> (ECID)disableIdSyncs - (DIL)
disableIDSyncs-> (ECID)disableIdSyncs - (DIL)
iframeAkamaiHTTPS-> (ECID)dSyncSSLUseAkamai - (DIL)
declaredId-> (ECID)setCustomerIDs
- (DIL)
-
Publicera ändringarna.
Uppdatera till DIL 8.0 i Adobe DTM updating-to-dil-in-adobe-dtm
- Uppdatera AAM till version 8.0 eller senare. Den här versionsinställningen finns under"Allmänt" i verktyget AAM.
- Observera (så att du kan lägga till dem i ECID-verktyget) och sedan ta bort dem från den anpassade
disableIDSyncsi AAM-verktyget för alla borttagna metoder och element (som DIL code) som fanns i AAM-verktygets anpassade kod för DIL. - Uppdatera Experience Cloud ID-tjänsttillägget till version 3.3.0 eller senare
- Lägg till de avancerade alternativen i ECID-verktyget som du har tagit bort från AAM-verktygets anpassade kod.
- Publicera ändringarna
Uppdatera till DIL 8.0 utan någon 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.
-
Uppdatera ditt DIL-bibliotek till den senaste versionen (8.0 eller senare) - Du måste hämta den senaste DIL-koden från Adobe Consulting eller Adobe kundtjänst, 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).
-
Installera ECID Service eller uppdatera din befintliga version 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 dokumentationen eller prata med en Adobe-konsult.
-
Kontrollera att alla föråldrade metoder eller element som finns i din anpassade kod för DIL flyttas till ECID-metoderna:
-
(DIL)
disableDestinationPublishingIframe-> (ECID)disableIdSyncs -
(DIL)
disableIDSyncs-> (ECID)disableIdSyncs -
(DIL)
iframeAkamaiHTTPS-> (ECID)idSyncSSLUseAkamai -
(DIL)
declaredId-> (ECID)setCustomerIDs
-