コンテンツ配信のトラブルシューティング

ページに意図するコンテンツが表示されない場合は、コンテンツ配信をデバッグするためにいくつかの手順をおこないます。

  • アクティビティやキャンペーンコードを慎重に確認します。タイポやその他のエラーがあると、意図するコンテンツが表示されない場合があります。
  • mboxTraceまたはmboxDebugを使用してTargetリクエストのトラブルシューティングを行います。
  • Adobe Experience Cloudデバッガは、mboxDebugとほとんど同じ情報を提供する使いやすいツールで、Targetリクエストのトラブルシューティングに使用します。

mboxDebugは、ページにTargetを設定して、Targetリクエストが実行され、cookieが設定されていることを確認する場合に特に便利です。 ただし、mboxDebug は、コンテンツ配信のデバッグに役立つ詳細までは調べません。ページにアクティビティが表示されない場合や、意図していないコンテンツが表示される場合は、mboxTrace を使用してページの調査とデバッグを詳細におこないます。

デバッグツールで使用する認証トークンを取得

mboxTrace と mboxDebug は、外部パーティにキャンペーンデータとプロファイルデータを公開するので、認証トークンが必要です。認証トークンは、Target UI で取得できます。トークンは 6 時間有効です。

認証トークンを生成するには、次のいずれかのユーザー権限が必要です。

  • エディター権限(または承認者)以上

    Target Standardユーザーの詳細については、ユーザー​の役割と権限の指定を参照してください。 Target Premiumユーザーの詳細については、エンタープライズ権限の設定を参照してください。

  • ワークスペース/製品プロファイルレベルの管理者ロール

    ワークスペースはTarget Premiumのお客様のみ利用できます。 詳しくは、エンタープライズ権限の設定を参照してください。

  • Adobe Target製品レベルの管理権限(Sysadmin権限)

認証トークンを取得するには、次の手順に従います。

  1. 管理/実装​をクリックします。

  2. 「Debugger Tools」セクションで、「Generate New Authentication Token」をクリックします。

    新しい認証トークンの生成

  3. 生成されたトークンをパラメーターとして URL に追加して、高度なデバッグツールの 1 つを有効にします。

    認証トークン

mboxTrace

mboxTraceを使用すると、Target応答に添付されたトレース情報を受信できます。 トレース情報は、Target呼び出しの結果(コンバージョンやインプレッションなど)と、キャンペーンで選択された分岐のセットなど、この特定の結果が発生した理由を判断するのに役立つ追加データを反映します。 この情報を使用してコンテンツ配信をデバッグします。

次のパラメーターを使用できます。

mboxTrace のオプション 結果
?mboxTrace=console コンソールログにオブジェクトとして出力します。
at.js の場合は、mbox.js のように新しいブラウザーウィンドウをポップアップしたりコンソールに出力したりする代わりに、ネットワークリクエストを調べて、プレビュー(Chrome)または応答(Firefox)を確認する必要があります。
?mboxTrace=json コンソールログにリテラル JSON 文字列として出力します。
?mboxTrace=window ポップアップウィンドウに JSON 文字列として出力します。
?mboxTrace=disable セッションモードのトレースをオフにします。

mboxTrace呼び出しの例

https://www.mysite.com/page.html?mboxTrace=window&authorization=f543abf-0111-4061-9619-d41d665c59a6

出力に、コンテンツに関するきわめて詳しい情報が表示されます。mboxTrace は、キャンペーンまたはアクティビティとプロファイルの詳細を表示します。また、実行前のプロファイルのスナップショットと、実行後の変化を示すスナップショットも提供します。さらに、各場所で評価されたキャンペーンやアクティビティも表示します。

情報によっては、一致するセグメント、一致しないセグメントおよびターゲット ID が含まれる場合もあります。

  • SegmentId:セグメントの ID。再利用可能なセグメントライブラリか、特定のキャンペーン用に作成された匿名セグメントのいずれかのものです。
  • TargetId:ターゲットの ID。ターゲットエクスプレッションライブラリか、キャンペーンの任意のセグメント用の匿名ターゲットのものです。
  • Unmatched:リクエストは、この呼び出しで、セグメントまたはターゲットに適していませんでした。
  • Matched:リクエストは、指定されたセグメントまたはターゲットに適していました。

レコメンデーションページでのmboxTraceの使用:ページにmboxTraceをクエリパラメーターとしてレコメンデーションと共に追加すると、ページ上のRecommendationsデザインがmboxTrace詳細ウィンドウに置き換えられます。このウィンドウには、レコメンデーションに関する次のような詳細情報が表示されます。

  • 返されたレコメンデーションと要求されたレコメンデーション
  • 使用されたキーと、それがレコメンデーションを生成するかどうか
  • 条件によって生成されたレコメンデーションとバックアップレコメンデーション
  • 条件の設定
  • 適用される除外とインクルージョン
  • 収集ルール

クエリパラメーターには、=console=json、または =window を含める必要はありません。mboxTrace の詳細が完了したら、=disable を追加して、Enter キーを押すと、通常の表示モードに戻ります。

サイトの通常の機能や外見は、mboxTrace の影響を受けません。訪問者には、通常のレコメンデーションのデザインが表示されます。

mboxDebug

mboxDebug を使用するには、URL の末尾に mboxDebug パラメーターを追加します。次の表に、Target応答関連のURLパラメーターに関する情報を示します。

メモ

