Consents and Preferences欄位群組
Consents and Preferences是XDM Individual Profile 類別的標準欄位群組，可擷取個別客戶的同意和偏好設定資訊。
欄位群組結構 structure
Consents and Preferences欄位群組提供單一物件型別欄位consents，以擷取同意和偏好設定資訊。 此欄位延伸Consent for Privacy, Personalization and Marketing Preferences資料型別，移除adID欄位並新增idSpecific對應欄位。
下列JSON顯示Consents and Preferences欄位群組可以處理的資料型別範例。 如需有關如何使用欄位群組所提供之大部分欄位的資訊，請參閱同意和偏好設定資料型別的指南。 以下子區段著重於欄位群組新增至資料型別的獨特屬性。
{
"consents": {
"collect": {
"val": "VI"
},
"share": {
"val": "y"
},
"personalize": {
"content": {
"val": "y"
}
},
"marketing": {
"preferred": "email",
"any": {
"val": "y"
},
"email": {
"val": "y"
}
},
"idSpecific": {
"ECID": {
"37784337855396895622558625508046772577": {
"adID": {
"val": "n",
},
"share": {
"val": "n"
},
"marketing": {
"push": {
"val": "n",
"time": "2020-09-30T01:02:33+00:00",
"reason": "not relevant"
}
}
}
},
"email": {
"john@xyz.com": {
"marketing": {
"email": {
"val": "y"
}
}
}
}
},
"metadata": {
"time": "2019-01-01T15:52:25+00:00"
}
}
}
idSpecific
當特定同意或偏好設定不普遍適用於客戶，但僅限於單一裝置或ID時，可以使用idSpecific。 例如，客戶可以選擇不接收某個地址的電子郵件，而可能允許另一個地址的電子郵件。
consents以外的idSpecific底下提供的同意和偏好設定）套用至該管道內的所有ID。 因此，無論遵循對等的ID或裝置特定設定，所有管道層級同意和偏好設定都會直接生效：- 如果客戶已在頻道層級選擇退出，則會忽略
idSpecific中的任何對等同意或偏好設定。 - 如果未設定管道層級的同意或偏好設定，或客戶已選擇加入，則會接受
idSpecific中相等的同意或偏好設定。
idSpecific物件中的每個索引鍵代表Adobe Experience Platform Identity服務可辨識的特定身分名稱空間。 雖然您可以定義自己的自訂名稱空間來分類不同的識別碼，但建議您使用Identity Service提供的標準名稱空間之一，來減少即時客戶個人檔案的儲存大小。 如需識別名稱空間的詳細資訊，請參閱Identity Service檔案中的識別名稱空間概觀。
每個名稱空間物件的索引鍵代表客戶已設定偏好設定的唯一身分值。 每個身分值都可以包含一組完整的同意和偏好設定，格式與consents相同。
"idSpecific": {
"email": {
"jdoe@example.com": {
"marketing": {
"email": {
"val": "n"
}
}
}
},
"ECID": {
"37784337855396895622558625508046772577": {
"collect": {
"val": "y"
},
"adID": {
"val": "n"
},
"marketing": {
"push": {
"val": "n"
}
}
}
}
}
在marketing區段中提供的idSpecific物件中，any和preferred欄位不受支援。 這些欄位只能在使用者層級設定。 此外，idSpecific、email和sms的push行銷偏好設定不支援subscriptions欄位。
也有一個同意只能在idSpecific區段中提供： adID。 以下小節將介紹此欄位。
adID
adID同意代表客戶同意是否可以使用廣告商ID （IDFA或GAID）在此裝置上跨應用程式連結客戶。 此值只能在ECID區段中的idSpecific身分名稱空間下設定，並且不能為其他名稱空間或此欄位群組的使用者層級設定。
"idSpecific": {
"ECID": {
"37784337855396895622558625508046772577": {
"collect": {
"val": "y"
},
"adID": {
"val": "n"
},
"marketing": {
"push": {
"val": "n"
}
}
}
}
}
使用欄位群組擷取資料 ingest
若要使用Consents and Preferences欄位群組從客戶擷取同意資料，您必須根據包含該欄位群組的結構描述建立資料集。
如需如何將欄位群組指派給欄位的步驟，請參閱有關在UI中建立結構描述的教學課程。 建立包含具有Consents and Preferences欄位群組的欄位的結構描述後，請參閱資料集使用指南中有關建立資料集的章節，接著依照步驟建立具有現有結構描述的資料集。
處理同意和偏好設定變更
當客戶在您的網站上變更其同意或偏好設定時，應收集這些變更，並透過在使用的資料收集程式庫中設定同意來立即執行。 如果客戶選擇退出資料收集，所有資料收集必須立即停止。 如果客戶選擇退出個人化，則他們載入的下一個頁面上應該不會出現個人化。 請參閱使用JavaScript資料庫的setConsent，或使用網頁SDK標籤延伸的Set consent動作。
後續步驟
此檔案涵蓋Consents and Preferences欄位群組的結構和使用。 如需欄位群組所提供其他欄位的詳細資訊，請參閱Consent for Privacy, Personalization and Marketing Preferences資料型別的檔案。