Delegar IDs do descritor

Ao usar tags no Adobe Experience Platform, todas as funcionalidades que você 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 do descritor delegado. A ID do descritor delegado de um recurso específico informa ao sistema o tipo de recurso e ao 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 cadeias de caracteres são compostas para serem legíveis em 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 chamada custom-code, essa ação teria a seguinte ID do descritor delegado: example-package::actions::custom-code.

Uso 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, condição ou ação que pertence 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 evento click 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 criar 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 quando ele é criado pela primeira vez, pois cada pacote de extensão define os tipos compatíveis para seus elementos de dados delegados, bem como seu comportamento pretendido.

Por exemplo, para criar um elemento de dados que use o tipo cookie 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 criar um elemento de dados para obter mais informações.

Extensões

Uma extensão é automaticamente associada a um pacote de extensão quando é criado pela primeira vez e é representada dentro do objeto relationships da extensão. Se sua extensão exigir configurações personalizadas, ela também exigirá uma ID de descritor delegado.

OBSERVAÇÃO

Extensões que não exigem configurações personalizadas para não precisarem de 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 guia em criar uma extensão para obter mais informações.

Nesta página