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

at.jsとPlatform Web SDKの比較

最終更新日： 2026年10月17日

作成対象：

Intermediate
Experienced
Developer

スタンドアロンのAdobe Target at.js ライブラリは、Platform Web SDKとは大きく異なります。次の表は、移行プロセスで重視する必要がある実装の領域を評価するのに役立つ参考資料です。

以下の情報を確認し、現在のテクニカル at.jsの実装を評価した後は、次の点を理解できる必要があります。

Platform Web SDKでサポートされているTargetの機能
どのat.js関数がPlatform Web SDKに相当するか
Platform Web SDKでのTarget設定の適用方法
at.jsとPlatform Web SDKのデータフローの違い

Platform Web SDKを初めて使用する場合でも、心配はいりません。以下の項目については、このチュートリアル全体を通じて詳しく説明します。

機能比較

Target at.js 2.x

Platform Web SDK

Target プロファイルを更新

サポートあり

SPAのトリガービュー

サポートあり

ターゲットレコメンデーション

サポートあり

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

サポートあり

トラックイベント

サポートあり

A4T：シングルページアプリケーション

サポートあり

A4T: クリックの追跡

サポートあり

A4T: クライアント側のログ

サポートあり

A4T: サーバーサイドのログ

サポートあり

オファーの適用

サポートあり

通知なしでSPAでビューを再レンダリング

サポートあり

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

サポートあり

QA URL

サポートあり

Mbox 3rd パーティ 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

フリッカーの軽減

非同期実装の事前非表示スニペットでは、スタイル ID at-body-styleが使用されます。 at.jsは、応答を受け取ると、この要素IDを検索してスタイルを削除します。

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

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

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

Platform Web SDK sendEvent コマンドで指定します。 renderDecisions オプションをtrueに設定することで有効になります。

コンテンツを手動でレンダリングする

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

applyPropositions コマンドは、HTMLの設定、置換、追加をサポートしています。柔軟性を高めます

カスタムイベントのトラッキング

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

Platform Web SDK sendEvent呼び出しのすべてのデータは、Targetに転送されます。 Targetに特に必要な補足データは、Adobe Analytics メトリクスに影響を与えないように、sendEvent コマンドにdecisioning.propositionDisplayまたはdecisioning.propositionInteractのeventTypeを含める必要があります。

Target CNAME

サポートされています。これは、AnalyticsおよびExperience Cloud ID サービスに使用されるCNAMEとは別です。

もう関連性がありません。すべてのPlatform Web SDKの呼び出しには、1つのCNAMEを使用できます。

デバッグ

mboxDisable、mboxDebugおよびmboxTraceのURL パラメーターは、ブラウザーの開発者ツールでのデバッグに使用できます。

Adobe Experience Platform Debuggerは、サポートされているデバッグツールでもあります。

mboxDisable、mboxDebugおよびmboxTraceのURL パラメーターはサポートされていません。

クエリ文字列にalloy_debug=trueを追加するか、開発者コンソールでalloy("setDebug", { "enabled": true });を実行することで、Web SDKのデバッグを有効にできます。

Adobe Experience Platform Debugger ブラウザー拡張機能を使用して、デバッグ用のエッジトレースを開始できます。

詳しくは、「Platform Web SDKのデバッグ」のドキュメントを参照してください。

Analytics for Target（A4T）

SDID値を使用してTargetとAnalyticsの呼び出しを合成します

データを結合することなくネイティブにサポート

NOTE

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

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

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

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

at.js 2.x関数

Adobe Experience Platform Web SDK版

getOffer() および getOffers()

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

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

applyOffer() および applyOffers()

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

triggerView()

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

trackEvent() および sendNotifications()

sendEvent コマンドを固有のeventType セットで使用すると、

decisioning.propositionDisplayはアクティビティのレンダリングを示し、

decisioning.propositionInteractはマウスクリックなどのアクティビティを伴うユーザーインタラクションを示します。

targetGlobalSettings()

直接同等のものはありません。詳細については、Target設定の比較を参照してください。

targetPageParams() および targetPageParamsAll()

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

データは、ターゲットプロファイルおよびRecommendations固有のパラメーターにマッピングされます。

at.js カスタムイベント

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

at.js設定とPlatform Web SDKに相当するもの

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

at.js設定

Adobe Experience Platform Web SDK版

bodyHiddenStyle

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

bodyHidingEnabled

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

clientCode

自動設定

cookieDomain

該当なし

crossDomain

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

cspScriptNonce および cspStyleNonce

CSPの設定のドキュメントを参照してください

dataProviders

サポートなし

decisioningMethod

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

defaultContentHiddenStyle および defaultContentVisibleStyle

at.js 1.xでのみ適用できます。 at.js 2.xと同様に、フォームベースのエクスペリエンスのちらつきを軽減するには、カスタムコードを使用します。

deviceIdLifetime

サポートされていません。 targetMigrationEnabledがconfigure コマンドでtrueに設定されている場合、mbox Cookieは、デバイスの有効期間が2年に設定された状態で設定されます。この値は設定可能ではありません。

enabled

ターゲット機能は、データストリーム設定で有効または無効になります

globalMboxAutoCreate

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

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

imsOrgId

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

optinEnabled および optoutEnabled

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

overrideMboxEdgeServer および overrideMboxEdgeServerTimeout

影響しない。すべてのPlatform Web SDK リクエストは、Adobe Experience Platform Edge ネットワークを使用します。

pageLoadEnabled

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

secureOnly

サポートされていません。 Platform Web SDKは、secureおよびsameSite="none"属性を持つすべてのCookieを設定します。

selectorsPollingTimeout

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

serverDomain

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

telemetryEnabled

該当なし

timeout

サポートされていません。フリッカー軽減コードに適切なタイムアウトが含まれていることを確認することをお勧めします。

viewsEnabled

サポートされていません。 renderDecisionsがtrueに設定されているか、__view__decisionScopeがリクエストに含まれている場合、Target ビューのコンテンツは常に最初のsendEvent()呼び出しで取得されます。

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 データは、SDID を使用して Analytics データに適合され、Analytics レポートストレージへと処理されます。 A4T レポートを使用して、Analytics データが Analytics for Target の両方に表示できるようになります。

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

Platform web SDK のシステム図

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

呼び出し

詳細

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

エッジネットワークは、エッジサービスにリクエストを送信し、訪問者ID、同意、および位置情報やデバイスに適した名前などのその他の訪問者コンテキスト情報でリクエストを強化します。

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

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

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

a. エッジネットワークは、パーソナライゼーション応答をページに送信し、オプションで追加のパーソナライゼーションのプロファイル値を含めます。現在のページ上のパーソナライズされたコンテンツは、デフォルトのコンテンツのちらつきを使用せずに、できるだけ早く表示されます。

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

c. エッジネットワークは、訪問者IDおよびその他の値をCookieに送信します（同意、セッション ID、ID、Cookie チェック、パーソナライゼーションなど）。

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

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

現在のTarget実装と使用する機能について技術的に十分に理解した後、次のステップは初期設定を実行することです。

NOTE

at.jsからWeb SDKへのTargetの移行を成功させるためのサポートを提供します。移行で障害が発生した場合、またはこのガイドに重要な情報が欠けていると感じた場合は、このコミュニティのディスカッションに投稿してお知らせください。

recommendation-more-help

platform-learn-help-tutorial-migrate-target-websdk