Domande frequenti

Hai altre difficoltà o non trovi il tuo problema tra i seguenti? Segnala un bug o richiedi una funzionalità e partecipa al gruppo Google cloud-recommendations-users o alle discussioni di Stack Overflow.

Generale

1. Disponi di librerie client per l'API Retail o di altro codice campione?

Sì. La guida alle librerie client per l'API Retail è disponibile qui per informazioni sulla configurazione e di riferimento per ogni libreria.

Puoi anche utilizzare Google API Discovery Service al posto delle chiamate REST non elaborate.

2. Tutti i modelli di consigli sono personalizzati?

I modelli Consigliati per te, Altri che potrebbero piacerti e Compra di nuovo offrono consigli personalizzati se forniti insieme alla cronologia utente. I modelli Comprati spesso insieme e Articoli simili non sono personalizzati.

Consulta Informazioni sui modelli di consiglio.

3. Riceverò subito consigli personalizzati o dovrò attendere che questi migliorino nel tempo?

I consigli migliorano man mano che raccogli più cronologia utente. Il modello Consigliati per te mostra i prodotti più apprezzati, mentre il modello Altri che potrebbero piacerti mostra prodotti simili in base principalmente alle visualizzazioni di altri utenti. Entrambi i modelli iniziano a tenere conto immediatamente del comportamento degli utenti, perciò è importante inviare eventi in tempo reale. Consulta Informazioni sui modelli di suggerimento.

Affinché la personalizzazione sia efficace, gli eventi utente devono essere inviati in tempo reale, o molto quasi in tempo reale. Se gli eventi utente vengono inviati solo quotidianamente o in batch nel corso della giornata, i modelli personalizzati potrebbero non funzionare al meglio se venissero inviati eventi in tempo reale.

4. Utilizzi dati demografici degli utenti di Google nei tuoi modelli?

I modelli utilizzano solo i dati del catalogo e degli eventi utente che fornisci. Se vuoi includere dati demografici, puoi includere altre informazioni testuali o numeriche che potrebbero essere utili come attributi personalizzati. Questi dati inizieranno a essere utilizzati dal modello dopo essere stati perfezionati.

Non includere informazioni che consentono l'identificazione personale (PII) come indirizzi email o nomi utente. Ti consigliamo di anonimizzare i dati demografici, ad esempio eseguendo l'hashing dei valori o utilizzando gli ID gruppo.

5. Posso dare consigli in base alla cronologia degli eventi di un gruppo di utenti anziché alla cronologia di un singolo utente?

Attualmente, i consigli si basano su un singolo ID visitatore o ID utente. Dovresti effettuare singole richieste e quindi combinare i risultati per basare i suggerimenti sulla cronologia di un gruppo. Se gli utenti hanno attributi dei metadati comuni, puoi utilizzare gli ID gruppo come ID utente per fornire suggerimenti a livello di gruppo.

6. Ho notato che puoi inviare gli URL immagine dei prodotti. I modelli prendono in considerazione le immagini prodotto?

Al momento no. Questi campi sono forniti in modo che tu possa recuperare questi metadati insieme ai risultati dei suggerimenti restituiti, in modo da facilitare il rendering dei risultati dei suggerimenti. L'anteprima della previsione utilizza anche gli URL immagine per visualizzare le immagini quando visualizzi l'anteprima dei risultati di previsione di un modello nella console Google Cloud.

7. La mia azienda non è un sito web di e-commerce di vendita al dettaglio. Posso comunque utilizzare i suggerimenti per prevedere x,y,z?

Alcuni clienti hanno usato i consigli per consigli sui contenuti, lo streaming di video, i giochi e altri casi d'uso. Tuttavia, i nostri contenuti e la nostra esperienza sono attualmente progettati per il caso d'uso dell'e-commerce per la vendita al dettaglio e potrebbero non essere ancora adatti ad altri casi d'uso.

8. Posso inserire consigli in qualsiasi pagina del mio sito?

Sì, ma tutti i modelli sono progettati per casi d'uso specifici e potrebbero funzionare al meglio su determinate pagine. Consulta Informazioni sui modelli di consiglio.

