同意和首 选项数据类型

隐私、个性化和营销首选项的同意数据类型（以下称“同意和首选项数据类型”）是Experience Data Model (XDM)数据类型，旨在支持由同意管理平台(CMP)生成的客户权限和首选项以及数据操作中的其他来源的收集。

本文档介绍同意和首选项数据类型提供的字段的结构和预期用途。

先决条件

本文档需要对XDM以及Experience Platform中架构的使用有一定的了解。 在继续操作之前，请查看以下文档：

• XDM系统概述
• 架构组合的基础知识

数据类型结构

同意和首选项数据类型提供了多个用于捕获​同意​和​首选项​信息的字段。

同意是允许客户指定如何使用其数据的选项。 大多数同意具有法律方面的内容，因为某些司法辖区需要获得许可才能以特定方式使用数据，或者要求客户有权在不需要肯定同意的情况下停止使用（选择退出）。

首选项是一个选项，允许客户指定如何处理其品牌体验的不同方面。 这分为两类：

• 个性化首选项:有关品牌应如何个性化交付给客户的体验的首选项。
• 营销首选项:关于是否允许品牌通过各种渠道联系客户的首选项。

以下屏幕截图显示了数据类型结构在Platform UI中的显示方式：

以下JSON显示了Consorents and Preferences数据类型可以处理的数据类型示例。 以下各节提供了有关每个字段具体用途的信息。

{
  "consents": {
    "collect": {
      "val": "y",
    },
    "adID": {
      "val": "VI"
    },
    "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

consents 包含多个描述客户同意和偏好的字段。以下各小节进一步详细介绍了这些字段。

"consents": {
  "collect": {
    "val": "y",
  },
  "adID": {
    "val": "VI"
  },
  "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（IDFA或GAID）在此设备上的多个应用程序中链接客户。

"adID" : {
  "val": "y"
}

share

share 表示客户同意是否可以与第二方或第三方共享（或出售给）其数据。

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

personalize

personalize 可捕获客户的偏好，以确定其数据可用于个性化的方式。客户可以选择退出特定的个性化用例，或完全退出个性化。

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

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",
}

使用数据类型摄取数据

要使用同意和首选项数据类型从客户那里摄取同意数据，您必须基于包含该数据类型的架构创建数据集。

有关如何将数据类型分配给字段的步骤，请参阅有关在UI🔗中创建架构的教程。 创建包含数据类型为Consorents and Preferences的字段的架构后，请参阅数据集用户指南中创建数据集部分，以按照使用现有架构创建数据集的步骤操作。

处理同意和首选项更改

当客户在您的网站上更改其同意或首选项时，应使用Adobe Experience Platform Web SDK收集并立即强制执行这些更改。 如果客户选择退出数据收集，则所有数据收集必须立即停止。 如果客户选择退出个性化，则他们访问的下一个页面上不应存在个性化。

附录

以下各节提供了有关同意和首选项数据类型的其他参考信息。

val的已接受值

下表概述了val的接受值：

preferred的已接受值

下表概述了preferred的接受值：

完整的同意和首选项架构

要查看同意和首选项数据类型的完整架构，请参阅官方XDM存储库。