ディレクトリ連絡先の追加

スイート

Customer Experience Strategy & Research

製品

Qualtrics

このページの内容

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

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

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

Qtip: ディレクトリに追加された連絡先は、ディレクトリにアクセシビリティを持つ組織内のすべてのユーザーに表示されます。

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

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

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

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

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

Qtip:アンケートへのリンクなしでメールを送信することもできます。

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

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

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

複製をマージするディレクトリによっては、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に変換されていることに注目してほしい。

ディレクトリ連絡先ファイルのアップロード

ディレクトリの連絡先タブから始めてください。

ディレクトリ連絡先の追加をクリックします。

ファイルのアップロードをクリックします。

Excelで、必要なフィールドを含む文書を作成し、CSVまたはTSVとして保存します。または、Download a sample templateをクリックし、適切な欄に記入し、必要な埋め込みデータを追加し、ファイルを保存します。

新しいウィンドウが開き、例のDOCにリンクする小さなテキストが表示され、ファイルをドラッグ＆ドロップするか、クリックして参照できる大きなボックスが表示されます。

ファイルの準備ができたら、指定されたスペースにファイルをドラッグ＆ドロップするか、「ファイルを選択」をクリックしてフォルダからファイルを選択します。

［次へ］をクリックします。

連絡先アップロードのルールを評価する。複製連絡先をマージするためのディレクトリ全体のルールは、ここに表示されます。これらのルールはディレクトリ設定で設定され、ファイル内の連絡先に適用されます。

Qtip:Directory SettingsタブへのアクセシビリティにはManage Directory権限が必要です。この設定へのアクセシビリティに興味がある場合は、ブランド管理者に相談してください。

ファイルのフィールドを評価し、情報が正しいことを確認する。フィールドが正しく認識されていない場合は、フィールド名をクリックしてドロップダウンを表示し、適切なフィールドを選択します。

Qtip: プレビューでデータが正しくフォーマットされていない場合（例えば、列ごとに区切られておらず、束になっている）、データが正しく区切られていない可能性があります。これを解決するには、別のデリミターや エンクロージャーを選択してください。

Qtip: 空の埋め込みフィールドを持つ連絡先がアップロードされ、そのフィールドにすでに値が保存されている場合、そのフィールドが上書きされるか、そのままにされるかはディレクトリの設定に依存します。

QTip: クアルトリクスは、不要な重複フィールドを作成しないように、ディレクトリ内の埋め込みデータフィールドと類似するインポートフィールドにフラグを立てます。フィールドはスペルや意味に基づいてフラグが立てられる。例えば、インポートファイルに “Zip “というフィールドが含まれている場合、既存のディレクトリの “Zip Code “というフィールドと類似しているというフラグが立てられます。

ファイルをアップロードをクリックして、連絡先をディレクトリにアップロードします。

Qtip:ExcelはASCII以外の文字（是やñなど）を独自の方法で解釈するため、クアルトリクスではアップロードが困難です。特殊文字を含む名前をインポートする場合、テキスト編集アプリケーション（Macの場合はText-edit、Windowsの場合はワードパッド）に連絡先リスト情報をあらかじめ保存してからQualtricsにファイルをアップロードする必要があります。その他の手順については、CSV/TSVアップロードの問題ページの特殊文字の問題を参照してください。

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

クアルトリクスでは、連絡先インポートのステータスを簡単に確認し、発生したエラーを修正することができます。アップロードの過程で、ファイルが正しく設定されていない場合、通知が表示されることがあります。解決策が提示され、修正されるまでファイルのアップロードが禁止されるため、ディレクトリデータはクリーンで正確な状態に保たれます。

例: 下のスクリーンショットでは、値の1つが20文字を超えたため、ファイルがブロックされました。これによって、ファイルを修正する際に何を見るべきかがわかる。

インポート・ステータス・レポートのダウンロード

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

ファイルをアップロードしたら、タスク完了ボタンをクリックします。

Qtip:特定のメーリングリストに連絡先をインポートする場合、メーリングリストの中からツールボックスをクリックすることもできます。

