このページ： CSV ファイルをアップロードするか、API 呼び出しを使用して、テストプロファイルを作成する方法について説明します。これにより、Adobe Journey Optimizer でコンテンツをプレビューし、ジャーニーをテストできます。
ジャーニーでテストモードを使用する際や、コンテンツをプレビューしてテストするには、テストプロファイルが必要です。
CSV ファイルをアップロードするか、API 呼び出しを使用して、テストプロファイルを作成できます。 また、Adobe Journey Optimizer には、テストプロファイルの作成を容易にする特定の製品内ユースケースも用意されています。
既存のデータセットに JSON ファイルをアップロードできます。 詳しくは、データ取り込みのドキュメントを参照してください。
テストプロファイルの作成は、Adobe Experience Platform で通常のプロファイルを作成する場合と似ています。詳しくは、リアルタイム顧客プロファイルのドキュメントを参照してください。
➡️ テストプロファイルの作成方法については、このビデオをご覧くださいテスト
前提条件 test-profile-prerequisites
プロファイルを作成するには、まず Adobe Journey Optimizer でスキーマとデータセットを作成する必要があります。
スキーマの作成 create-schema
スキーマを作成するには、次の手順に従います。
-
データ管理メニューセクションで、「スキーマ」をクリックし、「スキーマを作成」ボタンを選択します。
-
スキーマ作成オプションとして「標準」を選択します。
-
スキーマタイプ（例：個人プロファイル）を選択し、「次へ」をクリックします。
-
スキーマの名前を入力して、「終了」をクリックします。
-
「フィールドグループ」セクションの左側で、「追加」をクリックして、適切なフィールドグループを選択します。 「プロファイルテストの詳細」フィールドグループを必ず追加してください。
完了したら、「フィールドグループを追加」をクリックします。フィールドグループのリストが、スキーマの概要画面に表示されます。
note NOTE スキーマの名前をクリックして、そのプロパティを更新します。 -
フィールドのリストで、プライマリ ID として定義するフィールドをクリックします。
-
右の フィールドのプロパティ ペインで、「ID」オプションと「メイン ID」オプションをオンにし、名前空間を選択します。 メールアドレスをプライマリ ID にする場合は、「メール」名前空間を選択します。 「適用」をクリックします。
-
スキーマを選択し、スキーマのプロパティペインで「プロファイル」オプションを有効にします。
-
「保存」をクリックします。
スキーマ作成について詳しくは、XDM のドキュメントを参照してください。
/personID）に正しい ID 記述子が適用されていることを確認します。ID 記述子が欠落しているか、正しく設定されていない場合、取り込みプロセスが正常に完了したとしても、このデータセットに取り込まれたプロファイルがテストプロファイル（testProfile = true）としてフラグ付けされないことがあります。- データセットに関連付けられているスキーマを確認します。
- プライマリ ID フィールドに、名前空間に適したID記述子が含まれていることを確認します（上記の手順 6～7 を参照）。
- 記述子が欠落している場合は、スキーマを更新して ID 記述子を追加し、データを再取り込みします。
データセットの作成 create-dataset
次に、プロファイルのインポート先となる データセットを作成 する必要があります。 次の手順に従います。
- データセットを参照し、「データセットを作成」をクリックします。
- 「スキーマからデータセットを作成」を選択します。
- 作成済みのスキーマを選択し、「次へ」をクリックします。
- 名前を選択し、「終了」をクリックします。
- 「プロファイル」オプションを有効にします。
製品内のユースケース use-case-1
Adobe Journey Optimizer のホームページから、製品内ユースケースのテストプロファイルを活用できます。 このユースケースは、公開前にジャーニーのテストに使用するテストプロファイルの作成を容易にします。
「開始」ボタンをクリックして、ユースケースを開始します。
次の情報が必要です。
-
ID 名前空間：テストプロファイル を一意に識別するために使用される ID 名前空間。 例えば、メールを使用してテストプロファイルを識別する場合は、ID 名前空間の メール を選択する必要があります。 一意の識別子が電話番号の場合は、ID 名前空間の 電話 を選択する必要があります。
-
CSV ファイル：作成するテストプロファイルのリストを含む、コンマ区切りファイル。 このユースケースでは、作成するテストプロファイルのリストを含む CSV ファイルに対し、形式を事前に定義しておく必要があります。 ファイルの各行には、次のフィールドが次のように正しい順序で含まれている必要があります。
- 人物 ID：テストプロファイルを表す一意の識別子です。 このフィールドの値は、選択した ID 名前空間を反映する必要があります。 （例えば、ID 名前空間に「電話」を選択した場合、このフィールドの値は電話番号にする必要があります。 同様に、「メール」を選択した場合、このフィールドの値は、メールにする必要があります）
- メールアドレス：テストプロファイルのメールアドレス。 （ID 名前空間で「メール」を選択した場合、人物 ID フィールドと メールアドレス フィールドに同じ値が含まれる可能性があります）
- 名：テストプロファイルの名。
- 姓：テストプロファイルの姓。
- 市区町村：テストプロファイルが居住している市区町村
- 国：テストプロファイルの居住国
- 性別：テストプロファイルの性別。 指定可能な値は、male、female、non_specifiedです。
ID 名前空間を選択し、上記の形式に基づいて CSV ファイルを指定したら、右上の「実行」ボタンを選択します。 このユースケースは、完了するまで数分かかる場合があります。 ユースケースがテストプロファイルの処理と作成を完了すると、ユーザーに通知が送信されます。
CSV ファイルを使用したテストプロファイルの作成 create-test-profiles-csv
Adobe Experience Platform では、様々なプロファイルフィールドを含む CSV ファイルをデータセットにアップロードして、プロファイルを作成できます。 これが最も簡単なメソッドです。
- スプレッドシートソフトウェアを使用して、単純な CSV ファイルを作成します。
- 必要な各フィールドごとに 1 列ずつ追加します。 プライマリ ID フィールド（上記の例では
personID）を追加し、「testProfile」フィールドをtrueに設定します。
- プロファイルごとに 1 行追加し、各フィールドの値を入力します。
- スプレッドシートを CSV ファイルとして保存します。 カンマが区切り記号として使用されていることを確認します。
- Adobe Experience Platform ワークフローを参照します。
- 「CSV を XDM スキーマにマッピング」を選択し、「開始」をクリックします。
- プロファイルの読み込み先となるデータセットを選択します。 「次へ」をクリックします。
- 「ファイルを選択」をクリックし、csv ファイルを選択します。 ファイルをアップロードしたら、「次へ」をクリックします。
- ソース CSV フィールドをスキーマフィールドにマッピングし、「終了」をクリックします。
- データの読み込みが開始します。 ステータスが「処理中」から「成功」に変わります。 右上の「データセットのプレビュー」をクリックします。
- テストプロファイルが正しく追加されていることを確認します。
テストプロファイルが追加され、ジャーニーのテストで使用できるようになりました。 この節を参照してください。
API 呼び出しを使用したテストプロファイルの作成 create-test-profiles-api
また、API 呼び出しを使用してテストプロファイルを作成することもできます。 詳しくは、Adobe Experience Platform ドキュメントを参照してください。
プロファイルテストの詳細フィールドグループを含むプロファイルスキーマを使用する必要があります。 testProfile フラグは、このフィールドグループの一部です。
プロファイルを作成する場合は、次の値を渡す必要があります：testProfile = true
既存のプロファイルを更新して、testProfile フラグを true に変更することもできます。
テストプロファイルを作成するための API 呼び出しの例を以下に示します。
curl -X POST \
'https://dcs.adobedc.net/collection/xxxxxxxxxxxxxx' \
-H 'Cache-Control: no-cache' \
-H 'Content-Type: application/json' \
-H 'Postman-Token: xxxxx' \
-H 'cache-control: no-cache' \
-H 'x-api-key: xxxxx' \
-H 'x-gw-ims-org-id: xxxxx' \
-d '{
"header": {
"msgType": "xdmEntityCreate",
"msgId": "xxxxx",
"msgVersion": "xxxxx",
"xactionid":"xxxxx",
"datasetId": "xxxxx",
"imsOrgId": "xxxxx",
"source": {
"name": "Postman"
},
"schemaRef": {
"id": "https://example.adobe.com/mobile/schemas/xxxxx",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "xxxxx",
"_mobile":{
"ECID": "xxxxx"
},
"testProfile":true
}
}
}'
チュートリアルビデオ video
テストプロファイルを作成する方法について説明します。