ホロス・インバウンド・コネクター
Khoros Inbound Connectorについて
Khorosインバウンドコネクタを使用して、KhorosコミュニティからXM Discoverにデータをロードできます。
ホロスで必要なセットアップ
Khorosインバウンドコネクタを使ってジョブを設定する前に、Khorosコミュニティに関する以下の情報が必要です:
- KhorosベースのコミュニティURL。
- プライベートコミュニティでは、SSOエンドポイントとKhoros認証情報が必要です。
Khorosインバウンドジョブの設定
ヒント:この機能を使用するには、「ジョブの管理」権限が必要です。
- [ジョブ] ページで、[新規ジョブ] をクリックします。
- ホロスを選択する。
- ジョブを特定できるように、ジョブに名前を付けます。
- データをロードするプロジェクトを選択します。
- 目的がわかるように、ジョブに説明を付けます。
- [次へ] をクリックします。
- 使用するKhorosコミュニティを選択するか、新規追加を選択して新しいコミュニティを追加します。
- 新規アカウントを追加する場合は、以下の情報を入力する:
- 接続名: 接続を識別できるように名前を付けます。
- フォーラムのURL: コミュニティ・フォーラムのベースURL(例:https://community.mycompany.com/)。
- コミュニティが非公開の場合は、「SSO認証機能でプライベートフォーラムに接続」チェックボックスを選択します。
- コミュニティが非公開の場合は、以下の情報を入力してください:
- SSO認証エンドポイント:コミュニティが使用するSSOエンドポイント。
- ユーザー名: Khorosでのユーザー名。
- パスワード: Khorosのパスワード。
- 認証情報の有効期限を設定したい場合は、以下のオプションを設定する:
- 期限切れ通知を送信する:クレデンシャルの有効期限を設定するには、このオプションを選択します。
- 有効期限までの日数:有効期限切れ通知を有効にする場合、有効期限切れの何日前に通知を希望するかを入力します。1 日から 100 日の間の値を入力することができます。
- 有効期限: 認証情報の有効期限が切れる日付を設定します。ボックスをクリックしてカレンダを開き、日付を選択します。
- [次へ] をクリックします。
- チェックボックスを使用して、関連する投稿と返信を取得したいKhorosボードを選択します。
Qtip:Check Allをクリックすると利用可能なすべてのボードを選択でき、Uncheck Allをクリックすると選択したすべてのボードのチェックを外すことができます。 - [次へ] をクリックします。
- 必要であれば、検索キーワードを入力すると、被評価者または本文に検索キーワードを含む投稿のみを表示することができます。キーワードを入力しないと、選択したボードからすべての投稿が引き出されます。
Qtip:複数のキーワードをカンマ区切りで指定すると、すべてのキーワードを含む投稿を引き出すことができます。 - [次へ] をクリックします。
- 必要に応じて、データマッピングを調整します。XM Discoverのマッピングフィールドの詳細については、「データマッピング」サポートページを参照してください。デフォルトデータマッピングセクションには、このコネクタに固有のフィールドに関する情報があり、会話フィールドのマッピングセクションには、会話データのデータマッピング方法が記載されています。
- [次へ] をクリックします。
- 必要に応じて、データ代替ルールおよび編集ルールを追加して、機密データを非表示にしたり、顧客フィードバックおよびインタラクションの特定の単語およびフレーズを自動的に置換したりすることができます。データ置換と再編集のサポートページをご覧ください。
Qtip:サンプルデータのダウンロードをクリックすると、サンプルデータを含むエクセルファイルがコンピュータにダウンロードされます。 - [次へ] をクリックします。
- 必要に応じて、受信データをフィルタリングするコネクタフィルタを追加して、インポートされるデータを制限することができます。
- また、レコード制限の指定ボックスで数を入力して、1 つのジョブでインポートされるレコードの数を制限することもできます。すべてのレコードをインポートする場合は、”すべて” を入力します。
ヒント:会話データの場合、上限は行ではなく会話に基づいて適用されます。
- [次へ] をクリックします。
- 通知を受け取るタイミングを選択します。詳細については、ジョブ通知を参照してください。
- [次へ] をクリックします。
- 重複伝票の処理方法を選択します。詳細については、重複処理を参照してください。
- ジョブをスケジュールに従って定期的に実行する場合は、増分実行のスケジュールを選択します。ジョブを 1 回だけ実行する場合は、ワンタイムプル設定を選択します。詳細については、ジョブスケジュールを参照してください。
- [次へ] をクリックします。
- 設定をレビューします。特定の設定を変更する必要がある場合は、編集ボタンをクリックして、コネクタ設定のそのステップに移動します。
- [完了] をクリックしてジョブを保存します。
デフォルトデータマッピング
注意してください:Connectorsではフィールド名の大文字と小文字が区別されるため、データマッピングを正確に行い、ジョブを成功させるには、データサンプリングに表示されているように、フィールド名の最初の文字を大文字にする必要があります。
このセクションには、Khorosインバウンドジョブのデフォルトフィールドに関する情報が含まれています。
- natural_id: ドキュメントの一意の識別子。重複を正しく処理するには、伝票ごとに一意の ID を設定することを強くお奨めします。[Natural ID] では、データから任意のテキストフィールドまたは数値フィールドを選択できます。または、ユーザ定義項目を追加して ID を自動的に生成することもできます。
- document_date: ドキュメントに関連付けられている主要な日付フィールド。この日付は、XM Discoverのレポート、トレンド、アラートなどで使用されます。デフォルトでは、SOQLクエリーを指定した後に選択された日付フィールドにマッピングされます。以下のオプションのいずれかを選択できます:
- post_time(デフォルト)。 元の投稿の日時。
- last_post_time. スレッドの最後のメッセージの日時。
- データソースに他の日付フィールドが含まれている場合は、そのいずれかを選択できます。
- 特定の伝票日付を設定することもできます。
- feedback_provider: 特定のプロバイダから取得したデータを識別します。ホロス文書では、この属性の値は “Khoros “に設定され、変更することはできません。
- ソース:特定のソースから取得したデータを特定する。これは、サーベイやモバイルマーケティングキャンペーンの名称など、データの発生源を示すあらゆるものにできます。デフォルトでは、この属性の値は “Khoros “に設定されている。カスタム変換を使用して、カスタム値の設定、式の定義、または別のフィールドへのマッピングを行います。
- feedback_type: データをそのタイプに基づいて識別します。これは、プロジェクトにさまざまなタイプのデータ(アンケートやソーシャルメディアフィードバックなど)が含まれる場合にレポートに役立ちます。デフォルトでは、この属性の値は “Forums “に設定されている。カスタム変換を使用して、カスタム値の設定、式の定義、または別のフィールドへのマッピングを行います。
- job_name: アップロードに使用されたジョブの名前に基づいてデータを識別します。設定時に各ページの上部に表示されるジョブ名フィールドを使用して、設定時にこの属性の値を変更することができます。
- loadDate:ドキュメントがXM Discoverにアップロードされた日時を示します。この項目は自動的に設定され、変更することはできません。