Prerequisiti per la configurazione

Prima di poter configurare Vertex AI Search for Retail per un nuovo progetto, devi:

  1. Crea un nuovo progetto o configura quello esistente
  2. Attiva Vertex AI Search per il retail
  3. Importa il catalogo dei prodotti e gli eventi utente

Crea un progetto Google Cloud

  1. Nella pagina Gestisci risorse della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai alla pagina Gestisci risorse

  2. Verifica che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come controllare se la fatturazione è attivata in un progetto.

Configura Vertex AI Search for Retail

Per utilizzare Vertex AI Search for Retail, svolgi i seguenti passaggi. Inoltre, se attivi Vertex AI Search for Retail e utilizzi i consigli, tieni presente che i costi si basano sul numero di query. Per ulteriori informazioni sui prezzi di Vertex AI Search per il retail, consulta Addebiti di Vertex AI Search per il retail.

Per il tuo nuovo progetto

Per configurare Vertex AI Search for Retail:

  1. Vai alla pagina Vertex AI Search per il retail nella console Google Cloud.

    Vai alla pagina Search for Retail

  2. Nella pagina Configura Vertex AI Search per il retail, fai clic su Attiva l'API.

  3. Quando Vertex AI Search per il retail e AI per i consigli sono impostati su On, fai clic su Continua.

  4. Leggi i Termini per l'utilizzo dei dati di Vertex AI Search for Industry e fai clic su Accetta se accetti i termini per l'utilizzo dei dati. Una volta accettati i termini per la Ricerca, riceverai una conferma dalla console Google Cloud.

  5. Se vuoi utilizzare il progetto solo con i consigli, fai clic su Inizia.

  6. Per attivare la ricerca oltre ai consigli:

    1. Fai clic su Continua e poi su Attiva nella pagina Attiva la ricerca (facoltativo).
    2. Fai clic su Inizia.

    La console Google Cloud mostra i componenti di Vertex AI Search for Retail che hai attivato. Ora puoi configurare le impostazioni iniziali del progetto.

Per un progetto esistente

Per continuare con un progetto esistente:

  1. Vai alla pagina Ricerca per la vendita al dettaglio nella console Google Cloud del tuo progetto.

    Vai alla pagina Search for Retail

  2. Nella pagina Termini per l'utilizzo dei dati, leggi i termini di utilizzo dei dati di Discovery Solutions e fai clic su Accetta se li accetti.

  3. Se vuoi utilizzare il progetto solo con i consigli, fai clic su Inizia.

  4. Se vuoi attivare la ricerca oltre ai consigli:

    1. Fai clic su Continua e poi su Attiva nella pagina Attiva la ricerca (facoltativo).
    2. Fai clic su Inizia.

Disattivare le funzionalità di ricerca

Se non vuoi più utilizzare la ricerca, puoi disattivarla inviando un ticket di assistenza.

Per impostare il ticket sul componente corretto, seleziona i seguenti campi:

  • Categoria: Machine Learning
  • Componente: Vertex AI Search for Retail: ricerca e navigazione
  • Componente secondario: Amministrazione account e fatturazione

Per ulteriori informazioni sulla creazione di un ticket di assistenza, consulta la pagina Richiedere assistenza.

Disattivare Vertex AI Search for Retail

Puoi disattivare Vertex AI Search for Retail in qualsiasi momento disattivandolo. In questo modo vengono disattivati sia i consigli sia la ricerca.

Per disattivare Vertex AI Search per il retail, completa i seguenti passaggi:

  1. Vai alla pagina Dettagli dell'API/del servizio Vertex AI Search for Retail nella console Google Cloud.

    Vai alla pagina Dettagli del servizio API Vertex AI Search for Retail

  2. Fai clic su Disabilita API.

  3. Nella casella Disattivare l'API Vertex AI Search for Retail?, fai clic su Disattiva.

Inizia a utilizzare Vertex AI Search per il retail

