Aangepaste criteria beheren

Laatst bijgewerkt: 14 november 2023

Gemaakt voor:

Ontwikkelaar

Soms kunnen de algoritmen die door Recommendations worden aangeboden, geen specifieke items weergeven die u wilt promoten. In een dergelijke situatie bieden aangepaste criteria u een manier om een specifieke reeks aanbevolen items voor een bepaald sleutelitem of een bepaalde categorie te leveren.

Als u aangepaste criteria wilt maken, definieert en importeert u de gewenste toewijzing tussen het sleutelitem of de categorie en de aanbevolen items. Dit proces wordt beschreven in het dialoogvenster documentatie met aangepaste criteria. Zoals vermeld in die documentatie, kunt u douanecriteria tot stand brengen uitgeven en schrappen door het gebruikersinterface van het Doel (UI). Target biedt echter ook een set API's met aangepaste criteria waarmee u uw aangepaste criteria gedetailleerder kunt beheren.

WARNING

Voor aangepaste criteria voert u alle handelingen (maken, bewerken, verwijderen) voor een bepaald aangepast criterium uit met behulp van de API's, of voert u anders alle handelingen (maken, bewerken, verwijderen) uit met behulp van de interface. Het beheren van uw aangepaste criteria via een combinatie van de interface en de API kan leiden tot conflicterende informatie of onverwachte resultaten. Als u bijvoorbeeld een aangepast criterium maakt in de gebruikersinterface, maar dit vervolgens bewerkt via de API, worden uw updates in de gebruikersinterface niet weergegeven, ook al wordt het op de achtergrond bijgewerkt, zoals zichtbaar via de API.

Aangepaste criteria maken

Aangepaste criteria maken met de opdracht Aangepaste criteria-API maken, is de syntaxis:

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

WARNING

Aangepaste criteria die zijn gemaakt met de Create Custom Criteria API (Aangepaste criteria maken), zoals in deze exercitie wordt beschreven, worden weergegeven in de gebruikersinterface, waar ze blijven bestaan. U kunt ze niet bewerken of verwijderen uit de gebruikersinterface. U kunt ze bewerken of verwijderen via API, maar in beide gevallen blijven deze zichtbaar in de doelinterface. Als u de optie voor het bewerken of verwijderen van de interface wilt behouden, maakt u de aangepaste criteria met behulp van de interface per de documentatiein plaats van de API Aangepaste criteria maken te gebruiken.

Ga pas verder met de volgende stappen nadat u de bovenstaande waarschuwing hebt gelezen en u vertrouwd bent met het maken van nieuwe aangepaste criteria die vervolgens niet uit de gebruikersinterface kunnen worden verwijderd.

Verifiëren TENANT_ID en API_KEY for Create custom criteria verwijzen naar de eerder vastgestelde Postman-omgevingsvariabelen. Gebruik de onderstaande afbeelding om deze te vergelijken.
Voeg uw Lichaam als ruw JSON die de locatie van uw CSV-bestand met aangepaste criteria definieert. Gebruik het voorbeeld in het dialoogvenster Aangepaste criteria-API maken documentatie als sjabloon, die uw environmentId en andere waarden indien nodig. Voor dit voorbeeld, gebruiken wij LAST_PURCHASED als sleutel.
Verzend het verzoek en bekijk de reactie, die de details van de douanecriteria bevat u enkel creeerde.
Als je wilt controleren of je aangepaste criteria zijn gemaakt, navigeer dan in Adobe Target naar Recommendations > Criteria en zoek uw criteria op naam of gebruik de List Custom Criteria API in de volgende stap.

In dit geval hebben we een fout. Laten we de fout onderzoeken door de aangepaste criteria nauwkeuriger te bekijken met de opdracht List Custom Criteria API.

Aangepaste criteria weergeven

Als u een lijst met al uw aangepaste criteria wilt ophalen, gebruikt u de opdracht Aangepaste criteria-API weergeven. De syntaxis is:

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

Verifiëren TENANT_ID en API_KEY als voorheen, en verzend het verzoek. Let in de reactie op de id van de aangepaste criteria en op details met betrekking tot het eerder vermelde foutbericht.

In dit geval is de fout opgetreden omdat de serverinformatie onjuist is. Dit betekent dat Target geen toegang heeft tot het CSV-bestand dat de definitie van het aangepaste criterium bevat. Bewerk de aangepaste criteria om dit te corrigeren.

Aangepaste criteria bewerken

Als u de details van een definitie voor aangepaste criteria wilt wijzigen, gebruikt u de optie Aangepaste criteria-API bewerken. De syntaxis is:

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

Verifiëren TENANT_ID en API_KEY, zoals eerder.
Geef de criteria-id op van de (enkele) aangepaste criteria die u wilt bewerken.
Geef in het body-gedeelte bijgewerkte JSON de juiste serverinformatie. (Geef voor deze stap FTP-toegang op tot een server die u kunt openen.)
Verzend de aanvraag en noteer het antwoord.

Laten we het succes van de bijgewerkte aangepaste criteria controleren met de opdracht Get Custom Criteria API.

Aangepaste criteria ophalen

Als u de details van aangepaste criteria voor specifieke aangepaste criteria wilt bekijken, gebruikt u de opdracht API voor aangepaste criteria ophalen. De syntaxis is:

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

Geef de criteria-id op van de aangepaste criteria waarvan u de details wilt ophalen. Verzend het verzoek en bekijk het antwoord.
Verifieer succes. (Controleer in ons geval of er geen verdere FTP-fouten zijn.)
(Optioneel) Controleer of de update correct wordt weergegeven in de gebruikersinterface.

Aangepaste criteria verwijderen

Verwijder uw aangepaste criteria met de eerder vermelde criteria aan de hand van de Aangepaste criteria-API verwijderen. De syntaxis is:

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

Geef de criteria-id op van de (enkele) aangepaste criteria die u wilt verwijderen. Klik op Send.
Controleer of de criteria zijn verwijderd met Aangepaste criteria ophalen.

In dit geval geeft de verwachte fout van 404 aan dat de verwijderde criteria niet kunnen worden gevonden.

NOTE

Ter herinnering: de criteria worden niet verwijderd uit de doelinterface, ook al is deze verwijderd, omdat deze zijn gemaakt met de API Aangepaste criteria maken.

Gefeliciteerd! U kunt nu met de Recommendations API gegevens maken, weergeven, bewerken, verwijderen en ophalen over aangepaste criteria. In de volgende sectie gebruikt u de API voor doellevering om aanbevelingen op te halen.

<!— Next "Fetch Recommendations with the Server-side Delivery API" > —>

recommendation-more-help