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 列舉中的所有值。請注意，如果沒有特定變數的值，此方法將會傳回空字串。