DokumentationExperience PlatformMigrieren von Target von at.js 2.x zum Web SDK

Vergleich von at.js mit dem Platform Web SDK

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

Erstellt für:

  • Fortgeschrittener
  • Experte
  • Entwickler

Die eigenständige Adobe Target at.js-Bibliothek unterscheidet sich erheblich vom Platform Web SDK. Die folgenden Tabellen sind eine Referenz, die Sie bei der Bewertung von Bereichen Ihrer Implementierung unterstützen soll, auf die Sie sich während des Migrationsprozesses konzentrieren müssen.

Nachdem Sie die unten stehenden Informationen überprüft und Ihre aktuelle technische at.js-Implementierung bewertet haben, sollten Sie Folgendes verstehen:

  • Welche Target-Funktionen werden vom Platform Web SDK unterstützt?
  • Welche at.js-Funktionen verfügen über Platform Web SDK-Entsprechungen
  • Anwendung von Target-Einstellungen mit dem Platform Web SDK
  • Unterschiede zwischen dem Datenfluss von at.js und dem Platform Web SDK

Wenn Sie mit dem Platform Web SDK noch nicht vertraut sind, machen Sie sich keine Gedanken - die unten stehenden Elemente werden in diesem Tutorial ausführlicher behandelt.

Funktionsvergleich

Target at.js 2.x
Platform Web-SDK
Target-Profil aktualisieren
Unterstützt
Unterstützt
Trigger-Ansicht für SPA
Unterstützt
Unterstützt
Target Recommendations
Unterstützt
Unterstützt
Formularbasierte Angebote abrufen
Unterstützt
Unterstützt
Verfolgen von Ereignissen
Unterstützt
Unterstützt
A4T: Einzelseitenanwendung
Unterstützt
Unterstützt
A4T: Klick-Tracking
Unterstützt
Unterstützt
A4T: Clientseitige Protokollierung
Unterstützt
Unterstützt
A4T: Serverseitige Protokollierung
Unterstützt
Unterstützt
Angebote anwenden
Unterstützt
Unterstützt
Ansicht in SPA ohne Benachrichtigungen erneut rendern
Unterstützt
Unterstützt
Hybride Anwendungen
Unterstützt
Unterstützt
QA-URLs
Unterstützt
Unterstützt
Mbox-Drittanbieter-IDs
Unterstützt
Unterstützt
Kundenattribute
Unterstützt
Unterstützt
Remote-Angebote
Unterstützt
Unterstützt
Umleitungsangebote
Unterstützt
Unterstützt. Eine Umleitung von einer Seite mit Platform Web SDK zu einer Seite mit at.js (und umgekehrt) wird jedoch nicht unterstützt.
On-Device Decisioning
Unterstützt
Derzeit nicht unterstützt
Vorabruf-mboxes
Unterstützt für benutzerdefinierte Bereiche und SPA VEC
Der Vorabruf ist der Standardmodus für das Web SDK.
Benutzerspezifische Ereignisse
Unterstützt
Nicht unterstützt. Informationen zum aktuellen Status finden Sie in der öffentlichen Roadmap .
Antwort-Token
Unterstützt
Unterstützt. Codebeispiele und Unterschiede zwischen at.js und dem Platform Web SDK finden Sie in der Dokumentation zu den dedizierten Antwort-Token .
Datenanbieter
Unterstützt
Nicht unterstützt. Mit benutzerdefiniertem Code kann ein Platform Web SDK sendEvent -Befehl Trigger werden, nachdem Daten von einem anderen Anbieter abgerufen wurden.

Wichtige Hinweise

