ウェブサイト／アプリのインサイトに埋め込まれたデータ

ウェブサイト／アプリのインサイトにおける埋め込みデータについて

ウェブサイト／アプリのインサイトで追跡できる情報は、ターゲットウェブサイトまたはターゲットアンケートに送信することもできます。たとえば、ターゲットが Web サイトの満足度調査である場合、参加者が Web サイトにアクセスした時間やアクセスしたページ数に関する情報を保存することを選択できます。この情報はインターセプトやクリエイティブ自体には保存されず、ウェブサイトやアンケートに渡されます。埋め込みデータを設定

することで、アンケートまたはサイトに情報を渡すことができます。埋め込みデータは、任意の値に名前を付けて設定できるカスタム変数です。たとえば、米国、カナダ、アイルランドなどの値を持つことができる Location という名前の埋め込みデータがあるとします。

埋め込みデータはいつキャプチャされるのか？

デフォルトでは、埋め込みデータはアンケートが回答者に表示される直前に取得されます。

しかし、ある種のクリエイティブなタイプやコンフィギュレーションは、この動作を変化させる：

• ［フィードバック］ボタン: 埋め込みデータは、サイト訪問者によってフィードバックボタンがクリックされたときに収集されます。
• レスポンシブなダイアログ:アンケートを直接ダイアログに表示」オプションは、埋め込みデータの収集方法を変更します：
  • 有効にすると、アンケートがクリエイティブに直接埋め込まれ、クリエイティブが読み込まれると同時に埋め込まれたデータが取り込まれます。
  • 無効にすると、アンケートのための新しいウィンドウを開くボタンが表示され、この新しいウィンドウがロードされたときにデータが取り込まれます。
• クリエイティブターゲット：カスタム埋め込みフィードバック、ポップオーバークリエイティブ、ポップアンダークリエイティブ、スライダークリエイティブ、インフォバークリエイティブでは、クリエイティブターゲットが埋め込みデータの収集方法を制御します：
  • アンケートの埋め込み：アンケートをクリエイティブに埋め込むと、クリエイティブが表示されると同時に埋め込まれたデータが取得されます。
  • リンクされたアンケート：リンクやボタンでアンケートを開くと、リンクやボタンがクリックされたときに埋め込みデータが取得されます。
    ヒント:ポップアンダークリエイティブの場合、アンケートセッションがページ変更またはサイト終了時に開始されると、埋め込みデータはポップアンダーウィンドウが開く前に取得されます。
• テンプレート化されたe寝台のフィードバック:テンプレート化された埋め込みフィードバッククリエイティブの最初の質問が送信されるとすぐに、埋め込みデータが取り込まれます。たとえば、「役に立ちましたか」という質問に続いて自由形式の入力質問をする埋め込みフィードバッククリエイティブでは、ユーザーが最初の質問に対して「はい」または「いいえ」をクリックすると、埋め込みデータがキャプチャされます。

アンケートを開いた後の埋め込みデータの更新

一部のクリエイティブでは、アンケートが公開されている間にウェブサイトが更新されると、埋め込みデータが継続的に更新されます。たとえば、アンケートが新しいウィンドウで開くようにインターセプトがトリガーされ、サイト訪問者がサイトの新しいページに移動した場合、その開いているアンケートセッションに関連付けられている埋め込みデータは、その新しいページを反映するように更新されます。

さらに、エンベデッドデータを収集する方法はインターセプトだけではない。埋め込まれたデータ値は、以下の順序で収集される：

1. インターセプトの埋め込みデータが最初に収集される。インターセプトのクリエイティブに応じた具体的な情報については、「エンベデッドデータはいつキャプチャされるのか」のセクションを参照のこと。
2. アンケート回答が送信された後、アンケートフロー組み込みデータが収集される。詳細については「埋め込みデータ」を参照してください。
3. インターセプトがXM Directoryとリンクしており、連絡先がすでにディレクトリに存在する場合は、XM Directory埋め込みデータが最後に適用されます。

この3つのステップで同じデータキーが埋め込まれている場合は、最後に収集された値がアンケートの回答に記録されます。たとえば、「customerId」というフィールドがインターセプト、アンケートフロー、XM Directoryによって設定されている場合、XM Directoryの連絡先の値がアンケートの回答の「customerId」に保存されます。

埋め込みデータの設定

通常、インターセプトの個々のアクションに埋め込みデータを指定します。たとえば、2 つの異なるアクションセットをランダム化するとします。ある処理で、「条件」という埋め込みデータフィールドを値「バージョン 1」で追加し、別の処理で「条件」という埋め込みデータフィールドを値「バージョン 2」で追加することができます。

