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 をクエリーパラメーターとして追加すると、ページ上の Recommendation のデザインが、mboxTrace の詳細ウィンドウに置き換わり、以下を含むレコメンデーションに関する詳細が表示されます。
- 返されたレコメンデーションと要求されたレコメンデーション
- 使用されたキーと、それがレコメンデーションを生成するかどうか
- 条件によって生成されたレコメンデーションとバックアップレコメンデーション
- 条件の設定
- 適用される除外とインクルージョン
- 収集ルール
クエリパラメーターに =console
、=json
、=window
を含める必要はありません。 mboxTrace の詳細が完了したら、=disable
を追加して、Enter キーを押すと、通常の表示モードに戻ります。
サイトの通常の機能や外見は、mboxTrace の影響を受けません。訪問者には、通常のレコメンデーションデザインが表示されます。
mboxDebug
mboxDebug を使用するには、URL の末尾に mboxDebug パラメーターを追加します。Target 応答に関連する URL パラメーターについての情報を次の表に示します。
URL パラメーター | 目的 |
---|---|
mboxDebug=1 | デバッガー Target リクエストが定義された任意の URL にこのパラメーターを追加すると、ポップアップウィンドウが開き、有用なデバッグ詳細情報が表示されます。Cookie 情報、PCID およびセッション ID の値が記述され、 URL がすべて表示されます。Targe リクエストの URL をクリックすると、その Target リクエストに対する応答を表示できます。詳しくは、mbox_debug.pdf を参照してください。 |
mboxDisable=1 | ページ上の mbox を無効化 |
mboxOverride.browserIp=<Insert IP address> | Geotargeting のテスト Geotargeting をこの URL パラメーターでテストします。この属性の値に IP アドレスを入力すると、Test&Target のジオターゲティングがこの IP アドレスを評価し、キャンペーン内のジオターゲティングまたはセグメント化セットに一致させます。 |
#
の後はすべてフラグメント識別子となり、デバッグパラメーターが正しく機能しません。Adobe Experience Cloud デバッガー
Adobe Experience Cloud デバッガーを使用すると、Target の実装をすばやく簡単に理解できます。ライブラリ設定をすばやく表示し、リクエストを検証してカスタムパラメーターが正しく渡されたことを確認し、コンソールのログを有効にして、Target のすべてのリクエストを無効にすることができます。Experience Cloud への認証をおこなうと、強力な MboxTrace ツールを使用して、アクティビティ、オーディエンスの資格情報、訪問者プロファイルを調査できます。
詳しくは、以下のトレーニングビデオを参照してください。
詳しくは、Adobe Experience Cloud Debugger を使用した at.js のデバッグを参照してください。
Recommendations にトップセラーが表示されない
SiteCatalyst: purchase
呼び出しは、購入アルゴリズムトラフィックデータには使用できません。代わりに、orderConfirmPage
呼び出しを使用します。
アクティビティの優先度を確認
Target Standard/Premium で作成されたフォームベースのアクティビティは、優先度が同じで、同じ Target リクエスト使用している Target Classic UI で作成されたアクティビティと競合する場合があります。
Internet Explorer 8 でカスタムコードが期待どおりの結果を返さない
Target は、IE 8 をサポートしていません。
Target の Cookie が設定されない
サイトにサブドメイン(us.domain.com など)がある場合で Target の cookie を(domain.com ではなく)us.domain.com に設定する必要がある場合、cookieDomain
設定を上書きする必要があります。詳しくは、targetGlobalSettings ()を参照してください。
要素が Adobe Experience Manager パーソナライゼーションにも含まれていると、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 を参照してください。
Target リクエストがサイトで実行されません。
無効な doctype を使用している場合、at.js は Target mbox を実行しません。a.js には HTML5 の doctype が必要です。
Target アクティビティが、クエリ文字列パラメーターを使用して URL を正しく処理することを確認します。
Activity URL は、訪問者をアクティビティの対象に認定し、ユーザーに対するアクティビティエクスペリエンスをレンダリングするページを決定します。 アクティビティの作成中にプロンプトが表示された場合、特にクエリ文字列パラメーターを含む URL の場合、完全な URL を入力してもコンテンツがそのサイトページに配信されるとは限りません。
デフォルトでは、Visual Experience Composer (VEC)は Visual Experience Composer 設定で指定されているページを開きます。 アクティビティ作成中に、別のページを指定することもできます。
VEC が開いた後に別のページを表示するには、Configure gear icon をクリックして Page Delivery を選択し、「Activity URL」フィールドに目的の URL を指定します。
URL にクエリ文字列パラメーターが含まれている場合はどうなりますか?そのパラメーターが機能して、パーソナライズされたコンテンツが表示されますか? このシナリオでは、ターゲットオーディエンスに関係なく、ベース URL に加えて、テンプレートルールを含めてクエリパラメーターを定義できます。
追加のテンプレートルールを含めるには、次のオプションを使用できます。