Target at.js 2.x
Platform Web-SDK
Flimmern
Das Vorabausblendungs-Snippet für asynchrone Implementierungen verwendet eine Stil-ID von at-body-style. at.js sucht nach dieser Element-ID, um den Stil zu entfernen, sobald eine Antwort empfangen wird.
Der standardmäßige Codeausschnitt zur Vorab-Ausblendung verwendet die Stil-ID alloy-prehiding. Das Web SDK ist nicht mit dem at.js-Codeausschnitt zur Vorab-Ausblendung kompatibel, daher muss es im Rahmen des Migrationsprozesses geändert werden.
Automatisches Rendern von Inhalten beim Laden der Seite
Wird mit einer globalen Target-Einstellung gesteuert. Aktiviert, wenn pageLoadEnabled auf true gesetzt ist.
Wird im Befehl "Platform Web SDK sendEvent"angegeben. Aktiviert durch Festlegen der renderDecisions -Option auf true.
Manuelles Rendern von Inhalten
Die Funktionen applyOffer() und applyOffers() unterstützen nur das Festlegen von HTML
Der Befehl applyPropositions unterstützt das Festlegen, Ersetzen oder Anhängen von HTML für mehr Flexibilität
Verfolgen benutzerspezifischer Ereignisse
Unterstützt mit den Funktionen trackEvent() und sendNotifications(). Diese Funktionen sind spezifisch für Target und wirken sich nicht auf Adobe Analytics-Metriken aus.
Alle Daten aus Platform Web SDK sendEvent -Aufrufen werden an Target weitergeleitet. Zusätzliche Daten, die speziell für Target benötigt werden, sollten mit dem Befehl sendEvent mit dem Ereignistyp decisioning.propositionDisplay oder decisioning.propositionInteract eingeschlossen werden, um sicherzustellen, dass Adobe Analytics-Metriken nicht betroffen sind.
Target CNAME
Unterstützt. Dies unterscheidet sich vom CNAME, der für Analytics und den Experience Cloud ID-Dienst verwendet wird.
Nicht mehr relevant. Ein einzelner CNAME kann für alle Platform Web SDK-Aufrufe verwendet werden.
Debugging
Die URL-Parameter mboxDisable, mboxDebug und mboxTrace können zum Debugging mit den Entwicklertools Ihres Browsers verwendet werden.

Der Adobe Experience Platform Debugger ist auch ein unterstütztes Debugging-Tool.
Die URL-Parameter mboxDisable, mboxDebug und mboxTrace werden nicht unterstützt.

Sie können das Debugging des 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-Browsererweiterung kann verwendet werden, um einen Edge-Trace für das Debugging zu initiieren.Weitere Informationen finden Sie in der Dokumentation zum Debugging des Platform Web SDK .
Analytics for Target (A4T)
Verwendet SDID-Werte zum Zuordnen von Target- und Analytics-Aufrufen
Nativ unterstützt ohne Stitching
NOTE
Die Migration von Target zum Platform Web SDK unter Beibehaltung einer bestehenden AppMeasurement Adobe Analytics-Implementierung für eine bestimmte Seite wird nicht unterstützt.
Es ist möglich, Ihre at.js- (und AppMeasurement.js-) Implementierung auf Platform Web SDK einzeln zu migrieren. Wenn Sie diesen Ansatz wählen, ist es am besten, die Optionen idMigrationEnabled und targetMigrationEnabled mit dem Befehl configure auf true festzulegen.

"at.js"-Funktionen und Platform Web SDK-Entsprechungen

Viele at.js-Funktionen verwenden einen äquivalenten Ansatz mit dem Platform Web SDK, wie in der folgenden Tabelle beschrieben. Weitere Informationen zu den at.js-Funktionen finden Sie im Adobe Target-Entwicklerhandbuch.

Funktion "at.js 2.x"
Platform Web SDK-Entsprechung
getOffer() und getOffers()
Verwenden Sie zum Anfordern und automatischen Rendern vonVEC-basierten Erlebnissen auf Target den Befehl sendEvent und legen Sie die Option renderDecisions auf "true"fest.

