Consents & Preferences 数据类型

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

此文档涵盖Consents & Preferences数据类型提供的字段的结构和预期用途。

先决条件

此文档需要对XDM和Experience Platform中模式的使用有效的了解。 在继续之前，请查看以下文档：

• XDM系统概述
• 模式合成基础

数据类型结构

Consents & Preferences数据类型提供了若干字段，用于捕获​connence​和​preference​信息。

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

首选项是一个选项，允许客户指定如何处理品牌体验的不同方面。 这属于两个类别:

• 个性化首选项:关于品牌如何个性化向客户提供体验的偏好。
• 营销首选项:关于是否允许品牌通过各种渠道联系客户的偏好。

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

以下JSON显示了Consents & 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"
    },
    "idSpecific": {
      "email": {
        "jdoe@example.com": {
          "marketing": {
            "email": {
              "val": "n"
            }
          }
        }
      }
    }
  }
}

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

idSpecific

idSpecific 当特定同意或偏好并非普遍适用于客户，但仅限于单个设备或ID时，即可使用。例如，客户可以接收到选择退出一个地址的电子邮件，同时允许另一个地址发送电子邮件。

idSpecific对象中的每个键都表示Adobe Experience Platform Identity Service可识别的特定身份命名空间。 虽然您可以定义自己的自定义命名空间来对不同的标识符进行分类，但建议您使用标识服务提供的标准命名空间之一来减少实时客户用户档案的存储大小。 有关身份命名空间的详细信息，请参阅Identity Service文档中的身份命名空间概述。

每个命名空间对象的键表示客户为其设置首选项的唯一标识值。 每个标识值可以包含一组完整的同意和首选项，格式与consents相同。

"idSpecific": {
  "email": {
    "jdoe@example.com": {
      "marketing": {
        "email": {
          "val": "n"
        }
      }
    }
  }
}

使用数据类型收录数据

要使用Consents & Preferences数据类型从客户那里收集同意数据，您必须根据包含该数据类型的模式创建数据集。

有关如何将模式类型分配给字段的步骤，请参阅有关在UI](http://www.adobe.com/go/xdm-schema-editor-tutorial-en)中创建数据的教程。 [创建包含数据类型为Consents & Preferences的字段的模式后，请参阅数据集用户指南中创建数据集部分，按照步骤使用现有模式创建数据集。

处理同意和首选项更改

当客户在您的网站上更改其同意或偏好时，应使用Adobe Experience Platform Web SDK收集并立即实施这些更改。 如果客户选择退出数据收集，则必须立即停止所有数据收集。 如果客户选择退出个性化，那么他们访问的下一页上不应出现个性化。

附录

以下各节提供了有关Consents & Preferences数据类型的其他参考信息。

val的已接受值

下表概述了val的已接受值：

preferred的已接受值

下表概述了preferred的已接受值：

完整Consents & Preferences模式

要视图Consents & Preferences数据类型的完整模式，请参阅官方XDM存储库。