Componente zona
Una zona è uno slot per i suggerimenti. Nonostante sia facoltativo, l'utilizzo delle zone offre una maggiore flessibilità. Ad esempio, la pagina dettagli prodotto può avere due zone: una per il Recommender "Potrebbe interessarti anche" e un'altra per il Recommender "Completamento del set". Utilizzando le zone è possibile passare facilmente da un Recommender all'altro in Einstein Configurator.
Diversamente dagli slot di contenuto, l'implementazione dei suggerimenti con Einstein Recommendations API richiede l'utilizzo di codice per abilitare il passaggio tra Recommender.
Quando si modificano i Recommender per una zona, limitare la modifica agli altri Recommender dello stesso tipo. Con questa azione si evita la necessità di modificare l'ancoraggio del suggerimento.
Con le zone | Senza le zone | |
---|---|---|
Modifica dei Recommender per una zona | In Einstein Configurator, modificare il Recommender collegato alla zona. | Utilizzare una modifica di codice per aggiornare la chiamata API con il nuovo Recommender. |
Endpoint API | Genera suggerimenti zona | Genera suggerimenti |
Risposta dell'endpoint dei suggerimenti | {recs: [], recoUUID: '', recommenderName: '', displayMessage: ''} | {recs: [], recoUUID: ''} |
L'endpoint delle attività è sempre lo stesso, che si utilizzino le zone oppure no. Le attività viewReco
e clickReco
richiedono sempre un parametrorecommenderName
. Quando si utilizzano le zone, il parametro recommenderName
nelle attività viewReco
e clickReco
deve provenire dalla risposta a una chiamata a Zone Recommendations API.
Dopo avere abilitato l'accesso all'API in Einstein Configurator, la scheda Suggerimenti sito diventa un menu per gli utenti amministratore del sito. Con questo menu è possibile visualizzare e configurare i Recommender o le zone.
Gli amministratori del sito possono abilitare l'accesso alle zone per altri utenti dalla scheda Gestione utenti individuando e selezionando l'utente, quindi selezionando Modifica azioni nel menu.
Nella scheda Recommender è possibile impostare, modificare ed eliminare Recommender, come con la pagina Suggerimenti sito senza accesso API configurato. Nella scheda Zone è possibile impostare, modificare ed eliminare zone.
Per creare una zona:
- Selezionare Zone nel menu Suggerimenti sito.
- Fare clic su +Nuova zona.
- Specificare un Nome zona e una descrizione facoltativa della zona.
- Una volta salvato, il Nome zona non può essere modificato.
- Selezionare nel menu un Recommender disponibile per l'utilizzo nella zona.
- Se non è stato configurato alcun Recommender o non si è deciso quale Recommender utilizzare per una zona, è possibile eseguire questo passaggio in seguito. Per informazioni sulla creazione dei Recommender, vedere Commerce Cloud Einstein Product Recommendations.
- Fare clic su Salva.
È possibile creare più zone da utilizzare in Einstein API.
Dopo aver impostato le zone in Einstein Configurator, lo sviluppatore utilizza il nome zona configurato come parametro di percorso zoneName
nella richiesta API della zona (vedere API Specification
- Endpoints
- Zone Recommendations
).
La risposta contiene un recommenderName
che identifica il nome del Recommender correntemente configurato per la zona. Passare questo valore come parametro di corpo recommenderName
nelle richieste delle attività viewReco
e clickReco
successive.