[有限可用性]{class="badge informative" title="仅限于Campaign Standard已迁移的用户"}
Recommendations和限制 limitations
权限和安全性 permissions
产品配置文件映射
在Campaign Standard中,无论您分配了什么产品配置文件,都向您授予了更高的API管理员角色访问权限。 Campaign v8引入了一组不同的产品配置文件,需要从Campaign Standard映射到Campaign v8产品配置文件。
通过迁移,可将两个产品配置文件添加到您现有或预先创建的技术帐户:管理员和消息中心(用于访问事务型API)。 如果您不希望将管理员产品配置文件映射到您的技术帐户,请查看产品配置文件映射,并分配所需的产品配置文件。
租户ID
迁移后,对于任何未来的集成,建议在REST URL中使用您的 Campaign v8租户ID,替换您以前的Campaign Standard租户ID。
密钥用法
PKey值的管理在Campaign Standard和Campaign v8之间有所不同。 如果您使用Campaign Standard存储PKeys,请确保您的实施使用从以前的API调用中获取的PKeys或href动态形成后续API调用。
可用API deprecated
目前,下面列出的REST API可供使用:
- 用户档案
- 服务和订阅
- 自定义资源
- 工作流
- 营销历史记录
- 组织实体
- 隐私管理
筛选
-
要在REST API负载中使用筛选器,您需要在Campaign v8中编辑这些筛选器,并提供要在负载中使用的名称。 为此,请从 参数 选项卡访问筛选器的其他参数,并在REST API的 筛选器名称 字段中提供所需的名称。
-
不再需要使用自定义筛选器所需的“by”前缀。 过滤器名称应按照原样在请求中使用。
示例:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/<resourceName>/<customFilterName>?<customFilterparam>=<customFilterValue>
删除的数据库字段
迁移期间将删除数据库中的某些字段。 使用放置的字段时,REST API将返回空白值。 将来,弃用和删除所有已删除的字段。
包含链接资源的POST
使用以下请求正文格式时,“vehicleOwner”表示指向“nms:recipient”的链接:
{
"vehicleNumber": "20009",
"vehicleName": "Model E",
"vehicleOwner":{
"firstName":"tester 11",
"lastName":"Smith 11"
}
}
链接信息将被忽略。 因此,在“cusVehicle”下生成了一个仅包含“vehicleNumber”和“vehicleName”值的新记录。 但是,链接仍然为空,导致“vehicleOwner”被设置为null。
在Campaign v8中,当使用相同的请求正文结构并且“vehicle”链接到用户档案时,会发生错误。 出现此错误是因为“firstName”属性未被识别为“cusVehicle”有效。 但是,请求正文仅包含属性而没有链接功能,没有任何问题。
PATCH操作
- Campaign v8不支持请求正文为空的PATCH:它返回204无内容状态。
- 虽然Campaign Standard支持对架构中的元素/属性进行PATCH,但请注意,Campaign v8不支持对位置进行PATCH操作。 尝试对位置进行PATCH将导致500内部服务器错误,并显示一条错误消息,指示“zipCode”属性对于“profile”资源无效。
REST响应
以下部分列出了Campaign Standard与v8 REST响应之间的细微差异。
- 对于单个GET记录,响应中包含href。
- 在使用属性进行查询时,Campaign v8在响应中提供计数和分页。
- POST操作后,响应中将返回来自链接资源的值。
错误代码和消息
以下部分列出了Campaign Standard与Campaign v8错误代码和消息之间的差异。
个人资料 — 时区
对于Campaign Standard,时区显示为 profileAndServices/profile REST API调用的JSON响应的一部分。
使用Campaign v8时,时区仅作为 profileAndServicesExt/profile REST API调用的一部分显示给用户。 它不是 profileAndServices/profile REST API调用的一部分,因为它被添加到扩展架构中。
工作流 — 外部信号触发
Campaign Standard工作流GETAPI返回参数名称,例如工作流实例变量及其数据类型(布尔值、字符串等)。 当通过POSTAPI调用触发信号时,可用于创建格式适当的JSON请求正文。
Campaign v8不支持广告工作流实例变量,但希望开发人员了解这些变量。 因此,在迁移后,需要构建POST请求正文中的参数信息,而没有GETAPI响应中的参数信息。