透過Adobe Experience Platform Identity Service取得使用者ID和區域 get-user-ids-and-regions-through-the-experience-cloud-id-service
ID服務客戶應參閱本節,瞭解如何讀取進行DCS API呼叫所需ID的訪客Cookie。
從ID服務Cookie取得使用者ID get-user-ids-from-service-cookie
Adobe Experience Platform Identity Service會將訪客與地區ID指派給造訪您網站的使用者。 這些ID可識別Experience Cloud中所有解決方案的使用者,如果您想進行DCS呼叫,則需使用這些ID。
- 需要user ID才能識別資料並與特定訪客建立關聯。
- region ID為必要項,因為它繫結至區域伺服器名稱,您必須傳送資料給DCS。 DCS會將資訊儲存在地理位置上最接近網站訪客的資料中心。 請參閱 DCS 地區 ID、位置與主機名稱。
ID服務客戶可以從ID服務Cookie或透過呼叫函式來擷取此資訊。 下表說明開始使用所需完成的工作或步驟。
斜體 中的程式碼代表變數預留位置。
您需要Experience Cloud帳戶才能使用識別碼服務。 如果您有Experience Cloud帳戶,很好!
如果您不屬於Experience Cloud,請註冊。 我們很樂意擁有您,而且永遠有更多的空間。 如需如何設定帳戶的指示,請參閱啟用核心服務的解決方案。
ID服務會將使用者和地區ID儲存在AMCV Cookie中。 完整的Cookie名稱為AMCV_###@AdobeOrg
。 ###
元素是您組織ID的預留位置。 如需詳細資訊,請參閱 Cookie與Experience Cloud識別碼。
剖析這些機碼值組的AMCV Cookie:
mid=user ID
:這個機碼值組包含Experience Cloud使用者識別碼。aamlh=region ID
:這個機碼值組儲存與地區伺服器名稱關聯的地區識別碼(有時稱為位置提示)。
一旦您擁有使用者和地區ID,即可呼叫 DCS。
(選擇性) 此函式傳回Experience Cloud訪客識別碼。 此範本專為自訂解決方案和特定使用案例而設計。 請參閱下列使用getMarketingCloudVisitorID以及相關的ID服務檔案。
如果您從ID服務Cookie取得使用者和位置ID,則不需要使用此選項。
使用getMarketingCloudVisitorID
working-with-getmarketingcloudvisitorid
另一種取得訪客ID的方法是使用getMarketingCloudVisitorID
函式。 叫用時,此函式會查詢ID service並傳回識別碼。 getMarketingCloudVisitorID
接受選用的callback
引數,如下所示:
var analyticsID = visitor.getAnalyticsVisitorID(callback)
回呼使用情況和用途 callback-usage
callback
是選用專案。 此函式可在沒有它的情況下運作,但只有在訪客的瀏覽器中有Experience Cloud Cookie時才會傳回ID。 如果訪客Cookie遺失,或訪客沒有ID,此函式會傳回空的()
物件。 即使頁面載入且訪客收到新ID,也可能會發生這種情況。 為避免此問題,callback
強制此函式在頁面載入後檢查訪客ID。 如果沒有callback
,即使稍後將訪客ID寫入訪客的瀏覽器,訪客ID函式也不會傳回ID。
後續步驟 next-steps
擁有使用者和地區ID後,您就可以開始傳送和接收DCS資料。 請參閱進行DCS API呼叫。