Customer Experience
Employee Experience
Brand Experience
Core XM
Design XM

XM Directoryとデジタルインターセプトのインテグレーション

デジタルインターセプトとのXM Directoryインテグレーションについて

注意：この機能を使用するには、クアルトリクスブランドが新しいXM Directoryインフラストラクチャーに含まれている必要があり、ウェブサイト／アプリのインサイトへのアクセス権も必要です。ブランドのステータスを確認してこの機能をリクエストするには、XMサクセスマネージャーにお問い合わせください。

XM Directoryを使用すると、顧客および見込顧客の豊富なプロファイルを含む独自の社内パネルを作成できます。組織全体の連絡先ディレクトリを持つことで、組織における連絡先の多くのタッチポイントのプロファイルを表示できるため、ブランドでのエクスペリエンスに関するインサイトをこれまで以上に簡単に見つけることができます。

ウェブサイト／アプリのインサイトをXM Directoryと統合すると、XM Directoryのメリットをウェブサイトの訪問者と活用できます。オムニチャネルの連絡頻度を設定し、ウェブサイトの訪問者がウェブインターセプトをすでに受信している場合はメール招待を受信しないように設定できます。逆の場合も同様です。また、ウェブサイトとアプリのインターセプトの表示をユーザーの特定のセグメントに合わせて設定したり、セグメント固有のインサイトやコース固有のインサイトを取得したりすることもできます。

この機能を使用するには、
にアクセスする必要があります。

XM Directoryにアクセスします。
ウェブサイト／モバイルからのフィードバックへのアクセス。
いずれかのディレクトリ内の連絡先またはセグメント。

統合の設定

XM Directory

ウェブサイトのインターセプトとのインテグレーションでは、既存のXM Directory設定が使用されます。ディレクトリをまだ設定していない場合は、「XM Directoryの開始」を参照してください。

統合を最大限に活用するには、以下のベストプラクティスに従ってください。

連絡先を常に最新の状態に保ちます。これにより、ウェブサイト訪問者が既存の連絡先か、新しい訪問者かを区別できます。
例：連絡先のインポートの自動化を設定して、XM Directoryを顧客リストと同期させるか、開発チームと協力して、新しい連絡先を作成し、連絡先APIコールを更新して連絡先を作成します。
重複した連絡先を自動的に結合します。マージできるのは、新規登録されたコンタクト、または既存のすべてのコンタクトのみです。詳細については、XM Directoryでの重複連絡先のマージを参照してください。
ヒント：［外部データ参照］フィールドに基づいて連絡先を結合し、各連絡先の値が一意であることを確認します。

ヒント：これらの各連絡先には、指定された参照ID（ExternalDataReference）フィールドが必要です。この値は、ウェブサイトの訪問者がログインセッション内で利用できる必要があり、インターセプトを表示するかどうかを決定するために使用されます。

インターセプト

注意：以下の文書を導入するには、プログラミングの知識が必要です。この情報は、デプロイメントコードを実装するチームに渡すことをお奨めします。クアルトリクスサポートチームでは、カスタムコーディングに関するサポートやコンサルティングは提供していません。ただし、コミュニティの経験豊かなユーザー（英語）に尋ねてみることは可能です。カスタムコーディングサービスの詳細については、クアルトリクスの営業担当にお問い合わせください。

ウェブサイト／アプリインサイトプロジェクトからXM Directoryのメリットにアクセスするには、まずクアルトリクスがウェブサイトの閲覧者を把握し、その情報と既存の連絡先をマッチングできるようにする必要があります。これを行うには、ユーザのログインセッションで評価される JavaScript 式を指定して、コンタクトの外部参照 ID を取得する必要があります。

注意：XM Directoryとデジタルインターセプトの統合は、連絡先が一意の場合に最適に機能します。各ユーザーに関連付ける値は一意であり、すべての Web サイトの連絡先を特定する必要があります。コンタクトの重複を多く回避するには、不明値に対してプレースホルダ値を入力せず、テストでは静的値のみを使用します。

例：サイトにJavaScript、Cookie、HTMLを使用して外部参照IDフィールドを保存すると、XM Directoryに保存されている外部参照IDに基づいて各訪問者をマッチングできます。

次に、訪問者に関する情報をQualtricsに渡す必要があります。Web サイトを使用している場合とモバイルアプリを使用している場合は手順が異なります。

