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.
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:
- Crea un’attività Target (A/B, XT, AP o Recommendations) utilizzando il Compositore basato su moduli (non il Compositore esperienza visivo).
- 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.
-
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.
-
In Target, passa a Activities > Create Activity > Recommendations, quindi seleziona Form.
-
Selezionare una proprietà e fare clic su Next.
-
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.
-
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
-
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.
-
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.
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 Testo di accompagnamento precedente: "Nota: questo consiglio si basa su prodotti simili di contenuto basati sul file entity.id inviato tramite mboxParameters." —>
-
-
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.
-
Ricevi una risposta in base alla progettazione JSON.
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.
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.
Documentazione di riferimento
Riepilogo e revisione
Congratulazioni! Completando questa guida, hai imparato a: