ドキュメント Experience Platform Target を at.js 2.x から Web SDK に移行する

at.js と Platform Web SDKの比較

Last update: Tue Sep 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

中級
経験者
開発者

スタンドアロンの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を初めて使用する場合は、心配はいりません。以下の項目については、このチュートリアル全体で詳しく説明します。

機能の比較

Target at.js 2.x

Platform Web SDK

ターゲットプロファイルを更新

サポートあり

SPA のトリガービュー

サポートあり

Target Recommendations

サポートあり

フォームベースのオファーの取得

サポートあり

トラックイベント

サポートあり

A4T：単一ページアプリケーション

サポートあり

A4T：クリックの追跡

サポートあり

A4T：クライアントサイドログ

サポートあり

A4T：サーバーサイドログ

サポートあり

オファーの適用

サポートあり

通知を使用せずに SPA でビューを再レンダリング

サポートあり

ハイブリッドアプリケーション

サポートあり

QA の URL

サポートあり

Mbox サードパーティ ID

サポートあり

顧客属性

サポートあり

リモートオファー

サポートあり

部分的にサポートされています。動的なリモートオファーはサポートされていません。

リダイレクトオファー

サポートあり

サポート。ただし、Platform Web SDKを含むページから at.js を含むページ（およびその逆方向）へのリダイレクトはサポートされていません。

オンデバイス判定

サポートあり

現在サポートされていません

Mbox をプリフェッチ

カスタムスコープおよび SPA VEC でサポート

Web SDKのデフォルトのモードはプリフェッチです

カスタムイベント

サポートあり

サポート対象外現在のステータスについては、パブリックロードマップを参照してください。

レスポンストークン

サポートあり

サポート。コード例と at.js と Platform Web SDKの違いについては、専用の応答トークンのドキュメントを参照してください

データプロバイダー

サポートあり

サポート対象外カスタムコードを使用すると、別のプロバイダーからデータを取得した後に、Platform Web SDK sendEvent コマンドをトリガーできます。

注目のコールアウト

Target at.js 2.x

Platform Web SDK

ちらつき軽減

非同期実装の事前非表示スニペットでは、at-body-style のスタイル ID を使用します。 at.js は、応答を受信したらスタイルを削除するためにこの要素 ID を探します。

デフォルトの事前非表示スニペットでは、alloy-prehiding のスタイル ID を使用します。 Web SDKは at.js 事前非表示スニペットと互換性がないので、移行プロセスの一環として変更する必要があります。

ページ読み込み時にコンテンツを自動的にレンダリング

Target グローバル設定で制御します。 pageLoadEnabled が true に設定されている場合に有効になります。

Platform Web SDK sendEvent コマンドで指定されます。有効にするには、renderDecisions オプションを true に設定します。

コンテンツの手動レンダリング

applyOffer() 関数と applyOffers() 関数は、HTMLの設定のみをサポートしています

applyPropositions コマンドでは、HTMLの設定、置き換え、追加をサポートしており、より柔軟に設定できます

カスタムイベントの追跡

trackEvent() 関数と sendNotifications() 関数でサポートされます。これらの関数は、Target に固有で、Adobe Analyticsの指標には影響しません。

Platform Web SDK sendEvent 呼び出しからのすべてのデータは、Target に転送されます。 Adobe Analytics指標が影響を受けないように、Target に特別に必要な追加データを、eventType を sendEvent または decisioning.propositionDisplay に指定して decisioning.propositionInteract コマンドに含める必要があります。

ターゲット CNAME

サポート。これは、Analytics で使用される CNAME やExperience Cloud ID サービスとは別のものです。

関係がなくなりました。 1 つの CNAME をすべての Platform web SDK呼び出しに使用できます。

デバッグ

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のデバッグドキュメントを参照してください。

Analytics for Target（A4T）

SDID 値を使用して、Target と Analytics の呼び出しをステッチします

ステッチを必要とせずにネイティブにサポートされる

NOTE

特定のページに既存の Platform Web SDK実装を保持したままAppMeasurementをAdobe Analyticsに移行することは、サポートされていません。

at.js （およびAppMeasurement.js）実装を 1 ページずつ Platform Web SDKに移行することが可能です。この方法を使用する場合は、idMigrationEnabled のコマンドで、 targetMigrationEnabled およびtrue オプションを configure に設定することをお勧めします。

at.js 関数と Platform Web SDKの同等機能

多くの at.js 関数は、次の表に示す Platform Web SDKを使用した同等のアプローチを持っています。 at.js 関数について詳しくは、Adobe Target開発者ガイドを参照してください。

at.js 2.x 関数

Platform Web SDKの同等の機能

getOffer() および getOffers()

Target VEC ベースのエクスペリエンスをリクエストし自動的にレンダリングするには、sendEvent コマンドを使用して、renderDecisions オプションを true に設定します。

フォームベースのエクスペリエンスをリクエストしたり、コンテンツを手動でレンダリングしたりするには、decisionScopes コマンドで sendEvent （mbox）の配列を指定します。

applyOffer() および applyOffers()

applyPropositions コマンドを使用してコンテンツを適用します。特定のセレクターに対して、HTMLの設定、置換、追加を選択できます。

triggerView()

コマンドのオプションで web.webPageDetails.viewName プロパティが設定されている場合、Platform Web SDKは SPA VEC 用に xdm ビューの変更 sendEvent を自動的にトリガーします。

trackEvent() および sendNotifications()

sendEvent コマンドを特定の eventType set:

decisioning.propositionDisplay と共に使用すると、アクティビティのレンダリングを示し

decisioning.propositionInteract マウスクリックなどのアクティビティに対するユーザー操作を示します。

targetGlobalSettings()

直接同等の手段はありません。詳しくは、ターゲット設定の比較を参照してください。

targetPageParams() および targetPageParamsAll()

xdm コマンドの sendEvent オプションで渡されたすべてのデータは、Target mbox パラメーターにマッピングされます。 mbox パラメーターにはシリアル化されたドット表記を使用して名前を付けるので、Platform Web SDKへの移行では、新しい mbox パラメーター名を使用するように既存のオーディエンスとアクティビティを更新する必要が生じる場合があります。

data.__adobe.target コマンドの sendEvent の一部として渡されたデータは、Target プロファイルおよび Recommendations 固有のパラメーターにマッピングされます。

at.js カスタムイベント

サポート対象外現在のステータスについては、パブリックロードマップを参照してください。レスポンストークンは、propositions 呼び出しの応答で sendEvent の一部として公開されます。

at.js の設定および Platform Web SDKの同等の機能

at.js ライブラリは、Target UI の様々な設定を使用して設定およびダウンロードできます。これらの設定は、targetGlobalSettings() 関数で更新することもできます。次の表は、これらの設定を Platform Web SDKで使用できる設定と比較しています。

at.js の設定

Platform Web SDKの同等の機能

bodyHiddenStyle

prehidingStyle コマンドでconfigure を設定します

bodyHidingEnabled

prehidingStyle コマンドで configure が定義されている場合、この機能は有効になります。スタイルが定義されていない場合、Platform Web SDKはコンテンツの非表示を試みません。

clientCode

自動的に構成

cookieDomain

該当なし

crossDomain

thirdPartyCookiesEnabled オプションを true に設定し、configure コマンドを使用して、クロスドメインの使用例に対してファーストパーティおよびサードパーティ Cookie を有効にします

cspScriptNonce および cspStyleNonce

CSP の設定については、ドキュメントを参照してください。

dataProviders

サポートなし

decisioningMethod

すべての Platform Web SDK sendEvent コマンドは、サーバーサイド判定を使用します。ハイブリッド判定とオンデバイス判定はサポートされていません。

defaultContentHiddenStyle および defaultContentVisibleStyle

at.js 1.x でのみ使用可能です。at.js 2.x と同様に、フォームベースのエクスペリエンスのフリッカーの軽減は、カスタムコードを使用して実現できます。

deviceIdLifetime

サポート対象外 targetMigrationEnabled が true コマンドで configure に設定されている場合、mbox Cookie はデバイスの有効期間が 2 年に設定されます。この値は変更できません。

enabled

データストリーム設定で Target 機能を有効または無効にする

globalMboxAutoCreate

renderDecisions オプションを true コマンドで sendEvent に設定して、VEC ベースのエクスペリエンスを自動的に取得し、レンダリングします。

VEC ベースのエクスペリエンスを手動でレンダリングする場合は、decisionScope の __view__ をリクエストします。

imsOrgId

orgId コマンドで configure を設定します

optinEnabled および optoutEnabled

Platform Web SDK プライバシーオプションを参照してください。「defaultConsent」オプションは、Platform Web SDKがサポートするすべてのAdobe ソリューションに適用されます。

overrideMboxEdgeServer および overrideMboxEdgeServerTimeout

適用できません。すべての Platform web SDK リクエストは、Adobe Experience Platform Edge ネットワークを使用します。

pageLoadEnabled

renderDecisions コマンドを使用して、true オプションを sendEvent に設定します

secureOnly

サポート対象外 Platform Web SDKは、secure 属性と sameSite="none" 属性を持つすべての cookie を設定します。

selectorsPollingTimeout

サポート対象外 Platform Web SDKは 5 秒の値を使用します。必要に応じて、カスタムコードを使用してコンテンツを手動でレンダリングできます。

serverDomain

edgeDomain コマンドで configure 設定を使用します

telemetryEnabled

該当なし

timeout

サポート対象外ちらつき軽減コードに適切なタイムアウトが含まれていることを確認することをお勧めします。

viewsEnabled