Um formularbasierte Erlebnisse anzufordern oder um manuell Inhalte zu rendern, geben Sie ein Array von decisionScopes (mboxes) mit dem Befehl sendEvent an.
applyOffer() und applyOffers()
Verwenden Sie den Befehl applyPropositions , um Inhalte anzuwenden. Sie können festlegen, HTML an einen bestimmten Selektor anzuhängen, ihn zu ersetzen oder anzuhängen.
triggerView()
Das Platform Web SDK Trigger für die Zwecke des SPA VEC automatisch eine Ansichtsänderung, wenn die Eigenschaft web.webPageDetails.viewName unter der Option xdm des Befehls sendEvent festgelegt ist.
trackEvent() und sendNotifications()
Verwenden Sie den Befehl sendEvent mit einem spezifischen eventType -Satz:

decisioning.propositionDisplay signalisiert die Wiedergabe einer Aktivität.

decisioning.propositionInteract signalisiert eine Benutzerinteraktion mit einer Aktivität, z. B. einen Mausklick.
targetGlobalSettings()
Keine direkte Entsprechung. Weitere Informationen finden Sie im Vergleich der Target-Einstellungen .
targetPageParams() und targetPageParamsAll()
Alle Daten, die in der Option xdm des Befehls sendEvent übergeben werden, werden Target-Mbox-Parametern zugeordnet. Da Mbox-Parameter mit serialisierter Punktnotation benannt werden, müssen Sie bei der Migration zum Platform Web SDK möglicherweise vorhandene Zielgruppen und Aktivitäten aktualisieren, um die neuen Mbox-Parameternamen zu verwenden.

Daten, die als Teil von data.__adobe.target des Befehls sendEvent übergeben werden, werden Target-Profil und Recommendations-spezifische Parameter zugeordnet.
Benutzerdefinierte at.js-Ereignisse
Nicht unterstützt. Informationen zum aktuellen Status finden Sie in der öffentlichen Roadmap . Antwort-Token werden als Teil des propositions in der Antwort des sendEvent -Aufrufs bereitgestellt.

at.js-Einstellungen und entsprechende Platform Web SDK-Elemente

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 des Platform Web SDK verglichen.

at.js-Einstellung
Platform Web SDK-Entsprechung
bodyHiddenStyle
Setzen Sie den prehidingStyle mit dem Befehl configure
bodyHidingEnabled
Wenn eine prehidingStyle mit dem Befehl configure definiert ist, ist diese Funktion aktiviert. Wenn kein Stil definiert ist, versucht das Platform Web SDK nicht, Inhalte auszublenden.
clientCode
Automatisch konfiguriert
cookieDomain
Nicht zutreffend
crossDomain
Setzen Sie die Option thirdPartyCookiesEnabled mit dem Befehl configure auf true , um Erstanbieter- und Drittanbieter-Cookies für domänenübergreifende Anwendungsfälle zu aktivieren.
cspScriptNonce und cspStyleNonce
Weitere Informationen finden Sie in der Dokumentation zum Konfigurieren eines CSP
dataProviders
Nicht unterstützt
decisioningMethod
Alle Befehle des Platform Web SDK sendEvent verwenden serverseitige Entscheidungsfindung. Hybride und geräteübergreifende Entscheidungen werden nicht unterstützt.
defaultContentHiddenStyle und defaultContentVisibleStyle
Gilt nur für at.js 1.x. Ähnlich wie bei at.js 2.x können Sie mit benutzerdefiniertem Code für formularbasierte Erlebnisse eine Flimmerverhinderung durchführen.
deviceIdLifetime
Nicht unterstützt. Wenn targetMigrationEnabled mit dem Befehl configure auf true gesetzt ist, wird das Cookie mbox gesetzt, wobei die Gerätelebensdauer auf 2 Jahre eingestellt ist. Dieser Wert kann nicht konfiguriert werden.
enabled
Die Target-Funktion ist mit der Datenstream-Konfiguration aktiviert oder deaktiviert
globalMboxAutoCreate
Setzen Sie die Option renderDecisions mit dem Befehl sendEvent auf true , um VEC-basierte Erlebnisse automatisch abzurufen und zu rendern.