任意のアクションで埋め込みデータを設定する

1. 任意のアクションで、オプションをクリックします。
   
2. ［埋め込みデータ］を選択します。
3. 最初の埋め込みデータフィールドの名前を入力します。
   
4. 値タイプを選択します。
   ヒント：［静的値］は、このアクションを受け取る訪問者ごとに埋め込みデータフィールドの値が同じになることを意味します（たとえば、値が 1 の 1 つのアクション「条件」と値 2 の「条件」を割り当てる）。その他の埋め込みデータ値オプションは動的です。つまり、特定の訪問者に応じて調整が行われます（例：クリエイティブを見た際に訪問者が閲覧していたページ）。
5. フィールドが提供されている場合は、埋め込みデータの値を入力します。
   
6. 埋め込みデータフィールドを追加する場合は、最初のフィールドの右側にあるプラス（+）記号をクリックして、手順4～6を繰り返します。
7. ［保存］をクリックします。

複数の埋め込みデータフィールド

埋め込みデータの保存には 20KB の制限があります。特定のフィールド (記録済みサイト履歴など) では、他のフィールドよりも多くのスペースが使用されます。埋め込みデータフィールドをすべてターゲット Web サイトに送信する十分なスペースがない場合は、リストの上部にあるフィールドに優先順位が付けられます。

埋め込みデータフィールドの優先順位を設定するには、フィールドの左側にあるドットをクリックし、項目を一覧の上下に移動するだけです。

埋め込みデータをクリエイティブに設定

上記のステップは、特定のアクションの埋込データを保存する方法を説明しています。ただし、与えられたクリエイティブを使用するすべてのアクションに同じ埋め込みデータを持つようにする場合は、クリエイティブ自体に埋め込みデータを設定することもできます。手順は同じですが、埋め込みデータメニューは、クリエイティブのターゲットを右クリックし、上のツールバーにあるドロップダウン矢印をクリックし、［埋め込みデータ］を選択すると表示されます。

これは、クリエイティブの［編集］セクションにもあります。

JavaScript を使用した複数ターゲットの埋め込みデータの設定

クリエイティブ内の複数の画像またはターゲットに埋め込みデータ値を設定したい場合がありますが、埋め込みデータフィールドはクリエイティブ内に複数のターゲットを持つことができません。情報をキャプチャして渡すには、JavaScript を使用して、それぞれが独自の値を持つ複数の埋め込みデータフィールドを作成します。

<div onclick="window._qLastClicked = 'Happy';">

埋め込みデータを渡したり、インターセプトを表示するためのターゲット条件を選択する際に最も柔軟性を持たせるために、QualtricsはJavaScript式のためのブラウザ組み込みのeval機能を活用しています。サイトのセキュリティポリシーがevalの使用を許可していない場合、ブラウザのコンソールに「Refused to evaluate a string as JavaScript because ‘unsafe-eval’ is not an allowed source of script in the following Content Security Policy directive」のようなエラーが表示されることがあります。

このエラーが表示され、サイトのコンテンツセキュリティポリシー設定を更新できない場合は、エンジニアリングチームと協力して、Qualtricsが読み込まれる前に以下のコードブロックを実行する必要があります：

window.QSI = window.QSI || {};
window.QSI.config = window.QSI.config || {};
window.QSI.global = window.QSI.global || {};
window.QSI.config.enableSecureVariables = true;
window.QSI.global.enableJSSanitization = true；

このコードブロックを実行すると、ターゲティング条件と埋め込みデータフィールドでJavaScriptの限られたサブセットを使用できるようになります。このJavaScriptのサブセットでは、ドット（”.”）とブラケット（”[]”）演算子を使った変数アクセスのみが許可されており、関数の実行にまつわるセキュリティ上の懸念を心配することなく、変数のコンテキストを収集することができる。document.querySelector()のような関数呼び出しは使用できません。

埋め込みデータ値タイプ

埋め込みデータの値を設定すると、この埋め込みデータの変数の種類を選択できます。以下に、各タイプの埋め込みデータが取り込む内容と、関連するインターセプト条件を示します。

