Documentatie Experience Platform Doel migreren van at.js 2.x naar Web SDK

Vergelijking van at.js met Platform Web SDK

Last update: Thu Oct 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:

Gemaakt voor:

tussenpersoon
Ervaren
Ontwikkelaar

De zelfstandige Adobe Target at.js-bibliotheek verschilt aanzienlijk van Platform Web SDK. De volgende tabellen zijn een referentie om u te helpen gebieden van uw implementatie te evalueren waarop u zich tijdens het migratieproces moet concentreren.

Na het herzien van de informatie hieronder en het beoordelen van uw huidige technische implementatie at.js, zou u het volgende moeten kunnen begrijpen:

Welke eigenschappen van het Doel door het Web SDK van het Platform worden gesteund
Welke functies at.js hebben de equivalenten van SDK van het Web van het Platform
Hoe de montages van het Doel met het Web SDK van het Platform worden toegepast
Hoe de gegevensstroom van at.js en het Web SDK van het Platform verschillen

Als u aan het Web SDK van het Platform nieuw bent, maak u geen zorgen - de punten hieronder zijn behandeld meer in detail door dit leerprogramma.

Functievergelijking

Doel op.js 2.x

Platform Web SDK

Doelprofiel bijwerken

Ondersteund

Weergave activeren voor SPA

Ondersteund

Doel Recommendations

Ondersteund

Formuliergebaseerde aanbiedingen ophalen

Ondersteund

Gebeurtenissen bijhouden

Ondersteund

A4T: Toepassing op één pagina

Ondersteund

A4T: klik op bijhouden

Ondersteund

A4T: Logboekregistratie op de client

Ondersteund

A4T: logboekregistratie op de server

Ondersteund

Aanbiedingen toepassen

Ondersteund

Weergave opnieuw renderen in SPA zonder meldingen

Ondersteund

Hybride toepassingen

Ondersteund

URL's kwaliteitscontrole

Ondersteund

Id's van derden van box

Ondersteund

Klantkenmerken

Ondersteund

Externe aanbiedingen

Ondersteund

Aanbiedingen omleiden

Ondersteund

Ondersteund. Nochtans, wordt een omleiding van een pagina met het Web SDK van het Platform aan een pagina met at.js (en in de tegenovergestelde richting) niet gesteund.

Apparaatbeslissingen

Ondersteund

Momenteel niet ondersteund

Prefetch Mboxes

Ondersteund voor aangepaste scènes en SPA VEC

Prefetch is de standaardmodus voor Web SDK

Aangepaste gebeurtenissen

Ondersteund

Niet ondersteund. Zie openbare roadmapvoor huidige status.

Reactietokens

Ondersteund

Ondersteund. Verwijs naar de specifieke documentatie van de reactietokensvoor codevoorbeelden en verschillen tussen at.js en het Web SDK van het Platform

Gegevensleveranciers

Ondersteund

Niet ondersteund. De code van de douane kan worden gebruikt om een bevel van het Web SDK van het Platform sendEvent teweeg te brengen nadat het gegeven van een andere leverancier wordt teruggewonnen.

Aanbiedingswaardige callouts

Doel op.js 2.x

Platform Web SDK

Verzadiging flikkering

In het bovenliggende codefragment voor asynchrone implementaties wordt de stijl-id at-body-style gebruikt. at.js zoekt naar deze element-id om de stijl te verwijderen zodra een reactie is ontvangen.

In het standaard voorverborgen fragment wordt de stijl-id alloy-prehiding gebruikt. SDK van het Web is niet compatibel met het bij.js prehide fragment zodat moet het als deel van het migratieproces worden veranderd.

Inhoud automatisch renderen bij laden van pagina

Gecontroleerd met de globale instelling Doel. Wordt ingeschakeld wanneer pageLoadEnabled is ingesteld op true .

Opgegeven in de opdracht Platform Web SDK sendEvent . Ingeschakeld door de optie renderDecisions in te stellen op true .

Inhoud handmatig renderen

De functies applyOffer() en applyOffers() ondersteunen alleen het instellen van HTML

De opdracht applyPropositions ondersteunt het instellen, vervangen of toevoegen van HTML voor extra flexibiliteit

Aangepaste gebeurtenissen bijhouden

Ondersteund met functies trackEvent() en sendNotifications() . Deze functies zijn specifiek voor Target en hebben geen invloed op de metriek van Adobe Analytics.

