Personalizzazione a più slot (anteprima)

La personalizzazione multi-slot (anteprima) consente di specificare come destinazione il contenuto nei layout Web, nelle etichette e negli elenchi in cui vengono visualizzate più azioni (ad esempio un prodotto o una parte di contenuto) agli utenti. Con le API multi-slot di Personalizza esperienze, è possibile avere i modelli di intelligenza artificiale in Personalizza esperienze per scoprire quali contesti utente e prodotti determinano determinati comportamenti, considerando e imparando dal posizionamento nell'interfaccia utente. Ad esempio, Personalizza esperienze può apprendere che determinati prodotti o contenuti determinano più clic come barra laterale o piè di pagina che come evidenziazione principale in una pagina.

In questo articolo si apprenderà perché la personalizzazione a più slot migliora i risultati, come abilitarla e quando usarla. Questo articolo presuppone che l'utente abbia familiarità con le API di Personalizza esperienze come Rank e Reward, e abbia una conoscenza concettuale del modo in cui viene usato nell'applicazione. Se non si ha familiarità con Personalizza esperienze e il relativo funzionamento, esaminare quanto segue prima di continuare:

• Informazioni su Personalizza esperienze
• Funzionamento di Personalizza esperienze

Quando usare la personalizzazione a più slot

Ogni volta che mostri prodotti e/o contenuti agli utenti, potresti voler mostrare più di un elemento ai tuoi clienti. Ad esempio:

• Layout di siti Web per le home page: molte sezioni e aree pagina sono dedicate all'evidenziazione del contenuto in caselle, banner e barre laterali di forme e dimensioni diverse. La personalizzazione a più slot apprenderà come le caratteristiche di questo layout influiscono sulle scelte e sulle azioni dei clienti.
• Sequenza: le sequenze di contenuto che cambiano dinamicamente hanno bisogno di un certo numero di elementi da scorrere. La personalizzazione a più slot può apprendere in che modo influisce la sequenza e persino la durata della visualizzazione sui clic e sul coinvolgimento.
• Prodotti/contenuti correlati e riferimenti incorporati: non è raro coinvolgere gli utenti incorporando o intervallando riferimenti a contenuti e prodotti aggiuntivi in banner, barre laterali, vignette e piè di pagina. La personalizzazione a più slot consente di allocare i riferimenti in cui è più probabile che vengano usati più facilmente.
• Risultati o elenchi di ricerca: se la funzionalità di ricerca dell'applicazione, in cui si forniscono risultati come elenchi o riquadri, è possibile usare la personalizzazione a più slot per scegliere quali elementi evidenziare nella parte superiore considerando più metadati rispetto ai classificatori tradizionali.
• Canali dinamici e playlist: la personalizzazione a più slot può aiutare a determinare una breve sequenza per un elenco di video o brani da riprodurre successivamente in un canale dinamico.

La personalizzazione a più slot consente di dichiarare gli "slot" nell'interfaccia utente per cui devono essere scelte le azioni. Consente inoltre di fornire altre informazioni sugli slot in modo che Personalizza esperienze possa usarle per migliorare il posizionamento dei prodotti, come ad esempio “questa è una scatola grande o una piccola scatola”? Mostra una didascalia o solo una funzionalità? È in un piè di pagina o in una barra laterale?

Come usare la personalizzazione a più slot

1. Abilitare la personalizzazione a più slot
2. Creare un oggetto JSON per la richiesta di classificazione
3. Chiamare l'API di classificazione che definisce gli slot e le azioni di base
4. Chiamare le API di ricompense

Abilitare la personalizzazione a più slot

Per comprendere e decidere se la personalizzazione a più slot è utile per l'utente, consultare Differenze tra la personalizzazione a slot singolo e a più slot. La personalizzazione con più slot è una funzionalità in anteprima: è consigliabile creare un nuovo ciclo di Personalizza esperienze se si desidera testare le API di personalizzazione con più slot, perché l'abilitazione non è reversibile e avrà effetti sul ciclo Personalizza esperienze in esecuzione nell'ambiente di produzione.

Dopo aver deciso di convertire un ciclo in personalizzazione a più slot, è necessario seguire questa procedura una volta per questo ciclo di Personalizza esperienze:

Aggiornare l'istanza di Personalizza esperienze a più slot

1. Disabilitare l'ottimizzazione automatica nel portale di Azure, nella risorsa Personalizza esperienze, in Gestione risorse, nella pagina Impostazioni modello e apprendimento disattivare e salvare l'ottimizzazione automatica.

