英語からAIを使用して翻訳されました

この記事はAI技術を使用して翻訳されたことにご注意ください。正確性を維持するよう努めていますが、一部の詳細は元のテキストを完全に反映していない場合があります。情報に不明な点がある場合は、英語版を参照してください。

この記事は、ProおよびEnterpriseプランの顧客に適用されます。

カテゴリー: 顧客の声

この統合はWebプロジェクト専用です

期待されること

この統合により、Qualtricsの回答者をQualtricsのフィードバックとの相互作用と応答に基づいてContentsquareでセグメント化することができます。さらに、カスタム属性として添付されたセッションリプレイリンクを探索することで、Qualtricsユーザーの応答をさらに調査できます。

収集するもの

動的変数

キー	値	データ型
FB_QT_Feedback Displayed	調査ID : {surveyID}	テキスト
FB_QT_Feedback Accepted	調査ID : {surveyID}	テキスト
FB_QT_Feedback Submitted	調査ID : {surveyID}	テキスト
FB_QT_Feedback Response ID	{responseID}	テキスト
FB_QT_NPS Rating - {QuestionID} - {SurveyID} - {Question}	{rating}	数値
FB_QT_Star Rating - {QuestionID} - {SurveyID} - {SubQuestion}	{starRating}	数値
FB_QT_{QuestionID} - {SurveyID}	{AnswerID}	テキスト
FB_QT_Feedback Completed	調査ID :{surveyID}	テキスト

人工ページビュー

以下のオプションに対して人工ページビューをトリガーするには、ContentsquareのCSMまたはサポートに依頼して、これらを送信できる機能を有効にする必要があります。これはContentsquareアプリケーションのジャーニー分析モジュールでの使用専用です。

トリガー	クエリ文字列
フィードバック承認	cs_qualtrics=feedback_accepted_{surveyID}
フィードバック提出	cs_qualtrics=feedback_submitted_{surveyID}
フィードバック完了	cs_qualtrics=feedback_completed_{surveyID}

送信するもの

セッションリプレイ

リプレイ機能を適切に利用するには、100%の収集比率またはETR（イベントトリガーリプレイ）が必要です。この件についてはCSMに相談してください。

制限事項

一般

WebKitの公式ポリシーであるITP（インテリジェントトラッキング防止）およびFirefoxの強化トラッキング防止により、特定のブラウザはデフォルトでiframe内のサードパーティクッキーをブロックします。 調査がiframe内に表示される場合、デフォルトでは以下のブラウザまたはブラウザモードをサポートできません:
Safari 12+
Chrome 83+（シークレットモードのみ）
Firefox 67+（プライベートブラウジングモードのみ）

解決策は、Contentsquareプロジェクト設定でゾーニングのためのiFramesトラッキングを有効化することです。この件についてはCSMまたはサポートに相談してください。

調査がウィンドウポップアップまたは新しいタブにある場合、上記は適用されません。

Qualtrics

調査に新しい「シンプル」レイアウトを使用している場合、評価やその他の質問/回答データをContentsquareに送信することはサポートされません。他のすべての機能はサポートされています。このデータをすべてContentsquareに送信したい場合は、「フラット」または「モダン」などの他のレイアウトオプションに戻す必要があります。これはQualtricsの制限です。

また、いつでもシンプルレイアウトに切り替えた場合、調査フロー内の埋め込まれたデータ項目の名前を __js_ContentsquareReplayLinkに変更する必要があります。

埋め込まれた調査

埋め込まれたフィードバック調査はサポートされていません。

実装

実装手順

この統合を有効にするには2つのステップがあります:

ステップ 1

次のセクションに移動してください統合のリクエスト方法を参照して、この統合を有効化するための指示を確認してください。完了したら、ここに戻ることができます。

必ず、qualtrics.com ドメインがあなたのアカウントでCSMによってホワイトリストに追加されるようリクエストしてください。

上記のステップをすでに完了している場合は、以下を継続してください。

ステップ 2

埋め込みデータの設定

新しいインターセプト構成フローを使用しているか、古いものを使用しているかによって、以下の関連情報を参照してください。

古いフローの場合：

この統合を有効化するには、Qualtricsのウェブサイトアプリ & フィードバックセクションに移動してください：

インターセプトに移動します

関連する調査を選択し、次に埋め込みデータボタンをクリックします

次のように新しい埋め込みデータオブジェクトを定義します：

CSID | Javascriptからの値 | sessionStorage.getItem("CSID")

保存を押して、変更を公開します。

新しいフローの場合：

これが新しいインターセプトである場合、構成でこれが表示されるかもしれません。埋め込みデータを追加を押してください：

