Qualtrics Platform
Customer Journey Optimizer
XM Discover
Qualtrics Social Connect

シングルページアプリケーション

Qtip:このページでは、2025年5月14日からリリース予定のシングルページアプリケーション機能の変更について説明します。クアルトリクスは、自らの裁量により責任を負うことなく、あらゆる製品機能のロールアウトのタイミングの変更、プレビュー段階または開発段階の製品機能の変更、何らかの理由により、または理由なく製品の機能をリリースしないことを選択する場合があります。

シングル・ページ・アプリケーションについて

シングル・ページ・アプリケーション（SPA）は、特別なタイプのウェブ・アプリケーションです。SPAは、あなたがウェブサイトに入ったときに1つのページを読み込み、その時点から、あなたがナビゲートするときに同じページ内の後続のすべてのコンテンツを読み込みます。これは通常のウェブサイトのように見えるが、「ページ」を切り替えても、実際にはページはリロードされない。

デフォルトでは、デプロイメントコードはWebページがロードされるとすぐに実行されます。しかし、SPAはページ間を移動するときにリフレッシュしないため、デプロイメントコードはページ間を移動するときに再評価されません。以下に説明するテクニックを使用することで、デプロイメントコードをSPAサイトでシームレスに機能させることができます。

Qtip:これらのテクニックのいくつかは、Website Feedback JavaScript APIを使用しています。クアルトリクスウェブサイトインサイトのJavaScript APIに関する詳細なドキュメントは、こちらのページをご覧ください。

注意以下のドキュメントを実行するには、プログラミングの知識が必要です。この情報は、デプロイメントコードを実装するチームに伝えることをお勧めします。クアルトリクスサポートチームでは、カスタムコーディングに関するサポートやコンサルティングは提供していません。その代わり、クアルトリクスXMコミュニティの経験豊富なユーザーにいつでも質問できます。委託可能なカスタムコーディングサービスの詳細をお知りになりたい場合は、クアルトリクス営業担当までご連絡ください。

qtip:Javascriptはすべてのクアルトリクスライセンスに含まれていません。アクセシビリティにご興味のある方は、クアルトリクス営業担当までお問い合わせください。

URL変更時のインターセプトロジックの自動再評価

Single Page Applicationがユーザーナビゲーションのためにクライアント側ルーティングに依存している場合、Re-evaluate intercept logic when the URL changes設定を有効にすることで、その後のURL変更時にインターセプトの再評価を強制することができます。この設定をチェックすると、最初のページロード時に行われる評価に加え、インターセプトロジックの評価が可能になります。

インターセプトロジックの自動再評価を有効にするには、以下の手順に従います：

インターセプトへ。
インターセプトの設定に進む。
Single-page App (SPA) Supportセクションで、Re-evaluate intercept logic when the URL changesがチェックされていることを確認してください。
変更の適用をクリックします。

Qtip:この動作をテストしたい場合は、プロジェクトレベルのブックマークレットを使用する必要があります。特定のインターセプトのブックマークレットを使用して、この動作をテストすることはできません。

インターセプトロジックの再評価とURL変更に伴うアクティビティの追跡

前のセクションでは、プロジェクト内のすべてのインターセプトでシングルページのアプリケーションをサポートする方法を示しました。ただし、プロジェクト内のすべてのインターセプトとエクスペリエンス分析でこの動作をサポートしたい場合は、代わりにプロジェクトレベルで設定を調整する必要があります。

Qtip:Manage projectで設定を有効にすると、インターセプトの設定でも自動的に適用されます。

プロジェクトのマネージャーへ。
Single-page App (SPA) SupportセクションのRe-evaluate intercept logic and/or track activity whenever URL changesがチェックされていることを確認してください。
変更の適用をクリックします。

注意カスタムJavascriptコードで表示するインターセプトレベルオプションと組み合わせてこのSPA設定を使用する場合、(手動で)

QSI.API.run();

メソッドを使用して、各SPAページに表示するインターセプトを取得します。

JavaScript APIによる手動実装

Qtip: クアルトリクスウェブサイトフィードバックのJavaScript APIに関する詳細なドキュメントは、こちらのページをご覧ください。

この方法では、デプロイメントコードを手動で実行するように切り替える方法を説明します。つまり、適切なJavaScript APIリクエストが開始されるまで、デプロイメントコードは関連するロジックを実行したり評価したりしません。

手動で実施する場合

インターセプトへ。
インターセプトの設定に進む。
インターセプト・ロード・オプションの見出しで、Manually Load Project を選択する。
変更の適用をクリックします。
必要であれば、インターセプトの1つに戻り、インターセプト全体または個々のアクションセットに論理セットを設定します。
デプロイメントコードは、できればすべてのページで読み込まれるように、グローバルヘッダまたはフッタに配置してください。
ウェブサイトにインターセプトを参照させたい回数に応じて、適切なJavaScript APIリクエストを追加します。これらのリクエストについては、以下のセクションを参照のこと。

JavaScript APIリクエスト

Qtip: クアルトリクスウェブサイトフィードバックのJavaScript APIに関する詳細なドキュメントは、こちらのページをご覧ください。

クアルトリクスにプロジェクトを1つのインスタンスで評価させたい場合は、以下の2つのリクエストを使用します：

このリクエストはページ上のインターセプトとクリエイティブのデプロイメントコードをロードします。load」APIは、コードのあるページをリロードするのと同じである。
```
QSI.API.load()；
```
Qtip:プロジェクト設定でManually Load Projectを有効にしている場合、最初のページロード時にデプロイメントコードをロードするためにこのAPIを呼び出す必要はありません。リロードせずに発生したページの状態変化をアカウントするために、強制ロードが必要になるだけである。
これによりデプロイコードの評価が開始され、表示条件を満たしたクリエイティブが表示される。
```
QSI.API.run()；
```

プロジェクトコードをクアルトリクスに同じページで複数回評価させたい場合は、以下の3つのステップを毎回繰り返してください：

このリクエストは、ページに存在するインターセプトやクリエイティブのデプロイメントコードを削除します。
```
QSI.API.unload()；
```
ページ上のインターセプトやクリエイティブのデプロイメントコードを読み込みます。これはページの再読み込みと同じである。
```
QSI.API.load()；
```
これによりデプロイコードの評価が開始され、表示条件を満たしたクリエイティブが表示される。
```
QSI.API.run()；
```