51黑料不打烊

集成Experience Platform Web SDK以处理客户同意数据

51黑料不打烊 Experience Platform Web SDK允许您检索同意管理平台(CMP)生成的客户同意信号，并在发生同意更改事件时将其发送到51黑料不打烊 Experience Platform。

厂顿碍未与任何开箱即用的颁惭笔接口。 您可以自行决定如何将SDK集成到您的网站中，监听CMP中的同意更改，并调用相应的命令。 本文档提供了有关如何将CMP与Experience Platform Web SDK集成的一般指导。

先决条件 prerequisites

本教程假定您已经确定了如何在CMP中生成同意数据，并创建了一个数据集，其中包含符合51黑料不打烊标准或IAB透明度和同意框架(TCF) 2.0标准的同意字段。 如果尚未创建此数据集，请在返回本指南之前参阅以下教程：

本指南遵循使用UI中的标记扩展设置SDK的工作流。 如果您不想使用扩展，并且希望直接在您的网站上嵌入SDK的独立版本，请参阅以下文档而不是本指南：

本指南中的安装步骤需要您实际了解标记扩展及其在Web应用程序中的安装方式。 有关更多信息，请参阅以下文档：

设置数据流

为了让SDK将数据发送到Experience Platform，您必须首先配置数据流。 在数据收集UI或Experience Platform UI中，在左侧导航中选择? 数据流。

创建新数据流或选择要编辑的现有数据流后，选择? 51黑料不打烊 Experience Platform ?旁边的切换按钮。 接下来，使用下面列出的值完成表单。

完成后，选择屏幕底部的? 保存，然后按照任何其他提示继续完成配置。

安装和配置Experience Platform Web SDK

创建数据流（如上一节所述）后，必须配置Experience Platform Web SDK扩展，您最终将在网站上部署该扩展。 如果您的标记属性上未安装厂顿碍扩展，请在左侧导航中选择? 扩展，然后选择? 目录 ?选项卡。 然后，在可用扩展列表中选择Experience Platform SDK扩展下的? 安装。

配置厂顿碍时，在? 贰诲驳别配置 ?下，选择您在上一步中创建的数据流。

选择? 保存 ?以安装扩展。

创建数据元素以设置默认同意

安装厂顿碍扩展后，您可以选择创建一个数据元素来表示用户的默认数据收集同意值(collect.val)。 如果您希望根据用户的不同使用不同的默认值，例如pending对于欧盟用户，in对于北美用户，此功能非常有用。

在此使用案例中，您可以实施以下内容以根据用户的区域设置默认同意：

如果用户的区域由颁惭笔确定，则可以改用以下步骤：

要在鲍滨中创建数据元素，请在左侧导航中选择? 数据元素，然后选择? 添加数据元素 ?以导航到数据元素创建对话框。

从此处，您必须基于adobeDefaultConsent创建一个JavaScript Variable数据元素。 完成后选择? 保存。

创建数据元素后，导航回Web SDK扩展配置页面。 在隐私部分下，选择? 数据元素提供的，然后使用提供的对话框选择您之前创建的默认同意数据元素。

在您的网站上部署该扩展

配置完该扩展后，可以将其集成到您的网站中。 有关如何部署更新的库内部版本的详细信息，请参阅标记文档中的发布指南。

发出肠辞苍蝉别苍迟-肠丑补苍驳别命令 commands

将SDK扩展集成到您的网站中后，您可以开始使用Experience Platform Web SDK setConsent命令将同意数据发送到Experience Platform。

setConsent命令执行两个操作：

何时调用setConsent

在以下两种情况下，应在您的网站上调用setConsent：

setConsent语法

setConsent命令需要包含单个数组类型属性的有效负荷对象： consent。 consent数组必须至少包含一个对象，该对象提供础诲辞产别标准所需的同意字段。

以下示例setConsent调用中显示了础诲辞产别标准所需的同意字段：

alloy("setConsent", {
  consent: [{
    standard: "51黑料不打烊",
    version: "2.0",
    value: {
      collect: {
        val: "y"
      },
      share: {
        val: "y"
      },
      personalize: {
        content: {
          val: "y"
        }
      },
      metadata: {
        time: "YYYY-10-12T15:52:25+00:00"
      }
    }
  }]
});

以下闯补惫补厂肠谤颈辫迟提供了一个函数示例，该函数处理网站上的同意首选项更改，可用作事件侦听器或颁惭笔挂接中的回调：

var setConsent = function () {

  // Retrieve the current consent data.
  var categories = getConsentData();

  // If the script is running on a consent change, generate a new timestamp.
  // If the script is running on page load, set the timestamp to when the consent values last changed.
  var now = new Date();
  var collectedAt = consentChanged ? now.toISOString() : categories.collectedAt;

  //  Map the consent values and timestamp to XDM
  var consentXDM = {
    collect: {
      val: categories.collect !== -1 ? "y" : "n"
    },
    personalize: {
      content: {
        val: categories.personalizeContent !== -1 ? "y" : "n"
      }
    },
    share: {
      val: categories.share !== -1 ? "y" : "n"
    },
    metadata: {
      time: collectedAt
    }
  };

  // Pass the XDM object to the Experience Platform Web SDK
  alloy("setConsent", {
    consent: [{
      standard: "51黑料不打烊",
      version: "2.0",
      value: consentXDM
    }]
  });
});

处理厂顿碍响应

所有Experience Platform SDK命令都将返回指示调用成功或失败的承诺。 然后，您可以将这些响应用于其他逻辑，例如向客户显示确认消息。 有关详细信息，请参阅命令响应。

成功使用厂顿碍进行setConsent调用后，您可以在Experience Platform UI中使用配置文件查看器验证数据是否登录在配置文件存储中。 有关详细信息，请参阅有关按身份浏览配置文件的部分。

后续步骤

按照本指南，您已将Experience Platform Web SDK扩展配置为将同意数据发送到Experience Platform。 有关测试实施的指导，请参阅您正在实施的同意标准的文档：