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.

NOTE
Använd Target Delivery API när du begär innehåll som innehåller faktiska rekommendationer (rekommenderade produkter eller objekt).

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:

  1. Skapa en Target-aktivitet (A/B, XT, AP eller Recommendations) med den formulärbaserade dispositionen (inte Visual Experience Composer).
  2. 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.

  1. 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.
    server-side-create-recs-json-design.png

  2. Gå till Activities > Create Activity > Recommendations i Mål och välj sedan Form.

    server-side-create-recs.png

  3. Välj en egenskap och klicka på Next.

  4. 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.
    server-side-create-recs-form.png

  5. 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

  1. 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.
    client-code.png

  2. 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.

      server-side-Delivery-API-call.png
      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 server-side-create-recs-post.png Gammal medföljande text: "Observera att den här rekommendationen baseras på innehåll Liknande produkter baserat på entitet.id som skickas via mboxParameters." —>
      client-code3

  3. 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.

  4. Få ett svar baserat på JSON-designen.
    server-side-create-recs-json-response2.png
    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.

Resurs
Information
Adobe Target Everywhere - Implementera serversidan eller i IoT
Adobe Summit 2019 Lab som ger dig en praktisk upplevelse av ett React-program som använder Adobe Target serversides-API:er.
Adobe Target i en mobilapp utan Adobe SDK
Den här guiden visar hur du konfigurerar Adobe Target i din mobilapp utan att installera Adobe SDK. Den här lösningen använder Tealium SDK-webbvyn och Remote Commands-modulen för att skicka och ta emot begäranden till Adobe Visitor API (Experience Cloud) och Adobe Target API.
Konfigurera måltillägget i Experience Platform Launch och implementera mål-API:er
Steg för att konfigurera Target-tillägget i Experience Platform Launch, lägga till Target-tillägget i programmet och implementera Target-API:er för att begära aktiviteter, förhämta erbjudanden och ange visuellt förhandsgranskningsläge.
Adobe Target Node Client
Open-sourced Target Node.js SDK v1.0
Översikt över serversidan
Information om Adobe Target Server Side Delivery APIs, Server Side Batch Delivery APIs, Node.js SDK och Adobe Target Recommendations APIs.
Adobe Campaign Content Recommendations in Email
Blogg som beskriver hur du kan utnyttja innehållsrekommendationer i e-post via Adobe Target och Adobe I/O Runtime i Adobe Campaign.

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.

Resurs
Information
Samlingar
Visa, skapa, hämta, redigera och ta bort samlingar.
Villkor
Lista och hämta villkor.
Designer
Lista, skapa, hämta, redigera, ta bort och validera designer.
Entiteter
Spara, ta bort och hämta enheter.
Kampanjer
Visa, skapa, hämta, redigera och ta bort kampanjer.
Kategorivillkor
Visa, skapa, hämta, redigera och ta bort kategorivillkor.
Anpassade villkor
Visa, skapa, hämta, redigera och ta bort anpassade villkor.
Objektvillkor
Visa, skapa, hämta, redigera och ta bort objektvillkor.
Popularitetskriterier
Visa, skapa, hämta, redigera och ta bort popularitetskriterier.
Profilattributsvillkor
Visa, skapa, hämta, redigera och ta bort villkor för profilattribut.
Senaste villkor
Lista, skapa, hämta, redigera och ta bort senaste villkor.
Sekvensvillkor
Visa, skapa, hämta, redigera och ta bort sekvensvillkor.

Referensdokumentation

Sammanfattning och granskning

Grattis! Genom att fylla i den här guiden har du lärt dig att:

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3