同意和偏好设置字段组

同意和偏好设置是XDM Individual Profile 类的标准字段组,用于捕获单个客户的同意和偏好设置信息。

NOTE
由于此字段组仅与XDM Individual Profile兼容,因此无法用于XDM ExperienceEvent架构。 如果要在Experience Event架构中包含同意和偏好设置数据,请改为使用自定义字段组隐私同意、Personalization和营销偏好设置数据类型添加到架构中。

字段组结构 structure

同意和偏好设置字段组提供单个对象类型字段consents以捕获同意和偏好设置信息。 此字段扩展了隐私、Personalization和营销偏好设置的同意数据类型,删除了adID字段并添加了idSpecific映射字段。

TIP
有关如何在Platform UI中查找任何XDM资源并检查其结构的步骤,请参阅关于探索XDM资源的指南。

以下JSON显示了同意和偏好设置字段组可以处理的数据类型示例。 有关如何使用字段组提供的大多数字段的信息,请参阅同意和偏好设置数据类型的指南。 以下子部分重点介绍字段组添加到数据类型的唯一属性。

{
  "consents": {
    "collect": {
      "val": "VI"
    },
    "share": {
      "val": "y"
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "y"
      },
      "email": {
        "val": "y"
      }
    },
    "idSpecific": {
      "ECID": {
        "37784337855396895622558625508046772577": {
          "adID": {
            "val": "n",
          },
          "share": {
            "val": "n"
          },
          "marketing": {
            "push": {
              "val": "n",
              "time": "2020-09-30T01:02:33+00:00",
              "reason": "not relevant"
            }
          }
        }
      },
      "email": {
        "john@xyz.com": {
          "marketing": {
            "email": {
              "val": "y"
            }
          }
        }
      }
    },
    "metadata": {
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}
TIP
您可以为在Experience Platform中定义的任何XDM架构生成示例JSON数据,以帮助可视化应如何映射客户同意和偏好设置数据。 有关更多信息,请参阅以下文档:

idSpecific

当特定同意或偏好设置不是普遍适用于某个客户,而是仅限于单个设备或ID时,可以使用idSpecific。 例如,客户可以选择不接收发往一个地址的电子邮件,而可能允许发往另一个地址的电子邮件。

IMPORTANT
渠道级别的同意和偏好设置(即idSpecific之外的consents下提供的同意和偏好设置)适用于该渠道内的所有ID。 因此,无论遵循等效的特定于ID还是特定于设备的设置,所有渠道级别的同意和偏好设置都会直接产生作用:
  • 如果客户在渠道级别选择退出,则idSpecific中的任何等效同意或偏好设置都将被忽略。
  • 如果未设置渠道级别的同意或偏好设置,或者客户已选择加入,则会接受idSpecific中的等效同意或偏好设置。

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

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

"idSpecific": {
  "email": {
    "jdoe@example.com": {
      "marketing": {
        "email": {
          "val": "n"
        }
      }
    }
  },
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}

idSpecific部分中提供的marketing对象中,anypreferred字段不受支持。 这些字段只能在用户级别配置。 此外,emailsmspushidSpecific营销首选项不支持subscriptions字段。

还有只能在idSpecific部分提供的同意: adID。 此字段将在以下子部分中介绍。

adID

adID同意表示客户同意是否可以使用广告商ID(IDFA或GAID)在此设备上跨应用程序链接客户。 此值只能在idSpecific部分中的ECID身份命名空间下配置,不能为其他命名空间或此字段组的用户级别设置。

"idSpecific": {
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}
NOTE
您不应直接设置此值,因为Adobe Experience Platform Mobile SDK会在适当时自动设置此值。

使用字段组摄取数据 ingest

要使用同意和偏好设置字段组从客户中摄取同意数据,您必须基于包含该字段组的架构创建数据集。

有关如何将字段组分配给字段的步骤,请参阅有关在UI中创建架构的教程。 创建架构后,该架构包含的字段具有同意和偏好设置字段组,请参阅数据集用户指南中有关创建数据集的部分,并按照使用现有架构创建数据集的步骤操作。

IMPORTANT
如果要将同意数据发送到Real-Time Customer Profile,需要您根据包含同意和偏好设置字段组的XDM Individual Profile类创建启用Profile的架构。 还必须为Profile启用您根据该架构创建的数据集。 请参阅上面链接的教程,了解与架构和数据集的Real-Time Customer Profile要求相关的特定步骤。
此外,您还必须确保将合并策略配置为优先考虑包含最新同意和偏好设置数据的数据集,以便正确更新客户配置文件。 有关详细信息,请参阅有关合并策略的概述。

处理同意和偏好设置更改

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

后续步骤

本文档介绍了同意和偏好设置字段组的结构和用法。 有关字段组提供的其他字段的更多信息,请参阅有关隐私同意、Personalization和营销偏好设置数据类型的文档。

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07