サポート対象外 Target ビューのコンテンツは、sendEvent() が renderDecisions に設定されている場合、または true decisionScope がリクエストに含まれている場合、常に最初の __view__ 呼び出し時に取得されます。

visitorApiTimeout

該当なし

システム図の比較

次の図は、at.js を使用した Target 実装と、Platform Web SDKを使用した実装のデータフローの違いを理解するのに役立ちます。

at.js 2.x のシステム図

ページ読み込み時の at.js 2.0 の動作 {modal="regular"}

通話

詳細

呼び出しによってExperience Cloud ID （ECID）が返されます。ユーザーが認証されると、別の呼び出しでその顧客 ID が同期されます。

at.js ライブラリは同期して読み込まれ、ドキュメントの本文を非表示にします（ページに実装されたオプションの事前非表示スニペットを使用して、at.js を非同期で読み込むこともできます）。

すべての設定済みパラメーター、ECID、SDID および顧客 ID を含むページ読み込みリクエストが行われます。

プロファイルスクリプトは、を実行してプロファイルストアに入力します。ストアは、オーディエンスライブラリから選定オーディエンス（Analytics、Audience Managerなどから共有されたオーディエンスなど）をリクエストします。顧客属性は、バッチプロセスでプロファイルストアに送信されます。

URL、リクエストパラメーター、プロファイルデータに基づいて、Target は、現在のページと今後の表示で訪問者に返すアクティビティとエクスペリエンスを決定します。

ターゲットコンテンツがページに送り返されます（オプションで、パーソナライゼーションを追加するためのプロファイル値も含む）。

現在のページ上のターゲットコンテンツは、デフォルトコンテンツのちらつきなしでできるだけ早く表示されます。

単一ページアプリケーションの将来のビューのターゲットコンテンツは、ブラウザーにキャッシュされるので、ビューがトリガーされたときに追加のサーバー呼び出しをおこなわずに即座にターゲットコンテンツを適用できます。

ページからデータ収集サーバーに送信された Analytics データ。

ターゲットデータは、SDID を介して Analytics データと照合され、Analytics レポートストレージ内で処理されます。 A4T レポートを使用して、Analytics データが Analytics と Target の両方に表示できるようになります。

詳しくは、開発者ガイドを参照してください単一ページアプリケーション用に at.js を使用して Target を実装する。

Platform Web SDKのシステム図

Platform Web SDKを使用したAdobe Target Edge Decisioning の図

通話

詳細

デバイスが Platform Web SDKを読み込みます。 Platform Web SDKは、XDM データ、データストリーム環境 ID、渡されたパラメーター、顧客 ID （オプション）を使用して、Edge Network にリクエストを送信します。ページ（またはコンテナ）は事前非表示になっています。

Edge network は、訪問者 ID、同意、その他の訪問者コンテキスト情報（位置情報やデバイスにわかりやすい名前など）を使用して、リクエストを強化するために edge サービスにリクエストを送信します。

エッジネットワークは、訪問者 ID と渡されたパラメーターを使用して、エンリッチメントされたパーソナライゼーションリクエストを Target エッジに送信します。

プロファイルスクリプトは、を実行して、Target プロファイルストレージにフィードします。プロファイルストレージは、オーディエンスライブラリからセグメントを取得します（例えば、Adobe Analytics、Adobe Audience Manager、Adobe Experience Platformで共有されているセグメント）。

Target は、URL リクエストパラメーターとプロファイルデータに基づいて、現在のページビューと将来の事前読み込みビューで、訪問者に表示するアクティビティとエクスペリエンスを決定します。次に、Target はこれをエッジネットワークに送り返します。

回答：Edge Network は、パーソナライゼーション応答をページに送り返します（オプションで、追加のパーソナライゼーションのプロファイル値も含みます）。現在のページ上のパーソナライズされたコンテンツは、デフォルトコンテンツのちらつきなしでできるだけ早く表示されます。

b.単一ページアプリケーション（SPA）でのユーザーアクションの結果として表示されるビューのパーソナライズされたコンテンツは、追加のサーバー呼び出しなしにインスタントレンダリング用にキャッシュされます。

c.Edge Network は、訪問者 ID と cookie のその他の値（同意、セッション ID、ID、Cookie チェック、パーソナライゼーションなど）を送信します。

エッジネットワークは、Analytics for Target （A4T）の詳細（アクティビティ、エクスペリエンスおよびコンバージョンメタデータ）を Analytics エッジに転送します。

詳しくは、シングルページアプリケーション用の Platform Web SDKを使用した Target の実装の方法に関する開発者ガイドを参照してください。

現在の Target 実装と使用する機能について技術的に理解したら、次の手順は初期設定を実行します。

NOTE

アドビは、at.js から web SDKへの Target の移行を成功させるために取り組んでいます。移行の際に問題が発生した場合、またはこのガイドに重要な情報が欠落していると感じる場合は、このコミュニティのディスカッションに投稿してお知らせください。

recommendation-more-help

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