Hantera anpassade villkor
Ibland kan de algoritmer som tillhandahålls av Recommendations inte visa vissa element som du vill lyfta fram. I sådana fall kan du med anpassade kriterier leverera en specifik uppsättning rekommenderade objekt för ett visst nyckelobjekt eller en viss kategori.
Om du vill skapa anpassade villkor definierar du och importerar den önskade mappningen mellan nyckelobjektet eller kategorin och de rekommenderade objekten. Den här processen beskrivs i dokumentationen för anpassade villkor. Som du kan se i den dokumentationen kan du skapa, redigera och ta bort anpassade villkor via användargränssnittet i Target. Target innehåller dock även en uppsättning API:er för anpassade kriterier som ger en mer detaljerad hantering av anpassade villkor.
Skapa anpassade villkor
Om du vill skapa anpassade villkor med Create Custom Criteria API är syntaxen:
POST https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom
Fortsätt bara med följande steg när du har läst varningen ovan och är säker på att du kan skapa nya anpassade villkor som inte kan tas bort från användargränssnittet.
-
Verifiera
TENANT_ID
ochAPI_KEY
för Create custom criteria referera till de Postman-miljövariabler som upprättats tidigare. Använd bilden nedan för att jämföra. -
Lägg till din Body som raw JSON som definierar platsen för din CSV-fil med anpassade villkor. Använd exemplet i Skapa API:t för anpassade kriterier som en mall och ange
environmentId
och andra värden efter behov. I det här exemplet använder vi LAST_PURCHASED som nyckel. -
Skicka förfrågan och observera svaret, som innehåller information om de anpassade villkor du just skapade.
-
Om du vill verifiera att dina anpassade villkor har skapats går du till Recommendations > Criteria i Adobe Target och söker efter dina villkor efter namn, eller använder List Custom Criteria API i nästa steg.
I det här fallet har vi ett fel. Låt oss undersöka felet närmare genom att undersöka de anpassade villkoren med List Custom Criteria API.
Lista anpassade villkor
Om du vill hämta en lista över alla dina anpassade villkor tillsammans med information för varje, använder du API:t för lista med anpassade kriterier. Syntaxen:
GET https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom
- Verifiera
TENANT_ID
ochAPI_KEY
som tidigare och skicka begäran. Observera det anpassade villkors-ID:t i svaret, liksom information om felmeddelandet som nämndes tidigare.
I det här fallet inträffade felet eftersom serverinformationen är felaktig, vilket innebär att Target inte kan komma åt CSV-filen som innehåller den anpassade villkorsdefinitionen. Låt oss redigera de anpassade villkoren för att korrigera detta.
Redigera anpassade villkor
Om du vill ändra informationen för en anpassad villkorsdefinition använder du API:t för redigering av anpassade kriterier. Syntaxen:
POST https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId
-
Verifiera
TENANT_ID
ochAPI_KEY
som tidigare.
-
Ange villkor-ID för det (enkla) anpassade villkor som du vill redigera.
-
I Body anger du uppdaterad JSON med rätt serverinformation. (I det här steget anger du FTP-åtkomst till en server som du har åtkomst till.)
-
Skicka förfrågan och notera svaret.
Låt oss verifiera om de uppdaterade anpassade villkoren lyckades med hjälp av Get Custom Criteria API.
Hämta anpassade villkor
Om du vill visa information om anpassade villkor för ett specifikt anpassat villkor använder du API:t Hämta anpassade villkor. Syntaxen:
GET https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId
- Ange villkor-ID för de anpassade villkor vars information du vill få. Skicka förfrågan och granska svaret.
- Bekräfta att åtgärden lyckades. (Kontrollera i vårt fall att det inte finns några ytterligare FTP-fel.)
- (Valfritt) Kontrollera att uppdateringen visas korrekt i användargränssnittet.
Ta bort anpassade villkor
Ta bort anpassade villkor med hjälp av det kriterier-ID som beskrivs ovan med API:t Ta bort anpassade kriterier. Syntaxen:
DELETE https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId
-
Ange kriterier-ID:t för det (enkla) anpassade villkor som du vill ta bort. Klicka på Send.
-
Kontrollera att villkoren har tagits bort med Hämta anpassade villkor.
I det här fallet anger det förväntade 404-felet att det inte går att hitta de borttagna villkoren.
Grattis! Du kan nu skapa, lista, redigera, ta bort och få information om anpassade villkor med hjälp av Recommendations API. I nästa avsnitt använder du Target Delivery API för att hämta rekommendationer.
<!— Nästa"Hämta Recommendations med leverans-API på serversidan" > —>