Fordern Sie einen decisionScope für __view__ an, wenn Sie VEC-basierte Erlebnisse lieber manuell rendern möchten.
imsOrgId
Setzen Sie orgId mit dem Befehl configure
optinEnabled und optoutEnabled
Siehe Platform Web SDK Datenschutzoptionen. Die Option defaultConsent gilt für alle Adobe-Lösungen, die vom Platform Web SDK unterstützt werden.
overrideMboxEdgeServer und overrideMboxEdgeServerTimeout
Nicht zutreffend. Alle Platform Web SDK-Anforderungen verwenden das Adobe Experience Platform Edge-Netzwerk.
pageLoadEnabled
Setzen Sie die renderDecisions -Option mit dem Befehl sendEvent auf true
secureOnly
Nicht unterstützt. Das Platform Web SDK setzt alle Cookies mit den Attributen secure und sameSite="none".
selectorsPollingTimeout
Nicht unterstützt. Das Platform Web SDK verwendet einen Wert von 5 Sekunden. Benutzerdefinierter Code kann bei Bedarf zum manuellen Rendern von Inhalten verwendet werden.
serverDomain
Verwenden Sie die Einstellung edgeDomain mit dem Befehl configure .
telemetryEnabled
Nicht zutreffend
timeout
Nicht unterstützt. Es wird empfohlen, sicherzustellen, dass jeder Flackern-Minderungscode eine geeignete Zeitüberschreitung enthält.
viewsEnabled
Nicht unterstützt. Inhalte für Target-Ansichten werden immer beim ersten sendEvent() -Aufruf abgerufen, wenn renderDecisions auf true oder der __view__ decisionScope in der Anfrage enthalten ist.
visitorApiTimeout
Nicht zutreffend

Vergleich von Systemdiagrammen

Die folgenden Diagramme sollen Ihnen dabei helfen, die Unterschiede zwischen einem Datenfluss zwischen einer Target-Implementierung mit at.js und einer Implementierung mit dem Platform Web SDK zu verstehen.

at.js 2.x-Systemdiagramm

Verhalten von at.js 2.0 beim Laden der Seite {modal="regular"}

Aufruf
Details
1
Ein Aufruf gibt Experience Cloud ID (ECID) zurück. Wenn der Benutzer authentifiziert ist, wird bei einem weiteren Aufruf die Kunden-ID synchronisiert.
2
Die at.js-Bibliothek wird synchron geladen und blendet den Dokumenttext aus (at.js kann auch asynchron mit einem optionalen Pre-hiding-Snippet geladen werden, das auf der Seite implementiert ist).
3
Die Seitenladeanforderung umfasst alle konfigurierten Parameter, ECID, SDID und Kunden-ID.
4
Profilskripte werden ausgeführt und in den Profilspeicher eingespeist. Der Store ruft geeignete Zielgruppen aus der Zielgruppenbibliothek ab (z. B. über Analytics, Audience Manager usw. freigegebene Zielgruppen). Kundenattribute werden in einem Batch-Prozess an den Profilspeicher gesendet.
5
Basierend auf URL, Anforderungsparametern und Profildaten entscheidet Target, welche Aktivitäten und Erlebnisse für die aktuelle Seite und zukünftige Ansichten an den Besucher zurückgegeben werden sollen.
6
Zielgerichteter Inhalt, der zurück an die Seite gesendet wird, optional einschließlich Profilwerten für eine zusätzliche Personalisierung.

Zielgerichteter Inhalt auf der aktuellen Seite wird so schnell wie möglich bereitgestellt, ohne dass Standardinhalte flackern.

