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

ID服務客戶應參閱本區段,了解如何讀取訪客Cookie,以取得進行DCS API呼叫所需的ID。

Adobe Experience Platform Identity Service會將訪客和地區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,便不需要使用此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呼叫🔗」。

本頁內容