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

Platform Web SDKでのTargetのデバッグ

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

作成対象：

  • Intermediate
  • Experienced
  • Developer

Target アクティビティを検証し、Web SDKをデバッグして、実装、コンテンツ配信、またはオーディエンス選定の問題をトラブルシューティングします。 移行ガイドのこのページでは、at.jsとPlatform Web SDKを使用したデバッグの違いについて説明します。

次の表は、テストおよびデバッグ方法の機能とサポートをまとめたものです。

機能またはツール
at.js サポート
Platform Web SDKのサポート
アクティビティ QA URL
○
○
mboxDisable URL パラメーター
○
以下の情報を参照して、Target機能を無効にする
mboxDebug URL パラメーター
○
同様のデバッグ情報にはalloy_debug パラメーターを使用します
mboxTrace URL パラメーター
○
Experience Platform Debugger ブラウザー拡張機能の使用
Adobe Experience Platform Debugger拡張機能
○
○
alloy_debug URL パラメーター
該当なし
○
Adobe Experience Platform Assurance
該当なし
○

Adobe Experience Platform Debugger拡張機能

ChromeおよびFirefox用のAdobe Experience Platform Debugger拡張機能は、web ページを調べ、Adobe Experience Cloud実装の検証に役立ちます。

任意のweb ページでPlatform Debuggerを実行でき、拡張機能は公開データにアクセスできます。 Targetのトレース情報などの拡張機能を使用して非公開データにアクセスするには、サインイン リンクを介してExperience Cloudに認証する必要があります。

Adobe Experience Platform Debuggerの入手とインストール

Adobe Experience Platform Debuggerは、Google Chromeにインストールできます。 以下の適切なリンクに従って、拡張機能をインストールします。

Chrome拡張機能またはFirefox アドオンをインストールすると、拡張機能バーにアイコン （ ）が追加されます。 このアイコンを選択して、拡張機能を開きます。

Adobe拡張機能の詳細と、すべてのAdobe Experience Platform Debugger web アプリケーションのデバッグ方法については、専用ガイドを参照してください。

QA URLを使用したTarget アクティビティのプレビュー

at.jsとPlatform Web SDKの両方で、Target QA URLを使用してTarget アクティビティをプレビューでき、両方の実装方法で同じQA機能をサポートしています。

at.jsまたはPlatform Web SDKに対して、at_qa_modeという名前のブラウザーに特定のCookieを書き込むように指示することで、QA URLをターゲットにします。 このCookieは、特定のアクティビティおよびエクスペリエンスに対する強制的な選定に使用されます。

CAUTION
Target QA モード機能は、Platform Web SDK バージョン 2.13.0以降でサポートされています。 ターゲット QA モードは、sendEvent呼び出しで渡されたxdm.web.webPageDetails.URL値に基づいて有効になります。 すべての文字を小文字にするなど、この値を変更すると、Target QA モードが正しく機能しなくなる場合があります。

Target アクティビティ QAの詳細については、専用ガイドを参照してください。

Target実装のデバッグ

次の表は、at.jsとPlatform Web SDKのデバッグ戦術の違いを示しています。

at.js機能
Adobe Experience Platform Web SDK版
Mbox Disable - Targetの取得とレンダリングを無効にして、Target インタラクションなしでページが壊れているかどうかを確認します

URL パラメーターがmboxDisable=trueのページを読み込みます
直接同等のものはありません。 ブラウザーのデベロッパーツールを使用して、すべてのPlatform Web SDK リクエストをブロックできます。
Mbox デバッグ - レンダリングの問題のトラブルシューティングに役立つブラウザーのコンソールにat.js アクションをすべて記録します

URL パラメーターを使用してページを読み込む：mboxDebug=true
Alloy Debug - Target パーソナライゼーションアクションを含むがこれに限定されない、SDKの詳細なアクションをログに記録します。

URL パラメーターを含むページを読み込む：alloy_debug=true

または開発者コンソールでalloy("setDebug", { "enabled": true });を実行します
Target Trace - Target UIで生成されたmbox トレーストークンを使用すると、決定プロセスに参加した詳細を含むトレースオブジェクトがwindow.___target_trace オブジェクトで利用できます。

URL パラメーターを含むページを読み込む：mboxTrace=window&authorization={TOKEN}
Adobe Experience Platform debugger拡張機能またはPlatform Assuranceを使用します。
NOTE
上記のすべてのat.js デバッグ機能は、Adobe Experience Platform Debuggerの強化機能で利用できます。

Target機能の無効化

Platform Web SDKには、現在、Targetの応答を選択的に抑制する機能はありません。 ただし、ブラウザーのデベロッパーツール、様々なブラウザー拡張機能、またはサードパーティアプリケーションを使用して、Platform Web SDK リクエストを抑制することは可能です。 例えば、Google ChromeでPlatform Web SDKをブロックするには、次の手順を実行します。

  1. ページ上の任意の場所を右クリックし、検査​を選択します
  2. 「ネットワーク」タブを選択します
  3. 文字列//ee//でフィルタリングして、Platform Web SDK呼び出しのみを表示します
  4. ページを再読み込み
  5. フィルタリングされたネットワークリクエストのいずれかを右クリックし、リクエストドメインをブロック​を選択します
  6. ページを再読み込みし、ネットワークリクエストがブロックされていることに注意してください
  7. デバッグが終了したら、ブロックされたネットワークリクエストを右クリックして​ ブロック解除 ​を選択するか、開発者ツールパネルを閉じます

デバッグログを表示

