setConsent

Adobe 2.0标准consent对象

如果您将数据发送到Adobe Experience Platform，则需要在配置文件架构中包含隐私架构字段组。 有关Adobe Experience Platform 2.0标准的更多信息，请参阅Adobe中的治理、隐私和安全性。 您可以在对应于consents配置文件字段组Consents and Preferences字段的架构的下方值对象中添加数据。

• standard：您选择的同意标准。 为Adobe 2.0标准将此属性设置为"Adobe"。

• version：表示同意标准版本的字符串。 为Adobe 2.0标准将此属性设置为"2.0"。

• value：包含同意值的对象。

  • value.collect.val：同意值。 当用户选择加入时将此项设置为"y"，当用户选择退出时将此项设置为"n"。
  • value.metadata.time：用户上次更新其同意设置的时间戳。

// Set consent using the Adobe 2.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "2.0",
    "value": {
      "collect": {
        "val": "y"
      },
      "metadata": {
        "time": "YYYY-03-17T15:48:42-07:00"
      }
    }
  }]
});

IAB TCF 2.0标准consent对象

要记录通过交互式Advertising Bureau Europe (IAB)透明度和同意框架(TCF)标准提供的用户同意首选项，请设置如下所示的同意字符串。

以这种方式设置同意后，Real-time Customer Profile将更新同意信息。 要使此功能正常工作，配置文件XDM架构需要包含配置文件隐私架构字段组。 发送事件时，需要手动将IAB同意信息添加到事件XDM对象。 Web SDK不会自动在事件中包含同意信息。

要在事件中发送同意信息，您必须将体验事件隐私字段组添加到已启用Profile的XDM ExperienceEvent架构中。 有关如何配置此架构的步骤，请参阅数据集准备指南中有关更新ExperienceEvent架构的部分。

• standard：您选择的同意标准。 对于IAB TCF 2.0标准，将此属性设置为"IAB TCF"。
• version：表示同意标准版本的字符串。 对于IAB TCF 2.0标准，将此属性设置为"2.0"。
• value：包含同意值的字符串。
• gdprApplies：一个布尔值，用于确定GDPR是否适用于此同意值。 其默认值为true。
• gdprContainsPersonalData：一个布尔值，用于确定与此用户关联的事件数据是否包含个人数据。 其默认值为false。

// Set consent using the IAB TCF 2.0 standard
alloy("setConsent", {
  consent: [{
    "standard": "IAB TCF",
    "version": "2.0",
    "value": "CO052l-O052l-DGAMBFRACBgAIBAAAAABIYgEawAQEagAAAA",
    "gdprApplies": true,
    "gdprContainsPersonalData": true
  }]
});

IAB TCF 2.0 API提供了一个事件，用于指示客户何时更新同意。 当客户最初设置其首选项以及更新其首选项时，会发生这种情况。 您可以添加事件侦听器以运行setConsent命令：

const identityMap = { ... };
window.__tcfapi('addEventListener', 2, function (tcData, success) {
  if (success && tcData.eventStatus === 'useractioncomplete') {
    window.alloy("setConsent", {
      identityMap,
      consent: [
        {
          standard: "IAB TCF",
          version: "2.0",
          value: tcData.tcString,
          gdprApplies: tcData.gdprApplies
        }
      ]
    });
  }
});

上述代码块监听useractioncomplete事件，然后设置同意，传递同意字符串和gdprApplies标记。 如果您有客户的自定义标识，请务必填写identityMap变量。

Adobe 1.0标准consent对象

• standard：您选择的同意标准。 为Adobe 1.0标准将此属性设置为"Adobe"。
• version：表示同意标准版本的字符串。 为Adobe 1.0标准将此属性设置为"1.0"。
• value.general：同意值。 当用户选择加入时将此项设置为"in"，当用户选择退出时将此项设置为"out"。

// Set consent using the Adobe 1.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "1.0",
    "value": {
      "general": "in"
    }
  }]
});