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.