mboxDebug=true URL パラメーターを使用したat.jsのデバッグログには、各Target リクエスト、応答、およびコンテンツのページへのレンダリング試行に関する詳細情報が表示されます。 Platform Web SDKには、alloy_debug=true URL パラメーターを使用した同様のデバッグログがあります。

ログ情報
at.js （mboxDebug=true）
Platform Web SDK （alloy_debug=true）
フィルタリング用のロギング接頭辞
AT:
[alloy]
ページ読み込みリクエストの詳細
○
○
Mboxまたはscope リクエストの詳細
○
○
リクエストのステータス
○
○
応答の詳細
○
○
レンダリングステータス
成功とエラー
エラーのみ
レンダリングの詳細
○
○
NOTE
at.jsとPlatform Web SDKのデバッグログは、同様の詳細レベルを提供しますが、Web SDKでは無効なセレクターによるレンダリングエラーのみが通知されます。 デバッグログは、現在、レンダリングが成功したことを確認しません。

ターゲットトレースの表示

ターゲットトレースは、アクティビティの適格性と訪問者のターゲットプロファイルに関する詳細な情報を提供します。 Target トレースには公開されていない情報が含まれているため、表示するには、認証トークンまたはAdobe Experience Platform Debugger ブラウザー拡張機能ウィンドウ内での認証が必要です。

ターゲットトレース法
at.js
Platform Web SDK
mboxTrace URL パラメーター
○
×
Adobe Experience Platform Debugger拡張機能
○
○
Adobe Experience Platform Assurance
×
○

Platform Web SDK TargetのトレースをAdobe Experience Platform Debuggerで表示するには、次の操作を行います。

  1. Platform Web SDKを実装したサイトのページに移動します
  2. ブラウザーのナビゲーションバーでアイコン （ ）を選択して、Adobe Experience Platform Debugger拡張機能を開きます
  3. 「ログイン」リンクを選択
  4. Adobe Experience Cloud ログインを使用した認証
  5. 左側の「ログ」タブを選択します
  6. 上部の「Edge」タブを選択します
  7. 必要に応じて、デバッグセッションに名前を付け、Connect ボタンをクリックします
  8. ページを再読み込みすると、ログにエッジネットワークのインタラクションに関する詳細情報が入力されます
  9. 説明の「ターゲットトレース」で始まるログエントリに焦点を当て、表示​を選択して、ターゲットトレースの詳細を表示します

Adobe Experience Platform DebuggerでTarget トレースを表示する方法 {modal="regular"}

ビュー​を選択すると、オーバーレイが表示され、リクエストに関連する次の情報が表示されます。

  • 一致するアクティビティ
  • 一致しないアクティビティ
  • リクエスト詳細
  • プロファイルスナップショット

Target トレースの詳細については、「Target コンテンツ配信のデバッグ ​」に関する専用ガイドを参照してください。

Assuranceのトラブルシューティング

ターゲットトレース情報は、Adobe Experience Platform Debugger ブラウザー拡張機能とAssurance アプリケーション（旧称Project Griffon）の両方で表示できます。 Assurance内のTarget トレースを表示するには、次の操作を行います。

  1. 上記のように、Adobe Experience Platform Debugger ブラウザー拡張機能を開き、リモートデバッグセッションを接続します
  2. デバッグログの上にあるセッション名のリンクを選択します
  3. Platform Assuranceは、実装のデータストリームで設定されたすべてのAdobe アプリケーションの詳細なログを読み込み、表示します
  4. ログをadobe.targetでフィルタリング
  5. タイプ com.adobe.target.traceのログ エントリを選択
  6. ペイロードの詳細を展開し、context > targetTraceの下の情報を表示します

AssuranceでTarget トレースを表示する方法 {modal="regular"}

ネットワークのリクエストとレスポンスを調べる

Platform Web SDK sendEvent呼び出しのリクエストペイロードと応答がat.jsと異なります。 以下の概要は、ブラウザーの開発者ツールを使用してネットワーク呼び出しを調べる際に、リクエストと応答の構造を理解するのに役立ちます。

コンテンツリクエストペイロード

Platform Web SDK ペイロードのTarget固有の要素 {modal="regular"}

  • プロファイル、エンティティ、およびその他の非mbox パラメーターは、data.__adobe.targetの下のイベント配列で渡されます
  • 決定範囲は、query.personalization.decisionScopesの下のイベント配列にあります
  • 下流のmbox パラメーターにマッピングされたXDM データは、xdmの下のイベント配列にあります

コンテンツ応答本文

Platform Web SDK応答本文のTarget固有の要素 {modal="regular"}

  • Platform Web SDKは、handle オブジェクトの下にあるすべてのAdobe アプリケーションのアクションを返します
  • personalization:decisions アクションは、Targetまたはオファー決定からの応答を意味します
  • ターゲット提案は配列として表示され、それぞれに一意の提案IDがAT:で接頭辞が付きます
  • 決定範囲とアクティビティの詳細は、提案配列内にあります
  • オファーの詳細は、dataの下のitems配列にあります
  • 応答トークンは、metaの下のitems配列にあります

提案イベントペイロード

Target提案イベントの例 {modal="regular"}

  • ターゲット固有のSDK イベントは、インプレッションのdecisioning.propositionDisplayか、クリックなどのインタラクションのdecisioning.propositionInteractのいずれかです
  • 提案イベントの詳細は、xdm._experience.decisioningの下のイベント配列にあります
  • ディスプレイまたはインタラクションイベントの提案IDは、Targetから返されるコンテンツの提案IDと一致する必要があります

おめでとうございます。チュートリアルが終了しました。 Adobe Targetの実装をWeb SDKに移行します。

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