DCS 错误代码、消息和示例 dcs-error-codes-messages-and-examples

生成的错误代码和消息 Data Collection Servers (DCS)按代码ID以数字顺序列出。

在下表中, 斜体 表示变量占位符。

系统错误代码 system-error-codes

错误代码
错误消息
描述
0
未指定的错误
这是一个捕获全部错误,它处理其他错误处理程序未涵盖的事件。 解决此错误非常困难。 它可能是由于各种未知操作或事件导致的。 如果收到此错误,请尝试使用 DCS 再次请求。 联系 Adobe 代表问题持续存在。
1
找不到主机名的配置: hostname
我们的合作伙伴配置团队尚未设置请求中发送的主机名。 联系 Adobe 代表(如果您看到此错误消息)。
2
无效 d_orgid 值(无法找到此组织id的配置): ID
组织ID不正确。 请检查您的ID,然后重试请求。 如果您不知道或没有您的组织ID,请参阅“管理页面”部分 组织和帐户关联 以获取有关如何查找的详细信息。
10
无法评估特征
请求中的特征被部分评估或根本没有被评估。 联系 Adobe 代表问题持续存在。

集成错误代码 integration-error-codes

错误代码
错误消息
描述
100
无法检索请求的主机名
An API 调用未发送主机 HTTP 标头。 请将主机标头添加到调用中,然后重试。 大多数浏览器和 API 客户端会自动执行此操作。
101
无效 Experience Cloud 传入的ID ID
此 DCS 调用包含无效的 Experience Cloud 标识。 查看 d_mid= 标头字符串中的键值对。 确保您传入的是正确的 Experience Cloud 请重试ID。
102
无效 AAM ID 传入请求 ID
此 DCS 调用包含无效的 Audience Manager 标识。 查看 d_uuid= 标头字符串中的键值对。 确保您传入的是正确的 Audience Manager 请重试ID。
104
所有客户标识均无效
调用中的所有客户ID无效。 请检查您的ID并重试。
109
Referer HTTP referer 不允许用于合作伙伴 Partner ID
HTTP referer 调用中的标头不允许用于调用中的合作伙伴ID。 检查 HTTP referer 标题正确。
111
无效 IMS 已接收令牌
返回对象 Audience Manager - Adobe Target 集成。 对进行调用时会引发错误 DCS,包含无效的 IMS 令牌。 令牌可能格式不正确、已过期或用户可能无权访问所需的资源。

选择退出错误代码 opt-out-error-codes

代码Id
消息
描述
171
遇到ID的选择退出标记 ID
客户已选择不接收基于兴趣的广告。
172
阻止的Cookie
当用户的浏览器阻止第三方Cookie时返回。
173
通过以下方式遇到信任关系 NAI
用户已通过NAI启动选择退出流程。
198
来自此国家/地区的请求被合作伙伴阻止
根据IP地址, DCS 会阻止来自合作伙伴故意限制流量的国家/地区的请求。
199
不允许来自此国家/地区的请求

根据IP地址, DCS 阻止来自以下国家/地区的请求:

  • 古巴(CU)
  • 伊朗
  • 朝鲜(KP)
  • 苏丹(SD)
  • 叙利亚(SY)

配置文件检索错误代码 profile-retrieval-error-codes

代码Id
消息
描述
200
无法从配置文件缓存中读取ID的特征: ID
当无法从我们的内部存储读取用户配置文件时返回。
201
无法从配置文件缓存中读取以下客户ID的设备ID: ID
返回时间 设备Id 无法检索配置文件链接合并规则。
202
无法读取设备ID的相关客户: ID
返回时间 客户ID (UUID) 无法从我们的内部存储中检索与设备ID关联的合并规则。
203
无法读取ID的设备群集: ID
无法为此设备ID返回来自同一设备图集群的链接设备ID。
204
无法执行迁移,因为主设备的配置文件读取失败
如果您收到此错误,我们的数据存储区可能会遇到可扩展性问题( PC)。 如果问题仍然存在,请联系您的Adobe代表。
205
无法从执行迁移 IDID,因为配置文件读取失败 ID
如果您收到此错误,我们的数据存储区可能会遇到可扩展性问题( PC)。 如果问题仍然存在,请联系您的Adobe代表。

集成警告代码 integration-warning-codes

