Dokumentation Experience Platform Migrera mål från at.js 2.x till Web SDK

Jämförelse mellan at.js och Platform Web SDK

Last update: Tue Sep 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:

Skapat för:

Mellanliggande
Erfaren
Utvecklare

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

Mål at.js 2.x

Platform Web SDK

Uppdatera målprofil

Stöds

Utlösarvy för SPA

Stöds

Målrekommendationer

Stöds

Hämta blankettbaserade erbjudanden

Stöds

Spåra händelser

Stöds

A4T: Single page application

Stöds

A4T: Klickspårning

Stöds

A4T: Loggning på klientsidan

Stöds

A4T: Loggning på serversidan

Stöds

Tillämpa erbjudanden

Stöds

Återge vyn i SPA utan meddelanden

Stöds

Hybridtillämpningar

Stöds

QA-URL:er

Stöds

Mbox-ID för tredje part

Stöds

Kundattribut

Stöds

Fjärrerbjudanden

Stöds

Stöds delvis. Dynamiska fjärrerbjudanden stöds inte.

Omdirigeringserbjudanden

Stöds

Stöds. Omdirigering från en sida med Platform Web SDK till en sida med at.js (och i motsatt riktning) stöds emellertid inte.

Beslut på enheten

Stöds

Stöds inte för närvarande

Förhämta kartonger

Stöds för anpassade omfattningar och SPA VEC

Förhämtning är standardläge för Web SDK

Anpassade händelser

Stöds

Stöds inte. Aktuell status finns i den offentliga färdplanen.

Svarstoken

Stöds

Stöds. Se dokumentationen för dedikerade svarstoken för kodexempel och skillnader mellan at.js och Platform Web SDK

Dataleverantörer

Stöds

Stöds inte. Anpassad kod kan användas för att utlösa ett SDK sendEvent-kommando för plattformen när data har hämtats från en annan provider.

Anteckningsbara bildtexter

Mål at.js 2.x

Platform Web SDK

Flimmerreducering

I det föregående dolda fragmentet för asynkrona implementeringar används ett format-ID på at-body-style. at.js söker efter detta element-ID för att ta bort formatet när ett svar tas emot.

Standardfragmentet för fördöljning använder ett format-ID på alloy-prehiding. Web SDK är inte kompatibelt med fragmentet at.js så det måste ändras under migreringsprocessen.

Återge innehåll automatiskt vid sidinläsning

Kontrolleras med en global målinställning. Aktiveras när pageLoadEnabled är inställd på true.

Anges i Platform Web SDK sendEvent-kommandot. Aktiveras genom att alternativet renderDecisions anges till true.

Återge innehåll manuellt

Funktionerna applyOffer() och applyOffers() stöder bara inställning av HTML

Kommandot applyPropositions stöder inställning, ersättning eller tillägg av HTML för ökad flexibilitet

Spåra anpassade händelser

Stöds med funktionerna trackEvent() och sendNotifications(). Dessa funktioner är specifika för Target och påverkar inte Adobe Analytics-statistik.

Alla data från SDK 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.

Mål-CNAME

Stöds. Detta skiljer sig från CNAME som används för Analytics och Experience Cloud ID Service.

Inte längre relevant. En enda CNAME kan användas för alla SDK-anrop för plattformen.

Felsökning

URL-parametrarna 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.

URL-parametrarna 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.

Analyser för mål (A4T)

Använder SDID-värden för sammanfogning av mål- och analysanrop

Inbyggt stöd utan behov av sys

NOTE

Det går inte att migrera Target till Platform Web SDK samtidigt som en befintlig AppMeasurement Adobe Analytics-implementering för en viss sida behålls.

Du kan migrera din at.js-implementering (och AppMeasurement.js) till Platform Web SDK en sida i taget. Om du väljer det här sättet är det bäst att ange alternativen 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.

funktionen at.js 2.x

SDK-motsvarighet för plattformar

getOffer() och getOffers()

Om du vill begära och automatiskt återge VEC-baserade målupplevelser använder du kommandot 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()

Använd kommandot 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()

Platform Web SDK utlöser automatiskt en vyändring för SPA VEC om egenskapen web.webPageDetails.viewName anges under alternativet xdm för kommandot sendEvent .

trackEvent() och sendNotifications()

Använd kommandot sendEvent med en specifik eventType uppsättning:

decisioning.propositionDisplay signalerar återgivningen av en aktivitet

decisioning.propositionInteract som signalerar en användarinteraktion med en aktivitet, till exempel ett musklick.

targetGlobalSettings()

Ingen direkt motsvarighet. Mer information finns i målinställningsjämförelsen.

targetPageParams() och targetPageParamsAll()

Alla data som skickas i alternativet 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.

at.js, anpassade händelser

Stöds inte. Aktuell status finns i den offentliga färdplanen. Svarstoken visas som en del av 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.

at.js, inställning

SDK-motsvarighet för plattformar

bodyHiddenStyle

Ange prehidingStyle med kommandot configure

bodyHidingEnabled

Om prehidingStyle 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.

clientCode

Automatiskt konfigurerad

cookieDomain

Ej tillämpligt

crossDomain

Ange alternativet thirdPartyCookiesEnabled till true med kommandot configure för att aktivera cookies från första och tredje part för korsdomänsanvändning

cspScriptNonce och cspStyleNonce

Läs dokumentationen om hur du konfigurerar en CSP ikonfigurationen.

