Bijwerken naar Adobe Audience Manager DIL versie 8.0 (of hoger)
- Onderwerpen:
- DIL-implementatie
Gemaakt voor:
- tussenpersoon
- Ontwikkelaar
In dit artikel worden de stappen en aanbevelingen voor het bijwerken van Adobe Audience Manager beschreven (AAM) Data Integration Library (DIL) naar versie 8.0 of hoger. Dit heeft betrekking op "client-side" DIL-implementatie, niet op het doorsturen van Adobe Analytics-gegevens aan de serverzijde, en geldt voor DTM, Launch by Adobe en implementaties zonder oplossing voor Adobe tagbeheer.
Overzicht
Audience Managers Data Integration Library (DIL) de code staat u toe om AAM op uw Website* uit te voeren. Bij het uitvoeren van vorige versies van DIL, werd het niet vereist om de Dienst van identiteitskaart van de Experience Cloud van Adobe te hebben ook (ECID) wordt uitgevoerd (hoewel het een zeer goed idee was). Vanaf DIL versie 8.0 is er een sterke afhankelijkheid van ECID versie 3.3 of hoger. Als u DIL 8.0 of later zonder ECID 3.3 of met een vroegere versie implementeert, krijgt u een fout en werkt deze niet. Aangezien er meerdere manieren zijn waarop u AAM kunt implementeren, hebben we deze pagina gemaakt om u enkele stappen te geven die u moet doorlopen, en enkele aanbevelingen. Hieronder vindt u deze stappen en aanbevelingen, uitgesplitst naar platform/implementatiemethode. Meer informatie over DIL is beschikbaar in het dialoogvenster documentatie.
- Zoals vermeld in de beschrijving van deze pagina, zal dit slechts "cliënt-kant"DIL implementaties omvatten, die door AAM klanten worden gebruikt die geen Adobe Analytics hebben. Als u Adobe Analytics hebt, zou u de server-kant het door:sturen methode moeten gebruiken om AAM uit te voeren. Deze methode wordt beschreven in het dialoogvenster documentatie.
Elementen en methoden dupliceren en vervangen
In eerdere versies van DIL en ECID waren er dubbele methoden (methoden die dezelfde functie in zowel DIL als ECID hebben), die verwarring veroorzaakten over welke methode moet worden gebruikt. Typisch, moest u beide gebruiken en hen aanpassen omhoog, en dat bericht werd niet goed meegedeeld aan onze klanten. Vanaf DIL 8.0 zijn deze dubbele methoden en elementen afgekeurd in DIL en het wordt aanbevolen de ECID-versie te gebruiken.
Bijvoorbeeld:
- Wanneer u DIL.create, zijn enkele elementen vervangen en u moet in plaats daarvan de ECID-elementen gebruiken. Deze elementen worden in het DIL.create documentatie.
- De idSync De methode op instantieniveau is ook vervangen, zoals wordt aangeroepen in de methode documentatie.
ID synchroniseren met een klant-id
In AAM kunt u uw UUID (anonieme unieke gebruikersnaam) op de computer synchroniseren met een klant-id, zodat u offlinegegevens over die klant kunt uploaden en deze kunt koppelen aan hun onlinegedrag om een beter inzicht te krijgen in uw klanten. In het verleden is dit op twee manieren gebeurd:
- De idSync instantieniveau, methode
- De declaredId element in DIL.create
Als u een van deze oudere methoden hebt gebruikt voor synchronisatie met een klant-id, is het raadzaam een update uit te voeren naar het gebruik van de setCustomerIDs methode, die deel uitmaakt van de ECID-dienst. Meer informatie over setCustomerIDs is beschikbaar in de methode documentatie.
Snelle tip: Wanneer u eerder een van de bovenstaande methoden hebt gebruikt, verwijst u naar de AAM Data Source met de Data Source ID (AKA de "DPID"). Wanneer u bijwerkt naar setCustomerIDs, moet u de AAM gebruiken Data Source' s 'Integration Code" in plaats daarvan. Het wijst nog steeds op hetzelfde Data Source maar het is slechts een andere id. Dit wordt weergegeven in de onderstaande video.
In de volgende secties vindt u stappen en aanbevelingen voor het bijwerken naar DIL 8.0 op basis van uw implementatiemethode:
Bijwerken naar DIL 8.0 in Adobe Experience Platform-tags
Basisstappen voor het bijwerken naar DIL 8.0
-
Als u pre-8.0 DIL gebruikt, alvorens u bevordert, ga in de configuratie van de DIL in de AAM uitbreiding, en neem een nota van om het even welke geavanceerde opties die u gebruikt (in een verdere stap moet worden gebruikt).
-
Werk de AAM extensie bij naar versie 8.0 of hoger.
-
Controleer of de extensie voor de Experience Cloud-id-service versie 3.3.0 of hoger is.
-
Voor afgekeurde methoden/elementen (zoals
disableIDSyncs) die zich in de extensie van vóór 8.0 AAM of in aangepaste code voor DIL bevonden, schakelt u de ECID-methoden in de ECID-extensie in.- (DIL)
disableDestinationPublishingIframe-> (ECID)disableIdSyncs - (DIL)
disableIDSyncs-> (ECID)disableIdSyncs - (DIL)
iframeAkamaiHTTPS-> (ECID)dSyncSSLUseAkamai - (DIL)
declaredId-> (ECID)setCustomerIDs
- (DIL)
-
Publiceer de wijzigingen.
Bijwerken naar DIL 8.0 in Adobe DTM
- Werk het AAM bij naar versie 8.0 of hoger. Deze versie-instelling bevindt zich onder de sectie Algemeen van het AAM.
- Voor afgekeurde methoden/elementen (zoals
disableIDSyncs) die in de aangepaste code van het gereedschap AAM 8.0 voor DIL stonden, noteer deze (zodat u ze aan het gereedschap ECID kunt toevoegen) en verwijder ze vervolgens uit de aangepaste code DIL code in het AAM. - Werk uw Experience Cloud ID-serviceverlenging bij naar versie 3.3.0 of hoger
- Voeg de geavanceerde opties toe aan het gereedschap ECID die u uit de aangepaste code van het gereedschap AAM hebt verwijderd.
- Wijzigingen publiceren
Bijwerken naar DIL 8.0 zonder Adobe Tag Management-oplossing
Als u de code rechtstreeks op de pagina bijwerkt, kunt u alleen oudere items vervangen door nieuwere items, behalve wanneer u methoden/elementen moet verplaatsen van DIL naar ECID, zoals hierboven beschreven. In dat geval vervangt u gewoon de oude methode/het oude element op de locatie DIL door de ECID-methode/het ECID-element op de locatie ECID.
Hetzelfde geldt voor niet-Adobe-tagmanagers. overal waar u de oude versies in die oplossing van het markeringsbeheer hebt, vervang het met de nieuwe code zoals die in de volgende stappen wordt beschreven.
-
Werk uw DIL-bibliotheek bij naar de nieuwste versie (8.0 of hoger) - U moet de nieuwste DIL-code ophalen van Adobe Consulting of Adobe Customer Care, omdat deze momenteel niet beschikbaar is op een openbare locatie. Vervang vervolgens gewoon de oude bibliotheekcode van de DIL door de nieuwe bibliotheekcode van de DIL en ga naar de volgende stap (stop nu niet of u gaat problemen krijgen, ha).
-
Installeren ECID Service of werk de bestaande versie bij naar 3.3.0 of hoger. U kunt de nieuwste release van de Experience Cloud-id-service downloaden van onze GitHub-pagina. Als u hier hulp bij nodig hebt, raadpleegt u de documentatie of overleg met een Adobe Consultant.
-
Controleer of afgekeurde methoden of elementen in de aangepaste code voor DIL naar de ECID-methoden worden verplaatst:
-
(DIL)
disableDestinationPublishingIframe-> (ECID)disableIdSyncs -
(DIL)
disableIDSyncs-> (ECID)disableIdSyncs -
(DIL)
iframeAkamaiHTTPS-> (ECID)idSyncSSLUseAkamai -
(DIL)
declaredId-> (ECID)setCustomerIDs
-