委派描述符ID

在Adobe Experience Platform中使用標籤時，您可在網站上部署的所有功能都由擴充功能提供。每個擴充功能提供的功能由擴充功能開發人員定義。部署擴充功能時，會以擴充功能套件的形式與其各種功能搭配。開發人員新增至擴充功能套件的功能視為該套件的「委派」。

擴充功能套件內的每個委派都獲得唯一的委派描述元ID。特定資源的委派描述符ID告知系統它是何種資源及其所屬的擴展包。

語法

委派描述符ID由三個由雙冒號字元(::)連結的字串組成，分別代表擴充功能套件名稱、委派類型和委派名稱。這些字串是人類看得懂的，且會在擷取擴充功能套件時由系統自動產生及指派。

例如，如果名為example-package的擴展包具有名為custom-code的操作，則該操作將具有以下委託描述符ID:example-package::actions::custom-code。

委派描述元ID對於在API中定義規則元件（事件、條件和動作）和資料元素時務必要了解。以下各節將說明這些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。

例如，要將委派描述符ID添加到屬於擴展包example-package的擴展中，該擴展將使用以下delegate_descriptor_id值：example-package::extensionConfiguration::config。

如需詳細資訊，請參閱建立擴充功能的指南。