同意和偏好設定欄位群組
同意和偏好設定是XDM Individual Profile 類別的標準欄位群組,可擷取個別客戶的同意和偏好設定資訊。
欄位群組結構 structure
同意和偏好設定欄位群組提供單一物件型別欄位consents
,以擷取同意和偏好設定資訊。 此欄位延伸隱私權、Personalization和行銷偏好設定的同意資料型別,移除adID
欄位並新增idSpecific
對應欄位。
下列JSON顯示同意和偏好設定欄位群組可以處理的資料型別範例。 如需有關如何使用欄位群組所提供之大部分欄位的資訊,請參閱同意和偏好設定資料型別的指南。 以下子區段著重於欄位群組新增至資料型別的獨特屬性。
{
"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
。 例如,客戶可以選擇不接收某個地址的電子郵件,而可能允許另一個地址的電子郵件。
idSpecific
以外的consents
底下提供的同意和偏好設定)套用至該管道內的所有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"
}
}
}
}
}
在idSpecific
區段中提供的marketing
物件中,any
和preferred
欄位不受支援。 這些欄位只能在使用者層級設定。 此外,email
、sms
和push
的idSpecific
行銷偏好設定不支援subscriptions
欄位。
也有一個同意只能在idSpecific
區段中提供: adID
。 以下小節將介紹此欄位。
adID
adID
同意代表客戶同意是否可以使用廣告商ID (IDFA或GAID)在此裝置上跨應用程式連結客戶。 此值只能在idSpecific
區段中的ECID
身分名稱空間下設定,並且不能為其他名稱空間或此欄位群組的使用者層級設定。
"idSpecific": {
"ECID": {
"37784337855396895622558625508046772577": {
"collect": {
"val": "y"
},
"adID": {
"val": "n"
},
"marketing": {
"push": {
"val": "n"
}
}
}
}
}
使用欄位群組擷取資料 ingest
若要使用同意和偏好設定欄位群組來擷取客戶的同意資料,您必須根據包含該欄位群組的結構描述建立資料集。
如需如何將欄位群組指派給欄位的步驟,請參閱有關在UI中建立結構描述的教學課程。 建立包含具有同意和偏好設定欄位群組的欄位的結構描述後,請參閱資料集使用指南中有關建立資料集的章節,然後依照步驟使用現有結構描述建立資料集。
處理同意和偏好設定變更
當客戶在您的網站上變更其同意或偏好設定時,應使用Adobe Experience Platform Web SDK收集這些變更並立即強制執行。 如果客戶選擇退出資料收集,所有資料收集必須立即停止。 如果客戶選擇退出個人化,則他們造訪的下一個頁面上應該不會出現個人化。
後續步驟
此檔案涵蓋同意和偏好設定欄位群組的結構和使用。 如需欄位群組所提供其他欄位的詳細資訊,請參閱隱私權同意、Personalization和行銷偏好設定資料型別的檔案。