Prima di iniziare

Creare 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 è abilitata su un progetto.

Configura Vertex AI Search for Retail

Per utilizzare Vertex AI Search for Retail e i suggerimenti, devi attivare Vertex AI Search for Retail e accettare i termini di Vertex AI Search for Industry per l'utilizzo dei dati. Se utilizzi anche la ricerca, devi abilitarla. L'uso della ricerca comporta costi aggiuntivi in base al numero di query. Per ulteriori informazioni, consulta la pagina relativa agli addebiti per la ricerca.

Per configurare Vertex AI Search for Retail, completa i seguenti passaggi:

  1. Vai alla pagina Vertex AI Search for Retail nella console Google Cloud.

    Vai alla pagina di Search for Retail

  2. Nella pagina Configura Vertex AI Search for Retail, fai clic su Attiva API.

  3. Quando Vertex AI Search for Retail e Recommendations AI viene visualizzato come On, fai clic su Continua.

  4. Leggi i termini di Vertex AI Search for Industry relativi all'utilizzo dei dati e fai clic su Accetta se accetti i termini per l'utilizzo dei dati.

    Quando accetti i termini per l'utilizzo dei dati, la console Google Cloud indica che i termini per l'utilizzo dei dati di Vertex AI Search for Retail sono accettati.

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

  6. Se vuoi attivare la ricerca oltre ai consigli:

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

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

Configura per un progetto esistente

Se configuri Vertex AI Search for Retail su un progetto Google Cloud prima dell'entrata in vigore dei Termini per l'utilizzo dei dati il 4 aprile 2022, devi accettare i termini di Vertex AI Search for Industry per continuare a utilizzare Vertex AI Search for Retail con quel progetto. Se necessario, devi anche abilitare la ricerca per il progetto.

Per accettare i termini di Vertex AI Search for Industry per un progetto esistente, completa i seguenti passaggi:

  1. Nella console Google Cloud, vai alla pagina Search for Retail relativa al tuo progetto.

    Vai alla pagina di Search for Retail

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

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

  4. Se vuoi attivare la ricerca oltre ai consigli:

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

Disattiva la ricerca o Vertex AI Search for Retail

Disattiva la ricerca

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

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

  • Categoria: Machine learning
  • Componente: Vertex AI Search for Retail: ricerca e navigazione
  • Sottocomponente: Amministrazione e fatturazione dell'account

Per ulteriori informazioni sulla creazione di un ticket di assistenza, consulta la sezione Ricevere assistenza.

Disattiva Vertex AI Search for Retail

Puoi disattivare Vertex AI Search for Retail in qualsiasi momento. Questa operazione disattiva sia i consigli sia la ricerca.

Per disattivare Vertex AI Search for Retail, completa i seguenti passaggi:

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

    Vai alla pagina dei dettagli del servizio API Vertex AI Search for Retail

  2. Fai clic su Disabilita API.

  3. Nella casella Vuoi disabilitare l'API Vertex AI Search for Retail?, fai clic su Disabilita.

Inizia a utilizzare Vertex AI Search for Retail

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

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

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

  • Configurazioni di pubblicazione: contiene i 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 progetto Vertex AI Search for Retail.

Importare 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 dei prodotti.
  3. Seleziona Merchant Center Sync come origine dati.
  4. Seleziona il tuo account Merchant Center. Controlla la sezione Accesso utenti se non trovi il tuo account.
  5. (Facoltativo) Seleziona Filtro 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 da filtrare.
  7. Seleziona la filiale in 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 la filiale in cui caricherai il catalogo.
  4. Scegli Schema cataloghi dei prodotti retail come schema.
  5. Inserisci la località di Cloud Storage dei tuoi dati.
  6. Se la ricerca non è abilitata, seleziona i livelli di prodotto.

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

    Importante: non puoi attivare la ricerca di progetti con un catalogo dei prodotti che è stato 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 dei prodotti.
  3. Seleziona BigQuery come origine dati.
  4. Seleziona la filiale in 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 località di un bucket Cloud Storage nel progetto come posizione temporanea per i dati.

    Se non specificata, viene utilizzata una località predefinita. Se specificato, i bucket BigQuery e Cloud Storage devono trovarsi nella stessa regione.
  8. Se la ricerca non è abilitata 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 stai reimportando il catalogo dopo averlo eliminato. Scopri di più sui livelli di prodotto. Modificare i livelli di prodotto dopo l'importazione dei dati richiede un impegno significativo.

    Importante: non puoi attivare la ricerca di progetti con un catalogo dei prodotti che è stato 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 località di Cloud Storage dei tuoi 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 località di un bucket Cloud Storage nel progetto come località temporanea per i dati.
    Se non specificata, viene utilizzata una località predefinita. Se specificato, i bucket BigQuery e Cloud Storage devono trovarsi nella stessa regione.
  7. (Facoltativo) In Mostra opzioni avanzate, inserisci la località di un bucket Cloud Storage nel progetto come posizione temporanea per i dati.

    Se non specificata, viene utilizzata una località 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 della ricerca o dei suggerimenti.

Per creare una configurazione di pubblicazione:

  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 cui verrà utilizzata la configurazione di pubblicazione.
  3. Specifica un nome per la configurazione di pubblicazione.

    Il nome non deve superare i 1024 caratteri e può contenere solo caratteri alfanumerici, trattini bassi, trattini e spazi.
  4. (Facoltativo) Se necessario, aggiorna l'ID.

    L'ID viene generato in base al nome da te fornito e deve essere univoco nell'intero progetto. Deve avere una lunghezza massima di 50 caratteri e non può contenere spazi.
  5. Fai clic su Continua.
  6. Scegli se abilitare il faceting dinamico per questa configurazione di pubblicazione.
  7. Scegli o crea controlli di pubblicazione con cui ottimizzare le ricerche.

    Per ulteriori informazioni sui controlli, consulta Creazione e gestione dei controlli.

La dashboard

Una volta completata la configurazione iniziale del progetto, la console Search for Retail visualizza lo stato del sistema del progetto Vertex AI Search for Retail. La console consente di gestire le risorse e monitorare l'attività.

Vai alla console Search for Retail

crea una chiave API

Una chiave API è necessaria se utilizzi un pixel JavaScript o un tag Tag Manager per acquisire gli eventi utente dai browser degli utenti. Per ulteriori informazioni su come acquisire gli eventi utente, consulta Registrare eventi utente in tempo reale.

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

  1. Vai alla pagina Credenziali della console Google Cloud.

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

  3. Fai clic su Crea credenziali e seleziona Chiave API. Non aggiungere limitazioni per le applicazioni sui siti web. È noto che alcune impostazioni della privacy dell'utente non trasmettono l'URL del referrer.

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

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

Passaggi successivi