Skip to main content
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

記事テンプレート


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


ディレクトリ連絡先の追加について

ディレクトリ連絡先タブには、組織のディレクトリに追加されたすべての連絡先が含まれます。メーリングリストに追加された連絡先は、自動的にこのディレクトリに追加されますが、ディレクトリの連絡先を追加ボタンを使用して、ディレクトリ自体に直接連絡先を追加することもできます。

ディレクトリ連絡先]タブの右上にある[ディレクトリ連絡先を追加]ボタンをクリックします。

Qtip: ディレクトリに追加された連絡先は、ブランド内のすべてのユーザーに表示されます。
Qtip: 新しい連絡先を追加する際、インポートウィンドウに表示される複製を統合する設定を確認してください。これらの設定は、複製がどのように識別され、結合されるかを決定し、ディレクトリオプションタブで変更することができます。

XM DIRECTORY連絡先を使用できるプロジェクト

Qtip:このセクションで説明されている機能は、必ずしもすべてのライセンスに含まれているわけではありません。アクセシビリティにご興味のある方は、アカウントチームまでお問い合わせください。

XM DIRECTORYを使って連絡先リストを作成し、クアルトリクスプロジェクトの招待状を送ることができます。ただし、すべてのクアルトリクスプロジェクトがXM DIRECTORYに対応しているわけではありません。

XM DIRECTORYは、以下の送信に使用できます

ただし、XM DIRECTORYの連絡先データは、従業員ディレクトリに保存されている従業員/参加者情報とは完全に分離されています。つまり、一方のディレクトリで編集されたデータが、もう一方のディレクトリに影響を与えることはない。XMディレクトリは、エンゲージメント、パルス、360などの従業員エクスペリエンス(EX)プロジェクトの配信には使用できません

利用可能な連絡先フィールド

連絡先のCSVやTSVをアップロードするにしても、手入力するにしても、連絡先には必ず記載しなければならない情報があります。

以下のすべてのカラムを含むCSV。

複製をマージするディレクトリによっては、FIRSTNAME、LASTNAME、Email、および/またはExternalDataReferenceが必須フィールドになる場合があります
  • FIRSTNAME: 連絡先の名前。
  • LASTNAME: 連絡先の姓。
  • 電子メール 連絡先のメールアドレス。このフィールドから複製をマージすることをお勧めします。
  • 外部データ参照:連絡先に関する追加情報。従業員や学生 ID などのデータの保存によく使用されます。自分らしくいられること認証機能にログインし、ディレクトリが複製をどのようにマージするかを設定するために使用することができる。
  • 埋め込みデータ:埋め込みデータは、任意のフィールドを含む追加フィールドです。これらは特定の命名規則に従う必要はない。上のスクリーンショットでは、Department、City、Countryはすべて埋め込みデータです。
    Qtip:埋め込みデータ名は最大200文字です。値はそれぞれ最大1024文字です。
    警告すべての埋め込みデータフィールドは、以前は大文字と小文字が区別されていました。つまり、”test “と “Test “は同じフィールドとして扱われることになる。ただし、ごく一部のアカウントではこの変更がまだ行われていないため、引き続き大文字と小文字を区別してマッチングすることをベストプラクティスとしてお勧めします。
    警告PointsはXM DIRECTORYの予約フィールドであるため、埋め込みデータフィールドとして使用しないでください。また、クアルトリクスのデフォルトフィールドは使用しないでください。
  • 言語:言語コードを使用して連絡先の言語を識別するオプションの列。
  • 電話番号:連絡先の電話番号を示すオプションの列。使用可能な電話番号形式については、SMS配信のサポートページを参照してください。
Qtip:これらのフィールド名をファイルに含める場合、カラムタイトルはこれらのフィールド名と大文字と小文字を完全に一致させる必要があります。唯一の例外は、埋め込みデータは大文字と小文字が区別されないことである。
注意ContactID列の値を変更しないでください!このフィールドは、既存の連絡先を識別するために使用されます。連絡先IDを使用して新しい連絡先を作成することはできません。ITは既存の連絡先を更新するためにのみ使用できます。

日時データ

埋め込みデータが日付形式で保存されている場合、フィルターを使って未来の日付や最近起こった日付を検索することができます。日付で検索するには、日付フィールドはISO-8601形式で、タイミングはUTCでなければなりません。(例:YYYY-MM-DDT-HH:mm:ss+ZZZZ 。これらの記号の詳細については、日付書式構文のサポートページを参照してください)。

日付が2021年3月31日9:00:00AM EDT(UTC-4)だとします。ISO-8601形式のこの日付は2021-03-21T13:00:00.000Zである。時間がEDTからUTCに変換されていることに注目してほしい。

