Qualtrics Platform
Customer Journey Optimizer
XM Discover
Qualtrics Social Connect

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

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

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

ヒント：ディレクトリに追加された連絡先は、ブランドのすべてのユーザーに表示されます。

ヒント：新しい連絡先を追加する際は、重複を結合するための設定を確認してください。この設定はインポートウィンドウに表示されます。これらの設定により、重複の識別および結合方法が決定され、ディレクトリオプションタブで変更することができます。

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

ヒント：このセクションで説明する機能は、必ずしもすべてのライセンスに含まれているわけではありません。アクセス権の取得に関心がある場合は、アカウントチームに連絡してください。

XM Directoryを使用して連絡先リストを作成し、さまざまなタイプのクアルトリクスプロジェクトへの招待を送信できます。ただし、すべてのクアルトリクスプロジェクトタイプがXM Directoryと互換性があるわけではありません。

XM Directoryは次の送信に使用できます。

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

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

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

CSVまたはTSVの連絡先をアップロードする場合でも、手動で入力する場合でも、連絡先に含める必要がある特定の情報があります。

ヒント：ディレクトリがどうマージされるかに応じて、［FirstName］、［LastName］、［Email］、または［ExternalDataReference］を必須フィールドにすることができます。

FirstName: 担当者の名。
LastName: 連絡先の姓。
メール：連絡先のメールアドレス。この項目から重複をマージすることをお奨めします。
ExternalDataReference: 連絡先に関する追加情報。従業員や学生 ID などのデータの保存によく使用されます。これは、認証機能にログインして、ディレクトリが重複をマージする方法を設定するために使用できます。
埋め込みデータ：埋め込みデータは、任意のフィールドを含む追加フィールドです。これらは、特定の命名規則に従う必要はありません。上のスクリーンショットでは、部署、市区町村、国はすべて埋め込みデータです。
ヒント：埋め込みデータ名は最大200文字です。値はそれぞれ 1024 文字以内にする必要があります。

警告：以前は、すべての埋め込みデータフィールドで大文字と小文字が区別されていました。大多数のユーザーについて、埋め込みデータの大文字と小文字は区別されなくなりました。つまり、「test」と「Test」は同じフィールドとして扱われます。ただし、ごく一部のアカウントではこの変更がまだ行われていないため、引き続き大文字と小文字を区別してマッチングすることをベストプラクティスとしてお勧めします。

警告：XM Directoryの予約済みフィールドであるため、埋め込みデータフィールドとしてポイントを使用しないでください。また、他のクアルトリクスデフォルトフィールドは使用しないでください。
言語:言語コードを使用してコンタクトの言語を識別するオプションの列。
電話: 連絡先の電話番号を識別するオプションの列。使用可能な電話番号の形式については、「SMS配信」サポートページを参照してください。

ヒント：これらのフィールドをファイルに含める場合、列のタイトルは大文字と小文字とスペースで完全に一致する必要があります。唯一の例外は、埋め込みデータでは大文字と小文字が区別されないことです。

注意:[ContactID] 列の値は変更しないでください。この項目は、既存のコンタクトを識別するために使用されます。ContactID を使用して新規コンタクトを登録することはできません。既存のコンタクトの更新にのみ使用できます。

日付および時刻データ

埋め込みデータを日付形式で保存している場合は、フィルタを使用して将来の日付または最近発生した日付を検索することができます。日付で検索するには、日付フィールドが 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として保存します。または、サンプルテンプレートのダウンロードをクリックし、適切な列を入力し、必要な埋め込みデータを追加して、ファイルを保存します。
ファイルの準備ができたら、指定されたスペースにファイルをドラッグ & ドロップするか、[ファイルの選択] をクリックしてフォルダからファイルを選択します。
[次へ] をクリックします。
コンタクトのインポート条件を確認します。重複コンタクトをマージするためのディレクトリ全体のルールがここに表示されます。これらのルールはディレクトリ設定で設定され、ファイル内の連絡先に適用されます。

ヒント：［ディレクトリ設定］タブにアクセスするには、［ディレクトリを管理］権限が必要です。この設定へのアクセスに関心がある場合は、ブランド管理者にお問い合わせください。
ファイル内のフィールドを確認し、情報が適切に表示されることを確認します。フィールドが正しく認識されていない場合は、フィールド名をクリックしてドロップダウンを表示し、適切なフィールドを選択します。
ヒント：プレビューでデータが正しくフォーマットされていない場合（列に分割される代わりに切り上げられた場合など）、データが正しく区切られていない（区切りになる）可能性があります。これを修正するには、青い［オプションを表示］リンクを選択し、別の［区切り文字］または［囲み文字］を選択します。

ヒント：すでにそのフィールドに値が保存されている空の埋め込みフィールドを含む連絡先がアップロードされた場合、そのフィールドは上書きされず、現在の値は残ります。
［ファイルをアップロード］をクリックして連絡先をディレクトリにアップロードします。

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

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

Qualtricsを使うと、連絡先のインポートのステータスを簡単に確認し、発生した可能性のあるエラーを修正できます。各連絡先の 1 行ごとのファイルと、ファイルが正しくインポートされたかどうかに関する情報が提供されます。これは参照として機能し、連絡先がインポートできなかった場合に問題を特定し、ファイルを修正して再試行することができます。

インポートの詳細なステータスを取得するには、以下の手順に従います。

ファイルをアップロードした後、［ディレクトリの連絡先］タブの右上隅にあるツールボックスアイコンをクリックします。

