Consents & Preferences 資料類型

資 Privacy/Marketing Preferences (Consent) 料類型（以下稱為「資料類型」）是Consents & PreferencesExperience Data Model (XDM)資料類型，旨在支援收集「同意管理平台」(CMPs)和您資料作業中其他來源產生的客戶權限和偏好。

本檔案涵蓋資料類型所提供欄位的結構與 Consents & Preferences 用途。

先決條件

本文檔需要對XDM和中的架構的使用有良好的瞭解 Experience Platform。 請先閱讀下列檔案，然後再繼續：

• XDM系統概述
• 架構構成基礎

資料類型結構

資料 Consents & Preferences 類型提供數個欄位，用於擷取 同意 和 偏好資訊 。

同意是允許客戶指定其資料的使用方式的選項。 大部分同意具有法律意義，因為有些司法轄區需要取得許可才能以特定方式使用資料，或要求客戶有權在不需要同意的情況下停止該使用（選擇退出）。

偏好設定選項可讓客戶指定如何處理其品牌體驗的不同方面。 這分為兩類：

• 個人化偏好設定:關於品牌應如何個人化傳遞給客戶的體驗的偏好設定。
• 行銷偏好設定:關於品牌是否允許透過各種管道與客戶聯絡的偏好設定。

下列JSON顯示資料類型可處理之資料類 Consents & Preferences 型的範例。 以下各節提供了有關這些欄位具體使用情況的資訊。

{
  "xdm:consents": {
    "xdm:collect": {
      "xdm:val": "y",
    },
    "xdm:adID": {
      "xdm:val": "VI"
    },
    "xdm:share": {
      "xdm:val": "y",
    },
    "xdm:personalize": {
      "xdm:any": {
        "xdm:val": "y",
      },
      "xdm:content": {
        "xdm:val": "y"
      }
    },
    "xdm:marketing": {
      "xdm:preferred": "email",
      "xdm:any": {
        "xdm:val": "u"
      },
      "xdm:push": {
        "xdm:val": "n",
        "xdm:reason": "Too Frequent",
        "xdm:time": "2019-01-01T15:52:25+00:00"
      }
    },
    "xdm:idSpecific": {
      "email": {
        "jdoe@example.com": {
          "xdm:marketing": {
            "xdm:email": {
              "xdm:val": "n"
            }
          }
        }
      }
    }
  },
  "xdm:metadata": {
    "xdm:time": "2019-01-01T15:52:25+00:00"
  }
}

xdm:consents

xdm:consents 包含數個欄位，說明客戶的同意與偏好。 以下子節將詳細說明這些欄位。

"xdm:consents": {
  "xdm:collect": {
    "xdm:val": "y",
  },
  "xdm:adID": {
    "xdm:val": "VI"
  },
  "xdm:share": {
    "xdm:val": "y",
  },
  "xdm:personalize": {
    "xdm:any": {
      "xdm:val": "y",
    },
    "xdm:content": {
      "xdm:val": "y"
    }
  },
  "xdm:marketing": {
    "xdm:preferred": "email",
    "xdm:any": {
      "xdm:val": "u"
    },
    "xdm:email": {
      "xdm:val": "n",
      "xdm:reason": "Too Frequent",
      "xdm:time": "2019-01-01T15:52:25+00:00"
    }
  }
}

xdm:collect

xdm:collect 代表客戶對收集其資料的同意。

"xdm:collect" : {
  "xdm:val": "y"
}

屬性	說明
xdm:val	客戶為此使用案例提供的同意選擇。 請參閱附 錄 ，瞭解接受的值和定義。

xdm:adID

xdm:adID 代表客戶同意廣告商ID（IDFA或GAID）是否可用於連結此裝置上各應用程式的客戶。

"xdm:adID" : {
  "xdm:val": "y"
}

屬性	說明
xdm:val	客戶為此使用案例提供的同意選擇。 請參閱附 錄 ，瞭解接受的值和定義。

xdm:share

xdm:share 代表客戶同意其資料是否可與第二方或第三方共用（或銷售給）。

"xdm:share" : {
  "xdm:val": "y"
}

屬性	說明
xdm:val	客戶為此使用案例提供的許可選擇。 請參閱附 錄 ，瞭解接受的值和定義。

xdm：個人化

xdm:personalize 擷取客戶偏好設定，以瞭解他們的資料可以透過哪些方式個人化。 客戶可以選擇退出特定的個人化使用案例，或完全退出個人化。

"xdm:personalize": {
  "xdm:content": {
    "xdm:val": "y",
  }
}

屬性	說明
xdm:content	代表客戶對您網站或應用程式中個人化內容的偏好。
xdm:val	指定使用案例的客戶提供的個人化偏好設定。 如果客戶不需要獲得許可，則此欄位的值應指明個人化的發生基礎。 請參閱附 錄 ，瞭解接受的值和定義。

xdm：行銷

xdm:marketing 擷取客戶對其資料可用於哪些行銷目的的偏好。 客戶可以選擇退出特定的行銷使用案例，或完全退出直接行銷。

"xdm:marketing": {
  "xdm:preferred": "email",
  "xdm:any": {
    "xdm:val": "u"
  },
  "xdm:email": {
    "xdm:val": "n",
    "xdm:reason": "Too Frequent"
  },
  "xdm:push": {
    "xdm:val": "y"
  },
  "xdm:sms": {
    "xdm:val": "y"
  }
}

