命名空间

最近更新： 2026年5月22日

创建对象：

{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

您希望能够搜索的每个 ID 均分配有一个命名空间；命名空间是一个自定义字符串，用于在所有报告包之间使用的任何变量中识别该 ID。

命名空间字符串用于识别您在数据隐私请求中提供 ID 时要搜索的字段。在提交数据隐私请求后，该请求将包含一个 JSON 部分，以指定要用于该请求的数据主体 ID。一位数据主体的一个请求中，可以包含多个 ID。 JSON包括：

包含命名空间字符串的“namespace”字段。
对于大多数Adobe Analytics请求而言，包含值“analytics”的“type”字段。
“value”字段，其中包含 Analytics 应在每个报告包的关联命名空间变量中搜索的 ID。

有关更多详细信息和标准身份命名空间列表，请参阅CX企业数据隐私API文档。请参阅创建一个访问/删除作业中的一个请求示例。

旧版 Analytics 跟踪 Cookie，又称为 Adobe Analytics ID (AAID)：

{
   "namespace": "AAID",
   "type": "standard",
   "value": "2CCEEAE88503384F-1188000089CA"
}

该值必须指定为两个用破折号分隔的十六进制数字。所有由字母构成的十六进制数字必须使用大写字母指定。十六进制值不应有任何前导零（请注意与已弃用形式中指定的相同值不同，后者要求前导零）。

此外，也可以转而使用 "namespaceId": 10 作为 "namespace": "AAID" 的代替或补充，您可能会看到其他一些 Adobe 产品使用该表单。

旧版 Analytics 跟踪 Cookie：弃用形式

{
   "namespace": "visitorId",
   "type": "analytics",
   "value": "2cceeae88503384f-00001188000089ca"
}

应将该值指定为两个16位十六进制数字或两个19位十进制数字。数字应以短划线、下划线或冒号分隔。如果任一数字没有足够的位数，则需在开头补零。

{
   "namespace": "ECID",
   "type": "standard",
   "value": "00497781304058976192356650736267671594"
}

该值必须指定为一个 38 位十进制数。如果您要从数据馈送或 Data Warehouse 报告的 mcvisid_high/low 或 post_msvisid_high/low 两列中提取该数字，则必须将这两个数字都补零为 19 位，然后先将它们与高值连接起来。

此外，也可以转而使用 "namespaceId": 4 作为 "namespace": "ECID" 的代替或补充，您可能会看到其他一些 Adobe 产品使用该表单。

NOTE

Experience Cloud ID (ECID) 以前称为 Marketing Cloud ID (MCID)，在一些现有的文档中依然会采用这种旧称。

这些 ID 是 Analytics 支持的唯一 ID，使用“type”值而不是“analytics”值。

若任何这些 Cookie ID 的值格式与规定的该 ID 格式不符，则数据隐私请求会失败，并出现“值格式不正确”的错误消息。

通常，您将会使用新的隐私 JavaScript 收集这些 Cookie ID，该 JavaScript 将为这些 JSON ID 自动提供所有相关的密钥/值对。

除了上面所列的字段（“namespace”、“type”、“value”）以外，该 JavaScript 代码还会在 JSON 中填充其他密钥/值对，但是上面列出的字段对于 Analytics 数据隐私处理来说最为重要，而且在您以其他方式收集 ID 时，只需提供上述字段。

自定义访客 ID

{
    "namespace": "customVisitorID",
    "type": "analytics",
    "value": "<ID>"
}

此外，还为自定义访客ID预定义命名空间。

自定义变量中的 ID

{
"namespace":"Email Address",
"type": "analytics",
"value": "john@xyz.com"
},
{
    "namespace": "CRM ID",
    "type": "analytics",
    "value": "123456-ABCD"
}

对于自定义流量或转化变量（prop 或 eVar）中的 ID，您应当为变量设置 ID-DEVICE 或 ID-PERSON 标签，然后将您自己的命名空间名称分配给此类型的 ID。请参阅为变量设置 ID-DEVICE 或 ID-PERSON 标签时提供命名空间。

您还可以查看之前为其他变量或报告包定义的命名空间并重复使用其中之一，以便轻松地将相同的命名空间用于存储此类型 ID 的所有报告包。另外，还可以将相同的命名空间分配给一个报告包内的多个变量。例如，一些客户将CRM ID存储在流量变量和转化变量中（根据页面，它有时位于其中一个变量中，有时位于另一个变量中，有时位于两个变量中），并且他们可以为这两个变量分配命名空间“CRM ID”。

TIP

在为数据隐私 API 指定命名空间时，请避免使用变量的友好名称（报告 UI 中显示的名称）或变量的编号（如 eVar12），除非该友好名称或变量编号也是您在应用 ID-DEVICE 或 ID-PERSON 标签时指定的命名空间。使用命名空间而不是友好名称可以使相同的用户身份标识块为多个报告包指定正确的变量：例如，当 ID 在某些报告包中位于不同的 eVar 中时，或者友好名称不匹配时（例如，友好名称已在特定的报告包中本地化）。

CAUTION

命名空间 visitorId 和 customVisitorId 是保留名称，用于识别 Analytics 旧版跟踪 Cookie 和 Analytics 客户的访客 ID。请勿将这些命名空间用于自定义流量或转化变量。

recommendation-more-help

analytics-help-admin

命名空间

Cookie ID

旧版 Analytics 跟踪 Cookie：弃用形式

身份标识服务 Cookie

自定义访客 ID

自定义变量中的 ID