getVisitorValues getvisitorvalues
這是非同步API,依預設會為Analytics、訪客ID服務、資料收集退出、地理位置以及中繼資料「blob」內容傳回識別碼。 您也可以透過選擇性的 visitor.FIELDS 列舉控制您要傳回的 ID。
內容:
語法 section-5aebe3907b2b46e997f45a1d1ed35c09
此函數使用下列語法 (斜體部分代表變數預留位置):var *values* = visitor.getVisitorValues (callback, [visitor.FIELDS. *ID type*, visitor.FIELDS. *ID type*]);
在函數參數中:
*callback*代表您擁有的回呼程式碼,此程式碼用於接收傳回的 ID。- (Optional)
visitor.FIELDS. *ID type*是列舉,可讓您指定想要此函數傳回的 ID 值。
請參閱以下所使用的案例和定義,以了解更多詳細資訊。
使用案例1:要求預設資料集 section-36a31683558742a5915db3a391e09f7b
此程式碼會傳回標準資料集。 您的請求和回應可能會如下列範例所示。
//Call the Visitor ID Service
var visitor = Visitor.getInstance ("INSERT-IMS-ORG-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 集合。 在此情況下,我們只需要訪客的ECID (MCID)和Analytics ID (MCAID)。 您的請求和回應可能會如下列範例所示。
//Call the Visitor ID Service
var visitor = Visitor.getInstance("INSERT-IMS-ORG-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 列舉中的所有值。 請注意,如果沒有特定變數的值,此方法將會傳回空字串。
值
說明
MCAAMB
加密的 Audience Manager 中繼資料稱為「Blob」。
MCAAMLH
資料收集地區 ID。 此為特定訪客ID服務資料中心之地理位置的數值識別碼。
請參閱 DCS 地區 ID、位置與主機名稱以及 getLocationHint。
MCAID
訪客的 Analytics ID。
MCMID
訪客的ECID。
請參閱 Cookie和訪客ID服務。
MCOPTOUT
指出訪客是否已選擇退出資料收集的標幟。
值包括:
- ‘isoptedout-true':訪客已選擇退出資料收集。
- ‘isoptedout-false’:訪客尚未選擇退出資料收集。
recommendation-more-help
id-service-help