Dokumentation Experience Platform Migrieren von Target aus at.js 2.x nach Web SDK

Vergleich von at.js mit Platform Web SDK

Last update: Tue Dec 31 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 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

Target at.js 2.x

Platform Web-SDK

Zielprofil aktualisieren

Unterstützt

Trigger-Ansicht für SPA

Unterstützt

Target Recommendations

Unterstützt

Formularbasierte Angebote abrufen

Unterstützt

Verfolgen von Ereignissen

Unterstützt

A4T: Einzelseitenanwendung

Unterstützt

A4T: Klick-Tracking

Unterstützt

A4T: Client-seitige Protokollierung

Unterstützt

A4T: Server-seitige Protokollierung

Unterstützt

Angebote anwenden

Unterstützt

Ansicht in SPA ohne Benachrichtigungen neu rendern

Unterstützt

Hybride Anwendungen

Unterstützt

QA-URLs

Unterstützt

Mbox-Drittanbieter-IDs

Unterstützt

Kundenattribute

Unterstützt

Remote-Angebote

Unterstützt

Umleitungsangebote

Unterstützt

Unterstützt. Eine Umleitung von einer Seite mit Platform Web SDK zu einer Seite mit at.js (und in umgekehrter Richtung) wird jedoch nicht unterstützt.

Geräteinterne Entscheidungsfindung

Unterstützt

Derzeit nicht unterstützt

Prefetch-Mboxes

Unterstützt für benutzerdefinierte Bereiche und SPA VEC

Der Vorabruf ist der Standardmodus für Web SDK

Benutzerspezifische Ereignisse

Unterstützt

Nicht unterstützt. Den aktuellen Status finden Sie " Roadmap“.

Antwort-Token

Unterstützt

Unterstützt. Code-Beispiele und zwischen at.js und Platform Web SDK finden Sie inDokumentation zu dedizierten Antwort-Token .

Datenanbieter

Unterstützt

Nicht unterstützt. Benutzerdefinierter Code kann zum Trigger eines Platform Web SDK-sendEvent-Befehls verwendet werden, nachdem Daten von einem anderen Anbieter abgerufen wurden.

Bemerkenswerte Hinweise

Target at.js 2.x

Platform Web-SDK

Flimmerschutz

Der Code-Ausschnitt zum Vorab-Ausblenden für asynchrone Implementierungen verwendet die Stil-ID at-body-style. at.js sucht nach dieser Element-ID, um den Stil zu entfernen, sobald eine Antwort eingeht.

Der standardmäßige Code-Ausschnitt zum Vorab-Ausblenden verwendet die Stil-ID 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.

Inhalt beim Laden der Seite automatisch rendern

Gesteuert mit einer globalen Zielgruppeneinstellung. Aktiviert, wenn pageLoadEnabled auf true gesetzt ist.

Wird im sendEvent-Befehl von Platform Web SDK angegeben. Aktiviert, indem die Option renderDecisions auf true gesetzt wird.

Manuelles Rendern von Inhalt

Die applyOffer()- und applyOffers() unterstützen nur das Einstellen von HTML

Der applyPropositions-Befehl unterstützt das Festlegen, Ersetzen oder Anhängen von HTML für mehr Flexibilität

Verfolgen benutzerdefinierter Ereignisse

Unterstützt mit trackEvent()- und sendNotifications(). Diese Funktionen sind Target-spezifisch 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 sendEvent-Befehl mit dem eventType-Wert decisioning.propositionDisplay oder decisioning.propositionInteract aufgenommen werden, um sicherzustellen, dass Adobe Analytics-Metriken nicht betroffen sind.

CNAME des Ziels

Unterstützt. Dies ist unabhängig vom CNAME, der für Analytics und den Experience Cloud-ID-Dienst verwendet wird.

Nicht mehr relevant. Für alle Aufrufe von Platform Web SDK kann ein einziger CNAME verwendet werden.

Debugging

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

Die URL-Parameter 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".

Analytics for Target (A4T)

Verwendet SDID-Werte zum Zusammenfügen von Target- und Analytics-Aufrufen

Nativ unterstützt, ohne dass Stitching erforderlich ist

