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。
  • (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 服務資料中心之地理位置的數字識別碼。
MCAID
訪客的
Analytics
ID。
MCMID
訪客的 Experience Cloud ID。
MCOPTOUT
表示訪客已選擇退出資料收集的標幟。
這些值包括:
  • ‘isoptedout-true'
    : 訪客已選擇退出資料收集。
  • ‘isoptedout-false’
    : 訪客尚未選擇退出資料收集。