同意和偏好设置数据类型

隐私同意、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存储库。