Recupero di Recommendations con l’API di consegna

Le API Recommendations di Adobe Target e Adobe Target possono essere utilizzate per fornire risposte alle pagine web, ma possono anche essere utilizzate in esperienze non basate su HTML, tra cui app, schermi, console, e-mail, chioschi e altri dispositivi di visualizzazione. In altre parole, quando non è possibile utilizzare le librerie di Target e JavaScript, l'API di consegna di Target consente ancora l'accesso all'intera gamma di funzionalità di Target, per distribuire esperienze personalizzate.

NOTE
Quando si richiedono contenuti contenenti consigli effettivi (prodotti o elementi consigliati), utilizza l’API di consegna di Target.

Per recuperare i consigli, invia una chiamata POST API di consegna Adobe Target con le informazioni contestuali appropriate, che possono includere un ID utente (da utilizzare con i consigli specifici del profilo, come gli elementi visualizzati di recente dall’utente), il nome mbox pertinente, i parametri mbox, i parametri del profilo o altri attributi. La risposta includerà il file entity.ids consigliato (e potrebbe includere altri dati di entità) in formato JSON o HTML, che potrà quindi essere visualizzato nel dispositivo.

L'API di consegna per Adobe Target espone tutte le funzionalità esistenti fornite da una richiesta Target standard.

L’API di consegna:

  • Consente di recuperare esperienze o offerte per una posizione e un pubblico in modo RESTful.
  • Non richiede alcuna autenticazione.
  • Solo POST.
  • Non elabora cookie o chiamate di reindirizzamento.
  • Non richiede o riconosce "ruoli utente". Recupera semplicemente i contenuti o segnala gli eventi ai server edge di Target.

Per utilizzare l’API di consegna per fornire esperienze Target, inclusi i consigli, segui questi passaggi:

  1. Crea un’attività Target (A/B, XT, AP o Recommendations) utilizzando il Compositore basato su moduli (non il Compositore esperienza visivo).
  2. Utilizza l’API di consegna per ottenere una risposta per le richieste generate dall’attività Target appena creata.

<!— D: Perché sono entrambe le fasi necessarie a questo scopo? Se hai definito un consiglio basato su moduli per una mbox, qual è il vantaggio di avere ANCHE il passaggio API di consegna in per recuperare i risultati? Perché non puoi semplicemente far sì che la registrazione basata su moduli distribuisca i risultati nel dispositivo di destinazione? ?? R: Vedi il caso d’uso seguente… è il momento in cui desideri "intercettare" i risultati in sospeso per fare più cose prima di visualizzarli. Confronti in tempo reale con i livelli di inventario. —>

Creare un consiglio utilizzando il Compositore esperienza basato su moduli

Per creare consigli che possono essere utilizzati con l'API di consegna, utilizza il Compositore basato su modulo.

  1. Innanzitutto, crea e salva una progettazione basata su JSON da utilizzare nei consigli. Per un esempio di JSON e informazioni generali su come restituire le risposte JSON durante la configurazione di un'attività basata su modulo, consulta la documentazione su Creazione di progettazioni per consigli. In questo esempio, la progettazione è denominata JSON semplice.
    server-side-create-recs-json-design.png

  2. In Target, passa a Activities > Create Activity > Recommendations, quindi seleziona Form.

    server-side-create-recs.png

  3. Selezionare una proprietà e fare clic su Next.

  4. Definisci il percorso in cui desideri che gli utenti ricevano la risposta del consiglio. Nell'esempio seguente viene utilizzata una posizione denominata api_charter. Seleziona la progettazione basata su JSON, creata in precedenza, denominata JSON semplice.
    server-side-create-recs-form.png

  5. Salva e attiva il consiglio. Genera risultati. Una volta che i risultati sono pronti, puoi utilizzare l'API di consegna per recuperarli.

Utilizzare l’API di consegna

La sintassi per l'API di consegna è:

POST https://{{CLIENT_CODE}}.tt.omtrdc.net/rest/v1/delivery

  1. Nota che il codice client è obbligatorio. Come promemoria, il tuo codice cliente si trova in Adobe Target passando a Recommendations > Settings. Nota il valore Codice client nella sezione Token API per i consigli.
    client-code.png

  2. Una volta ottenuto il codice client, crea la chiamata API di consegna. L'esempio seguente inizia con Web Batched Mboxes Delivery API Call fornito nella raccolta Postman API Delivery, apportando le modifiche necessarie. Ad esempio:

    • gli oggetti browser e address sono stati rimossi da Body, poiché non sono necessari per casi di utilizzo non HTML

    • api_charter è elencato come nome della posizione in questo esempio

    • viene specificato entity.id, in quanto questo consiglio si basa sulla somiglianza dei contenuti, che richiede la trasmissione di una chiave dell'elemento corrente a Target.

      server-side-Delivery-API-call.png
      Ricorda di configurare correttamente i parametri di query. Ad esempio, assicurarsi di specificare {{CLIENT_CODE}} come necessario. <!— Q: nella sintassi di chiamata aggiornata, entity.id è elencato come profileParameter invece di mboxParameter come nelle versioni precedenti. —> <!— D: Immagine precedente server-side-create-recs-post.png Testo di accompagnamento precedente: "Nota: questo consiglio si basa su prodotti simili di contenuto basati sul file entity.id inviato tramite mboxParameters." —>
      codice-client3

  3. Invia la richiesta. Questa operazione viene eseguita sulla posizione api_charter, su cui è in esecuzione un consiglio attivo, definita con la progettazione JSON che restituirà un elenco di entità consigliate.

  4. Ricevi una risposta in base alla progettazione JSON.
    server-side-create-recs-json-response2.png
    La risposta include l’ID della chiave e gli ID delle entità consigliate.

