getVisitorValues

這是非同步 API,依預設會為 Analytics、ID 服務、資料收集退出、地理位置以及中繼資料「blob」內容傳回識別碼。您也可以透過選擇性的 visitor.FIELDS 列舉控制您要傳回的 ID。

內容:

語法

此函數使用下列語法 (斜體部分代表變數預留位置): var *values* = visitor.getVisitorValues (callback, [visitor.FIELDS. *ID type*, visitor.FIELDS. *ID type*]);

在函數參數中:

  • *callback* 代表您擁有的回呼程式碼,此程式碼用於接收傳回的 ID。
  • (Optional) 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 Service

MCOPTOUT

指出訪客是否已選擇退出資料收集的標幟。

值包括:

  • ‘isoptedout-true':訪客已選擇退出資料收集。
  • ‘isoptedout-false’:訪客尚未選擇退出資料收集。

本頁內容