ウェブサイトを使用している場合は、プロジェクトデプロイコードに加えて、ウェブ開発チームと協力して以下のコードスニペットをウェブサイトに追加します。このスニペットは、ユーザーの externalReference IDをクアルトリクスに渡して、ウェブサイト訪問者をXM Directoryの連絡先に関連付けます。このコードスニペットをページのロード時に配置し、ID の値がすでに取得されていることを確認します。

コードスニペットを表示するには、ここをクリックします。

if(typeof QSI === "undefined") {

     QSI = {};

     QSI.config = {

       externalReference: extRef

     };

 }

注意: externalReference ID を設定するためのコードスニペットは、サイトコード内のプロジェクト展開コード JavaScript の上にある必要があります。

注意:extRef の代わりに、適切な外部参照 ID を取得するために評価する必要がある JavaScript 式 (例: “UserID”) を指定してください。この式は、JavaScript 変数や、特定のクッキーを評価する JavaScript 式と同じくらい単純です。

モバイルアプリを使用している場合は、モバイルアプリ開発チームと協力して、最新バージョンのクアルトリクスモバイルアプリSDKと統合してください。詳細については、API 文書を参照してください。

ヒント：エンドユーザーが現在XM Directoryにない外部参照IDでサイトにログオンした場合（このユーザーのレコードがまだXM Directoryにありません）、このユーザーにはインターセプトが表示されません。［自動連絡先作成］を使用してこのユーザーをディレクトリに追加できます。

XM Directoryにリンク

XM Directoryにリンクを使用すると、インターセプトとXM Directoryのディレクトリの1つ間のリンクを設定できます。このオプションを選択すると、ユーザーの連絡先埋め込みデータがアンケートの回答に自動的に追加されます。詳細については、「XM Directoryでの埋め込みデータの使用」を参照してください。さらに、訪問者のXM Directoryタッチポイントのタイムライン内のイベントは、インターセプトが表示されるたびに作成されます。

単一のディレクトリの使用

プロジェクトごとに 1 つのディレクトリにリンクすることをお奨めします。これにより、特に同じ連絡先が異なるディレクトリで頻度ルールが異なる場合に、連絡頻度ルールに問題がないようにすることができます。また、すべてのデジタルタッチポイントを 1 つの場所に集約し、整理および更新します。

インターセプトを1つのディレクトリに移動するには、まずインターセプトに接続するディレクトリを選択します。そのディレクトリに現在リンクされているインターセプトを編集する必要はありません。他のディレクトリにリンクされたインターセプトについては、［インターセプトオプション］に移動し、［XMDとリンク］の選択を解除します。このインターセプトを今後使用するディレクトリにリンクすることもできます。

ヒント：ガイド付きインターセプトについては、［オプション］ではなく、［頻度とXM Directoryを表示］に移動します。

注意：2024年初頭から、ウェブサイトインサイトプロジェクトではプロジェクト内で1つのディレクトリのみを選択する必要があります。

自動コンタクト登録

注意：APIを使用して連絡先情報をディレクトリに送信するには、ウェブサイトの開発チームと協力してコードを追加する必要があります。詳細については、ディレクトリの連絡先の作成またはメーリングリストへの連絡先の作成に関する API ドキュメントを参照してください。

XM Directoryの連絡先は、ユーザーがクアルトリクスプロジェクトのデプロイコードを含むウェブページにアクセスするたびに登録できます。このオプションにより、インターセプトの評価時に連絡先を自動的に追加できるため、手動のファイルアップロードや SFTP ベースの自動化が不要になります。

ヒント：連絡先を作成するためにインターセプトを表示する必要はありません。デプロイコードはページで実行するだけでかまいません。詳細については、ページビューを参照してください。

連絡先の自動作成を有効にするには、最初にインターセプトをXM Directoryにリンクする必要があります。次に、［連絡先がまだ存在しない場合は、XM ディレクトリーに自動的に作成します］というオプションの横にあるチェックマークをクリックします。

連絡先ごとに次の情報を追加できます:

名
姓
言語
追加のキー値ペア (例:”Location”:”Seattle”,”Gender”:”Female”)。最大 200 のペア
を追加できます

ヒント：クアルトリクスは、初めてデプロイコードがロードされたときに連絡先を作成します。以降のすべてのページでは、XM Directoryの既知のユーザーとしてカウントされます。