Zielgerichteter Inhalt für zukünftige Ansichten einer Einzelseitenanwendung wird im Browser zwischengespeichert, sodass er sofort ohne zusätzlichen Server-Aufruf angewendet werden kann, wenn die Ansichten ausgelöst werden.
7
Analytics-Daten, die von der Seite an die Datenerfassungsserver gesendet werden.
8
Target-Daten werden über die SDID mit Analytics-Daten abgeglichen und im Analytics-Berichtspeicher verarbeitet. Analytics-Daten können dann sowohl in Analytics als auch in Target über A4T-Berichte angezeigt werden.

Weitere Informationen zur Implementierung von Target mit at.js für Einzelseitenanwendungen finden Sie im Entwicklerhandbuch🔗.

Systemdiagramm für das Platform Web SDK

Diagramm der Adobe Target-Edge-Entscheidung mit dem Platform Web SDK

Aufruf
Details
1
Das Gerät lädt das Platform Web SDK. Das Platform Web SDK sendet eine Anfrage mit XDM-Daten, der ID der Datastreams-Umgebung, den übergebenen Parametern und der Kunden-ID (optional) an das Edge-Netzwerk. Seite (oder Container) ist vorab ausgeblendet.
2
Das Edge-Netzwerk sendet die Anfrage an die Edge-Dienste, um sie mit der Besucher-ID, der Zustimmung und anderen Besucherkontextinformationen wie Geolocation und gerätefreundlichen Namen anzureichern.
3
Das Edge-Netzwerk sendet die angereicherte Personalisierungsanforderung mit der Besucher-ID und den übergebenen Parametern an den Target-Edge.
4
Profilskripte werden ausgeführt und dann in den Target-Profilspeicher eingespeist. Der Profilspeicher ruft Segmente aus der Zielgruppenbibliothek ab (z. B. freigegebene Segmente aus Adobe Analytics, Adobe Audience Manager und Adobe Experience Platform).
5
Basierend auf URL-Anforderungsparametern und Profildaten bestimmt Target, welche Aktivitäten und Erlebnisse für den Besucher für die aktuelle Seitenansicht und für künftige vorab abgerufene Ansichten angezeigt werden sollen. Target sendet diese dann zurück an das Edge-Netzwerk.
6
a. Das Edge-Netzwerk sendet die Personalisierungsantwort zurück an die Seite, optional einschließlich der Profilwerte für eine zusätzliche Personalisierung. Personalisierte Inhalte auf der aktuellen Seite werden so schnell wie möglich bereitgestellt, ohne dass Standardinhalte aufflackern.

b. Personalisierte Inhalte für Ansichten, die als Ergebnis von Benutzeraktionen in einer Einzelseiten-App (SPA) angezeigt werden, werden für sofortiges Rendering ohne zusätzliche Server-Aufrufe zwischengespeichert.

c. Das Edge-Netzwerk sendet die Besucher-ID und andere Werte in Cookies (z. B. Zustimmung, Sitzungs-ID, Identität, Cookie-Überprüfung, Personalisierung usw.).
7
Das Edge-Netzwerk leitet Analytics for Target (A4T)-Details (Aktivitäts-, Erlebnis- und Konversionsmetadaten) an den Analytics-Edge weiter.

Weitere Informationen zur Implementierung von Target mit dem Platform Web SDK für Einzelseitenanwendungen finden Sie im Entwicklerhandbuch🔗 .

Nachdem Sie ein gutes technisches Verständnis Ihrer aktuellen Target-Implementierung und der von Ihnen verwendeten Funktionen haben, besteht der nächste Schritt darin, die Ersteinrichtung durchzuführen.

NOTE
Wir unterstützen Sie bei der erfolgreichen Target-Migration von at.js zum Web SDK. Wenn Sie bei Ihrer Migration auf Probleme stoßen oder der Eindruck haben, dass wichtige Informationen in diesem Handbuch fehlen, teilen Sie uns dies mit, indem Sie in dieser Community-Diskussion posten.
recommendation-more-help
a69e1b51-9545-4d8a-822d-319242c29110