NOTE

Das Migrieren von Target zu 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-Implementierung (und AppMeasurement.js) Seite für Seite auf Platform Web SDK zu migrieren. Wenn Sie diesen Ansatz verwenden, ist es am besten, die 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.

Funktion at.js 2.x

Platform Web SDK-Entsprechung

getOffer() und getOffers()

Um VEC-basierte Erlebnisse für anzufordern undautomatisch zu rendern), verwenden Sie den Befehl 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()

Verwenden Sie den Befehl applyPropositions zum Anwenden von Inhalten. Sie können festlegen, ersetzen oder HTML an einen bestimmten Selektor anhängen.

triggerView()

Platform Web SDK Trigger automatisch eine Ansichtsänderung für den SPA-VEC, wenn die web.webPageDetails.viewName-Eigenschaft unter der xdm-Option des sendEvent festgelegt ist.

trackEvent() und sendNotifications()

Verwenden Sie den sendEvent-Befehl mit einem spezifischen eventType:

decisioning.propositionDisplay signalisiert das Rendern einer Aktivität

decisioning.propositionInteract signalisiert eine Benutzerinteraktion mit einer Aktivität, wie z. B. einen Mausklick.

targetGlobalSettings()

Keine direkte Entsprechung. Weitere Informationen finden Sie „VergleichZielgruppeneinstellungen“.

targetPageParams() und targetPageParamsAll()

Alle in der Option 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).

Benutzerdefinierte at.js-Ereignisse

Nicht unterstützt. Den aktuellen Status finden Sie " Roadmap“. Antwort-Token werden als Teil der 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.

at.js-Einstellung

Platform Web SDK-Entsprechung

bodyHiddenStyle

Legen Sie die prehidingStyle mit dem Befehl configure fest

bodyHidingEnabled

Wenn ein prehidingStyle mit dem Befehl configure definiert wird, ist diese Funktion aktiviert. Wenn kein Stil definiert ist, versucht Platform Web SDK nicht, Inhalte auszublenden.

clientCode

Automatisch konfiguriert

cookieDomain

Nicht zutreffend

crossDomain

Legen Sie die Option thirdPartyCookiesEnabled auf true mit dem Befehl configure fest, um Erstanbieter- und Drittanbieter-Cookies für domänenübergreifende Anwendungsfälle zu aktivieren

cspScriptNonce und cspStyleNonce

Weitere Informationen finden Sie in der Dokumentation Konfigurieren eines CSP

dataProviders

Nicht unterstützt

decisioningMethod

Alle Platform Web SDK-sendEvent verwenden serverseitige Entscheidungsfindung. Hybride und geräteinterne Entscheidungsfindung werden nicht unterstützt.

defaultContentHiddenStyle und defaultContentVisibleStyle

Gilt nur für at.js 1.x. Ähnlich wie at.js 2.x kann jede Art von Flimmerschutz für formularbasierte Erlebnisse mit benutzerdefiniertem Code erreicht werden.

deviceIdLifetime

Nicht unterstützt. Wenn 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

Die Target-Funktion wird mit der Datenstromkonfiguration aktiviert oder deaktiviert

globalMboxAutoCreate

Legen Sie die 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

Legen Sie die orgId mit dem Befehl configure fest

optinEnabled und optoutEnabled

Siehe Platform Web SDK Datenschutzoptionen. Die defaultConsent Option gilt für alle Adobe-Lösungen, die von Platform Web SDK unterstützt werden.

overrideMboxEdgeServer und overrideMboxEdgeServerTimeout

Nicht zutreffend. Alle Platform Web SDK-Anfragen verwenden das Adobe Experience Platform Edge-Netzwerk.

pageLoadEnabled

Legen Sie mit dem Befehl sendEvent die renderDecisions Option auf true fest.

secureOnly

Nicht unterstützt. Platform Web SDK setzt alle Cookies mit den Attributen secure und sameSite="none".

selectorsPollingTimeout

Nicht unterstützt. Die 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 edgeDomain mit dem Befehl configure .

telemetryEnabled

Nicht zutreffend

timeout