mboxDebug パラメーターによっては、使用するのに認証を必要とするものと、認証を必要としないものがあります。

URL パラメーター 目的
mboxDebug=1 デバッガー
ターゲットリクエストが定義された任意のURLにこのパラメーターを追加すると、ポップアップウィンドウが開き、貴重なデバッグの詳細が表示されます。 Cookie 情報、PCID およびセッション ID の値が記述され、 URL がすべて表示されます。ターゲットリクエストURLをクリックすると、そのTargetリクエストの応答が表示されます。 詳しくは、mbox_debug.pdf を参照してください。
mboxDebug=x-cookie cookie の変更
mboxDisable=1 ページ上の mbox を無効化
mboxDebug=x-profile プロファイルセットを表示
mboxDebug=x-time 各Targetリクエストの応答時間を表示
mboxOverride.browserIp=<Insert IP address> Geotargeting のテスト
Geotargeting をこの URL パラメーターでテストします。この属性の値に IP アドレスを入力すると、Test&Target のジオターゲティングがこの IP アドレスを評価し、キャンペーン内のジオターゲティングまたはセグメント化セットに一致させます。
メモ

URLフラグメントがクエリ文字列パラメーターの後にあることを確認します。 最初の#の後はすべてフラグメント識別子で、デバッグパラメーターが正しく機能しません。

Adobe Experience Cloud デバッガー

Adobe Experience Cloud デバッガーを使用すると、Target の実装をすばやく簡単に理解できます。ライブラリ設定をすばやく表示し、リクエストを検証してカスタムパラメーターが正しく渡されたことを確認し、コンソールのログを有効にして、Target のすべてのリクエストを無効にすることができます。Experience Cloudを認証し、強力なMboxTraceツールを使用して、アクティビティとオーディエンスの資格、および訪問者プロファイルを調査できます。

詳しくは、以下のトレーニングビデオを参照してください。

詳しくは、Adobe Experience Cloudデバッガーを使用したat.jsのデバッグを参照してください。

配信中に target.js を読み込めなかった場合

配信中に target.js の読み込みに失敗した場合は、mbox.js から訪問者に対して「em-disabled」という cookie が送信されます。この cookie は、Visual Experience Composer を使用して作成されたオファーがサイトに表示されないようにします。この cookie が設定された訪問者には、テストコンテンツが表示されず、それらのアクティビティレポートでもカウントされません。その他すべてのオファーコンテンツ(例えば Target Classic のキャンペーンのコンテンツ)は引き続き読み込まれます。この cookie の有効期間は、読み込み失敗時から 30 分です。

レコメンデーションにトップセラーが表示されない

SiteCatalyst: purchase​呼び出しは、購入アルゴリズムのトラフィックデータには使用できません。 代わりに​orderConfirmPage​呼び出しを使用します。

アクティビティの優先度を確認

Target Standard/Premiumで作成されたフォームベースのアクティビティは、Target Classic UIで作成されたアクティビティと競合し、同じTargetリクエストを使用します。

Internet Explorer 8 でカスタムコードが期待どおりの結果を返さない

Target は、IE 8 をサポートしていません。

グローバルTargetリクエストによって配信されるJavaScriptコンテンツが、mbox.jsの使用時に読み込まれません。

mbox.js のバージョンを 58 以降にアップグレードしてください。

mbox.jsバージョン58以降では、HTML BODYタグの直後に、グローバルTargetリクエストの非JavaScriptコンテンツを実行します。 グローバルTargetリクエストの<script>タグ内のJavaScriptコンテンツは、DOMContentLoadedイベントの起動後に実行されます。 このコンテンツ配信の順序によって、グローバルTargetリクエストのJavaScriptコンテンツが適切に配信およびレンダリングされます。

ターゲットCookieが設定されていません

サイトにサブドメイン(us.domain.com など)がある場合で Target の cookie を(domain.com ではなく)us.domain.com に設定する必要がある場合、cookieDomain 設定を上書きする必要があります。詳しくは、「targetGlobalSettings()」を参照してください。。

要素が AEM パーソナライゼーションにも含まれていると、Target のコンテンツがちらつく、または表示されない

DOM 要素が Adobe Experience Manager(AEM)パーソナライゼーションのターゲット設定と Target アクティビティの両方に含まれていると、Target コンテンツがちらついたり表示されなかったりする場合があります。

これを修正するには、Target が実行されているページで AEM パーソナライゼーションを無効にします。

URL が無効なのでリダイレクトおよびリモートオファーを配信できない

リダイレクトまたはリモートオファーで無効な URL が使用されていると、配信できない可能性があります。

リダイレクトオファーの場合、Target応答には/* invalid redirect offer URL */を含めることができます

または

リモートオファーの場合、Target応答には/* invalid remote offer URL */を含めることができます

ブラウザーでTarget応答を確認するか、mboxTraceを使用します。 有効な URL について詳しくは、https://tools.ietf.org/html/std66 を参照してください。

サイトでターゲット要求が実行されていない。

at.jsは、無効なdoctypeを使用している場合、ターゲットリクエストを実行しません。 a.js には HTML5 の doctype が必要です。

トレーニングビデオ

以下のビデオは、この記事で説明する概念についてさらに詳しく説明しています。

拡張機能の追加 チュートリアルバッジ

基本的なターゲットのデバッグチュートリアルバッジ

mboxトレースチュートリアルバッジ

このページ