Web サイト/アプリインサイト技術文書

Web サイト/App Insights プロジェクトとは何ですか？また、なぜ当社のサイトで使用するのですか？

クアルトリクスのウェブサイト／App Insightsは、デジタルメディア内でのウェブ訪問者の体験を測定し、強化するのに役立ちます。ウェブサイト／App Insightsプロジェクトを使用すると、訪問者の体験に関するフィードバックを得たり、最新のディールやプロモーションなどを知らせたりするためのリンクやアンケートが埋め込まれた使いやすいグラフィックをウェブサイトに提示できます。

ユーザとその同僚は、グラフィック (クリエイティブとも呼ばれる) の概観、グラフィックが表示される条件 (インターセプト)、およびそれをデプロイするために使用されるコードに対する力を持っています。

プロジェクトコードがウェブサイトに追加されると、コードの変更やITチームへの通知を必要とせずに、どのような変更でも行えます。Qualtricsで作業するだけで、ウェブサイトのクリエイティブとインターセプトが適宜変更されます。

データは安全ですか？

ロジックにターゲットを設定するために必要な場合を除き、Qualtricsのサーバーにデータは一切パスされません。つまり、Qualtricsのシステムにはこうしたデータは一切保存されません。

このデータを有線上で安全に保ち、中間者攻撃から保護するために、Qualtricsでは「HTTPS」プロトコルを常に使用しています。プロトコルとは訪問者のウェブブラウザーへのコンテンツの配信方法を指します。

デプロイするプロジェクトコードはどこにありますか？

デプロイコード（またはプロジェクトデプロイコード）は、プロジェクト内の［デプロイメント］タブにあります。導入するには、コードをコピーし、ウェブ配置チームに送信してください。コードに変更を加える必要はありません。

デプロイコードには、そのプロジェクト全体で構築されたすべてのインターセプトが表示されます。

コードはどのように機能しますか？

デプロイコードは非同期です。つまり、ページのほかのすべてのコンテンツが読み込まれるまで実行されません。このようにデプロイコードが実行されるのはonLoadイベントがトリガーされた後のみであるため、デプロイコードによってページのほかの要素の読み込みが妨害されることはありません。

訪問者がブラウザーでデプロイコードを含むページを表示するとどうなるかを見てみましょう。

• デプロイコード (通常は HTML ヘッドに配置される) は、ページのロード時にすぐに実行され、page onLoad イベントがトリガされると Html 本文の末尾に別の <script> タグが挿入されます。
• この<script>タグは、コンテンツ配信ネットワーク（CDN）にキャッシュされたJavaScriptコード（Orchestrator）をクアルトリクスサーバーにリクエストします。
• Orchestratorはターゲットを絞ってQualtricsサーバーを呼び出し、表示するクリエイティブを決定します。この呼び出しはCDNにキャッシュされません。
  • 必要に応じて、必要なデータを取得するために 2 番目のターゲット指定要求がサーバに送信されます (例: JavaScript 式またはクッキーターゲティング)。
  • クアルトリクスは、データベースからウェブサイト／アプリインサイトの定義を取得し、コードを適切に構築します。
• Orchestratorは、ターゲットを絞った回答に基づいて、追加の呼び出しを行い、ページへの表示が必要な別のコンテンツを取得します。行われたリクエスト数は、ターゲティングロジックを通すものを示すクリエイティブの数によって異なる。こうしたすべてのコンテンツはCDNにキャッシュされるため、素早く読み込まれます。
• ページにクリエイティブが表示されます。

デプロイコードは動的です。つまり、ウェブサイト／App Insightsプロジェクトのインターフェイス内からインターセプトとクリエイティブに変更を加えても、コード自体は変更されません。そのため、アカウント内からウェブサイト／アプリのインサイトプロジェクトに変更を加えることができ、変更を表示するためにウェブサイト上でコードを交換する必要はありません。

ウェブサイト／App Insightsプロジェクトをデプロイするにはどうすればよいですか？

1. Web ページへのコードの直接追加

デプロイコードは、ウェブページの任意の場所に追加できます。コードは非同期で実行されるため、ウェブページがすべてのコンテンツ（画像、スクリプトファイル、CSSファイルなど）を完全に読み込むまで、読み込みは開始されません。

リクエストは、onLoadイベントがトリガーされると発生します： https://www.w3schools.com/jsref/event_onload.asp

また、ウェブページでクリエイティブが実際に表示される場所は、Qualtricsインターフェイス内で決定された設定によって決まります。(カスタム位置の情報を参照してください。)したがって、ページ内のコードの位置は、ページコンテンツが表示される場所に影響しません。

2. グローバルヘッダー/グローバルフッター（推奨）

