透過 Adobe Experience Platform Identity Service 取得使用者 ID 和區域

ID服務客戶應參閱本節，瞭解如何讀取訪問者Cookie以獲取所需ID的資訊 DCS API調用。

的 Adobe Experience Platform身份服務 將訪問者和區域ID分配給訪問您網站的用戶。 這些ID標識了中所有解決方案中的用戶 Experience Cloud 如果你想要 DCS 呼叫。

  • 的 user ID 需要標識資料並將其與特定訪問者關聯。
  • 的 region ID 是必需的，因為它與區域伺服器名稱相關聯，您需要將資料發送到 DCS。 的 DCS 將資訊儲存在地理上最接近站點訪問者的資料中心中。 請參閱 DCS 地區 ID、位置與主機名稱。

ID服務客戶可以從ID服務Cookie或通過調用函式提取此資訊。 下表說明了開始時需要完成的任務或步驟。

中的代碼 斜體 表示變數佔位符。

任務 說明

1. 檢查 Experience Cloud 狀態

你需要 Experience Cloud 帳戶以使用ID服務。 如果你有 Experience Cloud 帳戶，太好了！

如果你不是 Experience Cloud，然後註冊。 我們很想擁有你，總有更多空間。 有關如何設定帳戶的說明，請參閱 為核心服務啟用您的解決方案。

2.設定 ID服務

的 ID服務 由要用於資料收集的每頁上的JavaScript代碼組成。 請參閱ID服務 實施指南 的子菜單。

3.閱讀 ID服務 餅

的 ID服務 將用戶和區域ID儲存在AMCVcookie中。 完整Cookie名稱為 AMCV_###@AdobeOrg。 的 ### 元素是組織ID的佔位符。 請參閱 Cookie和Experience CloudID 的雙曲餘切值。

分析這些鍵值對的AMCVcookie:

  • mid=user ID:此鍵值對保存 Experience Cloud 用戶ID。
  • aamlh=region ID:此鍵值對保存區域ID(有時稱為 位置提示)，它與區域伺服器名關聯。

您可以撥打 DCS 一旦您擁有了用戶和區域ID。

4.檢索 Experience CloudID 具有getMarketingCloudVisitorID

（可選） 此函式返回 Experience Cloud 訪客身份。 它專為定制解決方案和特定使用案例而設計。 請參閱 使用getMarketingCloudVisitorID 下面和 相關ID服務文檔。

如果從ID服務Cookie獲取用戶和位置ID，則無需使用此功能。

使用 getMarketingCloudVisitorID

獲取訪問者身份的另一種方法是 getMarketingCloudVisitorID 的子菜單。 調用此函式時，將查詢 ID service 並返回ID。 getMarketingCloudVisitorID 接受可選 callback 參數，如所示：

var analyticsID = visitor.getAnalyticsVisitorID(callback)

回叫使用和用途

callback 為可選項。 此函式不工作，但僅當訪問者具有 Experience Cloud 瀏覽器中的cookie。 如果訪問者Cookie丟失，或訪問者沒有ID，則函式返回空 () 的雙曲餘切值。 即使在載入頁面並訪問者收到新ID後，也會發生這種情況。 為了避免這種情況， callback 強制此函式在載入頁面後檢查訪問者ID。 沒有 callback，即使稍後將訪問者瀏覽器寫入訪問者ID函式，訪問者ID函式也不會返回。

後續步驟

一旦您擁有了用戶和區域ID，就可以開始發送和接收 DCS 資料。 請參閱 進行DCS API調用。

本頁內容