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 服务数据中心的地理位置的数字标识符。

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

MCAID

访客的 Analytics ID。

MCMID

访客的 Experience Cloud ID。

请参阅 Cookie 和 Experience Cloud Identity 服务

MCOPTOUT

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

值包括:

  • 'isoptedout-true':访客已选择禁用数据收集。
  • 'isoptedout-false':访客未选择禁用数据收集。

在此页面上