ヒント：その他のXM Directory機能（セグメントターゲティングや連絡頻度ルールなど）は、連絡先プロファイルが作成されたページ読み込みでは機能しません。連絡先が作成されると、後続のインターセプトで連絡先の頻度とセグメントターゲティングルールが評価されます。

インターセプトの連絡頻度ルールの設定

ヒント：この機能を使用して実際の動作を確認するためのビデオデモについては、Qualtricsコミュニティでこの投稿をご覧ください。

注意：すべてのクライアントで適切なサービスレベルを維持するため、予想外に大きな急増が発生した場合にまれにクアルトリクスがサーバーへのトラフィックを制限する場合があります。

連絡頻度ルールを設定して、インターセプトの表示頻度を制限できます。一般的なディレクトリルールと、特定のアンケートのカスタムルールを使用できます。受動的なフィードバックのインターセプトなど、多くのデバイスまたはブラウザーで見られる可能性があるアンケートでは、連絡頻度を使用しないことをお勧めします。

注意: 現時点では、リストに適用されるカスタムルールはサポートされていません。同じページの複数のインターセプトがリスト（同じディレクトリまたは異なるディレクトリ）に基づいてXMディレクトリルールを使用する場合、それらのインターセプトのうち1つのみが表示されます。表示されたインターセプトは最も古いものです。

既存のウェブサイト／モバイルからのフィードバックプロジェクトを開くか、新しいプロジェクトを作成します。
既存のインターセプトの1つを開くか、新しいインターセプトを作成します。
頻度表示オプションとXM Directoryオプションを編集します。
XM Directoryとのリンクを有効にします。

ヒント：このオプションを選択すると、このアンケートに回答するユーザーの連絡先埋め込みデータが自動的にアンケートの回答に追加されます。「XM Directoryでの埋め込みデータの使用」を参照してください
ディレクトリを選択します。
コンタクト頻度ルールを有効化し、コンタクトが保存されるディレクトリを選択します。
変更内容を保存します。
次のステップは、この機能を Web サイトまたはモバイルアプリのどちらで実装するかによって異なります。
- Web サイト：インターセプトを起動するウェブサイトで、ユーザーのログインセッションで評価されるJavaScript式を指定して、連絡先の外部参照IDを取得します。この外部参照IDは、XM Directoryで訪問者を検索し、インターセプトを見たかどうかを追跡するために使用されます。
- アプリ: インターセプトを起動するアプリで、参照 ID を取得するためにモバイルアプリ SDK を更新する必要があります。API 文書を参照してください。

ヒント：照会IDを取得しない場合、インターセプトは連絡頻度ルールが有効でないように動作します。ディレクトリ内のどのIDにも一致しない参照IDを取得した場合、インターセプトは表示されません。

インターセプトターゲット設定のセグメントの設定

注意: セグメントを作成および編集できるのは、ディレクトリの管理権限が有効になっているユーザーのみです。連絡先へのアクセス権限を持つすべてのユーザーが既存のセグメントに配信できます。

XM Directoryにセグメントを作成すると、メーリングリストやサンプルと同じ多くの場所（ウェブサイト／アプリのインサイトを含む）でクアルトリクス全体で使用できます。XM Directoryとウェブサイト／アプリのインサイトを組み合わせることで、ウェブサイトとアプリのインターセプトの表示対象をユーザーの特定のセグメントに設定したり、セグメントやコース固有のインサイトを取得したりできます。

ヒント：インターセプトがウェブサイトの訪問者に表示される場合、このタッチポイントはXM Directoryのタッチポイントタイムラインにも表示されます。

例：ディレクトリからオプトアウトした連絡先には追加のメールが表示されませんが、インターセプトが表示される場合があります。オプトアウトしたユーザーにインターセプトが表示されないようにするには、セグメント条件を設定する際にオプトアウトステータスを使用し、セグメントターゲティングロジックを使用します。

の作成 インターセプト 既存または新規のウェブサイト／モバイルからのフィードバックプロジェクト。
ヒント：スタンドアロンのインターセプトを作成する代わりに、プロセス全体を通じてサポートが必要な場合は、ウェブサイト／アプリのフィードバックプロジェクトに関するガイド付き設定を自由に使用してください。ガイド付き設定を使用する場合、クリエイティブの追加、アンケートの接続、インターセプトの設定を求められます。ガイド付き設定の詳細については、フィードバックの収集方法の選択を参照してください。
インターセプトオプションに移動します。

