ページに意図するコンテンツが表示されない場合は、コンテンツ配信をデバッグするためにいくつかの手順をおこないます。
mboxDebugは、ページにTargetを設定して、Targetリクエストが実行され、cookieが設定されていることを確認する場合に特に便利です。 ただし、mboxDebug は、コンテンツ配信のデバッグに役立つ詳細までは調べません。ページにアクティビティが表示されない場合や、意図していないコンテンツが表示される場合は、mboxTrace を使用してページの調査とデバッグを詳細におこないます。
mboxTrace と mboxDebug は、外部パーティにキャンペーンデータとプロファイルデータを公開するので、認証トークンが必要です。認証トークンは、Target UI で取得できます。トークンは 6 時間有効です。
認証トークンを生成するには、次のいずれかのユーザー権限が必要です。
エディター権限(または承認者)以上
Target Standardユーザーの詳細については、ユーザーの役割と権限の指定を参照してください。 Target Premiumユーザーの詳細については、エンタープライズ権限の設定を参照してください。
ワークスペース/製品プロファイルレベルの管理者ロール
ワークスペースはTarget Premiumのお客様のみ利用できます。 詳しくは、エンタープライズ権限の設定を参照してください。
Adobe Target製品レベルの管理権限(Sysadmin権限)
認証トークンを取得するには、次の手順に従います。
管理/実装をクリックします。
「Debugger Tools」セクションで、「Generate New Authentication Token」をクリックします。
生成されたトークンをパラメーターとして URL に追加して、高度なデバッグツールの 1 つを有効にします。
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 が含まれる場合もあります。
レコメンデーションページでのmboxTraceの使用:ページにmboxTraceをクエリパラメーターとしてレコメンデーションと共に追加すると、ページ上のRecommendationsデザインがmboxTrace詳細ウィンドウに置き換えられます。このウィンドウには、レコメンデーションに関する次のような詳細情報が表示されます。
クエリパラメーターには、=console
、=json
、または =window
を含める必要はありません。mboxTrace の詳細が完了したら、=disable
を追加して、Enter キーを押すと、通常の表示モードに戻ります。
サイトの通常の機能や外見は、mboxTrace の影響を受けません。訪問者には、通常のレコメンデーションのデザインが表示されます。
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 デバッガーを使用すると、Target の実装をすばやく簡単に理解できます。ライブラリ設定をすばやく表示し、リクエストを検証してカスタムパラメーターが正しく渡されたことを確認し、コンソールのログを有効にして、Target のすべてのリクエストを無効にすることができます。Experience Cloudを認証し、強力なMboxTraceツールを使用して、アクティビティとオーディエンスの資格、および訪問者プロファイルを調査できます。
詳しくは、以下のトレーニングビデオを参照してください。
詳しくは、Adobe Experience Cloudデバッガーを使用したat.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リクエストを使用します。
Target は、IE 8 をサポートしていません。
mbox.js のバージョンを 58 以降にアップグレードしてください。
mbox.jsバージョン58以降では、HTML BODY
タグの直後に、グローバルTargetリクエストの非JavaScriptコンテンツを実行します。 グローバルTargetリクエストの<script>
タグ内のJavaScriptコンテンツは、DOMContentLoaded
イベントの起動後に実行されます。 このコンテンツ配信の順序によって、グローバルTargetリクエストのJavaScriptコンテンツが適切に配信およびレンダリングされます。
サイトにサブドメイン(us.domain.com など)がある場合で Target の cookie を(domain.com ではなく)us.domain.com に設定する必要がある場合、cookieDomain
設定を上書きする必要があります。詳しくは、「targetGlobalSettings()」を参照してください。。
DOM 要素が Adobe Experience Manager(AEM)パーソナライゼーションのターゲット設定と Target アクティビティの両方に含まれていると、Target コンテンツがちらついたり表示されなかったりする場合があります。
これを修正するには、Target が実行されているページで AEM パーソナライゼーションを無効にします。
リダイレクトまたはリモートオファーで無効な 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 が必要です。
以下のビデオは、この記事で説明する概念についてさらに詳しく説明しています。