Dokumentation Target Target-Entwicklerhandbuch

Verwalten benutzerdefinierter Kriterien

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

Entwickler

Manchmal können die von Recommendations bereitgestellten Algorithmen bestimmte Elemente, die Sie bewerben möchten, nicht aufdecken. In einem solchen Fall bieten benutzerdefinierte Kriterien eine Möglichkeit, einen bestimmten Satz empfohlener Elemente für ein bestimmtes Schlüsselelement oder eine bestimmte Kategorie bereitzustellen.

Um benutzerdefinierte Kriterien zu erstellen, definieren und importieren Sie die gewünschte Zuordnung zwischen dem Schlüsselelement oder der Kategorie und den empfohlenen Elementen. Dieser Prozess wird in der Dokumentation zu benutzerdefinierten Kriterien“. Wie in dieser Dokumentation erwähnt, können Sie benutzerdefinierte Kriterien über die Benutzeroberfläche von Target erstellen, bearbeiten und löschen. Target bietet jedoch auch eine Reihe von APIs für benutzerdefinierte Kriterien, die eine detailliertere Verwaltung Ihrer benutzerdefinierten Kriterien ermöglichen.

WARNING

Bei benutzerdefinierten Kriterien führen Sie entweder alle Aktionen (Erstellen, Bearbeiten, Löschen) für ein bestimmtes benutzerdefiniertes Kriterium mithilfe der APIs durch oder führen Sie alle Aktionen (Erstellen, Bearbeiten, Löschen) mithilfe der Benutzeroberfläche durch. Die Verwaltung Ihrer benutzerdefinierten Kriterien über eine Kombination aus Benutzeroberfläche und API kann zu widersprüchlichen Informationen oder unerwarteten Ergebnissen führen. Wenn Sie beispielsweise ein benutzerdefiniertes Kriterium in der Benutzeroberfläche erstellen, es dann aber über die API bearbeiten, werden Ihre Aktualisierungen in der Benutzeroberfläche nicht angezeigt, auch wenn sie im Backend aktualisiert werden, wie über die API sichtbar.

Erstellen benutzerdefinierter Kriterien

Zum Erstellen benutzerdefinierter Kriterien mit der API für benutzerdefinierte Kriterien erstellen lautet die Syntax:

POST https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom

WARNING

Benutzerdefinierte Kriterien, die mit der API Benutzerdefinierte Kriterien erstellen erstellt wurden, wie in dieser Übung beschrieben, werden in der Benutzeroberfläche angezeigt, wo sie beibehalten werden. Sie können sie nicht in der Benutzeroberfläche bearbeiten oder löschen. Sie können sie bearbeiten oder löschen über die API, aber in beiden Fällen werden sie weiterhin in der Target-Benutzeroberfläche angezeigt. Damit die Option zum Bearbeiten oder Löschen aus der Benutzeroberfläche beibehalten werden kann, erstellen Sie die benutzerdefinierten Kriterien mithilfe der Benutzeroberfläche gemäß Dokumentation im Gegensatz zur Verwendung der API zum Erstellen benutzerdefinierter Kriterien.

Fahren Sie mit den folgenden Schritten erst fort, nachdem Sie die obige Warnung gelesen haben und neue benutzerdefinierte Kriterien erstellen, die anschließend nicht aus der Benutzeroberfläche gelöscht werden können.

Überprüfen Sie TENANT_ID und API_KEY für Create custom criteria Verweis auf die zuvor festgelegten Postman-Umgebungsvariablen. Verwenden Sie die folgende Abbildung zum Vergleich.
Fügen Sie Ihren Textkörper als Roh-JSON hinzu, das den Speicherort Ihrer benutzerdefinierten CSV-Kriteriendatei definiert. Verwenden Sie das Beispiel in der Dokumentation Erstellen benutzerdefinierter Kriterien als Vorlage und geben Sie Ihre environmentId und andere Werte nach Bedarf an. In diesem Beispiel verwenden wir LAST_PURCHASED als Schlüssel.
Senden Sie die Anfrage und beobachten Sie die Antwort, die die Details der soeben erstellten benutzerdefinierten Kriterien enthält.
Um zu überprüfen, ob Ihre benutzerdefinierten Kriterien erstellt wurden, navigieren Sie in Adobe Target zu Recommendations > Criteria und suchen Sie anhand des Namens nach Ihren Kriterien, oder verwenden Sie die List Custom Criteria API im nächsten Schritt.