• 静的: カスタム埋込データを登録し、その値を定義します。
• インターセプト ID: インターセプトの内部 ID を取得します。このIDを使用して、同じサイト/アンケートにリンクしているインターセプトが複数ある場合に、訪問者が参照したインターセプトを確認できます。
• クリエイティブID：クリエイティブの内部IDを取得します。このIDは、同じサイト／アンケートにリンクしているクリエイティブが複数ある場合に、訪問者がどのクリエイティブを見たかを確認するために使用できます。
• 記録済みサイト履歴：ページ上にプロジェクトコードがある訪問者が訪問したすべてのサイトをキャプチャします。この情報は、Web サイト/App Insights によってブラウザに配置されるクッキーに保存されます。
  ヒント：記録された履歴の数は、このCookieに設定された制限に依存します。この制限は、[管理] ページで設定されます。
• イベントトラッキング:イベントトラッキングを設定することができます。
• Adobe Analytics:Adobe Analytics を参照してください。
• Adobe Experience ID:Adobe Analytics を参照してください。
• 一意のアクセスページ数: これにより、ユーザーがサイト上でアクセスしたさまざまなページの数を取得します。たとえば、同じページに 2 回アクセスすると、1 ページとしてカウントされます。ページカウント条件を参照してください。
• 合計アクセスページ数: これにより、ユーザーがサイト上でアクセスした合計ページ数が取得されます。ページカウント条件を参照してください。
• サイトに費やされた時間：現地で費やされた時間には、サイトに費やされた時間とサイトに集中した時間という 2 つのメトリクスが記録されます。「サイトで費やされた時間」は、訪問者が Web サイトをブラウザーウィンドウで開いた時間を指します。Time Focused On Site は、訪問者が Web サイトを前面で開いた時間 (コンピュータ上の “インフォーカス” ウィンドウ) を指します。  サイトに費やされた時間またはサイトに焦点を当てた時間を参照してください。
  ヒント：データでは、［サイトに費やした時間］と［フォーカスした時間］が、縦線で区切られた 2 つの数値として一緒に保存されます。行の左側にある数字は現場で費やされた時間であり、行の右側の数字は勤務地に焦点を当てた時間です。
  
• 現在のページURL：インターセプトが表示されたときに訪問者がオンになっているページ。 現在のページ URLを参照してください。
• HTML on Site: 値を取り込むページ上の HTML を指定します。たとえば、ショッピングカートの要素があり、訪問者のカートにあるアイテムの数を知りたい場合があります。サイトの HTML を参照してください。
• Cookieの値：サイトの特定のCookieから値を取得します。たとえば、誰かがサイトを訪問した前かどうかをキャプチャする return_bister という名前の cookie があるとします。「Cookie条件」を参照してください。
• URL パラメータ: URL にパラメータが追加されている場合は、このオプションを使用して任意のパラメータの値を取得できます。
• URL 正規表現：正規条件式コーディングが取得されます。
  ヒント：正規表現はカスタムコーディング機能です。残念ながら、Qualtricsサポートでは、カスタムコーディングに関するアドバイスを提供できません。ただし、 コミュニティの経験豊かなユーザー（英語） に尋ねてみることは可能です。
• JavaScriptからの値：このオプションでは、サイトからカスタムJavaScriptが取得されます。指定する値は JavaScript 式/呼び出しである必要があります。
  ヒント：JavaScriptはカスタムコーディング機能です。残念ながら、Qualtricsサポートでは、カスタムコーディングに関するアドバイスを提供できません。ただし、 コミュニティの経験豊かなユーザー（英語） に尋ねてみることは可能です。
• ページ参照者：インターセプトを含むページに到達する前に、訪問者が移動していたページです。Page Referrer を参照してください。
• サイト参照者: Web サイトに到着する前に訪問者がアクセスしていた Web サイト。サイト参照者を参照してください。
• 検索語句：Web サイトに届くために検索した訪問者の語句を取得します。検索語句を参照してください。
• Google データレイヤの値: このオプションでは、カスタムの Google データレイヤ変数がサイトから取得されます。Web サイト/アプリインサイトでの Google アナリティクスの使用を参照してください。

クアルトリクスアンケートへの埋め込みデータの保存

ターゲットがクアルトリクスアンケートの場合、ターゲットに送信された埋め込みデータをアンケートロジックで使用できるようになります。追加のアクションは必要ありません。ただし、この埋め込みデータをアンケート結果に保存する場合は、アンケートフローに追加する必要があります。

埋め込みデータのサポートページの手順

に従ってアンケートフローに追加します。項目の値については、パネルまたは URL から値が設定されますのままにします。

埋め込みデータを他のターゲットで使用