Questo utilizzo dell’API di consegna con Recommendations consente di eseguire passaggi aggiuntivi prima di visualizzare i consigli al visitatore sul dispositivo non HTML. Ad esempio, puoi prendere la risposta dall’API di consegna per eseguire una ricerca aggiuntiva e in tempo reale dei dettagli degli attributi di entità (inventario, prezzo, valutazione e così via) da un altro sistema (come una piattaforma CMS, PIM o e-commerce), prima di visualizzare i risultati finali.

Utilizzando l’approccio descritto in questa guida, puoi ottenere da qualsiasi applicazione di sfruttare la risposta di Target per fornire consigli personalizzati.

Implementazioni di esempio

Le risorse seguenti forniscono esempi di varie implementazioni non incentrate su HTML. Tieni presente che ogni implementazione sarà unica, a causa del sistema e dei dispositivi coinvolti.

Risorsa
Dettagli
Adobe Target Everywhere - Implementa lato server o nell'IoT
Adobe Summit 2019 Lab offre un’esperienza pratica per un’applicazione React che sfrutta le API lato server di Adobe Target.
Adobe Target in un'app mobile senza l'SDK Adobe
Questa guida illustra come configurare Adobe Target nell’app mobile senza installare l’SDK di Adobe. Questa soluzione utilizza la visualizzazione web dell’SDK Tealium e il modulo Remote Commands per inviare e ricevere richieste all’API visitatore Adobe (Experience Cloud) e all’API Adobe Target.
Configurazione dell'estensione Target nel Experience Platform Launch e implementazione delle API di Target
Passaggi per configurare l’estensione Target in Experienci Platform Launch, aggiungere l’estensione Target all’app e implementare le API Target per richiedere attività, preacquisire offerte e attivare la modalità di anteprima visiva.
Client nodo Adobe Target
SDK Node.js v1.0 di Target open-source
Panoramica lato server
Informazioni su API di distribuzione lato server di Adobe Target, API di distribuzione in batch lato server, SDK di Node.js e API di Adobe Target Recommendations.
Recommendations dei contenuti di Adobe Campaign nel messaggio e-mail
Blog che descrive come sfruttare i consigli sui contenuti nelle e-mail tramite Adobe Target e Adobe I/O Runtime in Adobe Campaign.

Gestione delle installazioni di Recommendations con le API

Nella maggior parte dei casi, i consigli sono configurati nell’interfaccia utente di Adobe Target e quindi utilizzati o accessibili tramite le API di Target, per motivi come quelli menzionati nelle sezioni precedenti. Questo coordinamento UI-API è comune. Tuttavia, a volte gli utenti possono voler eseguire tutte le azioni tramite API, sia la configurazione che l’utilizzo dei risultati. Anche se molto meno comune, gli utenti possono assolutamente configurare, eseguire, e sfruttare i risultati dei consigli interamente utilizzando le API.

In una sezione precedente abbiamo imparato a gestire le entità Recommendations di Adobe Target e a distribuirle lato server. Analogamente, Adobe Developer Console consente di gestire criteri, promozioni, raccolte e modelli di progettazione senza dover accedere ad Adobe Target. Un elenco completo di tutte le API di Recommendations è disponibile qui, ma qui trovi un riepilogo a titolo di riferimento.

Risorsa
Dettagli
Raccolte
Elenca, crea, ottieni, modifica ed elimina raccolte.
Criteri
Elencare e ottenere i criteri.
Progettazioni
Elencare, creare, ottenere, modificare, eliminare e convalidare le progettazioni.
Entità
Salvare, eliminare e ottenere le entità.
Promozioni
Elenca, crea, ottieni, modifica ed elimina promozioni.
Criteri categoria
Elenca, crea, ottieni, modifica ed elimina criteri di categoria.
Criteri personalizzati
Elenca, crea, ottieni, modifica ed elimina criteri personalizzati.
Criteri elemento
Elenca, crea, ottieni, modifica ed elimina i criteri degli elementi.
Criteri di popolarità
Elencare, creare, ottenere, modificare ed eliminare criteri di popolarità.
Criteri attributo profilo
Elenca, crea, ottieni, modifica ed elimina i criteri degli attributi di profilo.
Criteri recenti
Elenca, crea, ottieni, modifica ed elimina criteri recenti.
Criteri di sequenza
Elencare, creare, ottenere, modificare ed eliminare criteri di sequenza.

Documentazione di riferimento

Riepilogo e revisione

Congratulazioni! Completando questa guida, hai imparato a:

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