Hantera anpassade villkor

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

Utvecklare

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.

WARNING

För anpassade villkor utför du antingen alla åtgärder (skapa, redigera, ta bort) för ett givet anpassat villkor med API:erna, eller också utför du alla åtgärder (skapa, redigera, ta bort) med gränssnittet. Om du hanterar anpassade villkor med en kombination av användargränssnittet och API:t kan det leda till att information eller oväntade resultat hamnar i konflikt. Om du till exempel skapar ett anpassat villkor i användargränssnittet, men sedan redigerar det via API, återspeglas inte dina uppdateringar i användargränssnittet, även om det uppdateras i serverdelen, vilket visas via API:t.

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

WARNING

Anpassade villkor som skapats med API:t Skapa anpassade kriterier, som beskrivs i den här övningen, visas i användargränssnittet där de finns kvar. Du kan inte redigera eller ta bort dem från användargränssnittet. Du kan redigera eller ta bort dem via API, men på båda sätten visas de fortfarande i målgränssnittet. Om du vill behålla möjligheten att redigera eller ta bort från användargränssnittet skapar du anpassade villkor med användargränssnittet per dokumentationen, i stället för att använda API:t Skapa anpassade kriterier.

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 och API_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 och API_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 och API_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.

NOTE

Som en påminnelse tas villkoren inte bort från målgränssnittet även om det har tagits bort, eftersom det skapades med API:t Skapa anpassade kriterier.

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" > —>

recommendation-more-help

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