In diesem Fall liegt ein Fehler vor. Untersuchen wir den Fehler, indem wir die benutzerdefinierten Kriterien mithilfe der List Custom Criteria API genauer untersuchen.

Benutzerdefinierte Kriterien auflisten

Um eine Liste aller benutzerdefinierten Kriterien zusammen mit Details für jedes abzurufen, verwenden Sie die API für benutzerdefinierte Kriterien auflisten. Die Syntax lautet:

GET https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom

Überprüfen Sie TENANT_ID und API_KEY wie zuvor und senden Sie die Anfrage. Beachten Sie in der Antwort die Kennung der benutzerdefinierten Kriterien sowie Details zur zuvor erwähnten Fehlermeldung.

In diesem Fall ist der Fehler aufgetreten, weil die Server-Informationen falsch sind, d. h. Target kann nicht auf die CSV-Datei zugreifen, die die benutzerdefinierte Kriteriendefinition enthält. Bearbeiten wir die benutzerdefinierten Kriterien, um dies zu korrigieren.

Benutzerdefinierte Kriterien bearbeiten

Um die Details einer benutzerdefinierten Kriteriendefinition zu ändern, verwenden Sie die API für benutzerdefinierte Kriterien bearbeiten. Die Syntax lautet:

POST https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId

Überprüfen Sie TENANT_ID und API_KEY wie zuvor.
Geben Sie die Kriterien-ID der (einzelnen) benutzerdefinierten Kriterien an, die Sie bearbeiten möchten.
Geben Sie im Textkörper aktualisierte JSON-Dateien mit den richtigen Server-Informationen ein. (Geben Sie für diesen Schritt den FTP-Zugriff auf einen Server an, auf den Sie zugreifen können.)
Senden Sie die Anfrage und notieren Sie die Antwort.

Überprüfen wir den Erfolg der aktualisierten benutzerdefinierten Kriterien mithilfe der Get Custom Criteria API.

Abrufen benutzerdefinierter Kriterien

Um Details zu benutzerdefinierten Kriterien für bestimmte benutzerdefinierte Kriterien anzuzeigen, verwenden Sie die API für benutzerdefinierte Kriterien abrufen. Die Syntax lautet:

GET https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId

Geben Sie die Kriterien-ID der benutzerdefinierten Kriterien an, deren Details Sie erhalten möchten. Senden Sie die Anfrage und überprüfen Sie die Antwort.
Überprüfen Sie den Erfolg. (Stellen Sie in unserem Fall sicher, dass keine weiteren FTP-Fehler vorliegen.)
(Optional) Überprüfen Sie, ob die Aktualisierung korrekt in der Benutzeroberfläche angezeigt wird.

Benutzerdefinierte Kriterien löschen

Löschen Sie mithilfe der zuvor erwähnten Kriterien-ID Ihre benutzerdefinierten Kriterien mithilfe der API für benutzerdefinierte Kriterien löschen. Die Syntax lautet:

DELETE https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId

Geben Sie die Kriterien-ID der (einzelnen) benutzerdefinierten Kriterien an, die Sie löschen möchten. Klicken Sie auf Send.
Stellen Sie sicher, dass die Kriterien mit Benutzerdefinierte Kriterien abrufen gelöscht wurden.

In diesem Fall zeigt der erwartete 404-Fehler an, dass die gelöschten Kriterien nicht gefunden wurden.

NOTE

Zur Erinnerung: Die Kriterien werden nicht aus der Target-Benutzeroberfläche entfernt, obwohl sie gelöscht wurden, da sie mit der API für benutzerdefinierte Kriterien erstellen erstellt wurden.

Herzlichen Glückwunsch! Sie können jetzt mithilfe der Recommendations-API benutzerdefinierte Kriterien erstellen, auflisten, bearbeiten, löschen und Details dazu abrufen. Im nächsten Abschnitt verwenden Sie die Target-Bereitstellungs-API zum Abrufen von Empfehlungen.

<!— Weiter "Recommendations mit der Server-seitigen Bereitstellungs-API abrufen“ > —>

recommendation-more-help

6906415f-169c-422b-89d3-7118e147c4e3