getVisitorValues getvisitorvalues

这是一个异步 API,在默认情况下可返回 Analytics 和 ID 服务中的标识符、选择禁用数据收集的用户标识符、以及地理位置和元数据“blob”内容中的标识符。此外,您还可以通过可选的 visitor.FIELDS 枚举来控制要返回哪些 ID。

目录:

语法 section-5aebe3907b2b46e997f45a1d1ed35c09

此函数使用以下语法(斜体表示变量的占位符): var *values* = visitor.getVisitorValues (callback, [visitor.FIELDS. *ID type*, visitor.FIELDS. *ID type*]);

在此函数的参数中:

  • *callback* 表示您自己的用于接收所返回 ID 的回调代码。
  • (可选) visitor.FIELDS. *ID type* 是一个枚举,用于指定您希望此函数返回的 ID 值

有关更多信息,请参阅以下用例和定义。

用例1:请求默认数据集 section-36a31683558742a5915db3a391e09f7b

此代码会返回标准数据集。您的请求和响应可能类似于以下示例。

//Call the ID service
var visitor = Visitor.getInstance ("Insert Experience Cloud organization ID here",{...});

//Add your callback to the GET method to return IDs and data.
visitor.getVisitorValues(visitorIdsCallback);

出于演示目的,缩短了默认示例响应中的某些值。

//Formatted IDs in JSON response
{
    MCMID: 'mid-1234',
    MCOPTOUT: 'isoptedout-true',
    MCAID: 'aid-1234',
    MCAAMLH: 7,
    MCAAMB: 'hgfe54236786oygj'
}

用例2:请求自定义数据集 section-467b2f4e513344c89b7332b05f6f59f3

此代码使用可选数组通过 visitor.FIELDS 枚举来返回一组特定的 ID。在这种情况下,我们只需要访客的 Experience Cloud ID (MCID) 和 Analytics ID (MCAID)。您的请求和响应可能类似于以下示例。

//Call the ID service
var visitor = Visitor.getInstance("Insert Experience Cloud organization ID here", { ... });

// Add an optional array to specify which IDs you want to return.
visitor.getVisitorValues(visitorIdsCallback, [visitor.FIELDS.MCMID, visitor.FIELDS.MCAID]);

自定义示例响应只返回在请求中指定的 ID。

//Formatted IDs in JSON response
{
    MCMID: 'mid-1234',
    MCAID: 'aid-4321'
}

定义的响应参数 section-4c4c300167694c6fbff1d6c612f372b5

下表列出并定义了响应参数。这些参数也是 visitor.FIELDS 枚举中的所有值。请注意,如果某个特定变量没有值,则此方法将返回空字符串。

描述
MCAAMB
加密的 Audience Manager 元数据,称为“blob”。
MCAAMLH

数据收集区域 ID。这是用于标识特定 ID 服务数据中心的地理位置的数字标识符。

请参阅 DCS 区域 ID、位置和主机名以及 getLocationHint

MCAID
访客的 Analytics ID。
MCMID

访客的 Experience Cloud ID。

请参阅 Cookie 和 Experience Cloud Identity 服务

MCOPTOUT

用于指示访客是否已退出数据收集的标记。

值包括:

  • 'isoptedout-true':访客已选择禁用数据收集。
  • 'isoptedout-false':访客未选择禁用数据收集。
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a