2. Aggiornare Personalizza esperienze a più slot nel portale di Azure, nella risorsa Personalizza esperienze, in Gestione risorse, nella pagina Impostazioni modello e apprendimento selezionare Esporta impostazioni di apprendimento. Il campo argomenti nel file JSON scaricato inizierà con --cb_explore_adf. Passare a --ccb_explore_adf e salvare il file. CB (banditi contestuali) e CCB (banditi contestuali condizionali) sono gli algoritmi usati rispettivamente da Personalizza esperienze per la personalizzazione a slot singolo e multi-slot. ADF (funzionalità dipendenti dall'azione) indica che le azioni sono espresse/identificate con le funzionalità.

Nella stessa scheda del portale, in Importa impostazioni di apprendimento individuare il file JSON modificato di recente e caricarlo. In questo modo l'istanza di Personalizza esperienze verrà aggiornata in modo che sia un Personalizza esperienze "a più slot" e ora supporterà chiamate di classificazione e ricompensa con più slot.

Creare un oggetto JSON per una richiesta di classificazione

L'uso della personalizzazione a più slot richiede un'API leggermente diversa dall'API di personalizzazione a slot singolo.

Gli slot disponibili per assegnare azioni a in ogni richiesta di chiamata di classificazione vengono dichiarati nell'oggetto slot:

• Matrice di slot: è necessario dichiarare una matrice di slot. Gli slot vengono ordinati: la posizione di ogni slot nella matrice è importante. È consigliabile ordinare le definizioni di slot in base al numero di ricompense/clic/conversioni che ogni slot tende a ottenere, a partire da quello che ottiene di più. Ad esempio, si inserisce una grande casella "hero" della home page per un sito Web come slot 1, anziché un piè di pagina piccolo. Tutte le altre cose sono uguali, Personalizza esperienze assegnerà azioni con più probabilità di ottenere ricompense in precedenza nella sequenza.
• ID slot: è necessario assegnare un valore slotId a ogni slot, ovvero una stringa univoca per tutti gli altri slot in questa chiamata di classificazione.
• Funzionalità dello slot: è necessario fornire metadati aggiuntivi che descrivono e lo distinguono ulteriormente da altri slot. Queste sono denominate funzionalità. Quando si determinano le funzionalità dello slot, è necessario seguire le stesse linee guida consigliate per le funzionalità di contesto e azioni (consultare: Funzionalità per contesto e azioni). Le funzionalità tipiche degli slot consentono di identificare le dimensioni, la posizione o le caratteristiche visive di un elemento dell'interfaccia utente. Ad esempio position: "top-left", size: "big", animated: "no", sidebar: "true" o sequence: "1".
• Azioni di base: è necessario specificare l'ID di azione di base per ogni slot. Ovvero, l'ID dell'azione che verrebbe visualizzata in tale slot se Personalizza esperienze non esistesse. Questo è necessario per eseguire il training di Personalizza esperienze in modalità apprendista e avere un numero significativo durante l'esecuzione di valutazioni offline.
• Avere azioni sufficienti: assicurarsi di chiamare Classificazione con più azioni rispetto agli slot, in modo che Personalizza esperienze possa assegnare almeno un'azione a ogni slot. Personalizza esperienze non ripeterà le raccomandazioni per le azioni negli slot: la risposta di classificazione assegnerà ogni azione al massimo a uno slot.

È consentito aggiungere o rimuovere gli slot nel tempo, aggiungere e modificare le relative funzionalità o riordinare la matrice: Personalizza esperienze si adatterà e manterrà il training in base alle nuove informazioni.

Ecco un oggetto di esempio slots con alcune funzionalità di esempio. Anche se la maggior parte dell'oggetto slots sarà stabile (poiché le interfacce utente tendono a cambiare lentamente), la maggior parte di essa non cambierà spesso: ma è necessario assicurarsi di assegnare gli ID baselineAction appropriati a ogni chiamata di classificazione.

"slots": [ 
    { 
      "id": "BigHighlight", 
      "features": [ 
            { 
              "size": "Large", 
              "position": "Left-Middle" 
            }
        ],
        "baselineAction": "BlackBoot_4656" 
    }, 

    { 
      "id": "Sidebar1", 
      "features": [ 
            { 
              "size": "Small", 
              "position": "Right-Top" 
            } 
        ],
        "baselineAction": "TrekkingShoe_1122"  
    }  
  ]

Usare la risposta dell'API di classificazione

Una risposta di classificazione a più slot dalla richiesta precedente può essere simile alla seguente:

{ 
  "slots": [ 
        { 
          "id": "BigHighlight", 
          "rewardActionId": "WhiteSneaker_8181" 
        }, 
        { 
          "id": "SideBar1", 
          "rewardActionId": "BlackBoot_4656" 
        } 
    ], 
  "eventId": "123456D0-BFEE-4598-8196-C57383D38E10" 
} 

Prendere rewardActionId per ogni slot e usarlo per eseguire il rendering dell'interfaccia utente in modo appropriato.

Chiamare l'API di ricompensa

Personalizza esperienze apprende come scegliere le azioni che ottimizzano la ricompensa ottenuta. L'applicazione osserverà il comportamento dell'utente e calcola un "punteggio di ricompensa" per Personalizza esperienze in base alla reazione osservata. Ad esempio, se l'utente ha fatto clic sull'azione in "slotId": "SideBar1",, si invierà un "1" a Personalizza esperienze per fornire un rinforzo positivo per le scelte di azione.

L'API di ricompensa specifica l'eventId per la ricompensa nell'URL:

https://{endpoint}/personalizer/v1.0/events/{eventId}/reward

Ad esempio, la ricompensa per l'evento precedente con ID: 123456D0-BFEE-4598-8196-C57383D38E10/reward verrà inviata a https://{endpoint}/personalizer/v1.0/events/123456D0-BFEE-4598-8196-C57383D38E10/reward/reward:

{ 
  "reward": [ 
    { 
      "slotId": "BigHighlight", 
      "value": 0.2 
    }, 
    { 
      "slotId": "SideBar1", 
     "value": 1.0 
    }, 
  ] 
} 

Non è necessario fornire tutti i punteggi di ricompensa in una sola chiamata dell'API di ricompensa. È possibile chiamare l'API di ricompensa più volte, ognuna con eventId e slotIds appropriati. Se non viene ricevuto alcun punteggio di ricompensa per uno slot in un evento, Personalizza esperienze assegnerà la ricompensa theDefault configurata per il ciclo (in genere 0).

Differenze tra la personalizzazione a slot singolo e a più slot

Esistono differenze nell'uso delle API di classificazione e ricompensa con la personalizzazione a slot singolo e a più slot:

Impatto dell'abilitazione a più slot per un ciclo di Personalizza esperienze

Inoltre, quando si abilitano più slot, considerare quanto segue:

Passaggi successivi

• Come usare la personalizzazione a più slot
• Esempio: Notebook di Jupyter che esegue un ciclo di personalizzazione a più slot