命名空間

命名空間是一組自訂字串,可用來在所有報表套裝的任何變數中識別 ID,您要搜尋的每個 ID 都會有一個指定的命名空間。

當您提供 ID 用於資料隱私權請求時,命名空間字串可識別您要搜尋的欄位。提交資料隱私權請求時,該請求會包含 JSON 區段,用以指定用於請求的資料主體 ID。您可以納入多個 ID 做為資料主體的單一請求的一部分。JSON 包含以下項目:

  • 具有命名空間字串的「namespace」欄位。
  • 大部分 Adobe Analytics 請求的「type」欄位,其中具有「analytics」這個值。
  • 具有 ID 的「value」欄位,該 ID 是 Analytics 在每個報表套裝的相關聯命名空間變數中搜尋的目標。

如需更多詳細資料,請參閱 Experience Cloud 資料隱私權 API 文件

舊版 Analytics 追蹤 Cookie,亦稱為 Adobe Analytics ID (AAID):

{
   namespace: "AAID",
   type: "standard",
   value: "2CCEEAE88503384F-1188000089CA"
}

指定值時必須採用兩組十六進位並以破折號 (-) 區隔的數字。所有十六進位數字的字母字元,指定時必須採用大寫。十六進位數值不應以零開頭 (請注意,這與已廢止的形式不同,過去要求開頭為零)。

您也可以使用 "namespaceId": 10 (而非 "namespace": "AAID"),這樣就能看到其他幾種 Adobe 產品使用該表單。

舊版 Analytics 追蹤 Cookie:已廢止的形式

{
   "namespace": "visitorId",
   "type": "analytics",
   "value": "2cceeae88503384f-00001188000089ca"
}

已廢止的形式:

指定值時應採用兩組 16 位數十六進位數字,或兩組 19 位數十進位數字。數字之間應以破折號 (-)、底線 (_) 或冒號 (😃 區隔。若數字的位數不足,應於開頭以零補足。

{
    namespace: "ECID",
    type: "standard",
    value: "00497781304058976192356650736267671594"
}

指定值時必須採用 38 位數十進位數字。如果您是從 Data Warehouse 報表或資料摘要的「mcvisid_high/low」或「post_msvisid_high/low」兩欄擷取數字,必須將這兩組數字以零補滿 19 位數,然後以數值高者在前的方式串聯這兩組值。

您也可以使用 "namespaceId": 4 (而非 "namespace": "ECID"),這樣就能看到其他幾種 Adobe 產品使用該表單。

注意

Experience Cloud ID (ECID) 先前稱為 Marketing Cloud ID (MCID),現在有些文件還是會以舊名指稱。

這些是 Analytics 支援的 ID 中,唯一使用「type」值而非「analytics」值的 ID。

若這些 Cookie ID 的數值部分格式未遵照上述該 ID 的格式,則資料隱私權請求會失敗,並產生「數值格式有誤」錯誤。

大部分情況下,您會最常使用新的隱私權 JavaScript收集這些 Cookie ID,這會自動為 JSON ID 提供所有相關索引鍵值配對。

此 JavaScript 程式碼會使用除了上述 (命名空間、類型、值) 之外的其他索引鍵值配對填入 JSON,不過以上所列欄位是 Analytics 資料隱私權處理程序中最重要的欄位,也是您以其他方式收集 ID 時唯一需要提供的項目。

自訂訪客 ID

{
     namespace: "customVisitorID",
     type: "analytics",
     value: "<ID>"
}

系統也會為自訂訪客 ID 預先定義命名空間。

自訂變數中的 ID

{
    namespace: "Email Address",
    type: "analytics", 
    value: "john@xyz.com" }, 
{
    namespace: "CRM ID", 
    type: "analytics", 
    value: "123456-ABCD" 
}

對於自訂流量或轉換變數 (屬性或 eVar) 中的 ID,請使用 ID-DEVICE 或 ID-PERSON 標籤標記變數,然後將您自己的命名空間名稱指派給該類型 ID。請參閱將變數標示為 ID-DEVICE 或 ID-PERSON 時提供命名空間

您也會看到並可重複使用先前為其他變數或報表套裝定義的命名空間,如此即可輕鬆讓儲存該類型 ID 的所有報表套裝都使用相同的命名空間。此外,您也可以指派相同的命名空間給報表套裝中的多個變數。例如,部分客戶會在流量變數和轉換變數中儲存 CRM ID (視頁面而定,有時會儲存在其中一個變數或兩者皆有),並將「CRM ID」命名空間指派給這兩個變數。

秘訣

將命名空間指定給資料隱私權 API 時,除非該命名空間是在套用 ID-DEVICE 或 ID-PERSON 標籤時指定的命名空間,否則請避免使用簡單易記的變數名稱 (報表 UI 所顯示的名稱),也不要使用變數的號碼 (如 eVar12)。使用命名空間而非簡單易記的名稱,這樣能促使同一個使用者身分識別區塊為多個報表套裝指定正確的變數。例如 ID 位於部分報表套裝的其他 eVar,或是易記名稱不符時 (像是特定報表套裝已本地化的易記名稱)。

注意

系統會保留命名空間「visitorId」和「customVisitorId」,以識別 Analytics 舊版追蹤 Cookie 和 Analytics 客戶的訪客 ID。請勿將這些命名空間用於自訂流量或轉換變數。

如需詳細資訊,請參閱將變數標示為 ID-DEVICE 或 ID-PERSON 時提供命名空間

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now