Vergleich von at.js mit Platform Web SDK
Die eigenständige Adobe Target at.js-Bibliothek unterscheidet sich erheblich von Platform Web SDK. Die folgenden Tabellen dienen als Referenz bei der Bewertung von Bereichen Ihrer Implementierung, auf die Sie sich während des Migrationsprozesses möglicherweise konzentrieren müssen.
Nachdem Sie die folgenden Informationen durchgelesen und Ihre aktuelle technische at.js-Implementierung bewertet haben, sollten Sie Folgendes verstehen:
- Welche Target-Funktionen von Platform Web SDK unterstützt werden
- Welche at.js-Funktionen haben Platform Web SDK-Entsprechungen?
- Anwenden von Target-Einstellungen mit Platform Web SDK
- Unterschiede beim Datenfluss von at.js und Platform Web SDK
Wenn Sie mit Platform Web SDK noch nicht vertraut sind, können Sie sich keine Sorgen machen. Die folgenden Elemente werden in diesem Tutorial ausführlicher behandelt.
Funktionsvergleich
sendEvent
-Befehls verwendet werden, nachdem Daten von einem anderen Anbieter abgerufen wurden.Bemerkenswerte Hinweise
at-body-style
. at.js sucht nach dieser Element-ID, um den Stil zu entfernen, sobald eine Antwort eingeht.alloy-prehiding
. Das Web-SDK ist nicht mit dem Code-Ausschnitt zum Vorab-Ausblenden von at.js kompatibel, sodass es im Rahmen des Migrationsprozesses geändert werden muss.pageLoadEnabled
auf true
gesetzt ist.sendEvent
-Befehl von Platform Web SDK angegeben. Aktiviert, indem die Option renderDecisions
auf true
gesetzt wird.applyOffer()
- und applyOffers()
unterstützen nur das Einstellen von HTMLapplyPropositions
-Befehl unterstützt das Festlegen, Ersetzen oder Anhängen von HTML für mehr FlexibilitättrackEvent()
- und sendNotifications()
. Diese Funktionen sind Target-spezifisch und wirken sich nicht auf Adobe Analytics-Metriken aus.sendEvent
-Aufrufen werden an Target weitergeleitet. Zusätzliche Daten, die speziell für Target benötigt werden, sollten mit dem sendEvent
-Befehl mit dem eventType-Wert decisioning.propositionDisplay
oder decisioning.propositionInteract
aufgenommen werden, um sicherzustellen, dass Adobe Analytics-Metriken nicht betroffen sind.mboxDisable
-, mboxDebug
- und mboxTrace
-URL-Parameter können zum Debugging mit den Entwickler-Tools Ihres Browsers verwendet werden.Der Adobe Experience Platform Debugger ist auch ein unterstütztes Debugging-Tool.
mboxDisable
, mboxDebug
und mboxTrace
werden nicht unterstützt.Sie können das Debugging von Web SDK aktivieren, indem Sie die
alloy_debug=true
zu Ihrer Abfragezeichenfolge hinzufügen oder alloy("setDebug", { "enabled": true });
in Ihrer Entwicklerkonsole ausführen.Die Adobe Experience Platform Debugger-Browser-Erweiterung kann verwendet werden, um eine Edge-Ablaufverfolgung für das Debugging zu initiieren.
Informationen finden Sie in der Dokumentation Debuggen der Platform WebSDK".
idMigrationEnabled
- und targetMigrationEnabled
-Optionen so festzulegen, dass sie mit dem configure
-Befehl true
.at.js-Funktionen und Platform Web SDK-Entsprechungen
Viele at.js-Funktionen verwenden einen äquivalenten Ansatz unter Verwendung von Platform Web SDK, wie in der folgenden Tabelle beschrieben. Weitere Informationen zu den at.js-Funktionen finden Sie im Adobe Target-Entwicklerhandbuch.
getOffer()
und getOffers()
sendEvent
und setzen die Option renderDecisions
auf „true“.Um formularbasierte Erlebnisse anzufordern oder Inhalte manuell zu rendern geben Sie mit dem Befehl
sendEvent
ein Array von decisionScopes
(Mboxes) an.applyOffer()
und applyOffers()
applyPropositions
zum Anwenden von Inhalten. Sie können festlegen, ersetzen oder HTML an einen bestimmten Selektor anhängen.triggerView()
web.webPageDetails.viewName
-Eigenschaft unter der xdm
-Option des sendEvent
festgelegt ist.trackEvent()
und sendNotifications()
sendEvent
-Befehl mit einem spezifischen eventType
:decisioning.propositionDisplay
signalisiert das Rendern einer Aktivitätdecisioning.propositionInteract
signalisiert eine Benutzerinteraktion mit einer Aktivität, wie z. B. einen Mausklick.targetGlobalSettings()
targetPageParams()
und targetPageParamsAll()
xdm
des Befehls sendEvent
übergebenen Daten werden den Target-Mbox-Parametern zugeordnet. Da Mbox-Parameter mit serialisierter Punktnotation benannt werden, müssen Sie bei der Migration zu Platform Web SDK möglicherweise vorhandene Zielgruppen und Aktivitäten aktualisieren, um die neuen Mbox-Parameternamen zu verwenden.Daten, die im Rahmen der
data.__adobe.target
des sendEvent
-Befehls übergeben werden, werden Zielprofil- und Recommendations-spezifischen Parametern).propositions
in der Antwort des sendEvent
-Aufrufs bereitgestellt.at.js-Einstellungen und Entsprechungen von Platform Web SDK
Die at.js-Bibliothek kann mit verschiedenen Einstellungen in der Target-Benutzeroberfläche konfiguriert und heruntergeladen werden. Diese Einstellungen können auch mit der Funktion targetGlobalSettings()
aktualisiert werden. In der folgenden Tabelle werden diese Einstellungen mit denen verglichen, die in Platform Web SDK verfügbar sind.
bodyHiddenStyle
prehidingStyle
mit dem Befehl configure
festbodyHidingEnabled
prehidingStyle
mit dem Befehl configure
definiert wird, ist diese Funktion aktiviert. Wenn kein Stil definiert ist, versucht Platform Web SDK nicht, Inhalte auszublenden.clientCode
cookieDomain
crossDomain
thirdPartyCookiesEnabled
auf true
mit dem Befehl configure
fest, um Erstanbieter- und Drittanbieter-Cookies für domänenübergreifende Anwendungsfälle zu aktivierencspScriptNonce
und cspStyleNonce
dataProviders
decisioningMethod
sendEvent
verwenden serverseitige Entscheidungsfindung. Hybride und geräteinterne Entscheidungsfindung werden nicht unterstützt.defaultContentHiddenStyle
und defaultContentVisibleStyle
deviceIdLifetime
targetMigrationEnabled
mit dem configure
-Befehl auf true
gesetzt ist, wird das mbox
-Cookie gesetzt, wobei die Lebensdauer des Geräts auf 2 Jahre eingestellt ist. Dieser Wert kann nicht konfiguriert werden.enabled
globalMboxAutoCreate
renderDecisions
true
-Option fest, um mit dem sendEvent
-Befehl automatisch VEC-basierte Erlebnisse abzurufen und zu rendern.Fordern Sie eine
decisionScope
für __view__
an, wenn Sie es vorziehen, VEC-basierte Erlebnisse manuell zu rendern.imsOrgId
orgId
mit dem Befehl configure
festoptinEnabled
und optoutEnabled
defaultConsent
Option gilt für alle Adobe-Lösungen, die von Platform Web SDK unterstützt werden.overrideMboxEdgeServer
und overrideMboxEdgeServerTimeout
pageLoadEnabled
sendEvent
die renderDecisions
Option auf true
fest.secureOnly
secure
und sameSite="none"
.selectorsPollingTimeout
serverDomain
edgeDomain
mit dem Befehl configure
.telemetryEnabled
timeout
viewsEnabled
sendEvent()
-Aufruf abgerufen, wenn renderDecisions
auf true
festgelegt oder der Entscheidungsumfang der __view__
in der Anfrage enthalten ist.visitorApiTimeout
Vergleich von Systemdiagrammen
Die folgenden Diagramme sollen Ihnen dabei helfen, die Datenflussunterschiede zwischen einer Target-Implementierung mit at.js und einer Implementierung mit Platform Web SDK zu verstehen.
Systemdiagramm für at.js 2.x
Zielgerichtete Inhalte auf der aktuellen Seite werden so schnell wie möglich angezeigt, ohne dass der Standardinhalt flackert.
Zielgerichtete Inhalte für zukünftige Ansichten einer Einzelseitenanwendung werden im Browser zwischengespeichert, sodass sie sofort ohne zusätzlichen Server-Aufruf angewendet werden können, wenn die Ansichten ausgelöst werden.
Weitere Informationen zur Implementierung von Target (mithilfe .js für Einzelseitenanwendungen) finden Sie im.
Systemdiagramm für Platform Web SDK
B. Personalisierte Inhalte für Ansichten, die als Ergebnis von Benutzeraktionen in einer Single Page Application (SPA) angezeigt werden, werden zwischengespeichert, um eine sofortige Wiedergabe ohne zusätzliche Server-Aufrufe zu ermöglichen.
c. Das Edge Network sendet die Besucher-ID und andere Werte in Cookies (z. B. Einverständnis, Sitzungs-ID, Identität, Cookie-Prüfung, Personalisierung usw.).
Im Entwicklerhandbuch finden Sie weitere Informationen zur von Target mithilfe von Platform Web SDK für Einzelseitenanwendungen.
Nachdem Sie über ein gutes technisches Verständnis Ihrer aktuellen Target-Implementierung und der von Ihnen verwendeten Funktionen verfügen, besteht der nächste Schritt darin, die Ersteinrichtung“.