Alle gegevens van de vraag van SDK van het Web van het Platform sendEvent door:sturen aan Doel. Aanvullende gegevens die specifiek nodig zijn voor Target, moeten worden opgenomen in de opdracht sendEvent met het gebeurtenistype decisioning.propositionDisplay of decisioning.propositionInteract om ervoor te zorgen dat de metriek van Adobe Analytics niet wordt beïnvloed.

DoelNAAM

Ondersteund. Dit is los van CNAME die voor Analytics en de Dienst van identiteitskaart van het Experience Cloud wordt gebruikt.

Niet langer relevant. Één enkele CNAME kan voor alle vraag van SDK van het Web van het Platform worden gebruikt.

Foutopsporing

De URL-parameters mboxDisable , mboxDebug en mboxTrace kunnen worden gebruikt voor foutopsporing met de ontwikkelaarsgereedschappen van uw browser.

het Adobe Experience Platform Debugger is ook gesteund het zuiveren hulpmiddel.

De URL-parameters mboxDisable , mboxDebug en mboxTrace worden niet ondersteund.

u kunt het zuiveren van SDK van het Web door alloy_debug=true aan uw vraagkoord toe te voegen of alloy("setDebug", { "enabled": true }); in uw ontwikkelaarsconsole uit te voeren inschakelen.

de browser van het Adobe Experience Platform Debugger uitbreiding kan worden gebruikt om een randspoor voor het zuiveren in werking te stellen.

verwijs naar het zuiveren van de documentatie van SDK van het Web van het Platformvoor meer informatie.

Analyses voor doel (A4T)

Gebruikt waarden SDID om de vraag van het Doel en van de Analyse te bevestigen

Native ondersteund zonder dat stitching nodig is

NOTE

Migrating Target to Platform Web SDK while keeping an existing AppMeasurement Adobe Analytics implementation for a given page is not supported.

Het is mogelijk om uw implementatie at.js (en AppMeasurement.js) aan het Web SDK van het Platform één pagina tegelijk te migreren. Als u deze benadering gebruikt, is het best om idMigrationEnableden targetMigrationEnabledopties aan true met het configure bevel te plaatsen.

at.js functies en de equivalenten van SDK van het Web van het Platform

Vele functies at.js hebben een gelijkwaardige benadering gebruikend het Web SDK van het Platform die in de lijst hieronder wordt geschetst. Voor meer details over at.js functies, verwijs naar de Gids van de Ontwikkelaar van Adobe Target.

at.js 2.x, functie

Platform Web SDK, equivalent

getOffer() en getOffers()

Om te verzoeken en terug te gevenop VEC-Gebaseerde ervaringen van het Doel automatisch, gebruik het sendEvent bevel en plaats de renderDecisions optie aan waar.

om vorm-gebaseerde ervaringen te verzoeken of manueel terug te geveninhoud, specificeer een serie van decisionScopes (dozen) met het sendEvent bevel.

applyOffer() en applyOffers()

Gebruik de opdracht applyPropositionsom inhoud toe te passen. U kunt ervoor kiezen om HTML in te stellen, te vervangen of toe te voegen aan een specifieke kiezer.

triggerView()

Het Web SDK van het platform brengt automatisch a meningsveranderingten behoeve van SPA VEC in werking als het web.webPageDetails.viewName bezit onder de xdm optie van het sendEvent bevel wordt geplaatst.

trackEvent() en sendNotifications()

Gebruik het sendEvent bevel met a specifieke eventTypeplaats:

decisioning.propositionDisplay signalen het teruggeven van een activiteit

decisioning.propositionInteract signalen een gebruikersinteractie met een activiteit, zoals een muisklik.

targetGlobalSettings()

Geen direct equivalent. Verwijs naar de de montagesvergelijking van het Doelvoor extra details.

targetPageParams() en targetPageParamsAll()

Alle gegevens die worden doorgegeven in de optie xdm van de opdracht sendEvent , worden toegewezen aan de parameters van Target. Aangezien mbox de parameters gebruikend in series vervaardigde puntaantekening worden genoemd, kan het migreren aan het Web SDK van het Platform u vereisen om bestaande publiek en activiteiten bij te werken om de nieuwe namen van de mbox parameternamen te gebruiken.

Gegevens die als deel van data.__adobe.target van het sendEvent bevel worden overgegaan wordt in kaart gebracht aan profiel van het Doel en Recommendations specifieke parameters.

at.js, aangepaste gebeurtenissen

Niet ondersteund. Zie openbare roadmapvoor huidige status. de tokens van de Reactieworden blootgesteld als deel van propositions in de reactie van de sendEvent vraag.

at.js montages en de equivalenten van SDK van het Web van het Platform

