getVisitorValues getvisitorvalues

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

目录：

语法 section-5aebe3907b2b46e997f45a1d1ed35c09

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

在此函数的参数中：

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

用例 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 枚举中的所有值。请注意，如果某个特定变量没有值，则此方法将返回空字符串。