Id's van beschrijvingsbestanden delegeren
Wanneer u tags gebruikt in Adobe Experience Platform, worden alle functies die u op uw site kunt implementeren, geleverd door extensies. De mogelijkheden die door elke extensie worden geboden, worden gedefinieerd door de ontwikkelaar van de extensie. Wanneer een uitbreiding wordt opgesteld, wordt het gebundeld met zijn diverse mogelijkheden in de vorm van een uitbreidingspakket. De functies die ontwikkelaars aan een extensiepakket toevoegen, worden beschouwd als 'gedelegeerde' van dat pakket.
Elke afgevaardigde binnen een uitbreidingspakket wordt gegeven een unieke identiteitskaart van de afgevaardigde van de beschrijver. De afgevaardigde beschrijver identiteitskaart voor een bepaald middel vertelt het systeem welk soort middel het is en tot welk uitbreidingspakket het behoort.
Syntaxis
Een afgevaardigde beschrijver ID bestaat uit drie koorden die door dubbel-dubbelepelkarakters (::
) worden aangesloten, die de naam van het uitbreidingspakket, het afgevaardigde type, en de afgevaardigde naam vertegenwoordigen, respectievelijk. Deze tekenreeksen worden samengesteld om leesbaar te zijn voor de mens en worden automatisch gegenereerd en toegewezen door het systeem wanneer een extensiepakket wordt ingevoegd.
Als een extensiepakket met de naam example-package
bijvoorbeeld een handeling met de naam custom-code
heeft, heeft die handeling de volgende id voor de gedelegeerde descriptor: example-package::actions::custom-code
.
Het gebruiken van afgevaardigde beschrijver IDs op toepasselijke middelen
De beschrijvings IDs van de delegatie is belangrijk om te begrijpen wanneer het over het bepalen van regelcomponenten (gebeurtenissen, voorwaarden, en acties) en gegevenselementen in API komt. In de onderstaande secties wordt beschreven hoe deze id's voor elke bron worden afgespeeld.
Regelcomponenten
A regelcomponentmoet met een gebeurtenis, een voorwaarde, of een actie worden geassocieerd die tot een uitbreidingspakket behoort. Dit vertegenwoordigt het "type"van de regelcomponent aangezien het tot de logica van de algemene regel (een gebeurtenis, een voorwaarde, of een actie) behoort. Daarom wanneer het creëren van een regelcomponent, moet een identiteitskaart van de afgevaardigde van de beschrijver worden verstrekt om erop te wijzen welke gebeurtenis, voorwaarde, of actie de regelcomponent zou moeten worden geassocieerd met.
Als u bijvoorbeeld een gebeurtenisregelcomponent wilt maken die is gebaseerd op een gebeurtenis click
in een extensiepakket example-package
, gebruikt de component rule de volgende delegate_descriptor_id
waarde: example-package::events::click
.
Zie de sectie op creërend een regelcomponentvoor meer informatie.
Gegevenselementen
A gegevenselementmoet met een uitbreidingspakket worden geassocieerd wanneer het eerst wordt gecreeerd, aangezien elk uitbreidingspakket de compatibele types voor zijn elementen van gedelegeerde gegevens, evenals hun voorgenomen gedrag bepaalt.
Als u bijvoorbeeld een gegevenselement wilt maken dat het cookie
-type gebruikt zoals gedefinieerd door het extensiepakket example-package
, gebruikt het gegevenselement de volgende delegate_descriptor_id
-waarde: example-package::dataElements::cookie
.
Zie de sectie over het creëren van een gegevenselementvoor meer informatie.
Extensies
Een uitbreidingwordt automatisch geassocieerd met een uitbreidingspakket wanneer het eerst wordt gecreeerd, en wordt vertegenwoordigd binnen het voorwerp van de uitbreiding relationships
. Als uw extensie aangepaste instellingen nodig heeft, is ook een id voor de gedelegeerde descriptor vereist.
Als u bijvoorbeeld een id van een gedelegeerde descriptor wilt toevoegen aan een extensie die tot het extensiepakket example-package
behoort, wordt voor de extensie de volgende delegate_descriptor_id
value: example-package::extensionConfiguration::config
gebruikt.
Zie de gids bij het creëren van een uitbreidingvoor meer informatie.