Vergelijking van at.js met Platform Web SDK
Laatst bijgewerkt: 3 oktober 2024
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 | Ondersteund |
| Weergave activeren voor SPA | Ondersteund | Ondersteund |
| Doel Recommendations | Ondersteund | Ondersteund |
| Formuliergebaseerde aanbiedingen ophalen | Ondersteund | Ondersteund |
| Gebeurtenissen bijhouden | Ondersteund | Ondersteund |
| A4T: Toepassing op één pagina | Ondersteund | Ondersteund |
| A4T: klik op bijhouden | Ondersteund | Ondersteund |
| A4T: Logboekregistratie op de client | Ondersteund | Ondersteund |
| A4T: logboekregistratie op de server | Ondersteund | Ondersteund |
| Aanbiedingen toepassen | Ondersteund | Ondersteund |
| Weergave opnieuw renderen in SPA zonder meldingen | Ondersteund | Ondersteund |
| Hybride toepassingen | Ondersteund | Ondersteund |
| URL's kwaliteitscontrole | Ondersteund | Ondersteund |
| Id's van derden van box | Ondersteund | Ondersteund |
| Klantkenmerken | Ondersteund | Ondersteund |
| Externe aanbiedingen | Ondersteund | 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 |
NOTEMigrating 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
om vorm-gebaseerde ervaringen te verzoeken of manueel terug te geveninhoud, specificeer een serie van
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 activiteitdecisioning.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
Gegevens die als deel van
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
bodyHiddenStyleStel de opdracht
prehidingStylein met de opdracht configurebodyHidingEnabledAls 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.clientCodeAutomatisch geconfigureerd
cookieDomainNiet van toepassing
crossDomainStel de optie
thirdPartyCookiesEnabled in op true met de opdracht configure om cookies van derden in te schakelen voor gebruik in andere domeinencspScriptNonce en cspStyleNonceVerwijs naar de documentatie voor vormend CSP
dataProvidersNiet ondersteund
decisioningMethodAlle 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 defaultContentVisibleStyleAlleen 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.
deviceIdLifetimeNiet 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.enabledDoelfunctionaliteit is in- of uitgeschakeld met de configuratie van de gegevensstroom
globalMboxAutoCreateStel de optie
vraag a
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.imsOrgIdStel de
orgId in met de opdracht configureoptinEnabled en optoutEnabledVerwijs 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 overrideMboxEdgeServerTimeoutNiet van toepassing. Alle verzoeken van het Web SDK van het Platform gebruiken het netwerk van Adobe Experience Platform Edge.
pageLoadEnabledStel de optie
renderDecisions in op true met de opdracht sendEventsecureOnlyNiet ondersteund. De Platform Web SDK plaatst alle koekjes met de
secure en sameSite="none" attributen.selectorsPollingTimeoutNiet 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.
serverDomainDe instelling
edgeDomain gebruiken met de opdracht configuretelemetryEnabledNiet van toepassing
timeoutNiet ondersteund. Het wordt geadviseerd dat u ervoor zorgt om het even welke flikkerende matigingscode een aangewezen onderbreking omvat.
viewsEnabledNiet 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.visitorApiTimeoutNiet 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
Bellen
Details
1
De vraag keert identiteitskaart van het Experience Cloud (ECID) terug. Als de gebruiker voor authentiek wordt verklaard, synchroniseert een andere vraag de klantenidentiteitskaart
2
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).
3
Het verzoek om het laden van de pagina wordt ingediend met inbegrip van alle gevormde parameters, ECID, SDID, en klant ID.
4
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.
5
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.
6
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.
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.
7
Analysegegevens die van de pagina naar de Servers van de Inzameling van Gegevens worden verzonden.
8
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
Bellen
Details
1
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.
2
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.
3
Het randnetwerk verzendt het verrijkte verpersoonlijkingsverzoek naar de rand van het Doel met identiteitskaart van de Bezoeker en overgegaan parameters.
4
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).
5
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.
6
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).
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).
7
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.
NOTEWij 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