インポートの詳細を表示」をクリックします。

インポートの概要を評価する。これには、作成された連絡先の数、更新された連絡先の数、インポートに失敗した連絡先の数が含まれます。また、インポートしたデータにはProgress IDが割り当てられますので、クアルトリクスサポートに連絡する際に持っておくと便利です。

エラーレポートファイルをダウンロードするには、以下をクリックしてください。 レポートをダウンロードする。

Qtip:アップロードのサイズによっては、レポート作成に時間がかかる場合があります。

コンピュータのスプレッドシートエディタでファイルを開き、失敗した連絡先がないか評価します。失敗した連絡先を特定するために最も有用な列は、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
空白値：ディレクトリの設定が空白値の扱いに影響することに留意してください。連絡先を更新しようとして、期待した結果が得られない場合、それは管理者が設定したことが原因かもしれません。XM DIRECTORYの空白値のインポートを参照してください。
ファイル形式の問題： このセクションのtsvで問題が解決しない場合は、CSVとTSVアップロードの問題のページも参照してください。

ディレクトリ連絡先の手動入力

ディレクトリの連絡先タブから始めてください。

連絡先の追加をクリックします。

マニュアル入力を選択する。

連絡先アップロードのルールを評価者。複製連絡先をマージするためのディレクトリ全体のルールは、ここに表示されます。これらのルールはディレクトリ設定で設定され、入力した連絡先に適用されます。

利用可能なフィールドに記入してください。連絡先を入力、またはコピー＆ペーストすることができます。

埋め込みデータ用の列を追加するには、プラス記号（+）をクリックします。覚えておいてほしいのは、これらは何でもいいということだ。

次へ」をクリックして連絡先をアップロードします。

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

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

他のプラットフォームから連絡先を自動的に取り込む

連絡先が自動的に他のサービス（Sftp、クアルトリクスファイルサービス、Googleドライブなど）からクアルトリクスに取り込まれるように設定できます。あなたやあなたのチームに最適なスケジュールを選び、あとは勝手に動いてくれればいい。

詳しくはXM DIRECTORYワークフローのページをご覧ください。

FAQs

ファイルはアップロードされたようですが、XMディレクトリの私のリストに連絡先が表示されません。発生した事象を教えてください。

重複排除の設定を確認し、新しい連絡先の作成が妨げられていないことを確認するとよいでしょう。

Directory Settings] タブが表示されない場合は、 Brand Administrator に相談してください。

XMディレクトリで、メーリングリストやディレクトリの連絡先ファイルが全くアップロードされません。どうしたんですか？

ファイルにフォーマットエラーがある可能性があります。サンプルファイルをダウンロードし、ご自身のファイルと比較してみてください。関連するヘッダー（FirstName、LastName、Email、ExternalDataReferenceなど）はすべて正確に一致しているか。大文字、小文字、スペル、スペースは重要です。すべてのカラムにハダーがあることを確認する。また、ファイルがUTF-8形式のCSVかTSVファイルであることを確認してください。トラブルシューティングのヘルプについては、CSV / TSV Upload Issues をご覧ください。

XMディレクトリに登録されている連絡先をメーリングリストに追加するにはどうすればよいですか？

リストにディレクトリコンタクトを追加するのページをご覧ください。

XMディレクトリとは？/ ターゲットオーディエンスは？

Target AudienceはXM Directoryに名称を変更し、よりビジュアルに優れたデザインになりました。

When you import updates to existing contacts, how are empty / blank fields treated?

When updating contacts via a file upload, blank contact fields (such as FirstName, LastName, and ExternalDataReference) will overwrite existing values for contacts in the directory.

However, directory embedded data fields will not have their data overwritten by default. You can choose which embedded data fields should allow blank values to overwrite existing ones by adjusting your directory settings. See Importing Blank Values in XM Directory for more information.

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

この記事は役に立ちましたか

いただいたフィードバックはこのページの改善の目的のみに利用します。

素晴らしい！フィードバックありがとうございます！

フィードバックありがとうございます！