Questa pagina descrive come ottimizzare, mettere in pausa, riprendere, eliminare ed elencare i modelli di consigli. Per assistenza nella creazione di un nuovo modello di suggerimenti, consulta Crea modelli di suggerimenti.
Consigli generali per la qualità del modello
In genere, gli eventi devono essere caricati almeno una volta al giorno per mantenere una buona qualità dei dati.
Limiti di età dei dati: gli eventi utente precedenti al 2015 non vengono accettati. Per i suggerimenti di apprendimento automatico, il sistema utilizza gli eventi utente degli ultimi 180 giorni. Allo stesso modo, le metriche per gli eventi utente più vecchi di 180 giorni o generati più di 180 giorni fa non sono esportabili.
ID visitatore unici: il numero totale di ID visitatore unico per ogni tipo di evento deve essere almeno 100 per garantire dati sufficienti per risultati di qualità.
La maggior parte dei modelli offre il rendimento migliore con almeno tre mesi di visualizzazioni delle pagine di prodotto, visualizzazioni della home page ed eventi add-to-cart
.
Per il modello Acquistati spesso insieme, sono consigliati uno o due anni di cronologia acquisti. Questo modello richiede specificamente uno dei seguenti elementi:
In media, 10 occorrenze per voce di catalogo (con una finestra di un anno di eventi di acquisto completato).
Sia 90 giorni di eventi di acquisto completato nell'ultimo anno sia 1000 eventi di acquisto completato nello stesso anno.
Una o due settimane di visualizzazioni delle pagine di dettaglio possono essere sufficienti per iniziare l'addestramento dei modelli Altri video che ti potrebbero piacere e Consigliati per te.
Ottimizza un modello
Vertex AI Search per il commercio utilizza i dati di input che fornisci al modello per regolare gli iperparametri per l'addestramento.
L'ottimizzazione richiede 2-4 giorni, durante i quali il modello continua a funzionare come al solito. Per i dettagli sui costi di ottimizzazione, consulta la pagina Prezzi.
Impostare la frequenza di ottimizzazione di un modello
Ti consigliamo di ottimizzare periodicamente il modello. In questo modo, l'addestramento del modello rimane ottimale man mano che i dati cambiano e il comportamento dei clienti varia nel corso dell'anno. Inoltre, alcuni importanti upgrade interni del modello possono essere applicati solo dopo che il modello è stato ottimizzato.
Quando crei il modello, puoi impostarlo in modo che venga ottimizzato automaticamente ogni tre mesi oppure scegliere di ottimizzarlo solo manualmente. Indipendentemente dall'impostazione che scegli, il modello viene ottimizzato automaticamente una volta dopo la creazione.
Puoi modificare l'impostazione dello stato di ottimizzazione in qualsiasi momento. La modifica di questa impostazione non influisce sui processi di ottimizzazione in esecuzione.
Per modificare l'impostazione dello stato di ottimizzazione di un modello:
Console
Vai alla pagina Modelli nella console Search for commerce.
Vai alla pagina ModelliPuoi visualizzare lo stato di ottimizzazione di ogni modello in Stato di ottimizzazione.
Fai clic sul nome di un modello per visualizzarne la pagina dei dettagli.
Fai clic su Modifica edit accanto a Stato ottimizzazione.
Nell'elenco a discesa, seleziona un'impostazione:
- Ogni tre mesi. Viene eseguita automaticamente quando l'ultima ottimizzazione risale a 90 giorni prima.
- Solo correzione manuale. Si sintonizza solo quando esegui la sintonizzazione manualmente.
Fai clic su Fine done per salvare l'impostazione.
curl
Effettua una richiesta Models.patch
utilizzando l'API. Consulta il
Models.patch
riferimento API.
Per informazioni dettagliate su tutti i campi Models
, consulta il
riferimento API Models
.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d '{ "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID", "PeriodicTuningState": "NEW_TUNING_STATE_VALUE" }' \ 'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID?updateMask=PeriodicTuningState'
Ottimizzare manualmente un modello
L'ottimizzazione manuale attiva un'ottimizzazione una tantum del modello. Potresti ottimizzare manualmente il modello quando si verifica una variazione significativa nel catalogo (ad esempio un aumento delle dimensioni o una modifica della gerarchia del catalogo) o negli eventi (ad esempio il backfilling degli eventi storici o una modifica della distribuzione dei dati dopo la promozione di determinati gruppi di elementi).
Per ottimizzare manualmente un modello:
Console
Vai alla pagina Modelli nella console Search for commerce.
Vai alla pagina ModelliFai clic sul nome di un modello per visualizzarne la pagina dei dettagli.
Fai clic su Sintonizzazione manuale nella barra dei pulsanti.
L'ottimizzazione richiede 2-4 giorni, durante i quali il modello continua a funzionare come al solito.
curl
Effettua una richiesta Models.tune
utilizzando l'API. Consulta il
Models.tune
riferimento API.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ 'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:tune'
Mettere in pausa e riprendere l'addestramento di un modello
Se il modello è attivo (non in pausa), viene eseguito il retraining almeno una volta alla settimana, ma non più di una volta al giorno. Per un riaddestramento coerente, assicurati di caricare i dati degli eventi utente non più di 24 ore dopo che si è verificato l'evento.
Puoi mettere in pausa il modello per interrompere il riaddestramento. Potresti volerlo fare se hai importato dati errati o per rimanere al di sotto del limite di 10 modelli attivi per progetto. Se hai meno di 10 modelli attivi, puoi riavviare un modello in pausa in qualsiasi momento.
Per i dettagli sui costi di addestramento, consulta la pagina Prezzi.
Puoi avviare un massimo di cinque operazioni nei modelli al minuto. Le operazioni limitate nei modelli includono creazione, eliminazione, messa in pausa e ripresa.
Per mettere in pausa o riavviare un modello:
Console
Vai alla pagina Modelli nella console Search for commerce.
Vai alla pagina ModelliPuoi visualizzare lo stato di addestramento di ogni modello in Stato di addestramento.
Per mettere in pausa un modello attivo (Stato addestramento ADDESTRAMENTO), fai clic su Metti in pausa pause.
Per avviare un modello in pausa (Stato addestramento IN PAUSA), fai clic su Riprendi play_arrow.
curl
Per mettere in pausa un modello attivo, invia una richiesta Models.pause
utilizzando l'API. Consulta il riferimento API Models.pause
.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ 'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:pause'
Per avviare un modello in pausa, effettua una richiesta Models.resume
utilizzando l'API.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ 'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:resume'
Visualizza dettagli modello
Visualizza i dettagli di un modello nella console o utilizzando il metodo dell'API Models.get
.
Per visualizzare le configurazioni di pubblicazione associate a un modello specifico, utilizza questa procedura. Tutti gli altri dettagli del modello sono disponibili nella console e nella risposta dell'API.
Console
Vai alla pagina Modelli nella console Search for commerce.
Vai alla pagina ModelliLa pagina Modelli elenca tutti i tuoi modelli e i relativi stati di addestramento e query.
Fai clic sul nome di un modello per visualizzare la pagina Dettagli.
curl
Per ottenere le informazioni di un singolo modello, invia una richiesta Models.get
utilizzando l'API. Consulta il riferimento API Models.get
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ 'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'
Elencare i modelli
Visualizza un elenco dei tuoi modelli nella console o utilizzando il metodo dell'API Models.list
.
Console
Vai alla pagina Modelli nella console Search for commerce.
Vai alla pagina ModelliLa pagina Modelli elenca tutti i tuoi modelli e i relativi stati di addestramento e query.
curl
Per elencare tutti i modelli e i relativi dettagli in linea, invia una richiesta Models.list
utilizzando l'API. Consulta il riferimento
dell'API Models.list
.
Se vuoi, puoi utilizzare il parametro pageSize
per impostare un numero massimo di
risultati da restituire. Se sono disponibili altri risultati, la risposta list
include un token di pagina. Puoi passare un token di pagina nel parametro pageToken
di una richiesta list
per recuperare la pagina successiva dei risultati. Questo
esempio utilizza entrambi i parametri.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ 'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'
Eliminazione di un modello
Puoi avviare un massimo di cinque operazioni nei modelli al minuto. Le operazioni limitate nei modelli includono creazione, eliminazione, messa in pausa e ripresa.
Elimina un modello nella console o utilizzando il metodo dell'API Models.delete
.
Console
Vai alla pagina Modelli nella console Search for commerce.
Vai alla pagina ModelliFai clic sul nome del modello che vuoi eliminare per aprire la pagina dei dettagli.
Fai clic su Eliminadelete nella barra dei pulsanti.
Inserisci di nuovo il nome del modello e fai clic su Conferma.
curl
Effettua una richiesta Models.delete
utilizzando l'API. Consulta il
Models.delete
riferimento API.
Per informazioni dettagliate su tutti i campi Models
, consulta il
riferimento API Models
.
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ 'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'