Quando configuri Vertex AI Search per il retail per un nuovo progetto, la console Google Cloud mostra i tre pannelli seguenti per aiutarti a configurare il progetto Vertex AI Search per il retail:

  • Dati > Catalogo: mostra il catalogo dei prodotti e un link per importarlo.

  • Dati > Eventi: vengono visualizzati gli eventi utente e un link per importare gli eventi utente storici.

  • Configurazioni di pubblicazione: contiene dettagli sulla configurazione di pubblicazione e un link per crearne una nuova.

Puoi utilizzare questi riquadri per importare i dati e creare una configurazione iniziale per il tuo progetto Vertex AI Search per il retail.

Importa il catalogo dei prodotti

Per importare il catalogo dei prodotti, completa la serie di passaggi per l'origine dati. Per ulteriori informazioni sui cataloghi dei prodotti, consulta Importare le informazioni del catalogo.

Sincronizzazione Merchant Center

  1. Fai clic su Importa catalogo dei prodotti per aprire il riquadro Importa dati.
  2. Scegli Catalogo prodotti.
  3. Seleziona Sincronizzazione di Merchant Center come origine dati.
  4. Seleziona il tuo account Merchant Center. Seleziona Accesso utente se non vedi il tuo account.
  5. (Facoltativo) Seleziona Filtro dei feed di Merchant Center per importare solo le offerte dei feed selezionati.

    Se non specificato, vengono importate le offerte di tutti i feed (inclusi i feed futuri).
  6. (Facoltativo) Per importare solo le offerte destinate a determinati paesi o lingue, espandi Mostra opzioni avanzate e seleziona i paesi di vendita e le lingue di Merchant Center in base ai quali filtrare.
  7. Seleziona il branch su cui caricherai il catalogo.
  8. Fai clic su Importa.

Cloud Storage

  1. Fai clic su Importa catalogo dei prodotti per aprire il riquadro Importa dati.
  2. Scegli Catalogo dei prodotti come origine dati.
  3. Seleziona il branch su cui caricherai il catalogo.
  4. Scegli Schema cataloghi dei prodotti di Retail come schema.
  5. Inserisci la posizione in Cloud Storage dei dati.
  6. Se la ricerca non è attivata, seleziona i livelli di prodotto.

    Devi selezionare i livelli di prodotto se è la prima volta che importi il catalogo o se lo stai reimportando dopo averlo svuotato. Scopri di più sui livelli dei prodotti. La modifica dei livelli di prodotto dopo l'importazione dei dati richiede un impegno significativo.

    Importante:non puoi attivare la ricerca per i progetti con un catalogo di prodotti importato come varianti.
  7. Fai clic su Importa.

BigQuery

  1. Fai clic su Importa catalogo dei prodotti per aprire il riquadro Importa dati.
  2. Scegli Catalogo prodotti.
  3. Seleziona BigQuery come origine dati.
  4. Seleziona il branch su cui caricherai il catalogo.
  5. Scegli uno dei seguenti schemi:
  6. Inserisci la tabella BigQuery in cui si trovano i dati.
  7. (Facoltativo) In Mostra opzioni avanzate, inserisci la posizione di un bucket Cloud Storage nel tuo progetto come posizione temporanea per i dati.

    Se non specificato, viene utilizzata una posizione predefinita. Se specificato, i bucket BigQuery e Cloud Storage devono trovarsi nella stessa regione.
  8. Se la ricerca non è attivata e utilizzi lo schema di Merchant Center, seleziona il livello di prodotto.

    Devi selezionare il livello di prodotto se è la prima volta che importi il catalogo o se lo stai reimportando dopo averlo svuotato. Scopri di più sui livelli dei prodotti. La modifica dei livelli di prodotto dopo l'importazione dei dati richiede un impegno significativo.

    Importante:non puoi attivare la ricerca per i progetti con un catalogo di prodotti importato come varianti.
  9. Fai clic su Importa.

Importare gli eventi utente storici

Per importare gli eventi utente storici, completa la serie di passaggi per l'origine dati. Per saperne di più sugli eventi utente storici, consulta Importare gli eventi utente storici.

