Jämförelse mellan at.js och Platform Web SDK
Det fristående Adobe Target at.js-biblioteket skiljer sig avsevärt från Platform Web SDK. Följande tabeller är en referens som hjälper dig att utvärdera områden av implementeringen som du kan behöva fokusera på under migreringsprocessen.
När du har granskat informationen nedan och utvärderat din nuvarande tekniska at.js-implementering bör du förstå följande:
- Vilka Target-funktioner som stöds av Platform Web SDK
- Funktionerna at at.js har motsvarigheter för Platform Web SDK
- Hur Target-inställningarna tillämpas med Platform Web SDK
- Hur dataflödet i at.js och Platform Web SDK skiljer sig åt
Om du inte har använt Platform Web SDK tidigare behöver du inte bekymra dig - du hittar detaljerna nedan i hela kursen.
Jämförelse av funktioner
sendEvent-kommando för plattformen när data har hämtats från en annan provider.Anteckningsbara bildtexter
at-body-style. at.js söker efter detta element-ID för att ta bort formatet när ett svar tas emot.alloy-prehiding. Web SDK är inte kompatibelt med fragmentet at.js så det måste ändras under migreringsprocessen.pageLoadEnabled är inställd på true.sendEvent-kommandot. Aktiveras genom att alternativet renderDecisions anges till true.applyOffer() och applyOffers() stöder bara inställning av HTMLapplyPropositions stöder inställning, ersättning eller tillägg av HTML för ökad flexibilitettrackEvent() och sendNotifications(). Dessa funktioner är specifika för Target och påverkar inte Adobe Analytics-statistik.sendEvent-anrop för plattformen vidarebefordras till Target. Ytterligare data som behövs specifikt för Target ska inkluderas med kommandot sendEvent med händelsetypen decisioning.propositionDisplay eller decisioning.propositionInteract för att säkerställa att Adobe Analytics-mått inte påverkas.mboxDisable, mboxDebug och mboxTrace kan användas för felsökning med webbläsarens utvecklingsverktyg.Adobe Experience Platform Debugger stöds också som felsökningsverktyg.
mboxDisable, mboxDebug och mboxTrace stöds inte.Du kan aktivera Web SDK-felsökning genom att lägga till
alloy_debug=true i frågesträngen eller köra alloy("setDebug", { "enabled": true }); i utvecklarkonsolen.Webbläsartillägget för Adobe Experience Platform Debugger kan användas för att initiera en kantspårning för felsökning.
Mer information finns i felsökningsdokumentationen för Platform Web SDK.
idMigrationEnabled och targetMigrationEnabled till true med kommandot configure.at.js-funktioner och motsvarigheter till Platform Web SDK
Många at.js-funktioner har en likvärdig metod med Platform Web SDK som beskrivs i tabellen nedan. Mer information om funktionerna at.js finns i Adobe Target Developer Guide.
getOffer() och getOffers()sendEvent och anger alternativet renderDecisions till true.Om du vill begära formulärbaserade upplevelser eller återge innehåll manuellt anger du en array med
decisionScopes (rutor) med kommandot sendEvent.applyOffer() och applyOffers()applyPropositions för att tillämpa innehåll. Du kan välja att ställa in, ersätta eller lägga till HTML i en specifik väljare.triggerView()web.webPageDetails.viewName anges under alternativet xdm för kommandot sendEvent .trackEvent() och sendNotifications()sendEvent med en specifik eventType uppsättning:decisioning.propositionDisplay signalerar återgivningen av en aktivitetdecisioning.propositionInteract som signalerar en användarinteraktion med en aktivitet, till exempel ett musklick.targetGlobalSettings()targetPageParams() och targetPageParamsAll()xdm för kommandot sendEvent mappas till Target-parametrar för mbox. Eftersom mbox-parametrar namnges med serialiserad punktnotation kan du behöva uppdatera befintliga målgrupper och aktiviteter för att kunna använda de nya mbox-parameternamnen när du migrerar till Platform Web SDK.Data som skickas som en del av
data.__adobe.target av kommandot sendEvent mappas till Målprofil och Rekommendationer som är specifika parametrar.propositions i svaret från anropet sendEvent.at.js-inställningar och motsvarigheter till Platform Web SDK
At.js-biblioteket kan konfigureras och laddas ned med olika inställningar i målgränssnittet. Dessa inställningar kan även uppdateras med funktionen targetGlobalSettings(). I tabellen nedan jämförs dessa inställningar med de som finns i Platform Web SDK.
bodyHiddenStyleprehidingStyle med kommandot configurebodyHidingEnabledprehidingStyle definieras med kommandot configure aktiveras den här funktionen. Om inget format definieras försöker inte Platform Web SDK att dölja något innehåll.clientCodecookieDomaincrossDomainthirdPartyCookiesEnabled till true med kommandot configure för att aktivera cookies från första och tredje part för korsdomänsanvändningcspScriptNonce och cspStyleNoncedataProvidersdecisioningMethodsendEvent använder beslut på serversidan. Hybrid- och enhetsbeslut stöds inte.defaultContentHiddenStyle och defaultContentVisibleStyledeviceIdLifetimetargetMigrationEnabled är inställt på true med kommandot configure ställs cookien mbox in med enhetens livstid inställd på 2 år. Detta värde kan inte konfigureras.enabledglobalMboxAutoCreaterenderDecisions till true med kommandot sendEvent för att automatiskt hämta och återge VEC-baserade upplevelser.Begär en
decisionScope för __view__ om du föredrar att manuellt återge VEC-baserade upplevelser.imsOrgIdorgId med kommandot configureoptinEnabled och optoutEnableddefaultConsent gäller alla Adobe-lösningar som Platform Web SDK stöder.overrideMboxEdgeServer och overrideMboxEdgeServerTimeoutpageLoadEnabledrenderDecisions till true med kommandot sendEventsecureOnlysecure och sameSite="none".selectorsPollingTimeoutserverDomainedgeDomain med kommandot configuretelemetryEnabledtimeoutviewsEnabledsendEvent()-anropet om renderDecisions är inställt på true eller om __view__ DecisionScope är inkluderat i begäran.visitorApiTimeoutSystemdiagramsjämförelse
Följande diagram bör hjälpa dig att förstå skillnaderna i dataflöde mellan en Target-implementering som använder at.js och en implementering som använder Platform Web SDK.
at.js 2.x systemdiagram
Beteendet
Målinnehåll på den aktuella sidan visas så snabbt som möjligt utan att standardinnehållet flimrar.
Målanpassat innehåll för framtida vyer av ett enkelsidigt program cachelagras i webbläsaren, så att det kan tillämpas direkt utan ett extra serveranrop när vyerna aktiveras.
Mer information om hur du implementerar Target med at.js för enkelsidiga program finns i utvecklarhandboken.
SDK-systemdiagram - plattform
b. Personaliserat innehåll för vyer som visas som ett resultat av användaråtgärder i ett SPA-program (Single Page Application) cachas för direktåtergivning utan ytterligare serveranrop.
c. Edge-nätverket skickar besökar-ID och andra värden i cookies (till exempel samtycke, sessions-ID, identitet, cookie-kontroll, personalisering och så vidare).
Mer information om hur du implementerar Target med Platform Web SDK for Single-page applications finns i utvecklarhandboken.
När du har en god teknisk förståelse för den aktuella målinstallationen och de funktioner du använder är nästa steg att utföra den inledande konfigurationen.