Privacy/Personalization/Marketing Preferences (Consents) 字段组

Privacy/Personalization/Marketing Preferences (Consents) (以下简称“字段组 Privacy & Consents ”)是该类的标准字段 XDM Individual Profile 组,用于捕获客户同意和偏好信息。

注意

由于此字段组仅与XDM Individual Profile兼容,因此不能用于XDM ExperienceEvent模式。 如果要在“体验事件”模式中包含同意和首选项数据,请改用自定义字段组Consent for Privacy, Personalization and Marketing Preferences数据类型添加到模式。

字段组结构

重要

Consents & Preferences字段组旨在涵盖一系列同意和偏好管理用例。 因此,此文档以一般术语描述字段组字段的使用,并仅就您应如何解释这些字段的使用提出建议。 请咨询您的隐私法律团队,将现场组的结构与您的组织如何解释和向客户展示这些同意和偏好选择保持一致。

Consents & Preferences字段组提供多个字段,用于捕获​connence​和​preference​信息。

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

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

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

以下屏幕截图显示了字段组结构在平台UI中的表示方式:

小贴士

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

以下JSON显示了Consents & Preferences字段组可处理的数据类型示例。 以下各节提供了有关这些字段具体用途的信息。

{
  "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"
    }
  }
}
小贴士

您可以为在Experience Platform中定义的任何XDM模式生成示例JSON数据,以帮助可视化如何映射客户同意和偏好数据。 有关更多信息,请参阅以下文档:

现场使用案例

以下各节提供了这些字段的预期使用案例。

collect

collect 表示客户同意收集其数据。

"collect" : {
  "val": "y"
}
属性 描述
val 客户为此用例提供的同意选择。 有关已接受的值和定义,请参见附录

share

share 表示客户同意与(或售予)第二方或第三方共享其数据。

"share" : {
  "val": "y"
}
属性 描述
val 客户为此用例提供的同意选择。 有关已接受的值和定义,请参见附录

personalize

personalize 捕获客户的偏好,以了解其数据可以通过哪些方式进行个性化。客户可以选择退出针对特定的个性化使用案例,或选择退出者完全个性化。

重要

personalize 不涵盖营销使用案例。例如,如果客户选择退出所有渠道的个性化,则不应停止通过这些渠道接收通信。 相反,他们收到的消息应是通用的,而不是基于他们的用户档案。

通过同一示例,如果客户选择退出所有渠道的直接营销(通过marketing,在下一节中说明),则即使允许个性化,该客户也不应接收任何消息。

"personalize": {
  "content": {
    "val": "y",
  }
}
属性 描述
content 表示客户对您网站或应用程序上的个性化内容的偏好。
val 客户为指定用例提供的个性化首选项。 如果客户不必被提示提供同意,则此字段的值应指示进行个性化的基础。 有关已接受的值和定义,请参见附录

marketing

marketing 捕获客户关于其数据可用于哪些营销目的的偏好。客户可以选择退出使用特定的营销用例,或选择退出完全使用直接营销。

"marketing": {
  "preferred": "email",
  "any": {
    "val": "u"
  },
  "email": {
    "val": "n",
    "reason": "Too Frequent"
  },
  "push": {
    "val": "y"
  },
  "sms": {
    "val": "y"
  }
}
属性 描述
preferred 指示客户接收通信的首选渠道。 有关已接受的值,请参见附录
any 代表客户对直接营销的整体偏好。 此字段中提供的同意首选项被视为任何营销渠道的“默认”首选项,除非由marketing下提供的其他子字段覆盖。 如果您计划使用更精细的同意选项,建议您排除此字段。

如果将值设置为,则 n应忽略所有更具体的个性化设置。如果将值设置为y,则所有更细粒度的个性化选项也应视为y,除非明确设置为n。 如果取消设置该值,则每个个性化选项的值应按指定的方式显示。
email 指示客户是否同意接收电子邮件。 客户还可以在此渠道内提供个别订阅的偏好。 有关详细信息,请参阅下面的订阅部分。
push 指示客户是否允许接收推送通知。 客户还可以在此渠道内提供个别订阅的偏好。 有关详细信息,请参阅下面的订阅部分。
sms 指示客户是否同意接收短信。 客户还可以在此渠道内提供个别订阅的偏好。 有关详细信息,请参阅下面的订阅部分。
val 客户为指定用例提供的首选项。 如果客户不必被提示提供同意,则此字段的值应指明进行市场营销用例的依据。 有关已接受的值和定义,请参见附录
time 市场营销首选项更改时的ISO 8601时间戳(如果适用)。 请注意,如果任何单个首选项的时间戳与metadata下提供的时间戳相同,则不会为该首选项设置此字段。
reason 当客户选择退出营销用例时,此字符串字段表示客户选择退出的原因。

subscriptions

marketing对象的emailpushsms属性能够表示这些单个渠道的客户订阅。 这可以通过向相关营销渠道添加subscriptions属性来实现。