ヒント：モバイルアプリのインターセプトでも手順は同じですが、インターセプトオプションが少なくなります。
有効化 “XM Directoryにリンク” を、チェックボックスを選択して実行します。
セグメントを含むディレクトリを選択します。
インターセプトエディターに戻り、XM Directoryセグメントを含むターゲットロジックを追加します。
例：XM Directoryセグメントは高価値ユーザーです。

ヒント：ウェブサイトのインターセプトでは、セグメント内の連絡先とセグメントにない連絡先の両方で、ブックマークレットを使用してインターセプトをテストできます。テスト中、Qualtricsが連絡先を特定できるように、ブラウザー内の外部参照IDの設定を模倣する必要があります。
次のステップは、この機能を Web サイトまたはモバイルアプリのどちらで実装するかによって異なります。
- Web サイト：インターセプトを起動するウェブサイトで、ユーザーのログインセッションで評価されるJavaScript式を指定して、連絡先の外部参照IDを取得します。この外部参照IDは、XM Directoryで訪問者を検索し、インターセプトを見たかどうかを追跡するために使用されます。JavaScript 式の詳細については、上記のセクションを参照してください。
- アプリ: インターセプトを起動するアプリで、参照 ID を取得するためにモバイルアプリ SDK を更新する必要があります。API 文書を参照してください。

XM Directoryとウェブサイトのインターセプトのインテグレーションのテスト

ウェブサイトでインターセプトを開始する前に、接触頻度、セグメントターゲティング、または連絡先作成が正しく実装されていることを確認するためにテストする必要があります。

実際のデプロイメントでは、サイト訪問者の外部参照 ID は、ログに記録されるセッションのコンテキストで JavaScript 式またはクッキーを介して利用可能になります。

以下のステップで、テストデータおよび Web ブラウザの回避方法を使用してエンドツーエンドシナリオを実行することができます。

テスト連絡頻度

XM Directoryで新しい連絡先を作成し、その連絡先の一意の参照IDを指定します。
例: 例として、参照 ID として aaa123 を使用します。これらのステップで ID 番号を確認した場合は、常に指定した参照 ID に置き換えてください。
［インターセプトターゲティング用のセグメントの設定］セクションのステップに従い、セグメントターゲティングに従うようにインターセプトを設定します。
にジャンプ インターセプトをテスト.
ブックマークレットをブラウザのブックマークバーにドラッグします。
テストに使用する Web ページに移動します。
開発者コンソールに移動します。Web ブラウザに応じて、アクセス方法が異なります。
- Google Chrome: Chrome メニューバーで、View → Developer → Developer Tools に移動します。表示されるウィンドウで、コンソールに移動します。
- Apple Safari: Safari の開発メニューが有効になっていることを確認します。これを行うには、メニューバーで Preferences → Advanced → Show Develop メニューに移動します。Safari メニューの [Develop] をクリックし、[Web Inspector の表示] を選択します。表示されるウィンドウで、コンソールに移動します。
- Mozilla Firefox: メニューアイコンをクリックし、[Web Developer] を選択します。Web 開発者メニューで、コンソールを選択します。
- Microsoft Edge: メニューバーで、Tools → Developer → Developer Tools に移動します。開いたウィンドウで、コンソールに移動します。
- Internet Explorer: 歯車アイコンをクリックして、開発者ツールを選択します。開いたウィンドウで、コンソールに移動します。
[コンソール] メニューで、この式を入力して Enter キーを押します。
UserID="aaa123"

ヒント：aaa123は参照IDの値の例で、手順1で連絡先に割り当てた値に置き換える必要があります。
以下の JavaScript スニペットをペーストして、externalReference JavaScript 変数を JavaScript 式として設定します。
```
if(typeof QSI === "undefined") {
     QSI = {};
     QSI.config = {
         externalReference: UserID
     };
 }
```
Enter を押します。
ブックマークレットをクリックすると、セグメントの対象が適切なものとなり、インターセプトを表示すべきかどうかが判断されます。
ヒント：セキュリティ上の理由から、セグメントを含むターゲットロジック行にはセグメントIDのみが含まれます。セグメントIDをセグメント名に一致させるには、XM Directoryに移動してセグメントを編集します。URL にはセグメント ID が含まれます。これは、以下の URL の例で太字になっています。https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34k

追加のテストのためにこれらのステップを繰り返すには、テスト間で以下を実行してください。

ブラウザを毎回リフレッシュします。
コンソール内で JavaScript 式を設定します。
ブックマークレットを再度実行します。
XM Directoryに移動し、入力値で連絡先が作成されていることを確認します。

