文档Journey OptimizerJourney Optimizer 指南

创建测试轮廓 create-test-profiles

最近更新： 2026年9月13日

创建对象：

  • 中级
  • 用户

在此页面上：​了解如何通过上传CSV文件或使用API调用创建测试配置文件，以便在Adobe Journey Optimizer中预览内容和测试历程。

style
shade-box

在历程中使用测试模式时需要测试配置文件，并且需要预览和测试您的内容。

NOTE
Journey Optimizer提供两种方法来模拟内容：单击​ 模拟内容 ​以通过样本输入数据或AI自动生成来测试内容变体；或单击​模拟内容，然后从下拉列表中选择​ 模拟内容（AEP配置文件） ​以使用测试配置文件预览。 了解如何模拟内容变体

您可以通过上传CSV文件或使用API调用来创建测试配置文件。 Adobe Journey Optimizer还提供了特定的产品内用例以便于创建测试配置文件。

您可以将JSON文件上传到现有数据集。 有关详细信息，请参阅数据摄取文档。

创建测试配置文件与在Adobe Experience Platform中创建常规配置文件类似。 有关详细信息，请参阅实时客户资料文档。

➡️ 在此视频中了解如何创建测试配置文件

先决条件 test-profile-prerequisites

要创建配置文件，您首先需要在Adobe Journey Optimizer中创建架构和数据集。

创建架构 create-schema

要​创建架构，请执行以下步骤：

  1. 在“数据管理”菜单部分中，单击​ 架构 ​并选择​ 创建架构 ​按钮。

    带有“创建架构”按钮的“架构”菜单

  2. 选择​ Standard ​作为架构创建选项。

  3. 选择架构类型，例如​个人资料，然后单击​下一步。
    架构类型选择显示单个配置文件选项

  4. 输入架构的名称，然后单击​完成。
    命名并保存架构对话框

  5. 在​ 字段组 ​部分的左侧，单击​ 添加 ​并选择适当的字段组。 确保添加​ 配置文件测试详细信息 ​字段组。
    包含“添加”按钮的字段组部分
    完成后，单击​添加字段组：字段组的列表将显示在架构概述屏幕上。
    包含字段组列表的架构概述

    note
    NOTE
    单击架构的名称可更新其属性。

  6. 在字段列表中，单击要定义为主标识的字段。
    用于选择主标识的架构字段列表

  7. 在​ 字段属性 ​右侧窗格中，检查​ 标识 ​和​ 主标识 ​选项并选择命名空间。 如果希望主标识是电子邮件地址，请选择​ 电子邮件 ​命名空间。 单击​应用。
    具有“标识”和“主标识”选项的“字段属性”面板

  8. 选择架构并在​ 架构属性 ​窗格中启用​ 配置文件 ​选项。
    启用了配置文件选项的结构描述属性窗格

  9. 单击​保存。

有关架构创建的更多信息，请参阅XDM文档。

IMPORTANT
创建或替换测试配置文件摄取的数据集时，请确保架构将正确的身份描述符应用于目标命名空间的主身份字段（例如，/personID）。 如果标识描述符缺失或配置不正确，则即使摄取过程成功完成，摄取到此数据集的配置文件也可能不会标记为测试配置文件(testProfile = true)。
如果您的测试配置文件在摄取后未正确标记：
  1. 查看与数据集关联的架构。
  2. 确认主身份字段具有适用于您的命名空间的正确身份描述符（请参阅上面的步骤6-7）。
  3. 如果缺少描述符，请更新架构以添加身份描述符并重新摄取数据。

创建数据集 create-dataset

然后，您需要​创建要在其中导入用户档案的数据集。 执行以下步骤：

  1. 浏览到​数据集，然后单击​创建数据集。
    带有“创建数据集”按钮的数据集菜单
  2. 选择​ 从架构 ​创建数据集。
    从架构创建数据集选项
  3. 选择之前创建的架构，然后单击​下一步。
    用于创建数据集的 架构选择屏幕
  4. 选择一个名称，然后单击​完成。
    命名并完成数据集对话框
  5. 启用​ 配置文件 ​选项。
    启用了配置文件选项的数据集设置