"marketing": {
  "email": {
    "val": "y",
    "subscriptions": {
      "daily-mail": {
        "val": "y",
        "type": "paid",
        "subscribers": {
          "john@xyz.com": {
            "time": "2019-01-01T15:52:25+00:00",
            "source": "website"
          }
        }
      },
      "shipped": {
        "val": "y",

        "subscribers": {
          "john@xyz.com": {
            "time": "2021-01-01T08:32:53+07:00",
            "source": "website"
          },
          "jane@xyz.com": {
            "time": "2020-02-03T07:54:21+07:00",
            "source": "call center",
          }
        }
      }
    }
  }
}
属性 描述
type 订阅类型。 这可以是任何描述性字符串,前提是该字符串不超过15个字符。
subscribers 可选的映射类型字段,表示订阅特定订阅的一组标识符(例如电子邮件地址或电话号码)。 此对象中的每个键都表示有关的标识符,并包含两个子属性:
  • time:身份订阅时的ISO 8601时间戳(如果适用)。
  • source:用户源的源。这可以是任何描述性字符串,前提是该字符串不超过15个字符。

metadata

metadata 在上次更新客户同意和偏好时捕获有关这些同意和偏好的一般元数据。

"metadata": {
  "time": "2019-01-01T15:52:25+00:00",
}
属性 描述
time 上次更新客户同意和首选项时的ISO 8601时间戳。 可以使用此字段,而不是将时间戳应用到单个首选项,以减少负载和复杂性。 在单个首选项下提供time值将覆盖该特定首选项的metadata时间戳。

idSpecific

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

重要

渠道级同意和偏好(即,在idSpecific之外的consents下提供的同意和偏好)适用于该渠道中的ID。 因此,无论是接受对等的ID设置还是设备特定设置,所有渠道级同意和首选项都会直接影响:

  • 如果客户已在渠道级别退出,则会忽略idSpecific中的任何对等同意或首选项。
  • 如果未设置渠道级同意或偏好,或者客户已选择,则idSpecific中的对等同意或偏好将被接受。

idSpecific对象中的每个键都表示Adobe Experience Platform 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"
        }
      }
    }
  }
}
注意

您不应直接设置此值,因为Adobe Experience Platform Mobile SDK会在适当时自动设置它。

使用字段组收录数据

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

有关如何将字段组分配给字段的步骤,请参阅有关在UI🔗中创建模式的教程。 在创建包含字段的Consents & Preferences字段组的模式后,请参阅数据集用户指南中创建数据集部分,按照步骤使用现有模式创建数据集。

重要

如果要将同意数据发送到Real-time Customer Profile,则需要根据包含Consents & Preferences字段组的XDM Individual Profile类创建启用Profile的模式。 还必须为Profile启用您基于该模式创建的数据集。 有关与模式和数据集的Real-time Customer Profile要求相关的具体步骤,请参阅上面链接的教程。

此外,您还必须确保将合并策略配置为优先处理包含最新同意和首选项数据的数据集,以便正确更新客户用户档案。 有关详细信息,请参阅合并策略的概述。

处理同意和首选项更改

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

附录

以下各节提供了有关Consents & Preferences字段组的其他参考信息。

val的已接受值

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

标题 描述
y 客户已选择同意或偏好。 换句话说,他们​do​同意使用其数据,如有关同意或偏好所示。
n 客户已选择不同意或拒绝。 换句话说,他们​​同意使用其数据,这些数据由有关的同意或偏好所指示。
p 待验证 系统尚未收到最终同意或偏好值。 这通常是需要两步核查的同意的一部分。 例如,如果客户选择接收电子邮件,则该同意将设置为p,直到他们选择电子邮件中的链接以验证他们提供了正确的电子邮件地址,此时该同意将更新为y

如果此同意或偏好不使用两组验证过程,则 p 该选择可用于指示客户尚未响应同意提示。例如,您可以在客户响应同意提示之前,在网站的第一页自动将值设置为p。 在不需要明确同意的司法管辖区,您还可以使用它指示客户未明确选择退出(即假定客户同意)。
u Unknown 客户同意或偏好信息未知。
LI 合法利益 为特定目的收集和处理这些数据的合法商业利益超过数据对个人的潜在伤害。
CT 合同 为达到指定目的而收集数据,是为了履行与个人的合同义务。
CP 遵守法律义务 为达到特定目的而收集数据,是为了履行业务的法律义务。
VI 个人的切身利益 为了保护个人的切身利益,需要为特定目的收集数据。
PI Public Interest 为特定目的收集数据,是为了公共利益或行使官方权力而进行任务。

preferred的已接受值

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

描述
email 电子邮件消息.
push 推送通知.
inApp 应用程序内消息.
sms 短信消息.
phone 电话互动。
phyMail 实际邮件。
inVehicle 车内消息。
inHome 家庭内消息。
iot 物联网(IoT)消息。
social 社交媒体内容。
other 不符合标准渠道的类别。
none 无首选渠道。
unknown 首选渠道未知。

完整Consents & Preferences模式

要视图Consents & Preferences字段组的完整模式,请参阅官方XDM存储库

On this page