テストコンタクト登録

既存のインターセプトの1つを開くか、ウェブサイト／アプリのフィードバックプロジェクト内で新しいインターセプトを作成します。
頻度表示オプションとXM Directoryオプションを編集します。
XM Directoryとのリンクを有効にします。
ドロップダウンリストからディレクトリを選択します。
連絡先がまだ存在しない場合は、XM Directoryで自動的に作成します。の横にあるチェックボックスをクリックします。
［保存］をクリックします。
［インターセプトをプレビュー］をクリックします。
ブックマークレットをブラウザのブックマークバーにドラッグします。
テストに使用する Web ページに移動します。
開発者コンソールに移動します。Web ブラウザに応じて、アクセス方法が異なります。
- Google Chrome: Chrome メニューバーで、View → Developer → Developer Tools に移動します。表示されるウィンドウで、コンソールに移動します。
- Apple Safari: Safari の開発メニューが有効になっていることを確認します。これを行うには、メニューバーで Preferences → Advanced → Show Develop メニューに移動します。Safari メニューの [Develop] をクリックし、[Web Inspector の表示] を選択します。表示されるウィンドウで、コンソールに移動します。
- Mozilla Firefox: メニューアイコンをクリックし、[Web Developer] を選択します。Web 開発者メニューで、コンソールを選択します。
- Microsoft Edge: メニューバーで、Tools → Developer → Developer Tools に移動します。開いたウィンドウで、コンソールに移動します。
- Internet Explorer: 歯車アイコンをクリックして、開発者ツールを選択します。開いたウィンドウで、コンソールに移動します。
［コンソール］メニューで、この式をXM Directoryの連絡先値の例とともに入力して、Enterを押します。
```
QSI = {config: {externalReference:"test123", contactEmbeddedData: {"Location":"Seattle"}, language:"English", firstName:"Jane", lastName:"Smith"}}
```
ヒント：この式の値は、テスト連絡先のXM Directoryプロファイルに追加される連絡先値の例です。これらの値は任意の値に変更することができます。

注意: 安全性の高い Web インターセプトを保持するため、電子メールアドレスはプロファイル属性としてサポートされていません。電子メールアドレスは、ディレクトリから、またはファイルアップロードおよび SFTP 自動化によってマニュアルで追加することができます。
ブックマークレットをクリックすると、インターセプトが表示されます。
ヒント：連絡先の作成が機能するために、インターセプトを表示する必要はありません。ページ上で評価する必要があります。

ヒント：セグメントターゲット設定や連絡頻度ルールなど、その他のXM Directory機能は、連絡先プロファイルが作成されたものと同じページロードの一部として機能しません。ただし、コンタクトが登録されると、後続のインターセプトによってコンタクト頻度およびセグメントターゲットルールが評価されます。
ステップ3のドロップダウンで示されたXM Directoryに移動し、連絡先がステップ9で入力した値で作成されていることを確認します。

ヒント：ウェブサイトのインターセプトでは、セグメント内の連絡先とセグメントにない連絡先の両方で、ブックマークレットを使用してインターセプトをテストできます。テスト中、Qualtricsが連絡先を特定できるように、ブラウザー内の外部参照IDの設定を模倣する必要があります。

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

新しいユーザーがセグメントに追加されましたが、セグメントを対象にしたインターセプトが表示されません。

セグメントはXM Directoryで毎日再構築されます。そのため、新規ユーザがセグメントのメンバーとしてまだ考慮されていない可能性があります。

インターセプトデバッガウィンドウには、セグメント名は表示されません。

セキュリティ上の理由から、デバッガウィンドウには、セグメントを含むターゲットロジックに対してセグメント名が表示されません。セグメント ID が表示されます。セグメント ID をセグメント名にマッピングするには、XM Directoryでセグメントを編集し、URLを確認します。URLには、サンプルURLで強調表示されているセグメントIDがあります。https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34kAlternately

、インターセプトを直接開き、ターゲットを絞ったロジックを調べて、ターゲットとするセグメントを確認できます。

インターセプトの初回表示が遅い。

パフォーマンス上の理由から、セグメントメンバーシップは一時的にインメモリに格納され、必要な場合にのみ更新されます。ユーザーが一時記憶領域にまだ入っていない場合、そのユーザーのインターセプトの初回表示には少し時間がかかる場合があります。