ヒント：連絡先を特定のメーリングリストにインポートする場合は、メーリングリスト内からツールボックスをクリックすることもできます。
[インポートの詳細を表示] をクリックします。
インポートの概要を確認します。これには、作成された連絡先の数、更新された連絡先の数、インポートに失敗した連絡先の数が含まれます。また、インポートには進行状況IDが割り当てられます。これは、Qualtricsサポートに連絡する必要がある場合に役立ちます。
エラーレポートファイルをダウンロードするには、 レポートをダウンロードします。

ヒント：アップロードのサイズによっては、レポートが生成されるまでに少し時間がかかる場合があります。
コンピュータ上のスプレッドシートエディタでファイルを開き、失敗した連絡先がないかファイルを確認します。失敗した連絡先の識別に最も役立つ列は、ImportStatus 列です。各列の詳細は以下のとおりです。

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

以下は、エラーレポートの各フィールドの説明です。

SourceIndexId: インポートファイル内のコンタクトのインデックス、または行 ID。
Email ：連絡先に関連付けられているメールアドレス。
ContactId: ディレクトリ内の連絡先の ID。
ImportStatus: コンタクトのインポートステータス。値には、追加済み、更新済み、および失敗があります。
ImportStatusCode: インポートのステータスコード。コードとその意味の一覧については、次のセクションを参照してください。
トランザクション ID: 該当する場合、コンタクトのトランザクション ID がアップロードまたは更新されます。
ヒント：連絡先インポートの自動化を使用する場合、またはAPIを使用して連絡先を追加するときに、トランザクションを設定できます。
TransactionStatus: 該当する場合は取引のステータス。値には、追加済み、更新済み、および失敗があります。
TransactionStatusCode: トランザクションのステータスコード。コードとその意味の一覧については、次のセクションを参照してください。
ContactListContactId: メーリングリストに連絡先を追加するか、新しいリストを作成する場合は、特定のメーリングリスト内の連絡先の ID。
ContactListContactStatus: 連絡先をメーリングリストに追加するか、新しいリストを作成する場合、追加または更新のステータスです。値には、追加済み、更新済み、および失敗があります。
ContactListContactStatusCode: メーリングリスト内の連絡先のステータスコード。コードとその意味の一覧については、次のセクションを参照してください。

ステータスコード

以下は、使用可能なステータスコードとその内容説明の一覧です。

ヒント：サポートに連絡してサポートが必要な場合は、トラブルシューティングファイルを手元に用意してください。

ステータスコード	説明
0	不明なエラーが発生しました。クアルトリクスに連絡してサポートを依頼してください。
1	不明なエラーが発生しました。クアルトリクスに連絡してサポートを依頼してください。
10	連絡先の FirstName が空白または無効です。有効な名を入力してください。
11	連絡先の姓が空白または無効です。有効な姓を入力してください。
12	ExternalDataReference の連絡先値が空白または無効です。有効な ExternalDataReference 値を入力してください。
13	担当者電話が空白または無効です。有効な電話番号を入力してください。
14	連絡先のメールアドレスが無効です。有効なメールアドレスを入力してください。
15	埋め込みデータフィールドキーが200文字を超えているため、連絡先は無効です。
16	埋め込みデータフィールドの値が 1024 文字を超えているため、連絡先は無効です。
18	コンタクトの ContactID が、インポート先のディレクトリとは別のディレクトリに存在しています。値をクリアしてください。
19	担当者の言語が無効です。20 文字未満の言語コードを入力してください。
40	コンタクトが正常に登録されました。
41	連絡先が正常に更新されました。
42	連絡先は作成されませんでした。クアルトリクスに連絡してサポートを依頼してください。
43	連絡先は作成されませんでした。クアルトリクスに連絡してサポートを依頼してください。
44	連絡先は作成されませんでした。クアルトリクスに連絡してサポートを依頼してください。
45	連絡先は作成されませんでした。クアルトリクスに連絡してサポートを依頼してください。
46	連絡先は作成されませんでした。クアルトリクスに連絡してサポートを依頼してください。
47	連絡先は作成されませんでした。クアルトリクスに連絡してサポートを依頼してください。
60	連絡先はメーリングリストに正常に追加されました。
61	メーリングリストの連絡先が正常に更新されました。
62	連絡先はメーリングリストに追加されませんでした。クアルトリクスに連絡してサポートを受けてください。
63	連絡先の作成に失敗したため、リストに連絡先が追加されませんでした
70	取引は正常に登録されました。
71	トランザクションをインポートできませんでした – トランザクションに有効な連絡先が関連付けられていません。有効な連絡先情報を入力してください。
72	トランザクションは作成されませんでした。クアルトリクスに連絡してサポートを依頼してください。
73	ContactId または ContactListContactId がディレクトリに見つからなかったため、トランザクションの作成に失敗しました。有効な ContactId および ContactListContactId を入力してください。
74	取引日付がないため、取引の登録に失敗しました。有効な取引日付を入力してください。
75	不明なエラーが発生しました。クアルトリクスに連絡してサポートを依頼してください。
76	トランザクションデータフィールドキーが 200 文字を超えているため、取引は無効です。
77	トランザクションデータフィールドの値が 1024 文字を超えているため、トランザクションは無効です。
78	関連付けられた連絡先の作成に失敗したため、トランザクションは作成されませんでした。クアルトリクスに連絡してサポートを依頼してください。

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

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

手動入力

［ディレクトリの連絡先を追加］をクリックします。
マニュアル入力を選択します。
コンタクトのインポート条件を確認します。重複コンタクトをマージするためのディレクトリ全体のルールがここに表示されます。これらのルールはディレクトリ設定で設定され、入力した連絡先に適用されます。
利用可能な項目を入力します。連絡先情報を入力したり、コピーアンドペーストしたりできます。
プラス記号（+）をクリックして、埋め込みデータの列を追加します。覚えておいてください。これらは何でもなり得ます。
[次へ] をクリックして、連絡先をアップロードします。