De bibliotheek at.js kan met diverse montages in het Doel UI worden gevormd en worden gedownload. Deze instellingen kunnen ook worden bijgewerkt met de functie targetGlobalSettings(). In de onderstaande tabel worden deze instellingen vergeleken met de instellingen die beschikbaar zijn in Platform Web SDK.

at.js-instelling

Platform Web SDK, equivalent

bodyHiddenStyle

Stel de opdracht prehidingStylein met de opdracht configure

bodyHidingEnabled

Als een prehidingStyle wordt gedefinieerd met de opdracht configure , wordt deze functie ingeschakeld. Als een stijl niet wordt bepaald, dan probeert het Web SDK van het Platform om geen inhoud te verbergen.

clientCode

Automatisch geconfigureerd

cookieDomain

Niet van toepassing

crossDomain

Stel de optie thirdPartyCookiesEnabled in op true met de opdracht configure om cookies van derden in te schakelen voor gebruik in andere domeinen

cspScriptNonce en cspStyleNonce

Verwijs naar de documentatie voor vormend CSP

dataProviders

Niet ondersteund

decisioningMethod

Alle opdrachten van de SDK van het web van het platform sendEvent maken gebruik van beslissingen op de server. Hybride en op-apparaat beslissingen worden niet ondersteund.

defaultContentHiddenStyle en defaultContentVisibleStyle

Alleen van toepassing met at.js 1.x. Net als bij at.js 2.x, kan elke flikkeronderdrukking voor op vorm-gebaseerde ervaringen worden verwezenlijkt gebruikend douanecode.

deviceIdLifetime

Niet ondersteund. Als targetMigrationEnabled op true is ingesteld met de opdracht configure , wordt het mbox -cookie ingesteld met de levensduur van het apparaat ingesteld op 2 jaar. Deze waarde kan niet worden geconfigureerd.

enabled

Doelfunctionaliteit is in- of uitgeschakeld met de configuratie van de gegevensstroom

globalMboxAutoCreate

Stel de optie renderDecisions in op true met de opdracht sendEvent om VEC-ervaringen automatisch op te halen en weer te geven.

vraag a decisionScope voor __view__ als u verkiest om op VEC-Gebaseerde ervaringen manueel terug te geven.

imsOrgId

Stel de orgId in met de opdracht configure

optinEnabled en optoutEnabled

Verwijs naar de de privacyopties van SDK van het Web van het Platform 🔗. De optie defaultConsent is van toepassing op alle Adobe-oplossingen die de Platform Web SDK ondersteunt.

overrideMboxEdgeServer en overrideMboxEdgeServerTimeout

Niet van toepassing. Alle verzoeken van het Web SDK van het Platform gebruiken het netwerk van Adobe Experience Platform Edge.

pageLoadEnabled

Stel de optie renderDecisions in op true met de opdracht sendEvent

secureOnly

Niet ondersteund. De Platform Web SDK plaatst alle koekjes met de secure en sameSite="none" attributen.

selectorsPollingTimeout

Niet ondersteund. De SDK van het Web van het Platform gebruikt een waarde van 5 seconden. Aangepaste code kan worden gebruikt om inhoud handmatig te renderen.

serverDomain

De instelling edgeDomain gebruiken met de opdracht configure

telemetryEnabled

Niet van toepassing

timeout

Niet ondersteund. Het wordt geadviseerd dat u ervoor zorgt om het even welke flikkerende matigingscode een aangewezen onderbreking omvat.

viewsEnabled

Niet ondersteund. Inhoud voor doelweergaven wordt altijd opgehaald bij de eerste sendEvent() oproep als renderDecisions is ingesteld op true of als __view__ DecisionScope is opgenomen in de aanvraag.

visitorApiTimeout

Niet van toepassing

Vergelijking systeemdiagram

De volgende diagrammen zouden u moeten helpen de verschillen van de gegevensstroom tussen een implementatie van het Doel begrijpen gebruikend at.js en een implementatie gebruikend het Web SDK van het Platform.

at.js 2.x systeemdiagram

at.js 2.0 gedrag op paginading {modal="regular"}

Bellen

Details

De vraag keert identiteitskaart van het Experience Cloud (ECID) terug. Als de gebruiker voor authentiek wordt verklaard, synchroniseert een andere vraag de klantenidentiteitskaart

De bibliotheek at.js wordt synchroon geladen en de hoofdtekst van het document verborgen (at.js kan ook asynchroon worden geladen met een optioneel vooraf verborgen fragment dat op de pagina is geïmplementeerd).

Het verzoek om het laden van de pagina wordt ingediend met inbegrip van alle gevormde parameters, ECID, SDID, en klant ID.

