De Audience Manager-implementatie van uw site migreren van client-side DIL naar server-side forward migrating-your-site-s-aam-implementation-from-client-side-dil-to-server-side-forwarding
Deze zelfstudie is op u van toepassing als u zowel Adobe Audience Manager (AAM) als Adobe Analytics hebt en u momenteel een hit van de pagina naar AAM verzendt met DIL-code (Data Integration Library ) en ook een hit van de pagina naar Adobe Analytics verzendt. Aangezien u beide oplossingen hebt, en aangezien zij allebei deel van Adobe Experience Cloud uitmaken, hebt u de kans om de beste praktijk te volgen om server-zij het door:sturen aan te zetten, die de Analytics servers van de gegevensinzameling toelaat om plaats analysegegevens in real time aan Audience Manager door te sturen, in plaats van het hebben van cliënt-zijcode een extra klap van de pagina naar AAM verzendt. Dit leerprogramma begeleidt u door de stappen om de schakelaar van de oudere cliënt-kant implementatie van DIL aan de nieuwere server-kant door:sturen methode te maken.
Client-kant (DIL) versus server-kant client-side-dil-vs-server-side
Bij het vergelijken en contrasteren van deze twee methoden om Adobe Analytics-gegevens in AAM te plaatsen, kan het in de eerste plaats nuttig zijn om de verschillen in de volgende afbeelding te visualiseren:
DIL-implementatie op de client client-side-dil-implementation
Als u deze methode gebruikt om Adobe Analytics-gegevens in AAM te krijgen, komen er twee hits van uw webpagina's: een gaat naar Analytics en een gaat naar AAM (nadat u de Analytics -gegevens op de webpagina hebt gekopieerd). Segments wordt geretourneerd van AAM naar de pagina, waar ze kunnen worden gebruikt voor personalisatie, enzovoort. Dit wordt beschouwd als een oudere implementatie en wordt niet meer aanbevolen.
Afgezien van het feit dat dit niet de beste praktijken volgt, omvatten de nadelen om deze methode te gebruiken:
- Twee treffers komen van de pagina in plaats van slechts één
- server-side het door:sturen wordt vereist voor het in real time delen van het publiek van AAM aan Analytics, zodat de cliënt-zijimplementaties voor deze eigenschap (en potentieel andere eigenschappen in de toekomst niet toestaan)
Men adviseert dat u zich aan een server-kant het door:sturen methode van de implementatie van AAM beweegt.
Server-kant het door:sturen implementatie server-side-forwarding-implementation
Zoals in bovenstaande afbeelding wordt getoond, komt een hit van de webpagina naar Adobe Analytics. Analytics stuurt die gegevens vervolgens door naar AAM in real-time, en bezoekers worden beoordeeld op AAM-kenmerken en segments , net alsof de treffer rechtstreeks van de pagina afkomstig was.
Segments worden op dezelfde real-time hit geretourneerd als Analytics , die de reactie doorstuurt naar de webpagina voor personalisatie, enzovoort.
Er is geen timing aan het bewegen naar server-kant door:sturen. Adobe raadt iedereen die zowel Audience Manager als Analytics heeft, ten zeerste aan deze implementatiemethode te gebruiken.
U hebt twee hoofdtaken you-have-two-main-tasks
Er staat nogal wat informatie op deze pagina, en dat is natuurlijk allemaal belangrijk. Nochtans, stuitert het allen neer aan twee belangrijkste dingen die u moet doen:
- Wijzig uw code van client-side DIL-code in server-side door:sturen-code
- Draai de schakelaar in Analytics Admin Console om het daadwerkelijke door:sturen van gegevens (per report suite) te beginnen
Als u één van beiden van deze taken overslaat, server-kant door:sturen zal niet correct werken. Er zijn stappen en aanvullende gegevens toegevoegd aan dit document, zodat u deze twee stappen correct kunt uitvoeren.
Implementatieopties implementation-options
Aangezien u zich van cliënt-kant aan server-kant het door:sturen beweegt, één van de taken u zult hebben verandert de code aan de nieuwe server-kant door:sturen code. Dit gebeurt op basis van een van de volgende opties:
- Adobe Experience Platform-tags - door Adobe aanbevolen implementatieoptie voor webeigenschappen. U zult zien dat dit een gemakkelijke taak is, aangezien de tags Platform al het harde werk voor u hebben gedaan.
- Op de pagina - U kunt de nieuwe SWF-code ook rechtstreeks in de functie
doPluginsin uwappMeasurement.js-bestand plaatsen als u (nog) geen Adobe Launch gebruikt - Andere tagmanagers - Deze kunnen op dezelfde manier worden behandeld als de vorige optie (Op de pagina), aangezien u de SSF-code toch in
doPluginsplaatst, waar de andere tagmanager de AppMeasurement -code opslaat
Wij zullen elk van deze hieronder in bekijken Bijwerkend de code sectie.
Implementatiestappen implementation-steps
In de volgende stappen wordt de implementatie beschreven.
Stap 0: Vereiste: Experience Cloud ID Service (ECID) step-prerequisite-experience-cloud-id-service-ecid
De belangrijkste voorwaarde voor de overgang naar server-kant door:sturen is dat de Experience Cloud ID Service wordt geïmplementeerd. Dit is het gemakkelijkst gedaan als u de Lancering van het Platform van de Ervaring gebruikt, waarbij u eenvoudig de uitbreiding ECID installeert en het de rest zal doen.
Als u niet-Adobe TMS, of geen TMS bij allen gebruikt, dan gelieve ECID uit te voeren vóór om het even welke andere oplossingen van Adobe in werking te stellen. Zie de documentatie ECID voor meer details. De enige andere voorwaarde is betreffende codeversies, zodat aangezien u eenvoudig de meest recente versies van de code in de volgende stappen toepast, zult u in orde zijn.
Stap 1: Neem de momenteel gebruikte opties op van de code van DIL step-record-currently-used-options-from-dil-code
Aangezien u bereid wordt om zich van cliënt-kant DIL code aan server-kant door:sturen, is de eerste stap alles te identificeren dat u met de code van DIL doet, met inbegrip van douanemontages en gegevens die naar AAM worden verzonden. U kunt onder andere de volgende dingen opmerken en overwegen:
- Normale variabelen Analytics met de module
siteCatalyst.initDIL - U hoeft zich geen zorgen te maken over deze module, omdat het alleen maar gaat om het verzenden van de normale variabelen Analytics . Dat gebeurt door het eenvoudig doorsturen van de server in te schakelen. - Partner Subdomain - noteer de parameter
DIL.createin de functiepartner. Dit is gekend als uw "partner subdomain,"of soms "partner identiteitskaart,"en zal nodig zijn wanneer u de nieuwe server-kant het door:sturen code plaatst. - Visitor Service Namespace - ook gekend als uw "Org ID"of "IMS Org ID,"u zult dit eveneens nodig hebben wanneer u opstelling de nieuwe server-kant het door:sturen code. Noteer dit.
- containerNSID, uuidCookie, en andere geavanceerde opties - maak een nota van om het even welke extra geavanceerde opties u gebruikt zodat u hen in de server-zij het door:sturen code kunt plaatsen eveneens.
- Aanvullende paginabariabelen - Als andere variabelen vanaf de pagina naar AAM worden verzonden (naast de normale Analytics -variabelen die door siteCatalyst.init worden verwerkt), moet u hiervan nota nemen zodat ze via server-side forward kunnen worden verzonden (spoiler alert: via contextData -variabelen).
Stap 2: De code bijwerken step-updating-the-code
In de opties van de Implementatie (hierboven), worden de veelvoudige opties gegeven betreffende hoe en waar u server-kant het door:sturen uitvoert. Om deze paragraaf doeltreffend te maken, moeten we ze in deze secties opsplitsen (met twee gecombineerd). Ga naar de methode van deze sectie die uw behoeften het best beschrijft.
Adobe Experience Platform-tags launch-by-adobe
Bekijk de video hieronder voor meer informatie over het verplaatsen van implementatieopties van DIL-code aan de clientzijde naar server-side forward in Experience Platform Launch.
"Op de pagina" of niet-Adobe tagmanager on-the-page-or-non-adobe-tag-manager
Bekijk de video hieronder voor meer informatie over het verplaatsen van implementatieopties van DIL-code op de client naar-code op de server in AppMeasurement -code, die zich in een bestand of in een niet-Adobe-tagbeheersysteem bevindt.
Stap 3: Het door:sturen (per Report Suite) toelaten step-enabling-the-forwarding-per-report-suite
Tot dusver in deze zelfstudie hebben we al onze tijd besteed aan het overschakelen van de code van client-side DIL code naar server-side door:sturen. Dat is prima, want het is het moeilijkste. Hoewel u zult zien dat deze sectie bijzonder eenvoudig is, is deze net zo belangrijk als het bijwerken van de code. In deze video, zult u zien hoe te om de schakelaar te draaien die het daadwerkelijke door:sturen van gegevens van Analytics aan Audience Manager toelaat.
NOTA: Zoals verklaard in de video, herinner dat het tot 4 uren voor het toelaten van het door:sturen zal duren om volledig op Experience Cloud achterste worden uitgevoerd.
Timing timing
Ter herinnering, zijn er twee belangrijke taken om zich over van cliënt-kant DIL aan server-kant door
- De code bijwerken
- De schakelaar omdraaien in de Analytics Admin Console
Maar de vraag is: welke doe je eerst? Maakt het uit? Dat waren twee vragen. Maar de antwoorden zijn… het hangt af, en ja, kan het ** ertoe doen. Hoe is dat voor vaag? Laten we het splitsen. Maar eerst een aanvullende vraag die je kunt stellen als je een grote organisatie bent met veel sites: Moet ik alles tegelijk doen? Dat is iets makkelijker. Nope. Je kunt het stuk voor stuk doen.
Een beetje dieper duiken a-little-deeper-dive
De reden waarom timing en orde materie wegens is hoe het door:sturen __ echt werkt, die in de volgende weinig technische feiten kan worden samengevat:
- Als u de Experience Cloud ID Service (ECID) hebt geïmplementeerd en de schakelaar in Analytics Admin Console ("de switch") is ingeschakeld, sturen gegevens door van Analytics naar AAM, zelfs als u de code nog niet hebt bijgewerkt.
- Als u ECID niet hebt uitgevoerd, zullen de gegevens niet door:sturen, zelfs als u de schakelaar hebt, en de server-kant hebben door:sturen code.
- De server-kant het door:sturen code (of in de markeringen van het Platform of op de pagina) behandelt werkelijk de reactie en is noodzakelijk om de migratie te voltooien.
- De door:sturen switch aan de serverzijde wordt ingeschakeld door report suite , maar de code wordt afgehandeld door de eigenschap in Platform-tags of door het AppMeasurement -bestand als u geen Platform-tags gebruikt.
Aanbevolen procedures best-practices
Op basis van deze technische details zijn hier de aanbevelingen voor de timing van wat te doen en wanneer:
Als u ECID nog niet hebt geïmplementeerd if-you-do-not-have-ecid-yet-implemented
-
Draai de schakelaar in Analytics voor elke report suite die u voor server-zij door:sturen zult toelaten.
- Het doorsturen begint nog niet omdat u geen ECID hebt.
-
Werk per site uw code bij van client-side DIL naar server-side door:sturen (dit kan in Platform-tags staan) of op de pagina, zoals in een andere sectie hierboven is beschreven).
- Door:sturen nu stromen (aangezien u ECID) hebt toegevoegd, en u zou ook een juiste reactie JSON op uw Analytics baken moeten ontvangen (zie de sectie van de Bevestiging en van het Oplossen van problemen hieronder voor meer details).
Als u ECID hebt geïmplementeerd if-you-do-have-ecid-implemented
-
Bereid en plan zodat u bereid bent om uw code van DIL aan server-kant door:sturen PER report suite bij te werken die u voor server-kant het door:sturen zult toelaten:
-
Draai de schakelaar binnen Analytics om server-kant het door:sturen toe te laten.
- Het doorsturen begint omdat je ECID hebt ingeschakeld.
-
Werk uw code zo snel mogelijk bij van client-side DIL naar single-side forward (dit kan in Platform-tags of op de pagina staan, zoals in een andere sectie hierboven is beschreven).
- U zou een juiste reactie JSON op uw Analytics baken (zie de Bevestiging en het oplossen van problemensectie hieronder voor meer details) moeten ontvangen.
-
Tijdstip voor migratie wanneer u veel sites hebt en report suites migration-timing-when-you-have-many-sites-and-report-suites
Dit onderwerp wordt in eerdere paragrafen kort besproken, in die zin dat de hoofdstrategie als volgt kan worden samengevat:
Migreer één plaats/report suite (of groep plaatsen/report suites) tegelijkertijd.
Nochtans, kan dit een beetje lastig worden gebaseerd op een paar mogelijke scenario's:
- U hebt een site die verschillende verschillende onderdelen bevat report suites
- U hebt een report suite die meerdere sites bevat (zoals een algemene report suite )
- U gebruikt één eigenschap Platform-tags voor meerdere sites
- U hebt verschillende ontwikkelingsteams voor verschillende sites
Vanwege deze items kan het een beetje ingewikkeld worden. De beste dingen die ik kan voorstellen zijn:
- Neem wat tijd om een strategie te maken voor het migreren naar server-kant het door:sturen, die op de dingen wordt gebaseerd die hierboven zijn verklaard
- Gebaseerd op het feit dat één enkele bezit in de markeringen van het Platform (of één enkel AppMeasurement dossier) typisch aan 1 of 2 verschillend report suites toewijst, zult u waarschijnlijk een plan kunnen maken dat aan deze verschillende groepen één voor één werkt, die uw onderneming aan server-kant door:sturen
- Als u met Adobe Consulting werkt, praat dan met hen over uw migratieplan, zodat ze daar waar nodig hulp kunnen bieden
Validatie en probleemoplossing validation-and-troubleshooting
De belangrijkste manier om te bevestigen dat de server-kant het door:sturen in werking is door de reactie op om het even welk van uw Adobe Analytics klappen te bekijken die uit app komen.
Als u geen server-side het door:sturen van gegevens van Analytics aan Audience Manager doet, dan is er echt geen reactie op het Analytics baken (behalve een 2 pixel). Nochtans, als u server-kant het door:sturen doet, dan zijn er punten die u in het Analytics verzoek en de reactie kunt verifiëren die u zullen laten weten dat Analytics correct met Audience Manager communiceert, door:sturen de slag, en het krijgen van een reactie.
stuff in de reactie hebt. Als u dat niet doet, ziet u mogelijk een bericht met de tekst "status":"SUCCESS" . Hoe gek dit ook klinkt, dit is eigenlijk een bewijs dat het NIET correct werkt.
Voor meer informatie over server-kant door:sturen, gelieve de documentatie te zien.