XM Directoryサンプルタスクの作成
このページの内容
XM Directoryサンプルタスクの作成について
XM Directoryサンプルの作成タスクでは、ワークフロー内で使用する連絡先のサンプルを作成できます。このサンプルは、後続のワークフロータスクで参照できます。
例えば、XM Directoryに顧客ロイヤルティプログラムに登録しているすべての顧客を含むメーリングリストがあるとします。毎月、そのメーリングリストの中から無作為に抽出した 10% の人に、プログラムの改善方法に関するフィードバックアンケートを送信したいと考えています。また、同じ顧客が 6 か月以内にフィードバックアンケートを受け取ることも望ましくありません。ワークフローを設定してこのサンプルを作成し、その同じワークフローでそのサンプルにフィードバックアンケートを配信できます。
ヒント：このタスクは、XM DirectoryとXM Directory Liteの両方に対応しています。ただし、このタスクはすべてのライセンスで利用できるわけではなく、XM Directory Liteで使用する場合は特定の機能が含まれないことがあります。XM Directoryにアップグレードをご希望の場合は、アカウントエグゼクティブまでご連絡ください。
ヒント：このタスクで作成されたアウトプットはワークフローで使用できますが、既存のメーリングリストがサンプルソースとして選択されていない限り、メーリングリストのサンプルとして保存されません。
XM Directoryサンプルタスクの作成設定
リンク先の指示に従って、新しいワークフローを作成します。ワークフローは、イベントによってトリガーすることも、設定したスケジュールで実行することもできます。
タスクを追加するステップになったら、XM Directoryサンプルを作成タスクを選択します。
サンプルソースを選択します。これにより、サンプルを生成するために選択できるコンタクトリストが決まります。
オプションは次のとおりです。
- ディレクトリの既存リストを使用：XM Directoryに既存のメーリングリストからサンプルを生成します。
- ディレクトリの既存の細分化を使用する：XM Directoryにすでに存在する細分化からサンプルを生成します。
前のタスクで作成したリストを使用する：ワークフロー内の前のタスクのメーリングリストからサンプルを生成します。適切なメーリングリストIDを選択する方法の詳細については、サンプリングワークフローのパイプテキストを参照してください。
例：例えば、SFTPファイルからデータを抽出するタスクを使用して、会社のSFTPサーバーから顧客の連絡先をアップロードするとします。その後、XM Directoryへの連絡先とトランザクションの追加タスクを使用して、これらの連絡先をディレクトリの新しいリストに保存できます。次に、XM Directoryサンプルの作成タスクを使用して、このリストからサンプルを作成します。
- 前のタスクから生成されたトランザクションバッチを使用する：ワークフロー内の前のタスクのトランザクションバッチからサンプルを生成します。
[ 次へ]をクリックします。
後で識別できるように、サンプルに名前を付けます。新しいサンプルが作成されるたびに、一意のIDが生成され、サンプル名に追加されます。
次に、サンプルの入力データを選択します。
ソース ディレクトリで、参照するメーリングリストが含まれているディレクトリを選択します。ソースとして「前のタスクから選択」を選んだ場合は、参照する予定のメーリングリストまたは取引バッチを含む同じディレクトリを選択してください。新規作成されたサンプルはこのディレクトリに保存されます。
ヒント：すべての組織が複数のディレクトリを持っているわけではありません。組織にディレクトリが 1 つしかない場合、選択肢は「デフォルトディレクトリ」のみです。
- 2つ目のソースには、サンプリングするコンタクトが含まれているリストを選択します。ここに表示されるオプションは、ステップ3で選択したオプションによって異なります。例えば、既存の細分化に基づいてサンプルを作成する場合、ここでその細分化を選択します。
サンプルサイズを選択してください。
サンプルサイズは2種類の方法で設定できます。
- パーセンテージ：ソースリストの一部をサンプリングするには、1～100の間のパーセンテージを入力します。
コンタクト数：サンプルに含めるコンタクトの数を入力します。
ヒント：サンプリング基準を満たすコンタクトの数がここで指定した数より少ない場合、サンプリング基準を満たすコンタクトのみが返されます。
［サンプリング基準を追加］をクリックすると、サンプルに含める対象をさらに絞り込むことができます。
このタスクでサンプリング基準を作成する方法は、XM Directoryでサンプルとフィルターを作成する方法と同じです。サンプリング基準の作成に関する詳細は、メーリングリストサンプルの作成およびフィルタリング可能なフィールドを参照してください。最上位の条件は 10 個、ブロックごとの条件は 10 個 (合計 100 個の条件) まで設定できますが、トランザクションからサンプリングする場合は、合計 10 個の条件しか設定できません。
注意：トランザクション項目でサンプリングする場合、過去1年間の取引日を持つトランザクションのみが返されます。例えば、本日取引を追加したものの、その取引日を 2 年前に設定した場合、そのコンタクトはサンプリング基準を満たしません。
注意: 末尾のスペースは削除されません。
［保存］をクリックします。
プラス記号（+）をクリックし、次にタスクを追加してワークフローにタスクを追加します。
最も一般的に使用されるタスクは次のとおりです。
- メールでアンケートを送信するタスク：サンプルにメールでアンケートを配信します。
- テキストメッセージ(SMS)によるアンケート送信タスク：テキストメッセージ(SMS)でサンプルにアンケートを配信します。
後続のタスクを設定する際、テキストの差し込みメニュー{a}を使用して、作成したサンプルを参照できます。詳細については、サンプリングワークフローのパイプテキストを参照してください。
サンプリングワークフローのパイプテキスト
このセクションでは、さまざまなサンプリングワークフローでテキストの差し込みを使用する方法について説明します。
同じワークフローで作成されたリストに基づいてサンプルを作成する
サンプリングタスクを使用すると、同じワークフローで作成されたメーリングリストに基づいてサンプルを作成できます(タスクの例)。これを行うには、ワークフローで以前に作成したリストのIDが必要です。これは、以下の手順で動的に生成できます。
リストを選択ドロップダウンで、メーリングリストを作成するタスクにカーソルを合わせ、連絡先リストIDをインポートを選択します。
このタスクで作成されたサンプルに配信する
このタスクでサンプルを生成すると、同じワークフロー内でそのサンプルにアンケートを送信できます。
招待する人を選択する際、 ソースとして「XM Directoryサンプルタスクを作成」を選択します。 次に、タイプとしてサンプルを選択します。
タスク失敗のトラブルシューティング
サンプルタスクを含むワークフローが失敗した場合、実行履歴に次のメッセージが表示されることがあります。
MOD_15 - 「sample source」が空でした。空でない値が必要です。テキストの差し込み値を生成するタスクが正常に完了し、スキップまたは操作なしになっていないことを確認してください。
このメッセージは、サンプルの作成元となるメーリングリストがなかったために表示されています。これは、あるソースからデータを抽出し、それを使用してメーリングリストを作成するETLワークフローにサンプルタスクを追加した場合に最もよく見られます。コンタクトインポートワークフローの詳細をご覧ください。
例：毎週水曜日にSFTPファイルから抽出タスクを使用してサーバー上のコンタクトを検索し、ディレクトリにアップロードして戻します。今週は処理する新しいファイルがなかったため、タスクは失敗しました。
失敗したワークフローの数を減らすには、サンプルタスクの上に条件（ディシジョンとも呼ばれます）を追加できます。この条件では、生成されたメーリングリストIDが空でない場合にのみサンプルタスクを実行するように指定できます。
例：この条件は、タスク「ディレクトリに連絡先とトランザクションを追加」のリスト ID が空でない場合にのみ、次のタスクを実行する必要があることを示しています。
![この条件は、タスク[ディレクトリに連絡先とトランザクションを追加]のリストIDが空でない場合にのみ、次のタスクを実行する必要があることを示しています。](https://www.qualtrics.com/sites/default/files/styles/standard_xl_retina/public/2026-04/sample-condition.png.webp?itok=xKDfbgjP)
素晴らしい！ フィードバックありがとうございます！
フィードバックありがとうございます！