屬性	說明
xdm:preferred	指出客戶首選的接收通信渠道。 請參閱附 錄 ，瞭解接受的值。
xdm:any	代表客戶對整體直接行銷的偏好。 此欄位中提供的同意偏好設定會視為任何行銷管道的「預設」偏好設定，除非以下方提供的其他子欄位覆寫 xdm:marketing。 如果您打算使用更詳細的同意選項，建議您排除此欄位。 如果值設為，則 n應忽略所有更具體的個人化設定。 如果值設為，則 y所有更精細的個人化選項也應視為 y，除非明確設為 n。 如果未設定值，則每個個人化選項的值都應依指定的方式接受。
xdm:email	指出客戶是否同意接收電子郵件訊息。
xdm:push	指出客戶是否允許接收推播通知。
xdm:sms	指出客戶是否同意接收簡訊。
xdm:val	客戶提供的指定使用案例偏好設定。 如果客戶不需要獲得許可，則此欄位的值應指明應根據何種基礎進行市場營銷使用案例。 請參閱附 錄 ，瞭解接受的值和定義。
xdm:time	行銷偏好設定變更時的ISO 8601時間戳記（如果適用）。 請注意，如果任何個別偏好設定的時間戳記與下方提供的時間戳記相同 xdm:metadata，則不會針對該偏好設定設定此欄位。
xdm:reason	當客戶退出行銷使用案例時，此字串欄位代表客戶退出的原因。

xdm:idSpecific

xdm:idSpecific 當特定同意或偏好並非普遍適用於客戶，但僅限於單一裝置或ID時，即可使用。 例如，客戶可以選擇不接收某個地址的電子郵件，同時允許另一個地址發送電子郵件。

物件中的每個金鑰 xdm:idSpecific 代表Adobe Experience Platform Identity Service所識別的特定身分名稱空間。 雖然您可以定義自己的自訂名稱空間來分類不同的識別碼，但建議您使用Identity Service提供的標準名稱空間之一來減少即時客戶個人檔案的儲存空間。 有關身份名稱空間的詳細資訊，請參 閱Identity Service文檔中的身份名稱空間 概述。

每個namespace對象的鍵代表客戶為其設定首選項的唯一標識值。 每個識別值都可以包含一組完整的同意和偏好設定，格式與相同 xdm:consents。

"xdm:idSpecific": {
  "email": {
    "jdoe@example.com": {
      "xdm:marketing": {
        "xdm:email": {
          "xdm:val": "n"
        }
      }
    }
  }
}

xdm：中繼資料

xdm:metadata 每當客戶的同意和偏好上次更新時，都會擷取一般中繼資料。

"xdm:metadata": {
  "xdm:time": "2019-01-01T15:52:25+00:00",
}

屬性	說明
xdm:time	上次更新客戶同意和偏好的時間戳記。 此欄位可用來取代將時間戳記套用至個別偏好設定，以降低負載和複雜性。 在單個首 xdm:time 選項下提供值會覆蓋該特 xdm:metadata 定首選項的時間戳記。

使用資料類型接收資料

若要使用資料類 Consents & Preferences 型從客戶收集同意資料，您必鬚根據包含該資料類型的架構來建立資料集。

如需如何指派資 料類型至欄位的步驟 ，請參閱在UI中建立架構的教學課程。 在建立包含具有資料類型的欄位的模式後，請參 Consents & Preferences 閱資料集使用手冊中有關建立資料集的 部分 ，按照使用現有模式建立資料集的步驟操作。

處理同意和偏好變更

當客戶在您的網站上變更其同意或偏好設定時，應使用 Adobe Experience Platform Web SDK收集並立即強制執行這些變更。 如果客戶退出資料收集，所有資料收集必須立即停止。 如果客戶退出個人化，那麼他們造訪的下一頁上應該不會出現個人化。

附錄

以下各節提供有關資料類型的其他 Consents & Preferences 參考資訊。

xdm:val的接受值

下表概述了以下的接受值 xdm:val:

值	標題	說明
y	是	客戶已選擇同意或偏好。 換言之，他們 同意 ，如所涉同意或偏好所示，使用其資料。
n	無	客戶已選擇不同意或拒絕。 換言之，他們不 同意 ，如有關同意或偏好所示，使用其資料。
p	待覈實	該系統尚未獲得最終同意或優惠值。 這通常是需要兩步驟驗證的同意的一部分。 例如，如果客戶選擇接收電子郵件，則該同意會設為 p ，直到他們在電子郵件中選擇連結以確認他們提供了正確的電子郵件地址，此時同意會更新為 y。 如果此許可或偏好不使用兩組驗證流程，則該選 p 擇可用於指示客戶尚未響應許可提示。 例如，您可以在客戶回應 p 同意提示之前，自動將值設為網站的第一頁。 在不需要明確同意的司法管轄區中，您也可以使用該司法管轄區來指出客戶未明確選擇退出（換言之，假定同意）。
u	未知	客戶的同意或偏好資訊未知。
LI	合法利益	收集並處理資料以達到特定目的的正當商業利益，比其對個人的潛在傷害要大。
CT	合約	為達到特定目的而收集資料，是為了履行與個人的合同義務。
CP	遵守法律義務	為達到特定目的而收集資料，是為了履行企業的法律義務。
VI	個人的切身利益	為了保護個人的切身利益，必須收集符合特定目的的資料。
PI	公共利益	為特定目的收集資料，是為了公共利益或行使官方權力而執行的。

xdm:preferred的接受值

下表概述了以下的接受值 xdm:preferred:

值	說明
email	電子郵件訊息.
push	推播通知.
inApp	應用程式內訊息.
sms	SMS 訊息.
phone	電話通話互動。
phyMail	實體郵件。
inVehicle	車內訊息。
inHome	在家留言。
iot	物聯網(IoT)消息。
social	社交媒體內容。
other	不符合標準類別的渠道。
none	無首選渠道。
unknown	首選通道未知。

完整架 Consents & Preferences 構

要查看資料類型的完 Consents & Preferences 整模式，請參 閱正式XDM儲存庫。