Delegar IDs do descritor
Quando você usa tags na Adobe Experience Platform, todas as funcionalidades que pode implantar no site são fornecidas por extensões. Os recursos fornecidos por cada extensão são definidos pelo desenvolvedor da extensão. Quando uma extensão é implantada, ela é fornecida com seus vários recursos na forma de um pacote de extensão. As funcionalidades que os desenvolvedores adicionam a um pacote de extensão são consideradas "delegados" desse pacote.
Cada delegado em um pacote de extensão recebe uma ID exclusiva de descritor delegado. A ID do descritor delegado de um recurso específico informa ao sistema o tipo de recurso e o pacote de extensão ao qual ele pertence.
Sintaxe
Uma ID de descritor delegado consiste em três strings unidas por caracteres de dois-pontos (::
), representando o nome do pacote de extensão, o tipo delegado e o nome delegado, respectivamente. Essas strings são compostas para serem legíveis por humanos e são geradas e atribuídas automaticamente pelo sistema quando um pacote de extensão é assimilado.
Por exemplo, se um pacote de extensão chamado example-package
tiver uma ação chamadacustom-code
, essa ação terá a seguinte ID de descritor delegado: example-package::actions::custom-code
.
Utilização de IDs de descritor delegado em recursos aplicáveis
Delegar IDs de descritor é importante para entender quando se trata de definir componentes de regra (eventos, condições e ações) e elementos de dados na API. As seções abaixo descrevem como essas IDs são exibidas para cada recurso.
Componentes da regra
Um componente de regra deve ser associado a um evento, uma condição ou uma ação que pertença a um pacote de extensão. Representa o "tipo" do componente de regra, pois pertence à lógica da regra geral (um evento, uma condição ou uma ação). Portanto, ao criar um componente de regra, uma ID de descritor delegado deve ser fornecida para indicar a qual evento, condição ou ação o componente de regra deve ser associado.
Por exemplo, para criar um componente de regra de evento baseado em um click
evento em um pacote de extensão example-package
, o componente de regra usaria o seguinte valor: delegate_descriptor_id
: example-package::events::click
.
Consulte a seção sobre criação de um componente de regra para obter mais informações.
Elementos de dados
Um elemento de dados deve ser associado a um pacote de extensão ao ser criado pela primeira vez, pois cada pacote de extensão define os tipos compatíveis para seus elementos de dados delegados, bem como o comportamento pretendido.
Por exemplo, para criar um elemento de dados que use o cookie
tipo conforme definido por um pacote de extensão example-package
, o elemento de dados usaria o seguinte valor delegate_descriptor_id
: example-package::dataElements::cookie
.
Consulte a seção sobre criação de um elemento de dados para obter mais informações.
Extensões
Uma extensão é automaticamente associada a um pacote de extensão quando ele é criado pela primeira vez e é representada no objeto relationships
da extensão. Se sua extensão exigir configurações personalizadas, ela também exigirá uma ID de descritor delegado.
Por exemplo, para adicionar uma ID de descritor delegado a uma extensão que pertence ao pacote de extensão example-package
, a extensão usaria o seguinte valor delegate_descriptor_id
: example-package::extensionConfiguration::config
.
Consulte o manual sobre criação de uma extensão para obter mais informações.