同意和偏好設定資料型別

隱私權、Personalization和行銷偏好設定的同意資料型別（以下稱為「同意和偏好設定」資料型別）是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"
}

adID

adID代表客戶同意是否可以使用廣告商ID在此裝置上跨應用程式連結客戶。

"adID": {
  "idType": "IDFA",
  "val": "y"
}

share

share代表客戶同意其資料可以與第二方或第三方共用（或賣給）。

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

personalize personalize

personalize擷取客戶對其資料用於個人化的偏好設定。 客戶可以選擇退出特定的個人化使用案例，或完全選擇退出個人化。

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

marketing marketing

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

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

metadata

metadata會擷取有關客戶同意和偏好設定的一般中繼資料，而不論何時進行上次更新。

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

使用資料型別擷取資料 ingest

若要使用同意和偏好設定資料型別從客戶擷取同意資料，您必須根據包含該資料型別的結構描述建立資料集。

如需如何將資料型別指派給欄位的步驟，請參閱有關在UI中建立結構描述的教學課程。 建立包含欄位（具有同意和偏好設定資料型別）的結構描述後，請參閱資料集使用指南中有關建立資料集的章節，並依照步驟使用現有結構描述建立資料集。

處理同意和偏好設定變更

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

附錄 appendix

以下各節提供有關同意和偏好設定資料型別的其他參考資訊。

val的接受值 choice-values

下表概述val的接受值：

preferred的接受值 preferred-values

下表概述preferred的接受值。 preferred值表示客戶接收通訊的偏好管道，這些通訊會告知他們資料收集、隱私權政策和個人化選項。

完整同意和偏好設定結構描述 full-schema

若要檢視同意和偏好設定資料型別的完整結構描述，請參閱官方XDM存放庫。