デプロイコードはグローバルヘッダーかグローバルフッターに追加することをお勧めします。こうすると、世界中の全サイトに同時にコードが適用されます。この方法は、多くのページに繰り返しコードを追加する必要がないため、デプロイする最も簡単な方法です。長いプロセスになる可能性があります。この方法でコードがサイトにグローバルに追加されている場合は、インターセプト内の現在の URL ロジックを使用して、インターセプトが実際に表示されるページを制御できます。

3. タグマネージャーの使用

もう 1 つのオプションは、展開コードをサイトコードに直接適用するのではなく、タグ管理システムに追加することです。コピーしたコードをQualtricsのインターフェイスから直接タグマネージャーに貼り付けることができます。

お客様がウェブサイト／App Insightsとともに使用する一般的なタグ管理システムは、Adobe Launch、Tealium、Ensighten、Google Tag Managerです。特にTealiumには、ウェブサイト／App Insightsを簡単に導入できるウィザードが構築されている。必要なのは、導入するプロジェクトのゾーンIDと所属組織のIDのみです。

組織IDは、［アカウント設定］に移動し、［クアルトリクスID］タブを選択すると取得できます。

ゾーンIDは、ZN_で始まり、次のいずれかにあります。

1. プロジェクト内にいる場合は、プロジェクトの URL
   
2. プロジェクトのデプロイコード内。
   

通常、Web サイト/App Insights の実装に関与するのは誰ですか。

所属組織のウェブサイトにコンテンツを追加するアクセス権限を有する組織内の人物です。通常は、ITチーム、ウェブコンテンツチームなどのメンバーです。

ウェブサイト／App Insightsはサイトの速度を低下させますか？

デプロイコードは非同期です。つまり、ページのほかのすべてのコンテンツが読み込まれるまで実行されません。このようにデプロイコードが実行されるのはonLoadイベントがトリガーされた後のみであるため、デプロイコードによってページのほかの要素の読み込みが妨害されることはありません。

Qualtricsが停止したらどうしますか？当社ウェブサイトに問題が生じるでしょうか？

Qualtricsで停止や問題が発生した場合、インターセプトはページに表示されません。それ以外にも、サイトでの訪問者の体験に影響はありません。

自分のウェブサイトでのコードの実行速度は？

デプロイコードの読み込み速度は、リクエストの50％以上で300ミリ秒以内、リクエストの90％以上で750ミリ秒以内と予測されます。ユーザーの地理的位置と、プロジェクトのインターセプトとクリエイティブの数によって、速度は異なります。

デバッグウィンドウを開く

デバッグウィンドウを使用して、特定のウェブページでインターセプトが表示されない理由を診断できます。このウィンドウは、インターセプトが表示されるために必要なすべての条件と、その条件がパスしたか失敗したかを表示します。

デバッグウィンドウをどのように開くかは、インターセプトが実装された時期によって異なります。

2019年3月までに実施されるインターセプト

デプロイメントコードが2019年3月以前に実装されたインターセプトについては、URLにQ_DEBUG クエリー文字列を追加することでデバッグウィンドウを有効にすることができます。このクエリー文字列には、以下の例のように、「?

2019年3月以降に実施されるインターセプト

デプロイメントコードが2019年3月以降に実装されたインターセプトについては、以下の手順に従ってデバッグウィンドウを開いてください：

1. ブラウザの開発者ツールを開く。
2. QSI.API.unload();
QSI
   .isDebug = true;
QSI
   .API.load();
QSI
   .API.run()以下のJavaScriptコマンドを実行する
   ；

トラブルシューティングのヒント

インターセプトロジックとアクションセットのロジック

• 値が正確であることを確認します。
• “Is” vs の使用を確認します。”含む”
• および／またはロジックの使用をチェックします。
• 複数の値の中に含まれるスペースに注意します。

改訂履歴

公開済みバージョンが最新 (または予想されるバージョン) であることを確認します。

ウェブサイト／アプリインサイトネットワークリクエストを見る

1. ブラウザで開発者ツールを開きます。
2. のネットワーク要求を確認しますか?Q_ZID など
   • ネットワークリクエストがありません。実装は機能していません。
   • ネットワークリクエスト: 依頼のパラメータの不整合をチェックしてください。タグ管理システムを使用してコードが導入される場合、現在のURLに対するQualtricsのリクエストのパラメーターに悪影響を及ぼすケースがあります。
   • ネットワークリクエストにエラーがあります。プロジェクトが有効化されているかどうかを確認してください。

他のハングしているスクリプト要求の検索は SAP のスクリプトに干渉する可能性がある

1. ブラウザーの任意の場所を右クリックします。
2. ［要素を検査］を選択します。
3. ［コンソール］（エラーが表示される場所）を選択します。

FAQ