Platform Web SDK を使用した Target のデバッグ
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デバッガーブラウザー拡張機能の使用 |
| 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または Mozilla Firefox ブラウザーにインストールできます。 次の適切なリンクに従って、目的のブラウザーに拡張機能をインストールします。
Chrome拡張機能または Firefox アドオンをインストールすると、拡張機能バーにアイコン（
Adobe Experience Platform Debugger拡張機能の詳細と、すべてのAdobe web アプリケーションをデバッグする方法については専用ガイドを参照してください。
QA URL で Target アクティビティをプレビューする
at.js と Platform Web SDK の両方で、Target QA URL を使用して Target アクティビティをプレビューできます。また、両方の実装方法で同じ QA 機能をサポートしています。
at.js または Platform Web SDK に対し、at_qa_mode という名前のブラウザーに特定の Cookie を書き込むよう指示することで、Target QA URL が機能する。 この cookie は、特定のアクティビティおよびエクスペリエンスの選定を強制するために使用されます。
注意sendEvent 呼び出しで渡された xdm.web.webPageDetails.URL 値に基づいて有効になります。 この値を変更（すべての文字を小文字にするなど）すると、Target QA モードが正しく動作しなくなる可能性があります。ターゲットアクティビティ QA について詳しくは、専用ガイドを参照してください。
Target 実装のデバッグ
次の表に、at.js と Platform Web SDK デバッグ戦術の違いの概要を示します。
| at.js の機能 | Platform Web SDK の同等機能 |
|---|---|
| mbox 無効化 - Target は取得とレンダリングから無効にし、Target のインタラクション URL パラメーター mboxDisable=true を含むページの読み込みを行わずにページが壊れているかどうかを確認します | 直接同等の手段はありません。 ブラウザーの開発者ツールを使用して、すべての Platform Web SDK リクエストをブロックできます。 |
| mbox デバッグ - ブラウザーのコンソールにすべての at.js アクションを記録して、レンダリングの問題のトラブルシューティングに役立てます URL パラメーターを含むページを読み込み： mboxDebug=true | Alloy のデバッグ - Target のパーソナライゼーションアクションを含むがこれに限定されない、SDK の詳細なアクションをログに記録します。 URL パラメーターを使用してページを読み込む： alloy_debug=trueまたは、開発者コンソールで alloy("setDebug", { "enabled": true }); を実行します |
Target トレース - Target UI で生成された mbox トレーストークンを使用すると、決定プロセスに関与した詳細を含むトレースオブジェクトをオブジェクトの下で使用でき window.___target_trace す。URL パラメーターを持つページを読み込む： mboxTrace=window&authorization={TOKEN} | Adobe Experience Platform Debugger 拡張機能または Platform Assurance を使用します。 |
メモTarget 機能の無効化
Platform Web SDK には、現在、Target 応答を選択的に抑制する機能がありません。 ただし、ブラウザーの開発者ツール、様々なブラウザー拡張機能、サードパーティアプリケーションを使用して、Platform Web SDK リクエストを抑制することは可能です。 例えば、Google Chromeで Platform Web SDK をブロックするには、次の手順を実行します。
- ページ上を右クリックして、「Inspect」を選択します
- 「ネットワーク」タブを選択します。
- 文字列
//ee//でフィルタリングして、Platform Web SDK 呼び出しのみを表示します - ページをリロードします。
- フィルタリングされたネットワークリクエストの 1 つを右クリックし、「リクエストドメインをブロック」を選択します。
- ページをリロードし、ネットワークリクエストがブロックされていることを確認します
- デバッグが完了したら、ブロックされたネットワークリクエストを右クリックして「ブロック解除」を選択するか、開発者ツールパネルを閉じます
デバッグログの表示
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 またはスコープリクエストの詳細 | ○ | ○ |
| リクエストのステータス | ○ | ○ |
| 応答の詳細 | ○ | ○ |
| レンダリングステータス | 成功とエラー | エラーのみ |
| レンダリングの詳細 | ○ | ○ |
メモターゲットトレースの表示
Target トレースは、アクティビティ選定および訪問者の Target プロファイルに関する詳細情報を提供します。 Target トレースには、公開されていない情報が含まれているので、それらを表示するには、認証トークンまたはAdobe Experience Platform Debuggerブラウザー拡張機能ウィンドウ内での認証が必要です。
| ターゲットトレース方法 | at.js | Platform Web SDK |
|---|---|---|
mboxTrace URL パラメーター | ○ | × |
| Adobe Experience Platform Debuggerブラウザー拡張機能 | ○ | ○ |
| Adobe Experience Platform Assurance | × | ○ |
Adobe Experience Platform Debuggerで Platform Web SDK Target トレースを表示するには、次の手順を実行します。
- Platform Web SDK で Target が実装されているページに移動します
- ブラウザーのナビゲーションバーのアイコン（
- ログイン リンクを選択します
- Adobe Experience Cloud ログインを使用した認証
- 左側の「ログ」タブを選択します
- 上部の「Edge」タブを選択します
- 必要に応じて、デバッグセッションに名前を付け、「接続」ボタンをクリックします
- ページをリロードすると、ログにエッジネットワークインタラクションに関する詳細情報が表示されます
- 説明に「Target Traces」で始まるログエントリに焦点を当て、「表示 を選択して Target Trace の詳細を確認し す
「表示」を選択すると、オーバーレイが表示され、リクエストに関連する次の情報を確認できます。
- 一致したアクティビティ
- 比類のないアクティビティ
- リクエストの詳細
- プロファイルスナップショット
Target のトレースについて詳しくは、Target コンテンツ配信のデバッグに関する専用ガイドを参照してください。