ファイルをアップロード

  1. ディレクトリ連絡先の追加をクリックします。
    ディレクトリ連絡先]タブの右上にある[ディレクトリ連絡先を追加]ボタンをクリックします。
  2. ファイルのアップロードをクリックします。
    連絡先追加ウィンドウの左側にあるファイルのアップロードオプション
  3. Excelで、必要なフィールドを含む文書を作成し、CSVまたはTSVとして保存します。または、Download a sample templateをクリックし、適切な欄に記入し、必要な埋め込みデータを追加し、ファイルを保存します。
    新しいウィンドウが開き、例のDOCにリンクする小さなテキストが表示され、ファイルをドラッグ&ドロップするか、クリックして参照できる大きなボックスが表示されます。
  4. ファイルの準備ができたら、指定されたスペースにファイルをドラッグ&ドロップするか、「ファイルを選択」をクリックしてフォルダからファイルを選択します。
  5. 次へ]をクリックします。
  6. 連絡先のインポート条件を評価する。複製連絡先をマージするためのディレクトリ全体のルールは、ここに表示されます。これらのルールはディレクトリ設定で設定され、ファイル内の連絡先に適用されます。
    インポート条件の確認とファイル内のフィールドのプレビュー

    Qtip:Directory SettingsタブへのアクセシビリティにはManage Directory権限が必要です。この設定へのアクセシビリティに興味がある場合は、ブランド管理者に相談してください。
  7. ファイルのフィールドを評価し、情報が正しいことを確認する。フィールドが正しく認識されていない場合は、フィールド名をクリックしてドロップダウンを表示し、適切なフィールドを選択します。
    Qtip: プレビューでデータが正しくフォーマットされていない場合(例えば、列ごとに区切られておらず、束になっている)、データが正しく区切られていない可能性があります。これを修正するには、青い「オプションを表示」リンクを選択し、別のデリミターや エンクロージャーを選択します。区切り文字と囲みフィールド
    Qtip: すでに値が保存されている空の埋め込みフィールドで連絡先がアップロードされた場合、フィールドは上書きされず、現在の値が残ります。
  8. ファイルをアップロードをクリックして、連絡先をディレクトリにアップロードします。
Qtip:ExcelはASCII以外の文字(是やñなど)を独自の方法で解釈するため、クアルトリクスではアップロードが困難です。特殊文字を含む名前をインポートする場合、テキスト編集アプリケーション(Macの場合はText-edit、Windowsの場合はワードパッド)に連絡先リスト情報をあらかじめ保存してからQualtricsにファイルをアップロードする必要があります。その他の手順については、CSV/TSVアップロードの問題ページの特殊文字の問題を参照してください。

ファイルインポートのトラブルシューティング

クアルトリクスでは、連絡先インポートのステータスを簡単に確認し、発生したエラーを修正することができます。各連絡先の行ごとのファイルと、正しくインポートされたかどうかの情報を提供します。これは、連絡先のインポートに失敗した場合に、何が問題であったかを特定し、ファイルを修正し、再試行できるようにするための参考資料となります。

インポートの詳細な状況を知るには

  1. ファイルをアップロードしたら、ディレクトリ連絡先タブの右上にあるツールボックスアイコンをクリックします。
    ツールボックスをクリックし、インポートのステータスを表示する

    Qtip:特定のメーリングリストに連絡先をインポートする場合、メーリングリストの中からツールボックスをクリックすることもできます。
  2. インポートの詳細を表示」をクリックします。
  3. インポートの概要を評価する。これには、作成された連絡先の数、更新された連絡先の数、インポートに失敗した連絡先の数が含まれます。また、インポートしたデータにはProgress IDが割り当てられますので、クアルトリクスサポートに連絡する際に持っておくと便利です。
    概要画面とダウンロードレポートボタン
  4. エラーレポートファイルをダウンロードするには、以下をクリックしてください。 レポートをダウンロードする。

    Qtip:アップロードのサイズによっては、レポート作成に時間がかかる場合があります。
  5. コンピュータのスプレッドシートエディタでファイルを開き、失敗した連絡先がないか評価します。失敗した連絡先を特定するために最も有用な列は、ImportStatus列です。各コラムの詳細は以下の通り。

エラーレポートフィールド

以下は、エラーレポートの各フィールドの説明である:

  • SourceIndexId:インポートファイル内の連絡先のインデックス(行ID)。
  • 電子メール:連絡先のメールアドレス。
  • ContactId:ディレクトリ内の連絡先のID。
  • インポートステータス:連絡先のインポートステータス。値には以下が含まれる:追加、更新、失敗。
  • ImportStatusCode:インポートのステータスコード。コードのリストとその意味については次へを参照。
  • トランザクションID:連絡先アップロードまたは更新のトランザクションID。
    Qtip:連絡先インポートオートメーションを使用する際、またはAPI経由で連絡先を追加する際にトランザクションを設定することができます。
  • トランザクションステータス: 該当する場合、トランザクションのステータス。値には以下が含まれる:追加、更新、失敗。
  • TransactionStatusCode:トランザクションのステータスコード。コードのリストとその意味については次へを参照。
  • ContactListContactId: 連絡先をメーリングリストに追加する場合、または新しいリストを作成する場合、特定のメーリングリストの連絡先のID。
  • ContactListContactStatus:メーリングリストに連絡先を追加する場合、または新規リストを作成する場合、追加または更新のステータス。値には以下が含まれる:追加、更新、失敗。
  • ContactListContactStatusCode: メーリングリストの連絡先のステータスコード。コードのリストとその意味については次へを参照。