Nicht unterstützt. Es wird empfohlen, sicherzustellen, dass jeder Flimmerminderungs-Code 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 festgelegt oder der Entscheidungsumfang der __view__ in der Anfrage enthalten ist.

visitorApiTimeout

Nicht zutreffend

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

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

Anruf

Details

Der Aufruf gibt die Experience Cloud-ID (ECID) zurück. Wenn der Benutzer authentifiziert ist, wird die Kunden-ID durch einen weiteren Aufruf synchronisiert.

Die at.js-Bibliothek wird synchron geladen und blendet den Hauptteil des Dokuments aus (at.js kann auch asynchron geladen werden, wobei ein optionales Snippet zum Vorab-Ausblenden auf der Seite implementiert wird).

Seitenladeanfrage erfolgt, einschließlich aller konfigurierten Parameter, ECID, SDID und Kunden-ID.

Profilskripte werden ausgeführt und in den Profilspeicher übertragen. Der Store fordert qualifizierte Zielgruppen aus der Zielgruppenbibliothek an (z. B. aus Analytics freigegebene Zielgruppen, aus Audience Manager usw.). Kundenattribute werden in einem Batch-Prozess an den Profilspeicher gesendet.

Basierend auf URL, Anfrageparametern 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.

Zielgerichteter Inhalt, der an die Seite zurückgesendet wird, optional einschließlich Profilwerten für eine zusätzliche Personalisierung.

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.

Analysedaten werden von der Seite an die Datenerfassungs-Server gesendet.

Zieldaten werden über die SDID mit Analytics-Daten abgeglichen und in den Analytics-Reporting-Speicher verarbeitet. Analytics-Daten können dann sowohl in Analytics als auch in Target über A4T-Berichte angezeigt werden.

Weitere Informationen zur Implementierung von Target (mithilfe .js für Einzelseitenanwendungen) finden Sie im.

Systemdiagramm für Platform Web SDK

Abbildung der Adobe Target-Edge-Entscheidungsfindung mit Platform Web SDK

Anruf

Details

Das Gerät lädt die Platform Web SDK. Platform Web SDK sendet eine Anfrage mit XDM-Daten, der Datenstrom-Umgebungs-ID, den weitergegebenen Parametern und der Kunden-ID an das Edge-Netzwerk (optional). Seite (oder Container) wird ausgeblendet.

Das Edge-Netzwerk sendet die Anfrage an die Edge-Services, um sie mit der Besucher-ID, dem Einverständnis und anderen Besucherkontextinformationen wie Geolokalisierung und gerätefreundlichen Namen anzureichern.

Das Edge-Netzwerk sendet die angereicherte Personalisierungsanfrage mit der Besucher-ID und den weitergegebenen Parametern an den Target-Edge.

Profilskripte werden ausgeführt und fließen dann in den Target-Profilspeicher ein. Der Profilspeicher ruft Segmente aus der Zielgruppenbibliothek ab (z. B. freigegebene Segmente aus Adobe Analytics, Adobe Audience Manager oder Adobe Experience Platform).

Basierend auf URL-Anfrageparametern und Profildaten bestimmt Target, welche Aktivitäten und Erlebnisse für den Besucher in der aktuellen Seitenansicht und für zukünftige vorab abgerufene Ansichten angezeigt werden sollen. Target sendet diese dann zurück an das Edge-Netzwerk.

a. Das Edge Network sendet die Personalisierungsantwort zurück an die Seite, wobei optional Profilwerte für die zusätzliche Personalisierung enthalten sind. Personalisierte Inhalte auf der aktuellen Seite werden so schnell wie möglich ohne Flackern der Standardinhalte angezeigt.

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

Das Edge Network leitet Analytics for Target(A4T)-Details (Aktivitäts-, Erlebnis- und Konversionsmetadaten) an den Analytics-Edge weiter.

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

NOTE

Wir möchten Sie bei der erfolgreichen Migration von at.js zu Web SDK unterstützen. Wenn Sie auf Hindernisse bei Ihrer Migration stoßen oder das Gefühl haben, dass wichtige Informationen in diesem Handbuch fehlen, lassen Sie es uns bitte wissen, indem Sie in diese Community-Diskussion posten.

recommendation-more-help

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