Gli acquisti frequenti e gli articoli che potrebbero piacerti richiedono ID articolo, quindi dovrebbero essere utilizzati per consigli tramite, ad esempio, un ID prodotto o articoli in un carrello. Gli articoli acquistati di frequente in genere funzionano meglio nelle pagine di aggiunta al carrello o di pagamento, mentre quelli acquistati di frequente che ti possono piacere e gli articoli simili funzionano meglio nelle pagine dei dettagli del prodotto. Consigliato per te potrebbe essere inserito in qualsiasi pagina, poiché richiede solo un ID visitatore come input, ma è progettata come configurazione di pubblicazione sulla home page. La funzionalità Acquista di nuovo è progettata per essere inserita in qualsiasi pagina.

9. Posso usare i consigli per ricevere consigli nelle newsletter via email?

Sì. A questo scopo, effettua una chiamata all'API con un ID visitatore o un ID utente e incorpora i risultati in un modello email. Se vuoi che gli elementi vengano caricati in modo dinamico al momento della lettura delle email, devi utilizzare un endpoint intermedio, come una funzione Google Cloud Functions, per inviare la richiesta di previsione. L'API fornisce solo un elenco di metadati e ID prodotto ordinati, quindi dovrai scrivere anche il tuo codice per visualizzare i risultati delle immagini.

10. Posso utilizzare l'API Retail per altri casi d'uso non web (app mobile, kiosk)?

Sì. Puoi configurare un endpoint (ad esempio, la funzione Google Cloud Functions) per ottenere risultati per l'app. È anche necessario un meccanismo simile per inviare eventi in tempo reale.

11. Non ho dati sugli eventi per più di 3 mesi. Posso continuare a usare l'API Retail? Posso aggiungere altri dati in un secondo momento?

Il modello Elementi simili non utilizza i dati sugli eventi utente o l'ottimizzazione del modello. Se non disponi di dati sugli eventi, puoi comunque creare e addestrare un modello Articoli simili a condizione che tu disponga di dati di catalogo.

Se riesci a registrare traffico sufficiente per eventi in tempo reale, puoi utilizzare i dati recenti per addestrare altri modelli. Se disponi di dati aggiuntivi in un secondo momento, puoi caricarli dopo l'addestramento iniziale del modello. I dati appena sottoposti a backfill vengono incorporati nei modelli durante il riaddestramento giornaliero. Tuttavia, se i dati sono significativamente diversi dagli eventi utilizzati per l'addestramento iniziale, potrebbe essere necessario ottimizzare i modelli.

La maggior parte dei modelli funziona meglio con almeno tre mesi di visualizzazioni della pagina prodotto, della home page e degli eventi di aggiunta al carrello per tutti i modelli e, idealmente, uno o due anni di cronologia degli acquisti per il modello Comprati spesso insieme.

Una o due settimane di visualizzazioni della pagina dei dettagli possono essere sufficienti per iniziare ad addestrare i modelli Altri che potrebbero piacerti e Consigliati per te, mentre le funzionalità Comprate insieme e Compra di nuovo di solito richiedono di più perché in genere il numero di acquisti giornalieri è inferiore al numero di visualizzazioni di pagina. La qualità del modello può essere notevolmente migliorata con più dati; la quantità minima potrebbe non produrre risultati ottimali. Un intero anno di acquisti, ad esempio, consente ai modelli di sfruttare meglio la stagionalità e le tendenze.

12. Posso consigliare le categorie insieme ai prodotti?

Al momento i suggerimenti restituiscono solo suggerimenti sui prodotti, ma puoi ottenere le categorie per ciascun prodotto come parte dei risultati.

13. Hai integrazioni per caricare dati da database SQL o altri sistemi, come BigQuery?

Sì. Per gli eventi, esiste un codice campione che legge da BigQuery. Visualizza un set di dati di esempio di Google Analytics per BigQuery.

14. L'API Retail utilizza i cookie?

L'API Retail non utilizza i cookie. Tuttavia, per tutti gli eventi inviati all'API Retail deve essere specificato un ID visitatore, che spesso è un identificatore di sessione di un cookie.

15. Ho bisogno di un progetto Google Cloud dedicato per l'API Retail?