Cloud Storage

  1. Fai clic su Importa eventi utente per aprire il riquadro Importa dati.
  2. Scegli Eventi utente.
  3. Seleziona Google Cloud Storage come origine dati.
  4. Scegli Schema eventi utente retail come schema.
  5. Inserisci la posizione in Cloud Storage dei dati.
  6. Fai clic su Importa.

BigQuery

  1. Fai clic su Importa eventi utente per aprire il riquadro Importa dati.
  2. Scegli Eventi utente.
  3. Seleziona BigQuery come origine dati.

  4. Seleziona lo schema dei dati.

  5. Inserisci la tabella BigQuery in cui si trovano i dati.
  6. (Facoltativo) Inserisci la posizione di un bucket Cloud Storage nel progetto come posizione temporanea per i dati.
    Se non specificato, viene utilizzata una posizione predefinita. Se specificato, i bucket BigQuery e Cloud Storage devono essere nella stessa regione.
  7. (Facoltativo) In Mostra opzioni avanzate, inserisci la posizione di un bucket Cloud Storage nel tuo progetto come posizione temporanea per i dati.

    Se non specificato, viene utilizzata una posizione predefinita. Se specificato, i bucket BigQuery e Cloud Storage devono trovarsi nella stessa regione.
  8. Fai clic su Importa.

Crea una configurazione di pubblicazione

Una configurazione di pubblicazione è un'entità di pubblicazione che associa un modello o un insieme di controlli utilizzati per generare i risultati di ricerca o dei suggerimenti.

Per creare una configurazione di pubblicazione, completa i seguenti passaggi:

  1. Nel riquadro Configurazioni di pubblicazione, fai clic su Crea configurazione di pubblicazione.
  2. Nella pagina Crea configurazione di pubblicazione, scegli Ricerca come prodotto per il quale verrà utilizzata la configurazione di pubblicazione.
  3. Fornisci un nome per la configurazione di pubblicazione.

    Il nome deve essere costituito da massimo 1024 caratteri e può contenere solo caratteri alfanumerici, trattini bassi, trattini e spazi.
  4. (Facoltativo) Se necessario, aggiorna l'ID.

    L'ID viene generato dal nome fornito e deve essere univoco in tutto il progetto. Deve contenere al massimo 50 caratteri e non può contenere spazi.
  5. Fai clic su Continua.
  6. Scegli se attivare la suddivisione in livelli dinamici per questa configurazione di pubblicazione.
  7. Scegli o crea controlli di pubblicazione per ottimizzare le tue ricerche.

    Per ulteriori informazioni sui controlli, consulta Creare e gestire i controlli.

Gestire le risorse e monitorare le attività

Una volta completata la configurazione iniziale del progetto, la dashboard della console Google Cloud mostra lo stato di sistema del progetto Vertex AI Search per la vendita al dettaglio. La dashboard della console ti consente di gestire le risorse e monitorare l'attività.

Vai alla console Ricerca per la vendita al dettaglio

Crea una chiave API

È necessaria una chiave API se utilizzi un pixel JavaScript o un tag Tag Manager per acquisire gli eventi utente dai browser degli utenti. Per ulteriori informazioni sui modi per acquisire gli eventi utente, consulta Registrare gli eventi utente in tempo reale.

Per creare una chiave API per le chiamate al metodo userEvents.Collect, completa i seguenti passaggi:

  1. Vai alla pagina Credenziali della console Google Cloud.

  2. Nell'elenco a discesa del progetto nella parte superiore della pagina della console Google Cloud, seleziona il progetto (potrebbe essere già selezionato).

  3. Fai clic su Crea credenziali e poi seleziona Chiave API. Non aggiungere limitazioni all'applicazione del sito web. È noto che alcune impostazioni della privacy dell'utente non trasmettono l'URL referrer.

    • Prendi nota della chiave API generata, che utilizzerai quando chiami il logging degli eventi utente.

  4. Per una maggiore sicurezza, aggiungi una limitazione API alla tua chiave API per limitare l'accesso al servizio Vertex AI Search for Retail all'indirizzo https://retail.googleapis.com/*.

Passaggi successivi