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' :访客未选择禁用数据收集。