テストプロファイルの作成 create-test-profiles
ジャーニーでテストモードを使用する場合は、テストプロファイルが必要です。テストモードの使用方法については、この節を参照してください。
Adobe Experience Platform でテストプロファイルを作成するには、様々な方法があります。このドキュメントでは、CSV ファイルのアップロードと API 呼び出しの使用の 2 とおりの方法を重点的に説明します。また、データセットに JSON ファイルをアップロードすることもできます。データ取り込みのドキュメントを参照してください。
これらの読み込み方法を使用すると、プロファイル属性を更新することもできます。 これにより、既存のプロファイルをテストプロファイルに変換できます。 同様のファイルまたは API 呼び出しを使用し、値が「true」の「testProfile」フィールドのみを含めます。
テストプロファイルの作成は、Adobe Experience Platform で通常のプロファイルを作成する場合と似ています。詳しくは、リアルタイム顧客プロファイルのドキュメントを参照してください。
前提条件 test-profile-prerequisites
プロファイルを作成するには、まず Adobe Experience Platform でスキーマとデータセットを作成する必要があります。
まず、スキーマを作成 する必要があります。次の手順に従います。
- Adobe Experience Platform で、左メニューの「スキーマ」をクリックします。
- 右上の「スキーマを作成」をクリックして、スキーマの種類を選択します（例：XDM 個人プロファイル）。
- スキーマの名前を選択します。
- 「Mixin」セクションで、「追加」をクリックします。
- 適切な Mixin を選択します。「プロファイルテストの詳細」Mixin を必ず追加してください。「Mixin を追加」をクリックします。
Mixin のリストは、スキーマの概要画面に表示されます。
- フィールドのリストで、プライマリ ID として定義するフィールドをクリックします。
- 右の フィールドのプロパティ ペインで、「ID」オプションと「プライマリ ID」オプションをオンにし、名前空間を選択します。メールアドレスをプライマリ ID にする場合は、「メール」名前空間を選択します。「適用」をクリックします。
- スキーマを選択し、スキーマのプロパティ で「プロファイル」オプションを有効にします。
- 「保存」をクリックします。
次に、プロファイルのインポート先となる データセットを作成 する必要があります。次の手順に従います。
- Adobe Experience Platform で、左メニューの「データセット」をクリックし、次に「データセットを作成」をクリックします。
- 「スキーマからデータセットを作成」を選択します。
- 作成済みのスキーマを選択し、「次へ」をクリックします。
- 名前を選択し、「終了」をクリックします。
- 「プロファイル」オプションを有効にします。
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 呼び出しを使用してテストプロファイルを作成することもできます。このページを参照してください。
「プロファイルテストの詳細」Mixin を含むプロファイルスキーマを使用する必要があります。testProfile フラグは、この Mixin の一部です。
プロファイルを作成する場合は、次の値を渡す必要があります：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
}
}
}'