ドキュメント

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

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

この記事では、Adobe Targetのシングルページアプリケーション（SPA）の Visual Experience Composer （VEC）の問題をデバッグするためのベストプラクティスについて説明します。

説明 description

環境

Adobe Target

問題／症状

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

SPAがページ読み込み時のオファーの取得に依存しないという事実に基づいて、いくつかの制限と前提条件があります。

  • SPA VEC では、自動ターゲット、Automated Personalization、レコメンデーションアクティビティをサポートしていません。

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

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

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

解決策 resolution

SPAに関連する VEC の問題をデバッグする際は、次を確認します。

  1. 関数 adobe.target.triggerView() 各 ビュー に対して実行されていることを確認します。

  2. ページでパラメーター mboxEdit=1 および mboxDisable=1 がトリミングされたり削除されたりしていないことを確認してください。

    Target は、Visual Experience Composer で web サイトを開く際に 2 つのパラメーター（mboxEdit=1 と mboxDisable=1）を追加します。

    お客様の Web サイト（特にシングルページアプリ）が、あるページから別のページに移動する際に、パラメーターをトリミングしたり削除したりした場合（ページの再読み込みなしに）、Target 機能が破損し、Target ライブラリが読み込まれません。

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

    code language-none 
    Uncaught DOMException: Blocked a frame with origin "https://view.customer-website.com" from accessing a cross-origin frame.
at https://www.adobe.com

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

  5. 変更が VEC に表示されなくなり、変更パネルに表示される問題、およびパネルから変更を削除できない問題については、view 名の末尾にスペースが入っていないことを確認してください。

  6. view name の設定時に確認するその他の詳細は、次のとおりです。

    • 末尾にスペースは使用しません。
    • 空白にすることはできません。
    • ビュー 名はすべてのページで一意である必要があります。
    • ビュー 名前の先頭または末尾に/を使用することはできません。 これは、通常、URL パスからビュー名を抽出するからです。 home と /home は異なります。
    • {page: true} オプションを使用して、同じビューを連続して複数回トリガーしないでください。
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f