同意和偏好設定 資料型別
此 隱私、個人化和行銷偏好設定的同意 資料型別(以下稱「同意和偏好設定 資料型別")是 Experience Data Model (XDM)資料型別,旨在支援從您的資料作業收集由同意管理平台(CMP)和其他來源產生的客戶許可權和偏好設定。
本檔案說明所提供的欄位結構和用途說明。 同意和偏好設定 資料型別。
先決條件 prerequisites
參閱本檔案前,請先實際瞭解XDM及中的結構描述用法 Experience Platform. 請先檢閱下列檔案再繼續:
資料型別結構 structure
此 同意和偏好設定 資料型別提供數個用於擷取的欄位 同意 和 偏好設定 資訊。
同意是一個選項,可讓客戶指定如何使用其資料。 大部分的同意都有法律層面,因為有些司法管轄區在資料以特定方式使用前必須先取得許可,或若不需要肯定同意,則要求客戶可以選擇停止該使用(選擇退出)。
偏好設定是一個選項,可讓客戶指定應如何處理其品牌體驗的不同方面。 這些屬於兩個類別:
- 個人化偏好設定:有關品牌應如何個人化提供給客戶的體驗的偏好設定。
- 行銷偏好設定:關於品牌是否可透過各種管道聯絡客戶的偏好設定。
下列熒幕擷圖顯示資料型別的結構在Platform UI中的呈現方式:
以下JSON範例說明 同意和偏好設定 資料型別可以處理。 以下各節將提供有關這些欄位各自特定用途的資訊。
{
"consents": {
"collect": {
"val": "VI",
},
"adID": {
"idType": "IDFA",
"val": "y"
},
"share": {
"val": "y",
},
"personalize": {
"content": {
"val": "y"
}
},
"marketing": {
"preferred": "email",
"any": {
"val": "u"
},
"push": {
"val": "n",
"reason": "Too Frequent",
"time": "2019-01-01T15:52:25+00:00"
}
},
"metadata": {
"time": "2019-01-01T15:52:25+00:00"
}
}
}
consents
choices
consents
包含數個說明客戶同意和偏好設定的欄位。 以下各小節會詳細說明這些欄位。
"consents": {
"collect": {
"val": "VI",
},
"adID": {
"idType": "IDFA",
"val": "y"
},
"share": {
"val": "y",
},
"personalize": {
"content": {
"val": "y"
}
},
"marketing": {
"preferred": "email",
"any": {
"val": "u"
},
"email": {
"val": "n",
"reason": "Too Frequent",
"time": "2019-01-01T15:52:25+00:00"
}
}
}
collect
collect
代表客戶同意收集其資料。
"collect": {
"val": "y"
}
val
adID
adID
代表客戶同意廣告商ID是否可用來在此裝置上跨應用程式連結客戶。
"adID": {
"idType": "IDFA",
"val": "y"
}
idType
IDFA
廣告商的Apple ID或 GAID
Google的廣告商ID,也稱為Android廣告商ID (AAID)。val
share
share
代表客戶同意其資料可與第二方或第三方共用(或銷售給)。
"share": {
"val": "y"
}
val
personalize
personalize
personalize
擷取客戶對其資料個人化使用方式的偏好設定。 客戶可以選擇退出特定的個人化使用案例,或完全選擇退出個人化。
personalize
不包含行銷使用案例。 例如,如果客戶選擇退出所有管道的個人化,他們不應停止透過這些管道接收通訊。 相反地,他們收到的訊息應該是通用的,而不是根據其設定檔。marketing
,說明於 下一節),則即使允許個人化,該客戶也不應收到任何訊息。"personalize": {
"content": {
"val": "y",
}
}
content
val
marketing
marketing
marketing
擷取有關其資料可用於行銷用途的客戶偏好設定。 客戶可以選擇退出特定行銷使用案例,或完全選擇退出直銷。
"marketing": {
"preferred": "email",
"any": {
"val": "u"
},
"email": {
"val": "n",
"reason": "Too Frequent"
},
"push": {
"val": "y"
},
"sms": {
"val": "y"
}
}
preferred
any
marketing
. 如果您打算使用更精細的同意選項,建議您排除此欄位。如果值設定為
n
,則會忽略所有更具體的個人化設定。 如果值設定為 y
,則所有較精細的個人化選項也應視為 y
,除非明確設定為 n
. 如果未設定該值,則每個個人化選項的值都應按照指定接受。email
push
sms
val
time
metadata
,則不會針對該偏好設定設定此欄位。reason
metadata
metadata
擷取有關客戶同意和偏好設定的一般中繼資料,隨時用於上次更新。
"metadata": {
"time": "2019-01-01T15:52:25+00:00",
}
time
time
個別偏好設定下的值會覆寫 metadata
該特定偏好設定的時間戳記。使用資料型別擷取資料 ingest
為了使用 同意和偏好設定 資料型別若要從客戶擷取同意資料,您必須根據包含該資料型別的結構描述建立資料集。
請參閱上的教學課程 在UI中建立結構描述 以瞭解如何將資料型別指派給欄位的步驟。 建立包含欄位的結構描述後,使用 同意和偏好設定 資料型別,請參閱以下章節: 建立資料集 請依照步驟,在資料集使用手冊中,使用現有結構描述建立資料集。
處理同意和偏好設定變更
當客戶在您的網站上變更其同意或偏好設定時,應使用收集這些變更並立即執行 Adobe Experience Platform Web SDK. 如果客戶選擇退出資料收集,所有資料收集必須立即停止。 如果客戶選擇退出個人化,則他們造訪的下一個頁面上應該不會出現個人化。
附錄 appendix
以下各節提供以下專案的其他參考資訊: 同意和偏好設定 資料型別。
接受的值 val
choice-values
下表概述下列專案可接受的值 val
:
y
n
p
p
直到他們選取電子郵件中的連結,以確認提供正確的電子郵件地址後,同意才會更新為 y
.如果此同意或偏好設定未使用兩集驗證程式,則
p
可改為使用選擇來表示客戶尚未回應同意提示。 例如,您可以自動將值設為 p
在客戶回應同意提示之前,在網站的第一頁。 在不要求明確同意的管轄區中,您也可以使用它來表示客戶尚未明確選擇退出(換言之,假設您同意)。u
dy
請注意,如果法律或貴公司隱私權政策的變更導致部分或所有使用者的預設值變更,您必須手動更新包含預設值的所有設定檔。
dn
請注意,如果法律或貴公司隱私權政策的變更導致部分或所有使用者的預設值變更,您必須手動更新包含預設值的所有設定檔。
LI
CT
CP
VI
PI
接受的值 preferred
preferred-values
下表概述下列專案可接受的值 preferred
. 此 preferred
值表示客戶接收通訊的偏好管道,這些通訊會告知他們資料收集、隱私權政策和個人化選項。
email
push
inApp
sms
phone
phyMail
inVehicle
inHome
iot
social
other
none
unknown
完整 同意和偏好設定 綱要 full-schema
若要檢視的完整結構描述 同意和偏好設定 資料型別,請參閱 官方XDM存放庫.