委托描述符ID
使用Adobe Experience Platform中的标记时,您可以在网站上部署的所有功能都由扩展提供。 每个扩展提供的功能由扩展开发人员定义。 部署扩展时,扩展将以扩展包的形式与其各种功能捆绑在一起。 开发人员添加到扩展包的功能被视为该包的“代理人”。
扩展包中的每个委托都分配有一个唯一的委托描述符ID。 特定资源的委托描述符ID可告知系统它是什么资源以及它属于哪个扩展包。
语法
委托描述符ID包含三个由双冒号字符(::
)连接的字符串,分别表示扩展包名称、委托类型和委托名称。 这些字符串的构成可由用户读取,并在摄取扩展包时由系统自动生成和分配。
例如,如果名为example-package
的扩展包具有名为custom-code
的操作,则该操作将具有以下委托描述符ID: example-package::actions::custom-code
。
在适用的资源上使用委托描述符ID
在API中定义规则组件(事件、条件和操作)和数据元素时,务必要了解委托描述符ID。 以下各节概述了这些ID对每个资源如何发挥作用。
规则组件
规则组件必须与属于扩展包的事件、条件或操作相关联。 这表示规则组件的“类型”,因为它与整体规则(事件、条件或操作)的逻辑相关。 因此,在创建规则组件时,必须提供委托描述符ID以指示应与规则组件关联的事件、条件或操作。
例如,若要创建基于扩展包example-package
中的click
事件的事件规则组件,该规则组件将使用以下delegate_descriptor_id
值: example-package::events::click
。
有关详细信息,请参阅有关创建规则组件的部分。
数据元素
数据元素必须在首次创建时与扩展包关联,因为每个扩展包都为其委托的数据元素定义了兼容类型及其预期行为。
例如,要创建使用扩展包example-package
定义的cookie
类型的数据元素,该数据元素将使用以下delegate_descriptor_id
值: example-package::dataElements::cookie
。
有关详细信息,请参阅有关创建数据元素的部分。
扩展
扩展在首次创建时自动与扩展包关联,并在扩展的relationships
对象中呈现。 如果您的扩展需要自定义设置,则它还需要委派描述符ID。
例如,要将委托描述符ID添加到属于扩展包example-package
的扩展,该扩展将使用以下delegate_descriptor_id
值: example-package::extensionConfiguration::config
。
有关详细信息,请参阅创建扩展指南。