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

ID服務客戶應參閱本節,以取得有關如何讀取訪客Cookie以取得進行DCS API呼叫所需ID的資訊。

Adobe Experience Platform身分服務會將訪客和地區ID指派給來到您網站的使用者。 這些ID可識別Experience Cloud中所有解決方案的使用者,如果您想進行DCS呼叫,則需要這些ID。

  • 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服務 cookie

ID服務將使用者和地區ID儲存在AMCV Cookie。 完整的Cookie名稱為AMCV_###@AdobeOrg###元素是您組織ID的預留位置。 如需詳細資訊,請參閱 Cookie和Experience CloudID

剖析這些金鑰值配對的AMCV Cookie:

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

一旦您擁有使用者和地區ID,即可呼叫 DCS

4.使用getMarketingCloudVisitorID擷取Experience CloudID

(可選)此 函式會傳回 Experience Cloud訪客ID。專為客制化解決方案和特定使用案例而設計。 請參閱下方的使用getMarketingCloudVisitorID以及相關ID服務檔案

如果您從ID服務Cookie取得使用者和位置ID,就不需要使用此功能。

使用getMarketingCloudVisitorID

另一種取得訪客ID的方式是使用getMarketingCloudVisitorID函式。 調用此函式時,將查詢ID service並返回ID。 getMarketingCloudVisitorID 接受可選 callback 參數,如所示:

var analyticsID = visitor.getAnalyticsVisitorID(callback)

回呼使用與用途

callback 為可選項。此函式不含此函式,但只有在訪客的瀏覽器中有[!DNL Experience Cloud] Cookie時,才會傳回ID。 如果訪客Cookie遺失,或訪客沒有ID,函式會傳回空的()物件。 即使頁面載入且訪客收到新ID後,仍可能發生此情況。 為避免此問題,callback會強制此函式在頁面載入後檢查訪客ID。 若沒有callback,即使訪客ID函式稍後寫入至訪客的瀏覽器,也不會傳回ID。

後續步驟

一旦您擁有使用者和地區ID,就可以開始傳送和接收DCS資料。 請參閱進行DCS API呼叫

本頁內容