このページ： 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
テストプロファイルを作成する方法について説明します。
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to create test profiles by uploading a CSV file, using API calls, or the in-product use case, including the schema and dataset prerequisites, so you can preview content and test journeys in Journey Optimizer.
Intents:
- Set up the schema (with the Profile test details field group) and dataset prerequisites for test profiles
- Create test profiles by uploading a CSV file using the Map CSV to XDM schema workflow
- Create test profiles using API calls
- Use the in-product use case to generate test profiles from a predefined CSV format
- Flag profiles as test profiles by setting the
testProfilefield totrue
Glossary:
- Test profile: A profile flagged with
testProfile = true, required for using test mode in a journey and for previewing and testing content (product-specific) - Profile test details: The field group that must be added to the schema; the
testProfileflag is part of this field group (product-specific) - Simulate content: The action to test content variations with sample input data or AI auto-generation (product-specific)
- Simulate content (AEP profiles): The option selected from the Simulate content dropdown to preview content with test profiles (product-specific)
- In-product use case: A guided card on the Journey Optimizer home page that facilitates test profile creation from a predefined CSV format (product-specific)
- Identity namespace: The namespace (for example Email or Phone) used to uniquely identify the test profiles (product-specific)
Guardrails:
- Test profiles are required when using test mode in a journey and to preview and test content.
- To create profiles you must first create a schema and a dataset; the schema must include the Profile test details field group.
- The schema must have the correct identity descriptor applied to the primary identity field for the intended namespace; if it is missing or incorrectly configured, ingested profiles may not be flagged as test profiles (
testProfile = true) even if ingestion completes successfully. - When creating a profile via CSV or API, the
testProfilefield must be set totrue. - Test profiles may override existing profiles; before running the in-product use case, ensure the CSV contains test profiles only and that it is executed against the correct sandbox.
- The in-product use case expects a predefined CSV format with fields in this order: Person Id, Email Address, First Name, Last Name, City, Country, Gender (available values male, female, non_specified).
Terminology:
- Canonical name: Test profile — Acronym: n/a — variants: test profiles
- Synonyms: “
testProfileflag” = “testProfilefield” - Do not confuse: “Simulate content” (sample input data or AI auto-generation) ≠ “Simulate content (AEP profiles)” (preview with test profiles)
- Do not confuse: “Person Id” (unique identifier reflecting the selected identity namespace) ≠ “Email Address” (test profile email address)
FAQ:
- Q: What are the ways to create test profiles? — By uploading a CSV file, using API calls, or the in-product use case.
- Q: What must the schema include? — The Profile test details field group, which contains the
testProfileflag. - Q: Why are my ingested profiles not flagged as test profiles? — The primary identity field may be missing the correct identity descriptor for your namespace; review the schema, confirm the descriptor, and re-ingest the data.
- Q: How do I mark a profile as a test profile? — Set the
testProfilefield totruewhen creating (or updating) the profile. - Q: What should I check before running the in-product use case? — That the CSV contains test profiles only and that it runs against the correct sandbox, since test profiles may override existing profiles.