API-Endpunkt für berechnete Attribute
Berechnete Attribute sind Funktionen, mit denen Daten auf Ereignisebene in Attribute auf Profilebene aggregiert werden. Diese Funktionen werden automatisch berechnet, sodass sie für die Segmentierung, Aktivierung und Personalisierung verwendet werden können. Dieses Handbuch enthält Beispiel-API-Aufrufe zum Ausführen grundlegender CRUD-Vorgänge mithilfe des /attributes
-Endpunkt.
Um mehr über berechnete Attribute zu erfahren, lesen Sie zunächst die Übersicht über berechnete Attribute.
Erste Schritte
Der in diesem Handbuch verwendete API-Endpunkt ist Teil der Echtzeit-Kundenprofil-API.
Bevor Sie fortfahren, lesen Sie bitte die Erste Schritte mit der Profil-API für Links zur empfohlenen Dokumentation, eine Anleitung zum Lesen der in diesem Dokument angezeigten Beispiel-API-Aufrufe und wichtige Informationen zu erforderlichen Kopfzeilen, die für das erfolgreiche Aufrufen von Experience Platform-APIs erforderlich sind.
Lesen Sie außerdem die Dokumentation für den folgenden Dienst:
- Experience Data Model (XDM) System: Das standardisierte Framework, mit dem Kundenerlebnisdaten von Experience Platform organisiert werden.
- Erste Schritte mit der Schema Registry: Informationen zu Ihrer
{TENANT_ID}
, die in den Antworten in diesem Handbuch angezeigt wird, bereitgestellt wird.
- Erste Schritte mit der Schema Registry: Informationen zu Ihrer
Liste berechneter Attribute abrufen list
Sie können eine Liste aller berechneten Attribute für Ihr Unternehmen abrufen, indem Sie eine GET-Anfrage an die /attributes
-Endpunkt.
API-Format
Der /attributes
-Endpunkt unterstützt verschiedene Abfrageparameter, mit denen Sie Ihre Ergebnisse filtern können. Diese Parameter sind zwar optional, doch wird ihre Verwendung dringend empfohlen, um bei der Auflistung von Ressourcen den teuren Verwaltungsaufwand zu reduzieren. Wenn Sie diesen Endpunkt ohne Parameter aufrufen, werden alle für Ihre Organisation verfügbaren berechneten Attribute abgerufen. Es können mehrere Parameter eingeschlossen werden, die durch kaufmännische Und-Zeichen (&
) voneinander getrennt werden.
GET /attributes
GET /attributes?{QUERY_PARAMETERS}
Beim Abrufen einer Liste berechneter Attribute können die folgenden Abfrageparameter verwendet werden:
limit
limit=20
offset
offset=5
sortBy
name
, status
, updateEpoch
, und createEpoch
. Sie können auch auswählen, ob eine Sortierung in aufsteigender oder absteigender Reihenfolge erfolgen soll, indem Sie eine -
vor der Sortieroption. Standardmäßig werden die Elemente nach updateEpoch
in absteigender Reihenfolge.sortBy=name
property
Ein Parameter, mit dem Sie nach verschiedenen berechneten Attributfeldern filtern können. Zu den unterstützten Eigenschaften gehören name
, createEpoch
, mergeFunction.value
, updateEpoch
, und status
. Die unterstützten Vorgänge hängen von der aufgeführten Eigenschaft ab.
name
:EQUAL
(=),NOT_EQUAL
(!=),CONTAINS
(=contains()),NOT_CONTAINS
(=!contains())createEpoch
:GREATER_THAN_OR_EQUALS
(<=),LESS_THAN_OR_EQUALS
(>=)mergeFunction.value
:EQUAL
(=),NOT_EQUAL
(!=),CONTAINS
(=contains()),NOT_CONTAINS
(=!contains())updateEpoch
:GREATER_THAN_OR_EQUALS
(<=),LESS_THAN_OR_EQUALS
(>=)status
:EQUAL
(=),NOT_EQUAL
(!=),CONTAINS
(=contains()),NOT_CONTAINS
(=!contains())
property=updateEpoch>=1683669114845
property=name!=testingrelease
property=status=contains(new,processing,disabled)
Anfrage
Mit der folgenden Anfrage werden die letzten drei berechneten Attribute abgerufen, die in Ihrem Unternehmen aktualisiert wurden.
code language-shell |
---|
|
Antwort
Eine erfolgreiche Antwort gibt den HTTP-Status 200 mit einer Liste der letzten 3 aktualisierten berechneten Attribute zurück, die zu Ihrer Organisation und Sandbox gehören.
code language-json |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 | |
---|---|
Eigenschaft | Beschreibung |
_links |
Ein Objekt, das die Paginierungsinformationen enthält, die für den Zugriff auf die letzte Ergebnisseite, die nächste Ergebnisseite, die vorherige Ergebnisseite oder die aktuelle Ergebnisseite erforderlich sind. |
computedAttributes |
Ein Array, das die berechneten Attribute basierend auf Ihren Abfrageparametern enthält. Weitere Informationen zum berechneten Attribut-Array finden Sie im Abschnitt Abrufen eines bestimmten berechneten Attributabschnitts. |
_page |
Ein Objekt, das Metadaten zu den zurückgegebenen Ergebnissen enthält. Dazu gehören Informationen zum aktuellen Versatz, zur Anzahl der zurückgegebenen berechneten Attribute, zur Gesamtanzahl der berechneten Attribute sowie zur Beschränkung der zurückgegebenen berechneten Attribute. |
Berechnetes Attribut erstellen create
Um ein berechnetes Attribut zu erstellen, stellen Sie zunächst eine POST-Anfrage an die /attributes
-Endpunkt mit einem Anfragetext, der die Details des berechneten Attributs enthält, das Sie erstellen möchten.
API-Format
POST /attributes
Anfrage
code language-shell |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 | |
---|---|
Eigenschaft | Beschreibung |
name |
Name des berechneten Attributfelds als Zeichenfolge. Der Name des berechneten Attributs darf nur aus alphanumerischen Zeichen ohne Leerzeichen oder Unterstriche bestehen. Dieser Wert must unter allen berechneten Attributen eindeutig sein. Als Best Practice sollte dieser Name eine camelCase-Version der displayName . |
description |
Eine Beschreibung des berechneten Attributs. Dies ist besonders nützlich, wenn mehrere berechnete Attribute definiert wurden, da es anderen in Ihrer Organisation dabei hilft, das richtige berechnete Attribut zu bestimmen, das verwendet werden soll. |
displayName |
Der Anzeigename für das berechnete Attribut. Dies ist der Name, der angezeigt wird, wenn Sie Ihre berechneten Attribute in der Adobe Experience Platform-Benutzeroberfläche auflisten. |
expression |
Ein Objekt, das den Abfrageausdruck des berechneten Attributs darstellt, das Sie erstellen möchten. |
expression.type |
Der Typ des Ausdrucks. Derzeit wird nur PQL unterstützt. |
expression.format |
Das Format des Ausdrucks. Derzeit wird nur pql/text unterstützt. |
expression.value |
Der -Wert des Ausdrucks. |
keepCurrent |
Ein boolescher Wert, der bestimmt, ob der Wert des berechneten Attributs mithilfe einer schnellen Aktualisierung auf dem neuesten Stand gehalten wird. Derzeit sollte dieser Wert auf false . |
duration |
Ein Objekt, das den Lookback-Zeitraum für das berechnete Attribut darstellt. Der Lookback-Zeitraum gibt an, wie weit zurück zum Berechnen des berechneten Attributs geguckt werden kann. |
duration.count |
Ein number -Wert, der die Dauer des Lookback-Zeitraums darstellt. Die möglichen Werte hängen vom Wert der
|
duration.unit |
Eine Zeichenfolge, die die Zeiteinheit darstellt, die für den Lookback-Zeitraum verwendet wird. Mögliche Werte sind: HOURS , DAYS , WEEKS , und MONTHS . |
status |
Der Status des berechneten Attributs. Mögliche Werte sind DRAFT und NEW . |
Antwort
Eine erfolgreiche Antwort gibt den HTTP-Status 200 mit Informationen zu Ihrem neu erstellten berechneten Attribut zurück.
code language-json |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
---|---|
Eigenschaft | Beschreibung |
id |
Die systemgenerierte ID Ihres neu erstellten berechneten Attributs. |
status |
Der Status des berechneten Attributs. Dies kann entweder DRAFT oder NEW . |
createEpoch |
Der Zeitpunkt, zu dem das berechnete Attribut erstellt wurde, in Sekunden. |
updateEpoch |
Der Zeitpunkt, zu dem das berechnete Attribut zuletzt aktualisiert wurde (in Sekunden). |
createdBy |
Die ID des Benutzers, der das berechnete Attribut erstellt hat. |
Abrufen eines bestimmten berechneten Attributs get
Sie können detaillierte Informationen zu einem bestimmten berechneten Attribut abrufen, indem Sie eine GET-Anfrage an die /attributes
-Endpunkt und die Kennung des berechneten Attributs angeben, das Sie im Anfragepfad abrufen möchten.
API-Format
GET /attributes/{ATTRIBUTE_ID}
Anfrage
code language-shell |
---|
|
Antwort
Eine erfolgreiche Antwort gibt den HTTP-Status 200 mit detaillierten Informationen zum angegebenen berechneten Attribut zurück.
code language-json |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 | |
---|---|
Eigenschaft | Beschreibung |
id |
Eine eindeutige, schreibgeschützte, systemgenerierte ID, die bei anderen API-Vorgängen zum Verweisen auf das berechnete Attribut genutzt werden kann. |
type |
Eine Zeichenfolge, die anzeigt, dass das zurückgegebene Objekt ein berechnetes Attribut ist. |
name |
Der Name des berechneten Attributs. |
displayName |
Der Anzeigename für das berechnete Attribut. Dies ist der Name, der angezeigt wird, wenn Sie Ihre berechneten Attribute in der Adobe Experience Platform-Benutzeroberfläche auflisten. |
description |
Eine Beschreibung des berechneten Attributs. Dies ist besonders nützlich, wenn mehrere berechnete Attribute definiert wurden, da es anderen in Ihrer Organisation dabei hilft, das richtige berechnete Attribut zu bestimmen, das verwendet werden soll. |
imsOrgId |
Die ID der Organisation, zu der das berechnete Attribut gehört. |
sandbox |
Das Sandbox-Objekt enthält Details zur Sandbox, in der das berechnete Attribut konfiguriert wurde. Diese Daten werden aus der in der Anfrage gesendeten Sandbox-Kopfzeile extrahiert. Weiterführende Informationen dazu finden Sie in der Sandbox-Übersicht. |
path |
Die path zum berechneten Attribut hinzu. |
keepCurrent |
Ein boolescher Wert, der bestimmt, ob der Wert des berechneten Attributs mithilfe einer schnellen Aktualisierung auf dem neuesten Stand gehalten wird. |
expression |
Ein Objekt, das den Ausdruck des berechneten Attributs enthält. |
mergeFunction |
Ein Objekt, das die Zusammenführungsfunktion für das berechnete Attribut enthält. Dieser Wert basiert auf dem entsprechenden Aggregationsparameter innerhalb des Ausdrucks des berechneten Attributs. Mögliche Werte sind SUM , MIN , MAX , und MOST_RECENT . |
status |
Der Status des berechneten Attributs. Dies kann einer der folgenden Werte sein: DRAFT , NEW , INITIALIZING , PROCESSING , PROCESSED , FAILED oder DISABLED . |
schema |
Ein Objekt, das Informationen zum Schema enthält, in dem der Ausdruck ausgewertet wird. Derzeit wird nur _xdm.context.profile unterstützt. |
lastEvaluationTs |
Ein Zeitstempel, der angibt, wann das berechnete Attribut zuletzt ausgewertet wurde. |
createEpoch |
Der Zeitpunkt, zu dem das berechnete Attribut erstellt wurde, in Sekunden. |
updateEpoch |
Der Zeitpunkt, zu dem das berechnete Attribut zuletzt aktualisiert wurde (in Sekunden). |
createdBy |
Die ID des Benutzers, der das berechnete Attribut erstellt hat. |
Löschen eines bestimmten berechneten Attributs delete
Sie können ein bestimmtes berechnetes Attribut löschen, indem Sie eine DELETE-Anfrage an die /attributes
-Endpunkt und die Kennung des berechneten Attributs angeben, das Sie im Anfragepfad löschen möchten.
DRAFT
). Dieser Endpunkt cannot verwendet werden, um berechnete Attribute in einem anderen Status zu löschen.API-Format
DELETE /attributes/{ATTRIBUTE_ID}
{ATTRIBUTE_ID}
id
des berechneten Attributs, das Sie löschen möchten.Anfrage
code language-shell |
---|
|
Antwort
Eine erfolgreiche Antwort gibt den HTTP-Status 202 mit Details zum gelöschten berechneten Attribut zurück.
code language-json |
---|
|
Aktualisieren eines bestimmten berechneten Attributs
Sie können ein bestimmtes berechnetes Attribut aktualisieren, indem Sie eine PATCH-Anfrage an die /attributes
-Endpunkt und die Kennung des berechneten Attributs angeben, das Sie im Anfragepfad aktualisieren möchten.
- Wenn der aktuelle Status
NEW
, kann der Status nur inDISABLED
. - Wenn der aktuelle Status
DRAFT
können Sie die Werte der folgenden Felder ändern:name
,description
,keepCurrent
,expression
, undduration
. Sie können den Status auch vonDRAFT
nachNEW
. Alle Änderungen an systemgenerierten Feldern, z. B.mergeFunction
oderpath
gibt einen Fehler zurück. - Wenn der aktuelle Status
PROCESSING
oderPROCESSED
, kann der Status nur inDISABLED
.
API-Format
PATCH /attributes/{ATTRIBUTE_ID}
{ATTRIBUTE_ID}
id
des berechneten Attributs, das Sie aktualisieren möchten.Anfrage
Die folgende Anfrage aktualisiert den Status des berechneten Attributs von DRAFT
nach NEW
.
code language-shell |
---|
|
Antwort
Eine erfolgreiche Antwort gibt den HTTP-Status 200 mit Informationen zu Ihrem neu aktualisierten berechneten Attribut zurück.
code language-json |
---|
|
Nächste Schritte
Nachdem Sie sich mit den Grundlagen berechneter Attribute vertraut gemacht haben, können Sie nun mit der Definition berechneter Attribute für Ihre Organisation beginnen. Informationen zur Verwendung berechneter Attribute in der Experience Platform-Benutzeroberfläche finden Sie in der UI-Handbuch für berechnete Attribute.