代码Id
消息
描述
300
客户ID无效 ID
客户ID无效(数据源缺少值,集成代码缺失,数据源格式无效,已阻止的客户ID,空白的客户ID,未授权访问不属于合作伙伴的数据源)。
301
超出了最大客户ID数。 允许的最大值为 maximum allowed. 找到的 maximum found.
与跨设备数据源关联的客户ID数量超过了每个请求允许的跨设备ID数量。 这些ID包括跨设备ID、移动设备ID或Cookie ID。 限制当前设置为10。
302
未授权的客户ID ID
当客户ID数据源不属于当前组织ID时返回。 如果您不知道或不知道自己的组织ID,请参阅中的“查找您的组织ID”部分 组织和帐户关联 以获取有关如何查找的详细信息。
303
已阻止的客户ID ID
当客户ID被识别为恶意且已添加到阻止列表中时返回。
304
阻止的数据源ID ID
当数据源ID被识别为恶意并已添加到阻止列表时返回
306
已阻止声明的设备ID ID
设备ID已被识别为恶意设备,并已添加到阻止列表中。当我们收到超量的 DCS 在短时间内包含此设备ID的请求。
307
已阻止的配置文件操作 ID
列入阻止列表已阻止读/写操作,因为ID已被识别为恶意并已添加到中。请参阅错误代码306。
309
客户ID ID 被丢弃,因为它超出了每个请求声明的客户ID限制

与错误301相关。 此错误指定由于超出限制而丢弃的客户ID。

例如,如果在 DCS 调用,其中两个将被丢弃。 为了中继哪些客户被丢弃,此错误将在响应中显示两次(每个被丢弃的客户ID显示一次)。

310
客户ID已被丢弃,因为它超出了给定命名空间的限制。 命名空间ID为 ID,客户ID为 ID.

如果为同一命名空间( )声明了3个以上的客户ID,则会返回此错误代码 DPID)在 DCS 呼叫。

https://partner.demdex.net/event?d_rtbd=json&d_cid_ic=one&d_cid_ic=one&d_cid_ic=one&d_cid_ic=one

在此示例中 DCS 请求时,为同一命名空间声明了4个id(其中集成代码一个)。 丢弃其中一个ID并返回错误310。

311
请求包含无效参数

此 DCS 至少有一个URL参数未正确编码时会返回此错误代码。 在本例中, DCS 忽略整个请求。

http(s)://partner.demdex.net/event?d_event=imp&d_rtbd=json&d_src=38454&d_site=%esid!&d_creative=%ecid!&d_adgroup=%eaid!&d_placement=%epid!&d_campaign=%ebuy!&d_adsrc=48123

在上述示例请求中, % 序列编码不正确。 因此, DCS 会置之不理。

正确编码的示例应如下所示:

http(s)://partner.demdex.net/event?d_event=imp&d_rtbd=json&d_src=38454&d_site=%25esid!&d_creative=%25ecid!&d_adgroup=%25eaid!&d_placement=%25epid!&d_campaign=%25ebuy!&d_adsrc=48123

312
请求包含无效的全局设备ID

此 DCS 当请求包含无效的全局设备ID时,将返回此错误代码。 DCS将忽略无效ID,并抛出312错误以及无效ID的特定错误。 请参阅 全局数据源Audience Manager中的ID索引 以了解有关正确的设备广告ID格式以及相应的全局数据源的详细信息。

不正确调用的示例: "http://partner.demdex.net/event?d_rtbd=json&d_cid=20915%01a53cc5a2-6aa1-4210-8ded-a88b29b6212z"

说明:An IDFA (DPID 20915) 必须为大写ID。 请求中提供的ID为小写。

313
GCL中不存在CMP ID
时间 gdpr=1 并且IAB TC字符串由评估时在Audience Manager的全局CMP列表的缓存版本中不存在的CMP ID生成,此时,适用于IAB TCF的Audience Manager插件将放弃IAB TC字符串,并照常处理请求。 IAB TCF v2.2 ${GDPR} 宏设置为0,且${GDPR_CONSENT_XXX} 宏为空。
314
CMP ID在GCL中标记为已删除
时间 gdpr=1 而且IAB TC字符串是由在我们的“全局CMP列表”缓存版本中标记为已删除的CMP生成的,如果评估时间超过从“全局CMP列表”中删除的时间,则适用于IAB TCF的Audience Manager插件会丢弃TC字符串并照常处理请求。 IAB TCF v2.2 ${GDPR} 宏设置为0,且${GDPR_CONSENT_XXX} 宏为空。
315
同意字符串表示不同意
未提供同意时,适用于IAB TCF的Audience Manager插件会选择用户退出进一步的数据收集,或者如果未检测到合作伙伴上下文,则完全丢弃调用。

示例错误代码消息 sample-error-codes

此 DCS 在中返回错误代码和消息 JSON 对象或HTTP响应字符串中的X标头。

DCS错误代码和消息示例

{
   "errors":[
      {
         "code":101,
         "msg":"Invalid Experience Cloud id passed in"
      },
      {
         "code":102,
         "msg":"Invalid aam id passed in request"
      }
   ]
}

X错误

X标头捕获的错误代码显示在URL字符串中,如下所示: X-Error: 101,102.

争用条件和错误处理

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695