Show Menu
主题×

getVisitorValues

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

语法

此函数使用以下语法(斜体表示变量的占位符):
var *
values
* = visitor.getVisitorValues (callback, [visitor.FIELDS. *
ID type
*, visitor.FIELDS. *
ID type
*]);
在此函数的参数中:
  • *
    callback
    *
    表示您自己的用于接收所返回 ID 的回调代码。
  • (可选)
    visitor.FIELDS. *
    ID type
    *
    是一个枚举,用于指定您希望此函数返回的 ID 值
有关更多信息,请参阅以下用例和定义。

用例 1:请求默认数据集

此代码会返回标准数据集。您的请求和响应可能与以下示例类似。
//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:请求自定义数据集

此代码使用可选数组通过
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' }

定义的响应参数

下表列出并定义了响应参数。这些参数也是
visitor.FIELDS
枚举中的所有值。请注意,如果某个特定变量没有对应的值,此方法会返回空字符串。
描述
MCAAMB
加密的
Audience Manager
元数据,称为“blob”。
MCAAMLH
数据收集区域 ID。这是特定 ID 服务数据中心地理位置的数字标识符。
MCAID
访客的
Analytics
ID。
MCMID
访客的 Experience Cloud ID。
MCOPTOUT
用于指示访客是否已选择禁用数据收集的标记。
值包括:
  • 'isoptedout-true'
    :访客已选择禁用数据收集。
  • 'isoptedout-false'
    :访客未选择禁用数据收集。