または、すでにインターセプトが設定されている場合は、ここで単に編集してください：

すでに埋め込みデータが定義されている場合は、プラス記号を押してください：

次のように値を挿入します：

Javascriptからの値 | sessionStorage.getItem("CSID") | CSID

Contentsquareタグの設定

追跡したい調査に移動してください。

次に、ルック & フィールセクションをクリックし、次に一般をクリックし、ヘッダーの下の編集ボタンをクリックします。

このセクションにすでにコンテンツがあるかもしれませんが、ソースアイコンをクリックする必要があります。

そこに入ったら、すでにコンテンツがあるかどうかに応じて、HTML/Javascriptコードのスニペットをどこかに追加する必要があります。最上部または最下部に追加するのが最適です。

以下がContentsquareタグですが、CSサポートにCSタグIDを問い合わせる必要があります。すでに持っている場合は、以下を続けてください。

以下のコードをコピーし、REPLACE_WITH_TAG_IDと書かれたコードの関連セクションにあなたのContentsquareタグIDを挿入してください。タグIDの後に.jsを保持してください。

<script>
Qualtrics.SurveyEngine.addOnReady(function () {
    (function () {
        if (!window.CS_CONF){
           window._cs_integration_qualtrics_csid = "${e://Field/CSID}";
		     
           var mt = document.createElement("script");
           mt.type = "text/javascript";
           mt.async = true;
           mt.src = "https://t.contentsquare.net/uxa/REPLACE_WITH_TAG_ID.js";
           document.getElementsByTagName("head")[0].appendChild(mt);
        }
    })();
});
</script>

次に、ヘッダーHTMLセクション内に完全なコードを貼り付けます。

コードを追加した後、次のようになります：

それを保存して、変更を適用してください。

これらの変更をQualtricsで公開することを忘れないでください。そうしないと、追加したスクリプトは本番環境に反映されません。

Contentsquareリプレイリンクの設定

ユーザー調査のフローに移動します:

使用するユーザー調査のレイアウトによって、ここに追加する名前が決まります。

非シンプルレイアウトのユーザー調査を使用する場合は、新しい埋め込みデータ項目を追加します。名前は ContentsquareReplayLink のようにします:

ただし、シンプルレイアウトのユーザー調査を使用する場合は、新しい埋め込みデータ項目を追加します。名前は__js_ContentsquareReplayLinkのようにします:

保存して、公開します。

ユーザー調査からのカスタム動的変数の送信

ユーザー調査のコンテキストから独自のキー/値ペアでカスタム動的変数を送信したい場合は、以下のコードをコピーして編集し、関連するユーザー調査の質問に貼り付けるだけです。複数の質問に追加できますが、各キーがユニークであることを確認してください。

編集が必要なのは、コード内の2つの変数の文字列値だけです:
var csKey
var csValue

window._uxa = window._uxa || [];
_uxa.push([
    "afterPageView",
    function (context) {
        if (typeof window.CustomEvent === "function") {
            var csKey = "";
            var csValue = "";

            if (csKey && csValue) {
                var evt = new window.CustomEvent("Contentsquare_QT_Integration_Dispatcher", {
                    detail: {
                        key: csKey,
                        value: csValue,
                    },
                });
                window.dispatchEvent(evt);
            }
        }
    },
]);

次に、関連する質問のJavaScriptセクションを開き、そこにコードを貼り付けます:

必ずQualtrics.SurveyEngine.addOnReady関数に追加してください。

その後、次のようになりますが、独自のカスタムキーと値の文字列を使用します。キーと値は、以下の値の例に示すように、コードを使用して動的に生成することもできます。ユーザー調査IDを動的に取得し、それを値として設定しています(Page.runtime.ED.SurveyID)。ここでは文字列値のみを受け入れることに注意してください。キーの最大長は50文字、値の最大長は255文字です。

新しい「シンプル」レイアウトのユーザー調査を使用している場合、ユーザー調査IDを取得するには、次のようにします(window.q.appData.setup.survey.id)。上記の内容の代わりに使用してください。

ページビューごとに50の動的変数の制限があることに注意してください。すでにその近くまで送信している場合は、作成した追加の変数を受信できない可能性があります。追加する前に、全体のユーザー調査から送信されている数を確認するのが最善です。

動作確認

Chrome拡張機能を使用して、結果がCSに送信されているか確認できます。

Qualtricsアカウントでは、十分な収集比率が設定されている場合、リプレイリンクを見ることができます。

比率が低すぎる場合は、CSMに相談してください。

ヘルプセンターの結果

技術文書

このセクションの記事

クアルトリクス