NOTE
有关创建数据集的详细信息，请参阅目录服务文档。

产品内用例 use-case-1

从Adobe Journey Optimizer主页中，您可以利用产品用例中的测试配置文件。 此用例有助于创建测试用户档案，用于在发布之前测试历程。

主页上的测试配置文件用例信息卡

单击​ 开始 ​按钮开始实施用例。

需要以下信息：

  1. 身份命名空间： 身份命名空间用于唯一标识测试配置文件。 例如，如果电子邮件用于识别测试用户档案，则应选择身份命名空间​Email。 如果唯一标识符是电话号码，则应选择身份命名空间​电话。

  2. CSV文件：包含要创建的测试配置文件列表的逗号分隔文件。 用例需要CSV文件的预定义格式，该文件包含要创建的测试用户档案列表。 文件中的每一行应按正确的顺序包含以下字段，如下所示：

    1. 人员ID：测试配置文件的唯一标识符。 此字段的值应当反映所选的身份命名空间。 (例如，如果为身份命名空间选择了​电话，则此字段的值应为电话号码。 同样，如果选择​电子邮件，则此字段的值应为电子邮件)
    2. 电子邮件地址：测试配置文件电子邮件地址。 （如果选择​ 电子邮件 ​作为身份命名空间，人员ID​字段和​ 电子邮件地址 ​字段可能包含相同的值）
    3. 名字：测试配置文件名字。
    4. 姓氏：测试配置文件的姓氏。
    5. 城市：测试配置文件居住城市
    6. 国家/地区：测试用户档案居住国家/地区
    7. 性别：测试个人资料性别。 可用值为​男、女​和​非指定

选择身份命名空间并根据上述格式提供CSV文件后，选择右上角的​ 运行 ​按钮。 用例可能需要几分钟才能完成。 一旦用例完成处理和创建测试用户档案，将发送通知以通知用户。

NOTE
测试配置文件可能会覆盖现有配置文件。 在执行用例之前，请确保CSV仅包含测试用户档案，并且它针对正确的沙盒执行。

使用CSV文件创建测试配置文件 create-test-profiles-csv

在Adobe Experience Platform中，您可以通过将包含不同配置文件字段的csv文件上传到数据集来创建配置文件。 这是最简单的方法。

  1. 使用电子表格软件创建一个简单的csv文件。
  2. 为每个必填字段添加一列。 确保添加主标识字段（上面示例中为personID），并将testProfile字段设置为true。
    CSV文件，其列标题包括personID和testProfile
  3. 为每个用户档案添加一行并填写每个字段的值。
    包含示例测试配置文件数据的 CSV文件
  4. 将电子表格另存为csv文件。 确保使用逗号作为分隔符。
  5. 浏览到Adobe Experience Platform 工作流。
    Adobe Experience Platform中的 工作流菜单
  6. 选择​将CSV映射到XDM架构，然后单击​启动。
    将CSV映射到XDM架构工作流选项
  7. 选择要将用户档案导入到的数据集。 单击​下一步。
    用于CSV导入的 数据集选择屏幕
  8. 单击​ 选择文件 ​并选择您的csv文件。 上传文件后，单击​下一步。
    使用“选择文件”按钮 文件上传屏幕
  9. 将源csv字段映射到架构字段，然后单击​完成。
    CSV字段映射界面显示源字段和目标字段
  10. 数据导入开始。 状态将从​ 正在处理 ​移至​成功。 单击右上方的​预览数据集。
    导入状态显示预览数据集按钮成功
  11. 检查测试配置文件是否已正确添加。
    数据集预览显示导入的测试配置文件

您的测试用户档案已添加，现在可以在测试历程时使用。 请参阅此小节。

NOTE
有关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

了解如何创建测试用户档案。

https://video.tv.adobe.com/v/3416329?captions=chi_hans&quality=12&learn=on
AI Knowledge Reference

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 testProfile field to true

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 testProfile flag 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 testProfile field must be set to true.
  • 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: “testProfile flag” = “testProfile field”
  • 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 testProfile flag.
  • 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 testProfile field to true when 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.
recommendation-more-help
journey-optimizer-help