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

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

Adobe Experience Platform Identity Service 會將訪客和地區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.Set up the ID service

ID 服務包含 JavaScript程式碼,可放置在您要用於資料收集的每個頁面上。 如需詳細資訊,請 參閱ID服務實作指南

3.閱讀 ID服務 Cookie

ID服 務會將使用者 和地區ID儲存在AMCV Cookie中。 完整的Cookie名稱為 AMCV_###@AdobeOrg。 元素 ### 是您組織ID的預留位置。 See Cookies and the Experience Cloud ID for details.

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

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

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

4.使用getMarketingCloud VisitorID擷取Experience Cloud ID

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

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

使用 getMarketingCloudVisitorID

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

var analyticsID = visitor.getAnalyticsVisitorID(callback)

回呼使用與用途

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

後續步驟

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

本頁內容