テストプロファイルの作成 create-test-profiles
ジャーニーでテストモードを使用する際や、コンテンツをプレビューしてテストするには、テストプロファイルが必要です。
テストプロファイルを作成する方法はいくつかあります。このページの詳細は次のとおりです。
既存のデータセットで json ファイルをアップロードすることもできます。詳しくは、データ取得ドキュメントを参照してください。
テストプロファイルの作成は、Adobe Experience Platform で通常のプロファイルを作成する場合と似ていることに注意してください。詳しくは、リアルタイム顧客プロファイルドキュメントを参照してください。
➡️ テストプロファイルの作成方法は、このビデオを参照してください
前提条件 test-profile-prerequisites
プロファイルを作成するには、まず Adobe Journey Optimizer でスキーマとデータセットを作成する必要があります。
スキーマを作成する には、次の手順に従います。
-
「データ管理」メニューセクションで、「スキーマ」をクリックします。
-
右上の「スキーマを作成」をクリックして、スキーマの種類を選択し(例:個人プロファイル)、「次へ」をクリックします。
-
スキーマの名前を入力して、「終了」をクリックします。
-
「フィールドグループ」セクションの左側で、「追加」をクリックして、適切なフィールドグループを選択します。「プロファイルテストの詳細」フィールドグループを必ず追加してください。
完了したら、「 フィールドグループを追加」をクリックします。フィールドグループのリストが、スキーマの概要画面に表示されます。
note note NOTE スキーマの名前をクリックして、そのプロパティを更新します。 -
フィールドのリストで、プライマリ ID として定義するフィールドをクリックします。
-
右の フィールドのプロパティ ペインで、「ID」オプションと「メイン ID」オプションをオンにし、名前空間を選択します。メールアドレスをプライマリ ID にする場合は、「メール」名前空間を選択します。「適用」をクリックします。
-
スキーマを選択し、スキーマのプロパティ ペインで「プロファイル 」オプションを有効にします。
-
「保存」をクリックします。
次に、プロファイルのインポート先となる データセットを作成 する必要があります。次の手順に従います。
- データセット を参照し、「データセットを作成」をクリックします。
- 「スキーマからデータセットを作成」を選択します。
- 作成済みのスキーマを選択し、「次へ」をクリックします。
- 名前を選択し、「終了」をクリックします。
- 「プロファイル」オプションを有効にします。
製品内のユースケース use-case-1
Adobe Journey Optimizer のホームページから、製品内ユースケースのテストプロファイルを活用できます。このユースケースは、公開前にジャーニーのテストに使用するテストプロファイルの作成を容易にします。
「開始」ボタンをクリックして、ユースケースを開始します。
次の情報が必要です。
-
ID 名前空間:テストプロファイル を一意に識別するために使用される ID 名前空間。例えば、メールを使用してテストプロファイルを識別する場合は、ID 名前空間の メール を選択する必要があります。一意の識別子が電話番号の場合は、ID 名前空間の 電話 を選択する必要があります。
-
CSV ファイル:作成するテストプロファイルのリストを含む、コンマ区切りファイル。このユースケースでは、作成するテストプロファイルのリストを含む CSV ファイルに対し、形式を事前に定義しておく必要があります。ファイルの各行には、次のフィールドが次のように正しい順序で含まれている必要があります。
- 人物 ID:テストプロファイルを表す一意の識別子です。このフィールドの値は、選択した ID 名前空間を反映する必要があります。(例えば、ID 名前空間に「電話」を選択した場合、このフィールドの値は電話番号にする必要があります。同様に、「メール」を選択した場合、このフィールドの値は、メールにする必要があります)
- メールアドレス:テストプロファイルのメールアドレス。(ID 名前空間で「メール」を選択した場合、人物 ID フィールドと メールアドレス フィールドに同じ値が含まれる可能性があります)
- 名:テストプロファイルの名。
- 姓:テストプロファイルの姓。
- 市区町村:テストプロファイルが居住している市区町村
- 国:テストプロファイルの居住国
- 性別:テストプロファイルの性別。指定可能な値は、male、female、non_specified です。
ID 名前空間を選択し、上記の形式に基づいて CSV ファイルを指定したら、右上の「実行」ボタンをクリックします。このユースケースは、完了するまで数分かかる場合があります。ユースケースがテストプロファイルの処理と作成を完了すると、ユーザーに通知が送信されます。
プロファイルからテストプロファイルへの変換 turning-profile-into-test
既存のプロファイルをテストプロファイルに変換したり、プロファイルの作成時と同じ方法でプロファイル属性を更新したりできます。
簡単な方法として、ジャーニーで「プロファイルを更新」アクションアクティビティを使用し、ブール値フィールド testProfile を「false」から「true」に変更します。
ジャーニーは、オーディエンスを読み取り アクティビティと プロファイルを更新 アクティビティで構成されます。まず、テストプロファイルに変換するプロファイルをターゲットにしたオーディエンスを作成する必要があります。
-
オーディエンス を参照し、右上の「オーディエンスを作成」を選択します。
-
オーディエンス名を定義してオーディエンスを作成する:目的のプロファイルをターゲットにするためのフィールドと値を選択します。
-
「保存」をクリックし、オーディエンスによってプロファイルが正しくターゲットになっていることを確認します。
note note NOTE オーディエンスの計算には時間がかかる場合があります。オーディエンスについて詳しくは、この節を参照してください。 -
次に、新しいジャーニーを作成し、オーディエンスを読み取り オーケストレーションアクティビティから始めます。
-
以前に作成したオーディエンスと、プロファイルで使用する名前空間を選択します。
-
「プロファイルを更新」アクションアクティビティを追加します。
-
スキーマ、testProfiles フィールド、データセットを選択し、値を「true」に設定します。これを実行するには、「値」フィールドで、右側の「ペン」アイコンをクリックし、「詳細設定モード」を選択して、「true」と入力します。
-
「公開」をクリックします。
-
「オーディエンス」セクションで、プロファイルが正しく更新されていることを確認します。
note note NOTE 「プロファイルを更新」アクティビティについては、このセクションを参照してください。
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
テストプロファイルを作成する方法について説明します。