Puoi creare un nuovo progetto dedicato per l'API Retail o abilitare l'API Retail in un progetto esistente.

16. Perché le mie credenziali non funzionano quando utilizzo l'API Retail tramite Cloud Shell?

Verifica di aver completato i passaggi di configurazione dell'autenticazione per Retail. Dovresti utilizzare un account di servizio che hai reso disponibile nel tuo ambiente. In caso contrario, potresti visualizzare un messaggio di errore simile al seguente: "La tua applicazione è stata autenticata utilizzando credenziali dell'utente finale di Google Cloud SDK o Google Cloud Shell, che non sono supportate."

Per ulteriori informazioni sugli account di servizio, consulta la sezione Autenticazione della documentazione di Google Cloud.

17. Come faccio a confrontare l'API Retail con soluzioni simili?

Puoi eseguire test A/B per confrontare i risultati dell'API Retail con quelli di altri prodotti.

18. Penso che le funzionalità x,y,z sarebbero ottime. Potete aggiungerlo all'API Retail?

La tua opinione è importante per noi. Le richieste di funzionalità possono essere inviate tramite il team dedicato all'account, l'Assistenza Google o il tracker dei problemi.

19. Posso continuare a utilizzare la versione precedente dell'API per i suggerimenti?

È stata eseguita la migrazione dei suggerimenti dall'API Recommendations Engine all'API Retail. Se utilizzavi l'API Recommendations Engine mentre era in versione beta, ti consigliamo di eseguire la migrazione dei suggerimenti all'API Retail (endpoint di servizio https://retail.googleapis.com), che è GA.

L'API precedente (endpoint di servizio https://recommendationengine.googleapis.com) e la relativa documentazione rimangono disponibili, ma non vengono più aggiornate.

Cataloghi e prodotti

1. In che modo i consigli gestiscono gli avvii a freddo per i nuovi prodotti?

Per i prodotti che non hanno una cronologia acquisti, offriamo consigli basati su prodotti simili. In questi casi, è particolarmente importante definire nel catalogo titoli, categorie e descrizioni di prodotto efficaci.

Per gli utenti avvii a freddo (visitatori senza cronologia), i modelli iniziano con i prodotti generali più popolari e diventano più personalizzati in tempo reale man mano che vengono ricevuti più eventi utente.

Consulta Informazioni su cataloghi e prodotti e la pagina di riferimento dei prodotti.

2. Posso utilizzare il mio catalogo di Merchant Center per i consigli?

Sì, puoi esportare un catalogo di Merchant Center in BigQuery utilizzando il servizio Data Transfer di Merchant Center. Dopodiché possiamo leggere il catalogo direttamente da BigQuery. Consulta Importare i dati del catalogo da Merchant Center.

3. In quale altro modo posso importare il mio catalogo?

  • Merchant Center: importalo con Merchant Center. Se utilizzi Retail Search, puoi utilizzare la console per collegare Merchant Center in modo che il suo catalogo si sincronizzi automaticamente.
  • BigQuery: importa direttamente da una tabella o una visualizzazione.
  • Cloud Storage: esegui l'importazione utilizzando file di testo con una voce di catalogo JSON per riga.
  • Importazione incorporata: esegui l'importazione con una chiamata API, utilizzando file di testo con una voce di catalogo JSON per riga.
  • Creare elementi del prodotto: utilizza il metodo di creazione Products.

4. Come faccio a mantenere aggiornato il mio catalogo? Con quale frequenza deve essere aggiornato il catalogo?

Consulta la pagina Mantieni aggiornato il catalogo.

Ti consigliamo di aggiornare il catalogo ogni giorno. Puoi eseguire un aggiornamento completo da Cloud Storage o BigQuery oppure un aggiornamento incrementale (ad esempio, solo elementi nuovi e modificati).

Se possibile, aggiorna il prezzo e la disponibilità in tempo reale. Questo influisce sulla velocità con cui i nuovi articoli possono essere resi disponibili per la ricerca con Retail Search.

Se hai a disposizione un modo semplice per ricevere notifiche sulle modifiche al catalogo (ad esempio tramite Pub/Sub, coda di messaggi, eventi e così via), puoi aggiornare il catalogo in tempo reale utilizzando i metodi API di import o creazione.

Ad esempio, Cloud Scheduler può essere utilizzato per effettuare una chiamata giornaliera di importazione da BigQuery.

5. Esistono dimensioni minime e massime del catalogo?

Non esiste un limite minimo, ma dimensioni del catalogo molto piccole (< 100 articoli) potrebbero non trarre grandi vantaggi dai suggerimenti poiché la disponibilità di prodotti diversi da consigliare è ridotta.

Il catalogo massimo è di 40 milioni di articoli.

Consulta la documentazione per quote e limiti predefiniti e per informazioni su come richiedere una modifica della quota.

6. La mia azienda gestisce siti web in più paesi. Devo utilizzare un solo catalogo per tutti i miei dati?

Solitamente, è meglio avere un solo catalogo con tutti gli articoli. Tutti gli eventi devono essere inviati utilizzando un'unica valuta. Al momento non è possibile avere più cataloghi all'interno dello stesso progetto, ma, se utilizzi le entità, puoi specificare il comportamento di ricerca, suggerimenti e completamento automatico per un paese specifico.

Se i cataloghi sono notevolmente diversi tra i siti web, consigliamo di creare un progetto distinto per ogni sito web. Inoltre, se i paesi hanno lingue diverse, consigliamo di avere progetti separati, uno per ogni lingua.

Se esistono siti web simili con basso traffico rispetto a quello principale, potrebbe essere preferibile utilizzare un unico catalogo se non ci sono eventi sufficienti per produrre modelli di alta qualità per tutti i singoli siti web.

Per utilizzare un unico catalogo, gli ID articolo del catalogo devono essere coerenti, ovvero lo stesso prodotto deve avere un unico ID articolo su tutti i siti web, in modo che non vi siano prodotti duplicati all'interno del catalogo.

Solo per i suggerimenti, un'alternativa all'utilizzo delle entità è filtrare in base a un sito web specifico utilizzando i tag di filtro. Tuttavia, l'aggiornamento dei tag di filtro può richiedere fino a 8 ore, quindi se sono previsti requisiti di disponibilità (non disponibili) specifici per paese, di solito devono essere gestiti da una regola aziendale che filtra i risultati dopo la risposta della previsione.

7. L'API Retail supporta più valute per catalogo?

No, l'API Retail supporta un solo tipo di valuta per catalogo. Gli eventi devono essere caricati nell'API Retail utilizzando un'unica valuta.

Se prevedi di utilizzare la console Google Cloud Retail per ottenere le metriche sulle entrate, assicurati che tutti gli eventi utilizzino una sola valuta o convertili tutti nella stessa valuta prima di caricarli nell'API Retail.

8. Ho più siti web con un catalogo condiviso o articoli simili. I suggerimenti possono fornire suggerimenti tra siti?

In genere consigliamo di utilizzare un unico catalogo come questo solo se vi è una sovrapposizione significativa tra i siti; i siti devono condividere molti o tutti gli stessi prodotti. Quindi, come per i siti multiregionali, puoi utilizzare le entità o filtrare i tag per restituire solo elementi specifici del sito per una determinata chiamata di previsione.

Se i siti non condividono molte o nessuna voce di catalogo, devono essere utilizzati più cataloghi. L'uso di più cataloghi richiede un progetto Google Cloud separato per ogni catalogo.

9. L'inclusione di altri metadati migliora il modello? Il modello considera i campi x,y,z?

Per i campi obbligatori, consulta la sezione Informazioni obbligatorie sulle voci di catalogo.

Altri campi dei metadati sono facoltativi (ad esempio, images e itemAttributes). Possono essere utilizzati per l'anteprima della previsione, l'analisi dei risultati, l'addestramento e l'ottimizzazione. Consigliamo di includere attributi utili come colore, dimensione, materiale e così via. Questi campi possono essere restituiti come parte dei risultati della predict specificando returnProduct:true, in modo che possano essere utili per i risultati del rendering. Le immagini e gli attributi degli elementi vengono utilizzati per l'anteprima della previsione nella console Google Cloud.

10. Quali attributi di un articolo di catalogo vengono utilizzati come input per l'addestramento di un modello?

Viene utilizzata una combinazione di comportamento degli utenti e attributi del prodotto. I campi principali utilizzati sono ID, titolo, gerarchia di categorie, prezzo e URL. Puoi includere altri attributi chiave-valore personalizzati che potrebbero essere utili in Product.attributes[].

Gli URL immagine sono più semplici da utilizzare: puoi restituire questi metadati nell'ambito dei risultati della previsione specificando returnProduct:true, che può salvare una chiamata aggiuntiva per recuperare queste informazioni. La presenza di URL immagine consente inoltre all'anteprima di previsione di visualizzare le immagini quando visualizzi l'anteprima dei risultati di previsione di un modello nella console Google Cloud.

11. Quali lingue sono supportate per i miei prodotti?

  • Consigli: supporta la maggior parte delle lingue. Il modello rileva automaticamente la lingua del testo. Per un elenco di tutte le lingue che possono essere rilevate automaticamente, consulta il documento README di Compact Language Detector.

  • Retail Search: supporta le seguenti lingue: arabo, olandese, inglese, francese, tedesco, italiano, giapponese, coreano, polacco, portoghese, spagnolo e turco. Puoi impostare la lingua quando carichi il catalogo. Il catalogo deve essere in una sola lingua e le query devono essere inviate nella stessa lingua. La presenza di più lingue nel catalogo riduce le prestazioni del modello. Ad esempio, se il catalogo è in spagnolo, ma la query di ricerca è in inglese, l'API Retail non traduce la query in spagnolo.

12. Il mio catalogo ha SKU principali/varianti o principali/secondari. Sono supportati?

Sì. È simile a item_group_id in Merchant Center. Devi stabilire come ricevere i suggerimenti (a livello principale o secondario) e se gli eventi sono a livello principale o secondario.

Per ulteriori informazioni sui livelli di prodotto, consulta Livelli di prodotto.

Determina e imposta il livello di prodotto corretto prima di inviare articoli o eventi. Il livello di prodotto può essere modificato, ma richiede la riassociazione degli elementi e l'ottimizzazione dei modelli.

13. Posso eliminare i prodotti dal catalogo quando non sono più disponibili?

Se un elemento non è più attuale, ti consigliamo di impostarne lo stato su OUT_OF_STOCK anziché eliminarlo, in modo che gli eventi utente precedenti che lo fanno riferimento non vengano invalidati.

Eventi utente

1. Quali eventi utente devo raccogliere?

Consulta Informazioni sugli eventi utente per un elenco dei tipi di eventi utilizzati dall'API Retail, nonché dei requisiti e delle best practice.

2. Come faccio a risolvere i problemi di qualità dei dati durante la creazione dei modelli?

Nella console Retail, vai alla pagina Qualità dei dati per le metriche sulla qualità dei dati relative al catalogo e agli eventi utente importati.

3. Posso eseguire l'integrazione con Google Analytics 360?

Puoi utilizzare i dati storici di Google Analytics 360 (GA360). Analogamente ai dati di Merchant Center, i dati di GA360 possono essere esportati in BigQuery e l'API Retail può leggere gli eventi direttamente da BigQuery.

Per gli eventi in tempo reale, consigliamo di integrare i pixel di monitoraggio con Google Tag Manager, poiché gli eventi vengono ritardati rispetto a GA360.

4. Voglio importare gli eventi utente da Google Analytics 360. Fornisce tutti gli eventi utente necessari dall'API Retail?

Google Analytics 360 supporta in modo nativo tutti gli eventi utente utilizzati dall'API Retail, ad eccezione degli eventi di ricerca. Puoi comunque importare gli eventi utente di ricerca da Analytics 360, ma tieni presente che l'API Retail crea l'evento utente di ricerca a partire dalle query di ricerca e, se presente, dalle impressioni del prodotto.

5. Come faccio a inserire gli eventi in Recommendations AI?

In genere gli utenti importano gli eventi storici utilizzando Cloud Storage o l'importazione API, quindi trasmettono gli eventi in tempo reale utilizzando il tag JavaScript o Pixel di Tag Manager sul sito dal vivo oppure tramite il metodo di scrittura nel backend.

6. Cosa succede se non riesco a inviare tutti i tipi di eventi utente elencati come obbligatori per un modello? Quali sono i tipi di eventi minimi necessari per ciascun modello?

I requisiti di ciascun modello e obiettivo di ottimizzazione sono leggermente diversi. Consulta i requisiti dei dati sugli eventi utente.

Il rendimento del modello è in genere migliore quando ci sono più eventi per voce di catalogo. Per i siti con grandi quantità di traffico e cataloghi più piccoli, potresti essere in grado di iniziare con un volume minore di eventi storici, ma in genere sono necessarie almeno alcune settimane di dati storici e gli eventi in tempo reale d'ora in poi.

7. Ho eventi di aggiunta al carrello e di completamento degli acquisti che non hanno un valore per entrate o quantità. Cosa devo inviare?

Se non disponi di un valore per la quantità, puoi passare il valore predefinito 1 senza influire sui risultati del modello. Per gli articoli è sempre impostato il valore displayPrice (può essere qualsiasi cosa venga mostrata all'utente, ad esempio un prezzo scontato). Il prezzo originale e il costo sono facoltativi.

8. I miei dati riguardavano solo tipi limitati di eventi. Posso comunque utilizzare l'API Retail?

Per conoscere i requisiti minimi dei dati per ciascun tipo di modello, consulta Requisiti dei dati sugli eventi utente.

Risultati di ricerca

1. I risultati di ricerca sono personalizzati?

Sì. Retail Search può fornire risultati personalizzati. I risultati di ricerca sono personalizzati in base agli ID visitatore. Per ulteriori informazioni, consulta la sezione Personalizzazione.

2. Come faccio a includere nella richiesta di ricerca un contesto, ad esempio il negozio da cui un utente fa acquisti?

La disponibilità e le opzioni di evasione degli ordini basate sull'ID negozio sono attributi del catalogo dei prodotti. Le opzioni di evasione ordini sono attributi come "consegna online", "acquisto online" e "ritiro in negozio".

Gli attributi possono essere inviati come parametro nella richiesta di ricerca. Quindi, per questo esempio, la richiesta di ricerca può specificare l'ID negozio dell'utente. I risultati possono essere filtrati o classificati più in alto in base all'ID negozio nella richiesta.

3. Posso nascondere i prodotti dai risultati di ricerca?

Sì. Il parametro filter può filtrare i risultati in base ai tag.

4. È possibile classificarsi in base a più criteri, ad esempio in base alla disponibilità e al prezzo?

Sì, l'attributo [boostSpec] consente regole di ranking complesse.

5. È possibile raggruppare alcuni attributi per ottenere risultati con più facet? Ad esempio, raggruppare le città nello stesso paese in base all'origine di produzione.

Gli attributi del prodotto non sono gerarchici. Tuttavia, puoi utilizzare più attributi personalizzati per ottenere questo risultato. In questo esempio, puoi usare attributi personalizzati sia per il paese di produzione che per la città di produzione.

6. Come funzionano i suggerimenti?

I suggerimenti sono una combinazione di query degli utenti, query riscritte, nomi di prodotti e così via. Per generare suggerimenti di completamento automatico di alta qualità, devi importare un numero sufficiente di eventi di ricerca insieme al catalogo.

Risultati previsione

1. Esiste un limite al numero di previsioni che posso restituire?

Per impostazione predefinita, una richiesta di previsione restituisce 20 elementi nella risposta. Questo valore può essere aumentato o diminuito specificando un valore per pageSize.

Se devi restituire più di 100 articoli, contatta l'Assistenza Google per aumentare il limite. Tuttavia, tieni presente che la restituzione di più di 100 elementi può aumentare la latenza della risposta.

2. Sono in grado di visualizzare i motivi per cui un modello ha consigliato un prodotto specifico?

Al momento non è possibile.

3. Posso scaricare e memorizzare nella cache i risultati delle previsioni?

Poiché i risultati delle previsioni migliorano in tempo reale in risposta all'attività utente sul tuo sito, non è consigliabile utilizzare le previsioni memorizzate nella cache. I modelli vengono riaddestrati ogni giorno per incorporare modifiche al catalogo e reagire alle nuove tendenze negli eventi utente, il che cambia anche i risultati.

4. Devo riposizionare i consigli restituiti in base a una regola aziendale. Questa funzionalità è supportata?

Sì. Tuttavia, anche se puoi riclassificare i suggerimenti restituiti in base alle tue regole aziendali, tieni presente che il riordinamento o l'applicazione di filtri ai risultati consigliati possono ridurre l'efficacia complessiva del modello nel raggiungere l'obiettivo di ottimizzazione scelto.

Gli ordini di re-ranking del prezzo vengono ordinati per primi nell'insieme di consigli restituiti ed è disponibile come personalizzazione integrata per i modelli Altri che ti potrebbero piacere e Consigliati per te.

Consulta la sezione Re-ranking del prezzo.

5. Esistono limitazioni al numero di tag filtro che posso creare e utilizzare?

Non esistono limiti rigidi al numero di tag univoci che puoi creare o utilizzare. Tuttavia, il sistema non è progettato per gestire molti tag di filtro per elemento. Ti consigliamo di limitare i tag di filtro a un massimo di 10 per articolo del catalogo, se possibile. È possibile utilizzare più di 10 valori in tutto il catalogo; si tratta di un limite per articolo. Il limite per i tag totali (la somma totale di tutti i conteggi di tag per elemento) è 100.000.000.

Consulta la documentazione per Quote e limiti di Retail.

6. Posso diversificare i consigli?

Sì. La diversificazione può essere specificata come parte della configurazione di pubblicazione o nei parametri della richiesta di previsione. Con una bassa diversificazione, le previsioni possono contenere elementi simili nella stessa categoria. Con una maggiore diversificazione, i risultati conterranno elementi di altre categorie.

7. Posso assegnare la priorità ai consigli in base al prezzo?

Sì. Il re-ranking del prezzo fa sì che i prodotti consigliati con una probabilità di suggerimento simile vengano ordinati per prezzo, partendo dagli articoli con il prezzo più alto. La pertinenza viene ancora utilizzata anche per ordinare gli articoli, quindi abilitare il re-ranking del prezzo non è la stessa cosa dell'ordinamento per prezzo. Il re-ranking del prezzo può essere specificato come parte della configurazione di pubblicazione o nei parametri della richiesta di previsione.

Modelli

1. Ho caricato il mio catalogo e i miei eventi, ma ricevo ancora questa risposta quando chiamo l'API Prediction: "Il modello di suggerimenti non è pronto. Puoi impostare "dryRun" su true nella richiesta di previsione per scopi di integrazione, in modo da restituire gli articoli arbitrari del catalogo dal tuo catalogo (NON utilizzare per il traffico di produzione)."

In genere ciò significa che l'addestramento del modello non è terminato. Se sono trascorsi più di 10 giorni dalla creazione del modello e continui a ricevere questa risposta, contatta l'assistenza.

2. Quanto tempo occorre per addestrare un modello?

L'addestramento e l'ottimizzazione iniziali del modello richiedono 2-5 giorni, ma possono richiedere più tempo per i set di dati di grandi dimensioni. In seguito, i modelli vengono riaddestrati automaticamente ogni giorno, a meno che non vengano disattivati. Vedi Mettere in pausa e riprendere l'addestramento di un modello.

3. Posso scaricare o esportare il modello?

No.

4. Posso utilizzare i modelli che ho creato in un progetto esistente in un nuovo progetto?

No. Devi creare e riaddestrare i modelli nel nuovo progetto.

5. Voglio utilizzare un modello per le pagine delle mie categorie. È possibile?

Sì. Consigliati per te è utile nelle pagine delle categorie. Una pagina di categoria è simile a una home page, ad eccezione del fatto che vengono visualizzati solo gli elementi di tale categoria. A questo scopo, puoi utilizzare un modello Consigliato per te standard con tag di filtro. Ad esempio, puoi aggiungere tag di filtro personalizzati (corrispondenti a ogni pagina di categoria) agli articoli del catalogo. Quando invii la richiesta di previsione, imposta l'oggetto evento utente come category-page-view e specifica un tag della pagina di categoria specifica nel campo filter. Vengono restituiti solo i risultati dei suggerimenti che corrispondono al tag di filtro richiesto. La diversità dovrebbe essere disabilitata in questo caso d'uso, perché può entrare in conflitto con i tag di filtro basati sulle categorie.

6. Posso disattivare la personalizzazione per i miei modelli?

Per impostazione predefinita, i risultati delle previsioni vengono personalizzati dall'utente per i tipi di modelli di consigli Altri che potrebbero piacerti, Consigliati per te e Acquista di nuovo.

La disabilitazione della personalizzazione non è consigliata perché può influire negativamente sulle prestazioni del modello.

Se devi mostrare articoli di catalogo pertinenti al prodotto visualizzato anziché in base alle precedenti interazioni dell'utente con il tuo sito, puoi ricevere consigli non personalizzati utilizzando un ID visitatore unico casuale in una richiesta di previsione. Assicurati di farlo solo per le richieste nelle configurazioni di gestione che non vuoi personalizzare.

Console Google Cloud per la vendita al dettaglio

1. Ho eliminato definitivamente diversi eventi, ma la dashboard mostra ancora i conteggi per questi tipi di eventi.

È previsto. La dashboard della console Google Cloud mostra il numero di eventi importati in un determinato periodo di tempo e non il numero o il numero di eventi correnti.

In genere, è consigliabile lasciare attivi gli eventi utente dopo che sono stati registrati. L'eliminazione definitiva degli eventi non è consigliata. Se prevedi di reimpostare completamente gli eventi utente, valuta la possibilità di creare un nuovo progetto.

Se devi eliminare definitivamente gli eventi che non sono stati registrati correttamente, consulta la documentazione relativa alla rimozione di eventi utente. Il completamento dell'eliminazione definitiva di un evento può richiedere diversi giorni.

2. Come faccio a capire se ci sono errori nel mio catalogo o nei miei eventi utente?

La maggior parte delle chiamate API per gli aggiornamenti degli articoli di catalogo o gli eventi utente restituisce un errore se si verifica un problema di sintassi o se per qualche motivo la richiesta non può essere elaborata.

La dashboard della console Google Cloud mostra la percentuale di eventi non uniti, che è anche una metrica utile da utilizzare per individuare problemi relativi al catalogo o agli eventi. Gli eventi non uniti (o chiamate di previsione non uniti) si verificano quando viene specificato un ID articolo che non è nel catalogo. Questo di solito significa che il catalogo non è aggiornato e che gli articoli nuovi o modificati devono essere caricati, ma può anche essere dovuto al passaggio di ID articolo non validi. Controlla le tue richieste per assicurarti che gli ID articolo siano mappati correttamente al catalogo, poi controlla il catalogo che hai caricato per assicurarti che gli articoli esistano.

Cloud Monitoring e Cloud Logging possono essere utilizzati per monitorare lo stato degli eventi. Ad esempio, puoi ricevere avvisi se non si verificano eventi in un determinato periodo di tempo o se le chiamate di previsione scendono al di sotto di una determinata soglia.

3. Perché le mie configurazioni di pubblicazione dei suggerimenti vengono visualizzate come inattive? Come faccio ad attivarli?

Per utilizzare le configurazioni di pubblicazione dei suggerimenti, devi prima inviare il catalogo e i dati sugli eventi utente per addestrare il modello corrispondente. Una volta addestrato un modello, la dashboard indica che il modello è pronto per l'esecuzione di query.

4. In quale valuta vengono utilizzate le metriche relative alle entrate della console Google Cloud?

La console Google Cloud per la vendita al dettaglio genera report sulle metriche nella valuta utilizzata nei dati caricati. L'API Retail non supporta l'utilizzo di più valute per catalogo e non converte le valute.

Se prevedi di utilizzare la console Google Cloud Retail per ottenere le metriche sulle entrate, assicurati che tutti gli eventi utilizzino una sola valuta o convertili tutti nella stessa valuta prima di caricarli nell'API Retail.