at.js と Platform Web SDK の比較
スタンドアロンのAdobe Target at.js ライブラリは、Platform Web SDK とは大きく異なります。 次の表は、移行プロセスの間に注意が必要になる実装領域を評価する際に役立つリファレンスです。
以下の情報を確認し、現在の at.js の技術的実装を評価すると、次のことを理解できるようになります。
- Platform Web SDK でサポートされている Target 機能
- Platform Web SDK と同等の機能を持つ at.js 関数
- Platform Web SDK での Target 設定の適用方法
- at.js と Platform Web SDK のデータフローの違い
Platform Web SDK を初めて使用する場合は、心配はいりません。以下の項目については、このチュートリアル全体でより詳しく説明します。
機能の比較
sendEvent
コマンドをトリガーできます。注目のコールアウト
at-body-style
のスタイル ID を使用します。 at.js は、応答を受信したらスタイルを削除するためにこの要素 ID を探します。alloy-prehiding
のスタイル ID を使用します。 Web SDK は at.js 事前非表示スニペットと互換性がないので、移行プロセスの一環として変更する必要があります。pageLoadEnabled
が true
に設定されている場合に有効になります。sendEvent
コマンドで指定されます。 有効にするには、renderDecisions
オプションを true
に設定します。applyOffer()
関数と applyOffers()
関数は、設定HTMLのみをサポートしていますapplyPropositions
コマンドでは、HTMLの設定、置換、追加をサポートしているので、柔軟性が向上していますtrackEvent()
関数と sendNotifications()
関数でサポートされます。 これらの関数は、Target に固有で、Adobe Analyticsの指標には影響しません。sendEvent
呼び出しからのすべてのデータは、Target に転送されます。 Adobe Analytics指標が影響を受けないように、Target に特別に必要な追加データを、eventType を decisioning.propositionDisplay
または decisioning.propositionInteract
に指定して sendEvent
コマンドに含める必要があります。mboxDisable
、mboxDebug
、mboxTrace
の URL パラメーターは、ブラウザーの開発者ツールでのデバッグに使用できます。Adobe Experience Platform Debuggerはサポートされているデバッグツールでもあります。
mboxDisable
、mboxDebug
、mboxTrace
の URL パラメーターはサポートされていません。Web SDK のデバッグを有効にするには、クエリ文字列に
alloy_debug=true
を追加するか、開発者コンソールで alloy("setDebug", { "enabled": true });
を実行します。Adobe Experience Platform Debuggerブラウザー拡張機能を使用して、デバッグ用のエッジトレースを開始できます。
詳しくは、Platform Web SDK のデバッグドキュメントを参照してください。
configure
のコマンドで、idMigrationEnabled
および targetMigrationEnabled
オプションを true
に設定することをお勧めします。at.js 関数と Platform Web SDK の同等機能
多くの at.js 関数は、次の表に示す Platform Web SDK を使用した同等のアプローチを備えています。 at.js 関数について詳しくは、Adobe Target開発者ガイドを参照してください。
getOffer()
および getOffers()
sendEvent
コマンドを使用して、renderDecisions
オプションを true に設定します。フォームベースのエクスペリエンスをリクエストしたり、コンテンツを 手動でレンダリングしたりするには、
sendEvent
コマンドで decisionScopes
(mbox)の配列を指定します。applyOffer()
および applyOffers()
applyPropositions
コマンドを使用してコンテンツを適用します。 特定のセレクターに対して、HTMLの設定、置換、追加を行うことができます。triggerView()
sendEvent
コマンドの xdm
オプションで web.webPageDetails.viewName
プロパティがトリガーされている場合、Platform Web SDK はSPA VEC 用に ビューの変更を自動的に設定します。trackEvent()
および sendNotifications()
sendEvent
コマンドを 特定の eventType
set:decisioning.propositionDisplay
と共に使用すると、アクティビティのレンダリングを示しdecisioning.propositionInteract
マウスクリックなどのアクティビティに対するユーザー操作を示します。targetGlobalSettings()
targetPageParams()
および targetPageParamsAll()
sendEvent
コマンドの xdm
オプションで渡されたすべてのデータは、Target mbox パラメーターにマッピングされます。 mbox パラメーターにはシリアル化されたドット表記を使用して名前を付けるので、Platform Web SDK に移行する場合は、新しい mbox パラメーター名を使用するように既存のオーディエンスとアクティビティを更新する必要が生じる場合があります。sendEvent
コマンドの data.__adobe.target
の一部として渡されたデータは、Target プロファイルおよびRecommendations固有のパラメーターにマッピングされます。sendEvent
呼び出しの応答で propositions
の一部として公開されます。at.js の設定および Platform Web SDK の同等の機能
at.js ライブラリは、Target UI の様々な設定を使用して設定およびダウンロードできます。 これらの設定は、targetGlobalSettings()
関数で更新することもできます。 以下の表は、これらの設定と Platform Web SDK で使用できる設定を比較しています。
bodyHiddenStyle
configure
コマンドで prehidingStyle
を設定しますbodyHidingEnabled
configure
コマンドで prehidingStyle
が定義されている場合、この機能は有効になります。 スタイルが定義されていない場合、Platform Web SDK はコンテンツの非表示を試みません。clientCode
cookieDomain
crossDomain
thirdPartyCookiesEnabled
オプションを true
に設定し、configure
コマンドを使用して、クロスドメインの使用例に対してファーストパーティおよびサードパーティ Cookie を有効にしますcspScriptNonce
および cspStyleNonce
dataProviders
decisioningMethod
sendEvent
コマンドは、サーバーサイド判定を使用します。 ハイブリッド判定とオンデバイス判定はサポートされていません。defaultContentHiddenStyle
および defaultContentVisibleStyle
deviceIdLifetime
targetMigrationEnabled
が configure
コマンドで true
に設定されている場合、mbox
Cookie はデバイスの有効期間が 2 年に設定されます。 この値は変更できません。enabled
globalMboxAutoCreate
renderDecisions
オプションを sendEvent
コマンドで true
に設定して、VEC ベースのエクスペリエンスを自動的に取得し、レンダリングします。VEC ベースのエクスペリエンスを手動でレンダリングする場合は、
__view__
の decisionScope
をリクエストします。imsOrgId
configure
コマンドで orgId
を設定しますoptinEnabled
および optoutEnabled
defaultConsent
オプションは、Platform Web SDK がサポートするすべてのAdobeソリューションに適用されます。overrideMboxEdgeServer
および overrideMboxEdgeServerTimeout
pageLoadEnabled
sendEvent
コマンドを使用して、renderDecisions
オプションを true
に設定しますsecureOnly
secure
属性と sameSite="none"
属性を持つすべての cookie を設定します。selectorsPollingTimeout
serverDomain
configure
コマンドで edgeDomain
設定を使用しますtelemetryEnabled
timeout
viewsEnabled
renderDecisions
が true
に設定されている場合、または __view__
decisionScope がリクエストに含まれている場合、常に最初の sendEvent()
呼び出し時に取得されます。visitorApiTimeout
システム図の比較
次の図は、at.js を使用した Target 実装と、Platform Web SDK を使用した実装のデータフローの違いを理解するのに役立ちます。
at.js 2.x のシステム図
現在のページ上のターゲットコンテンツは、デフォルトコンテンツのちらつきなしでできるだけ早く表示されます。
単一ページアプリケーションの将来のビューのターゲットコンテンツは、ブラウザーにキャッシュされるので、ビューがトリガーされたときに追加のサーバー呼び出しをおこなわずに即座にターゲットコンテンツを適用できます。
詳しくは、開発者ガイドを参照してください 単一ページアプリケーション用に at.js を使用して Target を実装する。
Platform Web SDK のシステム図
b.シングルページアプリケーション(SPA)でユーザーアクションの結果として表示されるビューのパーソナライズされたコンテンツは、追加のサーバーコールなしでインスタントレンダリング用にキャッシュされます。
c.Edge Network は、訪問者 ID と cookie のその他の値(同意、セッション ID、ID、Cookie チェック、パーソナライゼーションなど)を送信します。
詳しくは、開発者ガイドを参照してください 単一ページアプリケーション用 Platform Web SDK を使用した Target の実装。
現在の Target 実装と使用する機能について技術的に理解したら、次の手順は 初期設定を実行します。