Hämta Recommendations med leverans-API
API:erna för Adobe Target och Adobe Target Recommendations kan användas för att leverera svar på webbsidor, men kan också användas i upplevelser som inte är HTML, inklusive appar, skärmar, konsoler, e-post, kioskdatorer och andra visningsenheter. Om Target-bibliotek och JavaScript inte kan användas, kan Target Delivery API fortfarande ge tillgång till alla Target-funktioner och leverera personaliserade upplevelser.
Om du vill hämta rekommendationer skickar du ett Adobe Target Delivery API POST-anrop med lämplig sammanhangsberoende information, som kan innehålla ett användar-ID (som kan användas med profilspecifika rekommendationer som användarens nyligen visade objekt), relevant mbox-namn, mbox-parametrar, profilparametrar eller andra attribut. Svaret innehåller rekommenderade entity.ids (och kan inkludera andra entitetsdata) i JSON- eller HTML-format, som sedan kan visas i enheten.
Delivery API för Adobe Target visar alla befintliga funktioner som en standardTarget-begäran tillhandahåller.
Leverans-API:
- Gör att ni kan hämta upplevelser eller erbjudanden för en plats och en målgrupp på ett RESTful-sätt.
- Ingen autentisering krävs.
- Endast POST.
- Bearbetar inte cookies eller omdirigeringssamtal.
- Kräver eller känner inte igen"användarroller". Det hämtar bara innehåll eller rapporterar händelser till edge-servrar.
Följ de här stegen för att använda Delivery API för att leverera Target-upplevelser, inklusive rekommendationer:
- Skapa en Target-aktivitet (A/B, XT, AP eller Recommendations) med den formulärbaserade dispositionen (inte Visual Experience Composer).
- Använd leverans-API:t för att få ett svar på begäranden som genereras av den Target-aktivitet som du just skapade.
<!— F: Varför krävs BÅDA stegen för detta? Om du har definierat en formulärbaserad rekommendation för en mbox, vad är poängen med att ALSO har steget för leverans-API för att hämta resultat? Varför kan du inte bara få formulärbaserade kopior att leverera resultaten i målenheten…? S: Se användningsexempel nedan … det är när du vill avbryta väntande resultat för att kunna göra mer innan du visar resultaten. Exempel på jämförelser i realtid med lagernivåer. —>
Skapa en rekommendation med den formulärbaserade Experience Composer
Använd formulärbaserad disposition om du vill skapa rekommendationer som kan användas med leverans-API:t.
-
Först skapar och sparar du en JSON-baserad design som du kan använda i dina rekommendationer. Exempel-JSON, plus bakgrundsinformation om hur JSON-svar kan returneras när en formulärbaserad aktivitet konfigureras, finns i dokumentationen om Skapa rekommendationsdesigner. I det här exemplet heter designen Simple JSON.
-
Gå till Activities > Create Activity > Recommendations i Mål och välj sedan Form.
-
Välj en egenskap och klicka på Next.
-
Definiera den plats där du vill att användarna ska få rekommendationens svar. I exemplet nedan används en plats med namnet api_charter. Välj din JSON-baserade design, som skapades tidigare, med namnet Simple JSON.
-
Spara och aktivera rekommendationen. Det kommer att generera resultat. När resultaten är klara kan du hämta dem med leverans-API:t.
Använda leverans-API
Syntaxen för leverans-API är:
POST https://{{CLIENT_CODE}}.tt.omtrdc.net/rest/v1/delivery
-
Observera att klientkoden krävs. Som en påminnelse hittar du din klientkod i Adobe Target genom att gå till Recommendations > Settings. Observera värdet Klientkod i avsnittet API-token för rekommendation.
-
När du har fått din klientkod konstruerar du ett leverans-API-anrop. Exemplet nedan börjar med Web Batched Mboxes Delivery API Call som anges i Postman-samlingen för leverans och gör relevanta ändringar. Exempel:
-
objekten browser och address har tagits bort från Body eftersom de inte behövs för icke-HTML
-
api_charter listas som platsnamn i det här exemplet
-
entity.id anges eftersom den här rekommendationen baseras på innehållets likhet, vilket kräver att en aktuell artikelnyckel skickas till Target.
Kom ihåg att konfigurera frågeparametrarna korrekt. Ange till exempel{{CLIENT_CODE}}
efter behov. <!— Q: I den uppdaterade anropssyntaxen listas entity.id som en profileParameter i stället för en mboxParameter som i tidigare versioner. —> <!— Q: Gammal bild
-
-
Skicka begäran. Detta körs mot platsen api_charter som har en aktiv rekommendation som körs på den, definierad med din JSON-design som kommer att visa en lista över rekommenderade entiteter.
-
Få ett svar baserat på JSON-designen.
Svaret innehåller nyckel-ID samt enhets-ID för de rekommenderade entiteterna.
Om du använder API:t för leverans med Recommendations på det här sättet kan du utföra ytterligare steg innan du visar rekommendationer till besökaren på en annan enhet än HTML. Du kan till exempel ta svaret från leverans-API:t för att utföra en ytterligare sökning i realtid av information om entitetsattribut (lager, pris, klassificering och så vidare) från ett annat system (till exempel en CMS-, PIM- eller e-handelsplattform) innan du visar det slutliga resultatet.
Med den metod som beskrivs i den här guiden kan du få vilket program som helst som kan utnyttja Target-svaret för att ge personaliserade rekommendationer!
Exempelimplementeringar
Följande resurser innehåller exempel på olika icke-HTML-inriktade implementeringar. Tänk på att varje implementering blir unik på grund av det system och de enheter som används.
Hantera Recommendations-inställningar med API:er
Rekommendationer konfigureras oftast i Adobe Target-gränssnittet och används eller nås via Target-API:erna, av skäl som de som nämns i avsnitten ovan. Denna API-samordning är vanlig. Ibland kanske användare vill utföra alla åtgärder via API:er, både konfiguration och användning av resultat. Även om det är mycket mindre vanligt kan användare absolut konfigurera, köra, och utnyttja resultatet av rekommendationer helt och hållet med API:erna.
I ett tidigare avsnitt lärde vi oss att hantera Adobe Target Recommendations-entiteter och leverera dem på serversidan. På samma sätt kan du med Adobe Developer Console hantera villkor, kampanjer, samlingar och designmallar utan att behöva logga in på Adobe Target. En fullständig lista över alla Recommendations API:er finns här, men här finns en sammanfattning som du kan referera till.
Referensdokumentation
Sammanfattning och granskning
Grattis! Genom att fylla i den här guiden har du lärt dig att: