ドキュメント

シングルページアプリケーション (SPA) での Visual Experience Composer(VEC) の問題のデバッグ

Last update: Thu Mar 28 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

説明 description

環境

Adobe Target

問題／症状

Adobe Target VEC for SPAは、ビューと呼ばれる新しい概念を活用します。ビューとはビジュアル要素の論理的なグループで、全体としてSPAエクスペリエンスを構成します。

SPAはページ読み込み時のオファーの取得に依存しないので、次のような制限事項と前提条件があります。

  • SPA VEC は、自動ターゲット、自動パーソナライゼーションまたはレコメンデーションアクティビティをサポートしていません。

  • at.js 2.0+ そして adobe.target.triggerView() 関数は、SPA VEC を使用する前に、アプリで実装する必要があります。

  • 最初のページ読み込みの操作の順序は次のとおりです。

    読み込み VisitorAPI JS "読み込み at.js 2.x "実行 Target リクエスト（プリフェッチ呼び出し） "呼び出し triggerView().

解決策 resolution

SPAに関連する VEC の問題のデバッグ時に、以下を確認します。

  1. 確認 adobe.target.triggerView() 関数が呼び出されます。

  2. ページで、次のパラメーターがトリミングまたは削除されないことを確認します。 mboxEdit=1 および mboxDisable=1

    • Visual Experience Composer で Web サイトを開くと、Target によって 2 つのパラメーター（mboxEdit=1 および mboxDisable=1）が追加されます。
    • Web サイト（特にシングルページアプリ）で、ページの再読み込みなしでページ間を移動中にパラメーターがトリミングされたり削除されたりすると、Target の機能が壊れ、Target ライブラリは読み込まれません。

  3. コンソールログに表示される可能性のあるエラーメッセージを探します。 例えば、i-frame がビューの読み込みをブロックしている場合に問題が発生する可能性があります。 一般的なエラーメッセージは次のとおりです。

    code language-none 
    Uncaught DOMException: Blocked a frame with origin "https://view.ceros.com" from accessing a cross-origin frame.

at https://view.ceros.com/hitachi-vantara/hitachi-vantara-x-t-systems?heightOverride=4696&mobileHeightOverride=9696:610:38

  4. ネットワークログで Target ビュー通知呼び出しをチェックします（ステータスが 204 の Target 通知呼び出し）。 呼び出しがブロックされた場合は、ステータスを確認します。

  5. 変更が VEC に表示されなくなったが変更パネルに表示され、変更をパネルから削除できない問題の場合は、ビュー名の末尾にスペースがないことを確認してください。

  6. ビュー名を設定する際に確認すべきその他の詳細は次のとおりです。

    • 末尾にスペースはありません。
    • 空にはできません。
    • ビュー名はすべてのページに対して一意である必要があります。
    • ビュー名の先頭または末尾を次の文字にすることはできません /. これは、顧客は通常、URL パスからビュー名を抽出するからです。 我々のために home および /home が異なる。
    • 同じビューを、 {page: true} オプション。
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f