Delegaten-Deskriptor-IDs

Wenn Sie Tags in Adobe Experience Platform verwenden, werden alle Funktionen, die Sie auf Ihrer Site bereitstellen können, durch Erweiterungen bereitgestellt. Die von jeder Erweiterung bereitgestellten Funktionen werden vom Erweiterungsentwickler definiert. Wenn eine Erweiterung bereitgestellt wird, wird sie mit den verschiedenen Funktionen in Form eines Erweiterungspakets gebündelt. Die Funktionen, die Entwickler einem Erweiterungspaket hinzufügen, werden als „Delegaten“ dieses Pakets betrachtet.

Jedem Delegaten in einem Erweiterungspaket wird eine eindeutige Delegaten-Deskriptor-ID zugewiesen. Die Delegaten-Deskriptor-ID für eine bestimmte Ressource teilt dem System mit, um welche Art von Ressource es sich handelt und zu welchem Erweiterungspaket sie gehört.

Syntax

Eine Delegaten-Deskriptor-ID besteht aus drei Zeichenfolgen, die durch Doppelpunktzeichen (::) verbunden sind und den Namen des Erweiterungspakets, den Delegatentyp bzw. den Delegatennamen darstellen. Diese Zeichenfolgen sind so verfasst, dass sie für Menschen lesbar sind, und werden automatisch vom System generiert und zugewiesen, wenn ein Erweiterungspaket aufgenommen wird.

Wenn beispielsweise ein Erweiterungspaket mit dem Namen example-packageeine Aktion mit dem Namencustom-code enthält, hätte diese Aktion die folgende Delegaten-Deskriptor-ID: example-package::actions::custom-code.

Verwenden von Delegaten-Deskriptor-IDs für entsprechende Ressourcen

Es ist wichtig, Delegaten-Deskriptor-IDs zu verstehen, wenn Sie Regelkomponenten (Ereignisse, Bedingungen und Aktionen) und Datenelemente in der API definieren möchten. In den folgenden Abschnitten wird beschrieben, welche Rolle diese IDs für die einzelnen Ressourcen spielen.

Regel Komponenten

Eine Regelkomponente muss einem Ereignis, einer Bedingung oder einer Aktion zugeordnet sein, das/die zu einem Erweiterungspaket gehört. Dies stellt den „Typ“ der Regelkomponente dar, der sich auf die Logik der Gesamtregel bezieht (ein Ereignis, eine Bedingung oder eine Aktion). Daher muss beim Erstellen einer Regelkomponente eine Delegierten-Deskriptor-ID bereitgestellt werden, um anzugeben, welchem Ereignis, welcher Bedingung oder Aktion die Regelkomponente zugeordnet werden soll.

Um beispielsweise eine Ereignisregelkomponente zu erstellen, die auf einem click-Ereignis in einem Erweiterungspaket example-package basiert, würde die Regelkomponente den folgenden delegate_descriptor_id-Wert verwenden: example-package::events::click.

Weitere Informationen finden Sie im Abschnitt zum Erstellen einer Regelkomponente.

Datenelemente

Ein Datenelement muss bei seiner ersten Erstellung einem Erweiterungspaket zugeordnet werden, da jedes Erweiterungspaket die kompatiblen Typen für seine Delegierten-Datenelemente sowie deren beabsichtigtes Verhalten definiert.

Um beispielsweise ein Datenelement zu erstellen, das den vom Erweiterungspaket example-package definierten cookie-Typ verwendet, würde das Datenelement den folgenden delegate_descriptor_id-Wert verwenden: example-package::dataElements::cookie.

Weitere Informationen finden Sie im Abschnitt zum Erstellen eines Datenelements.

Erweiterungen

Eine Erweiterung wird beim ersten Erstellen automatisch einem Erweiterungspaket zugeordnet und im relationships-Objekt der Erweiterung dargestellt. Wenn Ihre Erweiterung benutzerdefinierte Einstellungen erfordert, ist auch eine Delegaten-Deskriptor-ID erforderlich.

Um beispielsweise einer Erweiterung, die zum Erweiterungspaket example-package gehört, eine Delegierten-Deskriptor-ID hinzuzufügen, würde die Erweiterung den folgenden delegate_descriptor_id-Wert verwenden: example-package::extensionConfiguration::config.

Weitere Informationen finden Sie im Handbuch zum Erstellen einer Erweiterung.