ターゲットが Qualtrics 調査でない場合でも、Qualtrics 調査の場合と同様に、埋め込みデータを活用して情報を渡すことができます。埋め込みデータは要求本文（POST メソッド）で渡されます。これにより、複数の埋め込みデータ要素を取得して、表示されるアンケートURLに表示しなくてもQualtrics XMプラットフォームに送信できます。

組み込みデータ収集のテスト

どのような埋め込みデータが収集されたかは、埋め込みデータ値がインターセプトによって収集されると予想されるときに、開発者コンソールでこのスニペットを実行することでテストできます：

window.QSI.EmbeddedData.getEmbeddedData('YOUR_INTERCEPT_ID')。

収集された値が期待したものでなかったり、空であったりする場合、トラブルシューティングは、収集することを期待している埋め込みデータのタイプによって異なります：

1. 静的：静的埋め込みデータフィールドに欠落や誤りがある場合は、最新バージョンのインターセプトを発行する必要があるかもしれません。
2. Googleデータレイヤー：Googleデータレイヤーに埋め込まれているデータフィールドに欠落や誤りがある場合は、データレイヤーの表現が間違っている可能性があります。あるいは、その値は、その後のデータレイヤーの更新によって上書きされた可能性もある。Qualtricsはデータレイヤーの最新の値のみを追跡します。Googleデータレイヤーとインターセプトの統合の詳細については、Google Analyticsとウェブサイト/アプリインサイトの統合を参照してください。
3. JavaScript：不適切なJavaScriptの埋め込みデータフィールドがない場合、表現が間違っている可能性があります。開発チームと協力して、探している変数がテストしているページに存在することを確認してください。

アンケートの回答の埋め込みデータが空または不正確な場合のトラブルシューティング

テスト時には変数が表示されるのに、実際のアンケートの回答には表示されない場合は、Qualtrics がデータを取得するタイミングと、実際にページ上でデータが利用可能になるタイミングに問題がある可能性があります。

以下の手順でトラブルシューティングを行ってください：

1. ページをリロードし、上のセクションのコード・スニペットを使って埋め込みデータをテストしてください。
2. ブラウザのコンソールで次のコードを実行
   します:QSI.API.unload();
QSI
   .API.load().then(QSI.API.run)；
3. アンケートの実施
4. アンケートセッションがインターセプト経由で開始されると、ウェブサイトのネットワークログに HTTPS リクエストが表示されます。このリクエストには、アンケートIDと、インターセプト設定からマッピングされた埋め込みデータが含まれます。このリクエストのペイロードをチェックすることは、セッションが埋め込まれた データで始まったかどうかを確認する助けになる。

正しい値が渡されるようになったのであれば、これはタイミングの問題である可能性が高いので、データ値がページに入力された後にインターセプトをトリガーする必要があります。これは、QSI.APIコールを介して、またはタグマネージャを使用して行うことができます。詳しくはプロジェクト展開コードをご覧ください。

ダッシュボードでのインターセプト埋め込みデータの表示

ウェブとアプリのインサイトをCXダッシュボードに表示できます。このセクションでは、埋め込みデータを読み取り可能な形式で表示する方法の一般的な手順について説明します。

1. インターセプトロジックで、ダッシュボードに表示する埋め込みデータフィールドを追加します。

   ヒント：一般的なフィールドには以下が含まれます：

   • インターセプト ID: インターセプトのIDまたは名前を表示します。
   • クリエイティブID：クリエイティブのIDまたは名前を表示します。
   • JavaScript からの値: JavaScript 式のデータを表示します。
   • Adobe Analytics 変数: Adobe Analytics のカスタム eVars からのデータを表示します。
   • 静的値：インターセプト名、クリエイティブ名、ウェブサイトに関する情報などのカスタム値を渡します。
2. インターセプトに表示されているアンケートに、インターセプトフィールドに一致する埋め込みデータフィールドを追加します。
   
3. アンケートをCXダッシュボードにマッピングし、埋め込みデータフィールドを含めてください。
4. ［インターセプト ID］や［クリエイティブID］などのフィールドを表示する場合、代わりにインターセプトまたはクリエイティブ名が表示されるようにIDを再コードできます。
   例：上の例では、2つの異なるクリエイティブのデータを同じダッシュボードに表示します。個々のクリエイティブのデータをわかりやすく表示するために、クリエイティブIDを埋め込みデータフィールドとして追加し、個々のID値をクリエイティブ名として割り当てました。その後、このフィールドをダッシュボードフィルタとして追加し、ウィジェットで使用することができます。

FAQ