dataProviders

Stöds inte

decisioningMethod

Alla plattformswebbkommandon för SDK sendEvent använder beslut på serversidan. Hybrid- och enhetsbeslut stöds inte.

defaultContentHiddenStyle och defaultContentVisibleStyle

Gäller endast med at.js 1.x. Precis som i at.js 2.x kan du använda anpassad kod för att reducera eventuella flimmer för formulärbaserade upplevelser.

deviceIdLifetime

Stöds inte. Om targetMigrationEnabled ä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.

enabled

Målfunktionen är aktiverad eller inaktiverad med dataströmskonfigurationen

globalMboxAutoCreate

Ange alternativet renderDecisions 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.

imsOrgId

Ange orgId med kommandot configure

optinEnabled och optoutEnabled

Se sekretessalternativen för Platform Web SDK. Alternativet defaultConsent gäller alla Adobe-lösningar som Platform Web SDK stöder.

overrideMboxEdgeServer och overrideMboxEdgeServerTimeout

Ej tillämpligt. Alla förfrågningar från Platform Web SDK använder Adobe Experience Platform Edge-nätverket.

pageLoadEnabled

Ange alternativet renderDecisions till true med kommandot sendEvent

secureOnly

Stöds inte. SDK för plattformen ställer in alla cookies med attributen secure och sameSite="none".

selectorsPollingTimeout

Stöds inte. Platform Web SDK har ett värde på 5 sekunder. Anpassad kod kan användas för att manuellt återge innehåll om det behövs.

serverDomain

Använd inställningen edgeDomain med kommandot configure

telemetryEnabled

Ej tillämpligt

timeout

Stöds inte. Vi rekommenderar att du ser till att en lämplig tidsgräns anges för all kod som reducerar flimret.

viewsEnabled

Stöds inte. Innehåll för målvyer hämtas alltid vid det första sendEvent()-anropet om renderDecisions är inställt på true eller om __view__ DecisionScope är inkluderat i begäran.

visitorApiTimeout

Ej tillämpligt

Systemdiagramsjä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 at.js 2.0 vid sidinläsning {modal="regular"}

Utlysning

Information

Anropet returnerar Experience Cloud ID (ECID). Om användaren är autentiserad synkroniseras kundens ID med ett annat samtal.

at.js-biblioteket läses in synkront och döljer dokumentets brödtext (at.js kan också läsas in asynkront med ett valfritt predhide-fragment implementerat på sidan).

Begäran om sidinläsning omfattar alla konfigurerade parametrar, ECID, SDID och kund-ID.

Profilskript körs och matas in i profilarkivet. Store begär kvalificerade målgrupper från Audience Library (till exempel målgrupper som delas från Analytics, Audience Manager och så vidare). Kundattribut skickas till profilarkivet i en gruppbearbetning.

Baserat på URL, begärandeparametrar och profildata avgör Target vilka aktiviteter och upplevelser som ska returneras till besökaren för den aktuella sidan och framtida vyer.

Målinriktat innehåll som skickas tillbaka till sidan, eventuellt med profilvärden för ytterligare personalisering.

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.

Analysdata som skickas från sidan till datainsamlingsservrarna.

Måldata matchas mot Analytics-data via SDID och bearbetas till lagringsplatsen för analysrapporter. Analysdata kan sedan visas både i Analytics och Target via A4T-rapporter.

Mer information om hur du implementerar Target med at.js för enkelsidiga program finns i utvecklarhandboken.

SDK-systemdiagram - plattform

Diagram över Adobe Target edge-beslut med Platform Web SDK

Utlysning

Information

Enheten läser in Platform Web SDK. Platform Web SDK skickar en begäran till edge-nätverket med XDM-data, DataStreams Environment ID, inskickade parametrar och kundens ID (valfritt). Sidan (eller behållarna) är fördold.

edge-nätverket skickar begäran till edge-tjänsterna för att berika den med besökar-ID, samtycke och annan kontextinformation för besökare, som geopositionering och enhetsvänliga namn.

Edge-nätverket skickar den berikade personaliseringsbegäran till Target-kanten med besökar-ID och skickade parametrar.

Profilskript körs och matas sedan in i målprofilens lagring. Profillagring hämtar segment från målgruppsbiblioteket (till exempel segment som delas från Adobe Analytics, Adobe Audience Manager, Adobe Experience Platform).

Baserat på parametrar för URL-begäran och profildata avgör Target vilka aktiviteter och upplevelser som ska visas för besökaren för den aktuella sidvyn och för framtida förhämtade vyer. Target skickar sedan tillbaka den här till gränsnätverket.

a. Edge-nätverket skickar personaliseringssvaret tillbaka till sidan, eventuellt inklusive profilvärden för ytterligare personalisering. Personaliserat innehåll på den aktuella sidan visas så snabbt som möjligt utan att man behöver flimra standardinnehållet.

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).

Edge Network Forwards Analytics for Target (A4T)-information (aktivitet, upplevelse och konverteringsmetadata) till Analytics-kanten.

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.

NOTE

Vi vill hjälpa dig att lyckas med din Target-migrering från at.js till Web SDK. Om du stöter på problem med din migrering eller om du känner att det saknas viktig information i den här guiden kan du meddela oss genom att publicera den här communitydiskussionen.

recommendation-more-help

a69e1b51-9545-4d8a-822d-319242c29110