Profielscripts worden uitgevoerd en toegevoegd aan de profielopslag. De opslag vraagt gekwalificeerd publiek van de Bibliotheek van het Publiek (bijvoorbeeld, publiek dat van Analytics, Audience Manager wordt gedeeld, etc.). Klantkenmerken worden in een batchproces naar de profielwinkel verzonden.

Gebaseerd op URL, verzoekparameters, en profielgegevens, beslist Target welke Activiteiten en Ervaringen aan de bezoeker voor de huidige pagina en de toekomstige meningen terug te keren.

Gerichte inhoud die naar pagina wordt teruggestuurd, eventueel inclusief profielwaarden voor extra personalisatie.

de gerichte inhoud op de huidige pagina wordt getoond zo snel mogelijk zonder flikkering van standaardinhoud.

de gerichte inhoud voor toekomstige meningen van een enig-paginatoepassing wordt in het voorgeheugen ondergebracht in browser, zodat kan het onmiddellijk zonder een extra servervraag worden toegepast wanneer de meningen worden teweeggebracht.

Analysegegevens die van de pagina naar de Servers van de Inzameling van Gegevens worden verzonden.

De doelgegevens worden via de SDID aangepast aan de analysegegevens en worden verwerkt in de analytische rapportageopslag. De analysegegevens kunnen dan in zowel Analytics als Doel via A4T- rapporten worden bekeken.

Verwijs naar de ontwikkelaarsgids voor meer informatie hoe te Doel uitvoeren gebruikend at.js voor enig-paginatoepassingen.

Platform Web SDK systeemdiagram

Diagram van de randbeslissing van Adobe Target met het Web SDK van het Platform

Bellen

Details

Het apparaat laadt de Platform Web SDK. De SDK van het Web van het Platform verzendt een verzoek naar het randnetwerk met XDM- gegevens, identiteitskaart van het Milieu van Datastreams, overgegaan parameters, en identiteitskaart van de Klant (facultatief). De pagina (of containers) is vooraf verborgen.

Het Edge-netwerk verzendt de aanvraag naar de Edge-services om deze te verrijken met de informatie over de bezoeker-id, toestemming en andere bezoekerscontext, zoals geolocatie en apparaatvriendelijke namen.

Het randnetwerk verzendt het verrijkte verpersoonlijkingsverzoek naar de rand van het Doel met identiteitskaart van de Bezoeker en overgegaan parameters.

Profielscripts worden uitgevoerd en vervolgens opgenomen in de opslag van het doelprofiel. De opslag van het profiel haalt segmenten van de Bibliotheek van de Publiek (bijvoorbeeld, segmenten die van Adobe Analytics, Adobe Audience Manager, Adobe Experience Platform worden gedeeld).

Op basis van URL-aanvraagparameters en -profielgegevens bepaalt Target welke activiteiten en ervaringen moeten worden weergegeven voor de bezoeker voor de huidige paginaweergave en voor toekomstige vooraf ingestelde weergaven. Het doel verzendt dit dan terug naar het randnetwerk.

a. Het Edge-netwerk stuurt de verpersoonlijkingsreactie terug naar de pagina, eventueel inclusief profielwaarden voor extra personalisatie. Gepersonaliseerde inhoud op de huidige pagina wordt zo snel mogelijk weergegeven zonder flikkering van de standaardinhoud.

b. De gepersonaliseerde inhoud voor meningen die als resultaat van gebruikersacties in Één enkele Toepassing van de Pagina (SPA) worden getoond wordt caching voor onmiddellijke teruggave zonder extra servervraag.

c. Het Edge-netwerk verzendt de bezoeker-id en andere waarden in cookies (bijvoorbeeld toestemming, sessie-id, identiteit, cookie-controle, personalisatie enzovoort).

Het randnetwerk forwards Analytics voor de details van het Doel (A4T) (activiteit, ervaring, en omzettingsmeta-gegevens) aan de rand van de Analyse.

Verwijs naar de ontwikkelaarsgids voor meer informatie hoe te Doel uitvoeren gebruikend het Web SDK van het Platform voor Enige-pagina toepassingen.

Nadat u een goed technisch inzicht in uw huidige implementatie van het Doel en de eigenschappen hebt u gebruikt, moet de volgende stap de aanvankelijke opstellinguitvoeren.

NOTE

Wij zijn geëngageerd om u met uw migratie van het Doel van at.js aan Web SDK te helpen succesvol zijn. Als u in obstakels met uw migratie loopt of als er kritieke informatie ontbreekt in deze gids voelt, gelieve ons te vertellen door in deze communautaire besprekingte posten.

recommendation-more-help

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