Prerequisiti per la configurazione

Prima di poter configurare AI Commerce Search per un nuovo progetto, devi:

  1. Creare un nuovo progetto o configurare il progetto esistente
  2. Attivare AI Commerce Search
  3. Importa il catalogo dei prodotti e gli eventi utente

Creare un Google Cloud progetto

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

    Vai alla pagina Gestisci risorse

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

Configurare AI Commerce Search

Per utilizzare AI Commerce Search, segui questi passaggi. Inoltre, se attivi AI Commerce Search e utilizzi i suggerimenti, tieni presente che i costi si basano sul numero di query. Per ulteriori informazioni sui prezzi di AI Commerce Search, consulta Addebiti di AI Commerce Search.

Per il nuovo progetto

Per configurare AI Commerce Search:

  1. Vai alla pagina AI Commerce Search nella Google Cloud console.

    Vai alla pagina AI Commerce Search in Gemini Enterprise for Customer Experience

  2. Nella pagina Configura AI Commerce Search, fai clic su Attiva API.

  3. Quando AI Commerce Search e Recommendations AI vengono visualizzati come Attivati, fai clic su Continua.

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

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

  6. Per attivare la ricerca oltre ai suggerimenti:

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

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

Per un progetto esistente

Per continuare a lavorare su un progetto esistente, completa questi passaggi:

  1. Vai alla pagina AI Commerce Search in Gemini Enterprise for Customer Experience nella Google Cloud console del tuo progetto.

    Vai alla pagina AI Commerce Search in Gemini Enterprise for Customer Experience

  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 i suggerimenti, fai clic su Inizia.

  4. Per attivare la ricerca oltre ai suggerimenti:

    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: AI Commerce Search: ricerca e navigazione
  • Sottocomponente: Amministrazione account e fatturazione

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

Disattivare AI Commerce Search

Puoi disattivare AI Commerce Search in qualsiasi momento disabilitandola. In questo modo vengono disattivati sia i suggerimenti sia la ricerca.

Per disattivare AI Commerce Search:

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

    Vai alla pagina dei dettagli del servizio dell'API AI Commerce Search

  2. Fai clic su Disabilita API.

  3. Nella casella Disabilitare l'API AI Commerce Search?, fai clic su Disabilita.

Iniziare a utilizzare AI Commerce Search

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

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

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

  • Configurazioni di pubblicazione: contiene i dettagli della 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 AI Commerce Search.

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 Sincronizzazione Merchant Center come origine dati.
  4. Seleziona il tuo account Merchant Center. Controlla l'accesso utente se non vedi il tuo account.
  5. (Facoltativo) Seleziona Filtro dei feed di Merchant Center per importare solo le offerte dai 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 il ramo 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 il ramo in cui caricherai il catalogo.
  4. Scegli Schema cataloghi dei prodotti di Retail come schema.
  5. Inserisci la località 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 eliminato definitivamente. Scopri di più sui livelli di prodotto. La modifica dei livelli di prodotto dopo l'importazione dei dati richiede uno sforzo significativo.

    Importante: non puoi attivare la ricerca per i progetti con un catalogo dei 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 dei prodotti.
  3. Seleziona BigQuery come origine dati.
  4. Seleziona il ramo 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 tuo progetto come località temporanea per i dati.

    Se non specificata, viene utilizzata una località predefinita. Se specificati, BigQuery e il bucket 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 eliminato definitivamente. Scopri di più sui livelli di prodotto. La modifica dei livelli di prodotto dopo l'importazione dei dati richiede uno sforzo significativo.

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

    Se non specificata, viene utilizzata una località predefinita. Se specificati, BigQuery e il bucket Cloud Storage devono trovarsi nella stessa regione.
  8. Fai clic su Importa.

Creare 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:

  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. Fornisci un nome per la configurazione di pubblicazione.

    Il nome deve contenere al 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 che fornisci e deve essere univoco nel progetto. Deve contenere al massimo 50 caratteri e non può contenere spazi.
  5. Fai clic su Continua.
  6. Scegli se attivare la suddivisione dinamica per questa configurazione di pubblicazione.
  7. Scegli o crea i controlli di pubblicazione per ottimizzare le ricerche.

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

Gestire le risorse e monitorare l'attività

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

Vai alla console AI Commerce Search in Gemini Enterprise for Customer Experience

Creare una chiave API

È necessaria una chiave API se utilizzi un pixel JavaScript o un tag di 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 userEvents.Collect metodo:

  1. Vai alla Google Cloud pagina Credenziali della console.

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

  3. Fai clic su Crea credenziali e poi seleziona Chiave API. Non aggiungere limitazioni relative alle applicazioni web. È noto che alcune impostazioni per la privacy degli utenti non trasmettono l'URL del referrer.

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

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

Passaggi successivi