ステータス・コード

以下は、考えられるステータスコードとその説明のリストである。

Qtip:サポートに連絡する場合は、トラブルシューティング・ファイルを手元に用意してください。

ステータスコード 説明
0 不明なエラーが発生しました。インポートを再試行してください。
1日 不明なエラーが発生しました。インポートを再試行してください。
10 連絡先FirstNameが空か無効です。有効なFirstNameを入力してください。
11 連絡先のLastNameが空か無効です。有効なLastnameを入力してください。
12 ExternalDataReferenceの連絡先の値が空か無効です。有効なExternalDataReferenceの値を入力してください。
13 連絡先の電話番号が空または検証されていません。有効な電話番号を入力してください。
14 連絡先メールアドレスが検証されていません。有効なメールアドレスを入力してください。
15 埋め込みデータフィールドのキーが200文字を超えるため、連絡先が無効です。
16 埋め込みデータフィールドの値が1024文字を超えているため、連絡先が無効です。
18 連絡先のContactIDが、インポート先のディレクトリと異なるディレクトリに存在します。
19 連絡先言語コードが無効です。20文字以下の言語コードを入力してください。
40 連絡先が正常に作成されました。
41 連絡先は正常に更新されました。
42 連絡先が作成されませんでした。インポートを再試行してください。
43 連絡先が作成されませんでした。インポートを再試行してください。
44 連絡先が作成されませんでした。インポートを再試行してください。
45 連絡先が作成されませんでした。インポートを再試行してください。
46 連絡先が作成されませんでした。インポートを再試行してください。
47 連絡先が作成されませんでした。インポートを再試行してください。
49 内部エラーが発生しました。失敗した行を再試行してください。エラーが解消されない場合は、クアルトリクスサポートまでご連絡ください。
60 連絡先がメーリングリストに正常に追加されました。
61 連絡先リストが正常に更新されました。
62 連絡先がメーリングリストに追加されていません。インポートを再試行してください。
63 連絡先の作成に失敗したため、連絡先がリストに追加されませんでした。
70 トランザクションは正常に作成されました。
71 トランザクションのインポートに失敗しました – トランザクションに関連付けられている有効な連絡先がありません。
72 トランザクションが作成されませんでした。インポートを再試行してください。
73 ディレクトリにContactIdまたはContactListContactIdが見つからなかったため、トランザクションの作成に失敗しました。
74 トランザクション作成日が不足しているため、トランザクションの作成に失敗しました。
75 不明なエラーが発生しました。インポートを再試行してください。
76 トランザクションデータフィールドのキーが200文字以上であるため、トランザクションが無効です。
77 トランザクションデータフィールドの値が1024文字を超えているため、トランザクションが無効です。
78 関連する連絡先の作成に失敗したため、トランザクションが作成されませんでした。

その他のエラーのトラブルシューティング

  • あなたのファイルには、文字数制限を超えるフィールドまたは複数のフィールドがあります。以下の文字数制限を評価者してください:
    • 言語:20
    • 名: 100
    • 姓: 100
    • メールアドレス254
    • 電話番号:20
    • 外部基準:100
    • 埋め込みデータフィールド:200
    • 埋め込みデータ値:1,024

手動入力

  1. ディレクトリ連絡先の追加]をクリックします。
    ディレクトリ連絡先]タブの右上にある[ディレクトリ連絡先を追加]ボタンをクリックします。
  2. マニュアル入力を選択する。
    連絡先追加ウィンドウの右側に手動入力オプションがあります。
  3. 連絡先のインポート条件を評価する。複製連絡先をマージするためのディレクトリ全体のルールは、ここに表示されます。これらのルールはディレクトリ設定で設定され、入力した連絡先に適用されます。
    既存の重複統合条件が表示された手動入力画面
  4. 利用可能なフィールドに記入してください。連絡先を入力、またはコピー&ペーストすることができます。
  5. 埋め込みデータ用の列を追加するには、プラス記号(+)をクリックします。覚えておいてほしいのは、これらは何でもいいということだ。
  6. 次へ」をクリックして連絡先をアップロードします。

デジタルインターセプトからの連絡先の追加

作成したデジタルインターセプトから連絡先を自動的にXM DIRECTORYに追加することができます。ウェブサイト/モバイルからのフィードバックプロジェクトでの自動連絡先作成の設定方法の詳細については、Digital InterceptsサポートページのXM DIRECTORY Integrationをご覧ください。

FAQ

当サポートサイトの日本語のコンテンツは英語原文より機械翻訳されており、補助的な参照を目的としています。機械翻訳の精度は十分な注意を払っていますが、もし、英語・日本語翻訳が異なる場合は英語版が正となります。英語原文と機械翻訳の間に矛盾があっても、法的拘束力はありません。