Crea controlli di pubblicazione

Questa pagina descrive come creare i controlli di pubblicazione.

I controlli della pubblicazione sono regole che definisci e applichi alle singole configurazioni di pubblicazione. Per ulteriori informazioni sulle configurazioni di pubblicazione, consulta Informazioni sulle configurazioni di pubblicazione.

I controlli di pubblicazione ti consentono di creare regole che personalizzino il modo in cui le configurazioni di pubblicazione pubblicano i risultati.

Puoi creare un controllo della pubblicazione nella console Ricerca per la vendita al dettaglio costituito da una condizione che attiva il controllo e da un'azione che viene eseguita quando si attiva la condizione. Puoi quindi collegare il nuovo controllo della pubblicazione a una configurazione di pubblicazione.

Le configurazioni di pubblicazione hanno una relazione many-to-many con i controlli. Puoi aggiungere più controlli a una configurazione di pubblicazione e un singolo controllo può essere associato a più configurazioni di pubblicazione.

Quando crei controlli di pubblicazione e configurazioni di pubblicazione, seleziona un prodotto (suggerimenti o ricerca) per il quale possono essere utilizzati. I controlli di pubblicazione possono essere associati solo alle configurazioni di pubblicazione dello stesso tipo di prodotto. Ad esempio, un controllo di pubblicazione creato per i consigli non può essere associato a una configurazione di pubblicazione creata per la ricerca.

Le configurazioni di pubblicazione gestiscono i controlli da applicare durante una richiesta di ricerca o di previsione. Al momento della pubblicazione vengono presi in considerazione solo i controlli nella configurazione di pubblicazione attiva per una richiesta. Ad esempio, supponiamo che tu abbia creato due controlli: uno denominato "Sconto gShoe" che migliora i risultati per il brand gShoe quando viene cercata la parola "scarpe" e un altro denominato "Altre scarpe" che espande le query che utilizzano il termine "scarpe da corsa" in modo da includere anche "scarpe sportive". Se agganci solo il controllo "Sconto gShoe" a una configurazione di pubblicazione, le richieste di ricerca che utilizzano questa configurazione migliorano i risultati di gShoe per le query che utilizzano il termine "scarpe", ma il controllo "Altre scarpe" non ha alcun effetto perché non è collegato alla configurazione di pubblicazione in uso.

Puoi creare controlli e poi aggiungerli o scambiarli in una configurazione di pubblicazione dinamica.

Crea o modifica i controlli di pubblicazione in qualsiasi momento nella pagina Controlli o in linea utilizzando il metodo Controls.create. Nella console, puoi facoltativamente creare controlli durante la procedura di creazione della configurazione di pubblicazione.

Puoi creare fino a 100 controlli di pubblicazione. Se hai bisogno di ulteriori controlli della pubblicazione, richiedi una quota aggiuntiva. Per scoprire come richiedere una quota aggiuntiva, consulta Aumentare le quote. Una configurazione di pubblicazione può avere fino a 100 controlli di pubblicazione di qualsiasi tipo, ad eccezione dei controlli di reindirizzamento, il cui limite è 1000 per configurazione di pubblicazione.

I controlli di pubblicazione sono disponibili per:

  • Migliora/nascondi: influisce sul ranking e sull'ordine dei risultati nell'elenco dei risultati restituiti. Disponibile per la ricerca e i consigli.
  • Filtro: rimuove dall'elenco dei risultati restituiti i risultati che non superano il filtro. Disponibile solo per la ricerca.
  • Reindirizzamento: reindirizza gli utenti a una pagina specifica a seconda della query di ricerca. Disponibile solo per la ricerca.
  • Linguistica: personalizza la linguistica delle query di ricerca. Disponibile solo per la ricerca. Sono disponibili diversi tipi di controlli linguistici:
    • Sinonimi: espande i sinonimi considerati per una query di ricerca.
    • Sinonimi unidirezionali: espande i sinonimi considerati in modo unidirezionale per termini specifici.
    • Non associare: impedisce l'utilizzo di un gruppo di termini nella ricerca quando vengono visualizzati termini specifici.
    • Ignora: impedisce l'utilizzo di un termine nelle ricerche.
    • Sostituisci: sostituisce i termini nella query di ricerca.
  • Fissaggio: influisce sull'ordinamento dei risultati, posizionando un risultato in una posizione specifica, ad esempio nella posizione 4. Disponibile per la ricerca e la navigazione.

Per esempi di questi controlli, consulta Informazioni sui controlli di pubblicazione.

Tutorial sul controllo del reindirizzamento

Questo tutorial mostra come utilizzare il controllo di reindirizzamento.

Per seguire le indicazioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su Procedura guidata:

Procedura guidata

Creare un nuovo controllo di pubblicazione

Crea un nuovo controllo di pubblicazione nella pagina Controlli della console Google Cloud o in linea utilizzando il metodo Controls.create.

I controlli hanno requisiti diversi a seconda del tipo. Vai alla procedura di creazione per il tipo di controllo che prevedi di creare:

Creare un controllo boost/bury

Per scoprire di più su questo tipo di controllo, consulta Controlli di messa in evidenza/nascondimento.

Questo tipo di controllo è disponibile per la ricerca e per i consigli.

Per creare un controllo di soppressione/miglioramento della ricerca:

Console

  1. Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Controlli

  2. Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

    Viene visualizzato il riquadro Crea controllo.

  3. Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome controllo.

  4. (Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.

  5. Nella sezione Selezione dei prodotti, seleziona Cerca.

  6. Scegli Controlli boost/bury come tipo di controllo. Fai clic su Continua.

  7. Nella sezione Attivatori, seleziona il tipo di comportamento dell'utente che attiva questo controllo.

    • Sfoglia categorie: la regola si attiva quando un utente sfoglia le categorie sul tuo sito (search.request.query è vuoto).

    • Ricerca: la regola viene attivata quando un utente esegue una ricerca sul tuo sito (search.request.query non è vuoto). Per impostare questo controllo in modo che si attivi quando viene visualizzata una categoria o viene eseguita una ricerca, salta il passaggio successivo.

  8. (Facoltativo) Imposta categorie o query specifiche che possono attivare questo controllo a seconda che si navighi in una categoria specifica o si cerchi una query specifica.

    • Se hai scelto Sfoglia categorie: nel campo Categorie, inserisci le categorie che attiveranno questo controllo quando vengono visualizzate.

    • Se hai scelto Ricerca: fai clic sul pulsante Aggiungi query per aggiungere i termini di query (ad es. running shoes) da filtrare. Per ogni termine, scegli Corrispondenza parziale o Corrispondenza completa.

  9. (Facoltativo) Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.

  10. Fai clic su Continua per passare alla sezione Azioni.

  11. Aggiungi filtri per gli attributi del prodotto nel campo Metti in evidenza/Nascondi prodotto.

    Utilizza la sintassi dell'espressione di filtro descritta in Filtro e ordinamento. Ad esempio, per specificare le versioni rossa e blu di "prodotto1" e "prodotto2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

  12. Per Valore di miglioramento/seppellimento, utilizza il cursore per impostare l'intensità del miglioramento. I valori positivi migliorano i risultati, mentre quelli negativi li nascondono. Fai clic su Continua.

  13. Nella sezione Configurazioni di pubblicazione, seleziona le configurazioni di pubblicazione a cui applicare il controllo.

  14. Invia le impostazioni di controllo.

    I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Ora puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Invia una richiesta Control.create con un ID controllo e un'istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

Un controllo di aumento/seppellimento può essere attivato quando un utente naviga tra le categorie sul tuo sito (search.request.query è vuoto) o quando un utente esegue una ricerca sul tuo sito (search.request.query non è vuoto).

L'esempio seguente mostra i campi per un controllo attivato dalla navigazione, in cui searchSolutionUseCase è impostato su SEARCH_SOLUTION_USE_CASE_BROWSE.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

L'esempio seguente mostra i campi per un controllo attivato dalla ricerca, in cui searchSolutionUseCase è impostato su SEARCH_SOLUTION_USE_CASE_SEARCH.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl:

Creare un controllo di boost/bury per i consigli

Per creare un controllo boost/bury per i consigli:

Console

  1. Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Controlli

  2. Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

    Viene visualizzato il riquadro Crea controllo.

  3. Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome controllo.

  4. (Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.

  5. Nella sezione Selezione dei prodotti, seleziona Consiglio.

  6. Scegli Controlli boost/bury come tipo di controllo.

  7. Fai clic su Continua per passare alla sezione Azioni.

  8. Aggiungi filtri per gli attributi del prodotto nel campo Metti in evidenza/Nascondi prodotto.

    Utilizza la sintassi dell'espressione di filtro descritta in Filtrare i consigli.

    Ad esempio, per specificare le versioni rossa e blu di "prodotto1" e "prodotto2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

  9. Per Valore di miglioramento/seppellimento, utilizza il cursore per impostare l'intensità del miglioramento. I valori positivi migliorano i risultati, mentre quelli negativi li nascondono.

  10. Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

  11. Seleziona le configurazioni di pubblicazione a cui applicare il controllo.

  12. Invia le impostazioni di controllo.

    I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Invia una richiesta Control.create con un ID controllo e un'istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

Per creare un'espressione di filtro, utilizza la sintassi dell'espressione di filtro descritta in Filtrare i consigli.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ],
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl:

Creare un controllo filtro

Per saperne di più su questo tipo di controllo, consulta Controlli filtro.

Console

  1. Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Controlli

  2. Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

    Viene visualizzato il riquadro Crea controllo.

  3. Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome controllo.

  4. (Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.

  5. Scegli Controlli filtro come tipo di controllo.

  6. Fai clic su Continua per passare alla sezione Attivatori.

  7. Seleziona il tipo di comportamento utente che attiva questo controllo:

    • Sfoglia categorie: la regola si attiva quando un utente sfoglia le categorie sul tuo sito (search.request.query è vuoto).

    • Ricerca: la regola viene attivata quando un utente esegue una ricerca sul tuo sito (search.request.query non è vuoto).

  8. (Facoltativo) Imposta una condizione di controllo che attivi la regola in base alla categoria visualizzata o alla query cercata. L'opzione disponibile dipende dal fatto che tu abbia scelto Sfoglia categorie o Cerca:

    • Se hai scelto Sfoglia categorie: nel campo Categorie, inserisci le categorie che attiveranno questo controllo quando vengono visualizzate.

    • Se hai scelto Ricerca: fai clic sul pulsante Aggiungi query per aggiungere i termini di query (ad es. running shoes) da filtrare e poi seleziona una delle seguenti opzioni per ogni termine:

      • Corrispondenza parziale: questo controllo si applica quando una query contiene una corrispondenza parziale a questo termine di query.
      • Corrispondenza completa: questo controllo si applica solo quando una query contiene una corrispondenza completa per questo termine di query.

      Quando uno di questi termini è incluso in una query, il controllo viene applicato.

  9. (Facoltativo) Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.

  10. Fai clic su Continua per passare alla sezione Azioni.

  11. Aggiungi i filtri per gli attributi del prodotto nel campo Azione filtro.

    Utilizza la sintassi dell'espressione di filtro descritta in Filtro e ordinamento.

    Ad esempio, per specificare le versioni rossa e blu di "prodotto1" e "prodotto2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

  12. Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

  13. Seleziona le configurazioni di pubblicazione a cui applicare il controllo.

  14. Invia le impostazioni di controllo.

    I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Invia una richiesta Control.create con un ID controllo e un'istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

Un controllo filtro può essere attivato quando un utente naviga tra le categorie sul tuo sito (search.request.query è vuoto) o quando un utente esegue una ricerca sul tuo sito (search.request.query non è vuoto).

L'esempio seguente mostra i campi per un controllo attivato dalla navigazione, in cui searchSolutionUseCase è impostato su SEARCH_SOLUTION_USE_CASE_BROWSE.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

L'esempio seguente mostra i campi per un controllo attivato dalla ricerca, in cui searchSolutionUseCase è impostato su SEARCH_SOLUTION_USE_CASE_SEARCH.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl:

Creare un controllo di reindirizzamento

Per saperne di più su questo tipo di controllo, consulta Controlli di reindirizzamento.

Console

  1. Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Controlli

  2. Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

    Viene visualizzato il riquadro Crea controllo.

  3. Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome controllo.

  4. (Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.

  5. Scegli Controlli di reindirizzamento come tipo di controllo.

  6. Fai clic su Continua per passare alla sezione Attivatori.

  7. Crea almeno un attivatore per termine di query o intervallo di tempo. I controlli di reindirizzamento richiedono almeno un attivatore:

  8. Seleziona il tipo di comportamento utente che attiva questo controllo:

    • Sfoglia categorie: la regola si attiva quando un utente sfoglia le categorie sul tuo sito (search.request.query è vuoto).

    • Ricerca: la regola viene attivata quando un utente esegue una ricerca sul tuo sito (search.request.query non è vuoto).

  9. Imposta una condizione di controllo che attivi la regola in base alla categoria visualizzata o alla query cercata. L'opzione disponibile dipende dal fatto che tu abbia scelto Sfoglia categorie o Cerca:

    • Se hai scelto Sfoglia categorie: nel campo Categorie, inserisci le categorie che attiveranno questo controllo quando vengono visualizzate.

    • Se hai scelto Ricerca: fai clic sul pulsante Aggiungi query per aggiungere i termini di query (ad es. running shoes) da filtrare e poi seleziona una delle seguenti opzioni per ogni termine:

      • Corrispondenza parziale: questo controllo si applica quando una query contiene una corrispondenza parziale a questo termine di query.
      • Corrispondenza completa: questo controllo si applica solo quando una query contiene una corrispondenza completa per questo termine di query.

      Quando uno di questi termini è incluso in una query, il controllo viene applicato.

  10. Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.

  11. Fai clic su Continua per passare alla sezione Azioni.

  12. Inserisci l'URI a cui reindirizzare quando viene attivato questo controllo.

  13. Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

  14. Seleziona le configurazioni di pubblicazione a cui applicare il controllo.

  15. Invia le impostazioni di controllo.

    I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Invia una richiesta Control.create con un ID controllo e un'istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

Un controllo di reindirizzamento può essere attivato quando un utente naviga tra le categorie sul tuo sito (search.request.query è vuoto) o quando un utente esegue una ricerca sul tuo sito (search.request.query non è vuoto).

L'esempio seguente mostra i campi per un controllo attivato dalla navigazione, in cui searchSolutionUseCase è impostato su SEARCH_SOLUTION_USE_CASE_BROWSE.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

L'esempio seguente mostra i campi per un controllo attivato dalla ricerca, in cui searchSolutionUseCase è impostato su SEARCH_SOLUTION_USE_CASE_SEARCH.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl:

Creare un controllo sinonimi bidirezionale

Per saperne di più su questo tipo di controllo, consulta Controlli sinonimi bidirezionali.

Console

  1. Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Controlli

  2. Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

  3. Nel campo Nome controllo, inserisci un nome per il nuovo controllo.

    Viene visualizzato il riquadro Crea controllo.

  4. Si aprirà la sezione Preferenze.

  5. (Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.

  6. Scegli Controllo sinonimi bidirezionali come tipo di controllo.

  7. Fai clic su Continua per passare alla sezione Attivatori.

  8. (Facoltativo) Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.

  9. Fai clic su Continua per passare alla sezione Azioni.

  10. Nel campo Sinonimi, inserisci da 2 a 100 termini di query (ad es. shirt e top) che devono essere sinonimi tra loro.

    Quando uno di questi termini è incluso in una query, la ricerca considera gli altri termini della query come sinonimi del termine incluso.

  11. Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

  12. Seleziona le configurazioni di pubblicazione a cui applicare il controllo.

  13. Invia le impostazioni di controllo.

    I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Invia una richiesta Control.create con un ID controllo e un'istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                    ]
                },
                "twoWaySynonymAction": {
                  "synonyms": [
                    "SYNONYM_1",
                    "SYNONYM_2"
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl. Consulta Aggiungere controlli alle configurazioni di pubblicazione in linea.

Creare un controllo sinonimi unidirezionale

Per saperne di più su questo tipo di controllo, consulta Controlli di sinonimi unidirezionali.

Console

  1. Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Controlli

  2. Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

    Viene visualizzato il riquadro Crea controllo.

  3. Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome controllo.

  4. (Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.

  5. Scegli Controllo dei sinonimi unidirezionale come tipo di controllo.

  6. Fai clic su Continua per passare alla sezione Attivatori.

  7. (Facoltativo) Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.

  8. Fai clic su Continua per passare alla sezione Azioni.

  9. Nel campo Termini di query, inserisci i termini (ad es. shoes) che devono avere sinonimi associati quando uno di questi è incluso in una query.

  10. Nel campo Sinonimi, inserisci i termini da utilizzare come sinonimi per i termini di query specificati (ad esempio sneakers e sandals come sinonimi unidirezionali per il termine di query shoes).

  11. Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

  12. Seleziona le configurazioni di pubblicazione a cui applicare il controllo.

  13. Invia le impostazioni di controllo.

    I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Invia una richiesta Control.create con un ID controllo e un'istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "oneWaySynonymAction": {
                  "synonyms": [
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "synonyms": [
                      "SYNONYM_1",
                      "SYNONYM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl:

Creare un controllo di mancata associazione

Per saperne di più su questo tipo di controllo, consulta Controlli di mancata associazione.

Console

  1. Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Controlli

  2. Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

    Viene visualizzato il riquadro Crea controllo.

  3. Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome controllo.

  4. (Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.

  5. Scegli Non associa controllo come tipo di controllo.

  6. Fai clic su Continua per passare alla sezione Attivatori.

  7. (Facoltativo) Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.

  8. Fai clic su Continua per passare alla sezione Azioni.

  9. Nel campo Termini di query, inserisci i termini (ad es. gShoe) che vuoi distinguere esplicitamente da altri.

  10. Nel campo Termini disaggiunti, inserisci i termini da disaggregare dai risultati di ricerca con i termini di query che hai specificato.

    Ad esempio, puoi disaccoppiare il termine di query gShoe dal termine cheap.

  11. Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

  12. Seleziona le configurazioni di pubblicazione a cui applicare il controllo.

  13. Invia le impostazioni di controllo.

    I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Invia una richiesta Control.create con un ID controllo e un'istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "doNotAssociateAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "doNotAssociateTerms": [
                      "DISSOCIATED_TERM_1",
                      "DISSOCIATED_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl:

Creare un controllo di ignoramento

Per saperne di più su questo tipo di controllo, consulta Ignorare i controlli.

Console

  1. Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Controlli

  2. Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

    Viene visualizzato il riquadro Crea controllo.

  3. Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome controllo.

  4. (Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.

  5. Scegli Non associa controllo come tipo di controllo.

  6. Fai clic su Continua per passare alla sezione Attivatori.

  7. (Facoltativo) Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.

  8. Fai clic su Continua per passare alla sezione Azioni.

  9. Nel campo Ignora termini, inserisci i termini (ad esempio shoddy) che vuoi che una ricerca ignori quando vengono inseriti come termini di query.

  10. Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

  11. Seleziona le configurazioni di pubblicazione a cui applicare il controllo.

  12. Invia le impostazioni di controllo.

    I controlli appena creati o aggiornati richiedono alcuni minuti prima di essere pronti per gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Invia una richiesta Control.create con un ID controllo e un'istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "ignoreAction": {
                  "ignoreTerms": [
                      "IGNORE_TERM_1",
                      "IGNORE_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl:

Creare un controllo sostitutivo

Per saperne di più su questo tipo di controllo, consulta Controlli di sostituzione.

Console

  1. Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Controlli

  2. Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

    Viene visualizzato il riquadro Crea controllo.

  3. Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome controllo.

  4. (Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.

  5. Scegli Controllo sostitutivo come tipo di controllo.

  6. Fai clic su Continua per passare alla sezione Attivatori.

  7. (Facoltativo) Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.

  8. Fai clic su Continua per passare alla sezione Azioni.

  9. Nel campo Termini di query, inserisci i termini di query (ad es. gShoe) che vuoi sostituire con il termine sostitutivo.

  10. Nel campo Termine sostitutivo, inserisci il termine che deve sostituire i termini di query specificati.

    Ad esempio, puoi sostituire il termine di query gShoe con il termine di sostituzione Google Shoe.

  11. Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

  12. Seleziona le configurazioni di pubblicazione a cui applicare il controllo.

  13. Invia le impostazioni di controllo.

    I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Invia una richiesta Control.create con un ID controllo e un'istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "replacementAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "replacementTerm": "REPLACEMENT_TERM"
                  }
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl:

Creare un controllo di blocco

Per creare un controllo di blocco:

Console

  1. Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Controlli

  2. Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

    Viene visualizzato il riquadro Crea controllo.

  3. Nel campo Nome controllo della sezione Preferenze, inserisci un nome per il nuovo controllo.

  4. (Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.

  5. Nella sezione Selezione dei prodotti, seleziona Cerca o Sfoglia.

  6. Scegli Controllo di blocco come tipo di controllo. Fai clic su Continua.

  7. Nella sezione Attivatori, scegli il comportamento dell'utente che attiva questo controllo:

    • Sfoglia categorie: per le richieste di ricerca è necessario che il campo page_categories sia compilato e che search.request.query sia vuoto.

    • Ricerca: le richieste di ricerca richiedono solo l'inserimento di search.request.query.

      Per impostazione predefinita, questo controllo viene attivato per tutte le categorie e le query cercate.

  8. (Facoltativo) Imposta una condizione che attivi la regola in base a una determinata categoria visualizzata o alla query cercata:

    • Sfoglia categorie: nel campo Categorie, inserisci le categorie che attivano il controllo.

    • Ricerca: per aggiungere termini di query da filtrare (ad es. running shoes), fai clic su Aggiungi query. Per ogni termine, scegli Corrispondenza parziale o Corrispondenza completa.

  9. (Facoltativo) Fai clic su Aggiungi intervallo di tempo o Aggiungi intervallo di date per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.

  10. Fai clic su Continua per passare alla sezione Azioni. Per Posizione bloccata, utilizza il cursore per specificare la posizione in cui devono essere bloccati i prodotti. Il dispositivo di scorrimento del valore del blocco non accetta valori pari a 0, numeri negativi o non interi.

    Vertex AI Search per il retail consente 10 indicatori nella mappa degli indicatori di qualsiasi singolo controllo. La posizione può essere qualsiasi valore compreso tra 1 e 120 (la dimensione massima della pagina della richiesta).

  11. Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione. Seleziona le configurazioni di pubblicazione a cui applicare il controllo e invia le impostazioni di controllo.

    I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Invia una richiesta Control.create con un ID controllo e un'istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

curl -X POST \
 -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 -H "Content-Type: application/json; charset=utf-8" \
 -H "X-Goog-User-Project: PROJECT_NUMBER" \
 --data '{
          "displayName": "DisplayName",
          "solutionTypes": "SOLUTION_TYPE_SEARCH",
          "searchSolutionUseCase": ["SEARCH_SOLUTION_USE_CASE_SEARCH"],
     "rule": {
            "condition": {
 "queryTerms": [
                {
                  "value": "Term1",
                  "fullMatch": "boolean: true / false"
                },
                {
                  "value": "Term2",
                  "fullMatch": "boolean: true / false"
                },
             ],
             "activeTimeRange": [
               {
                 "startTime": timestamp1,
                 "endTime": timestamp2
               },
               {
                 "startTime": timestamp3,
                 "endTime": timestamp4
               }
             ]
            },
            "pinAction": {
               "pinMap" :  {
                        "pin_position1": "product_id",
                      "pin_position2": "product_id>"
                    }
            }
              }
}' \
"https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/controls?controlId=CONTROL_ID"

pin_position deve essere un numero intero compreso tra [1,10] inclusi e product_id deve esistere nel tuo catalogo. Il numero massimo di elementi consentiti nella mappa dei pin è 10 per ogni controllo.

Quindi, collega il controllo di blocco alla configurazione di pubblicazione:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "X-Goog-User-Project: PROJECT_NUMBER" \
-d '{
      "controlId": "CONTROL_ID"
  }' \
'https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

In questo caso, CONTROL_ID deve essere il controllo di blocco id che hai creato in precedenza.

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl:

Infine, per testare la configurazione, effettua una richiesta di ricerca. Per assicurarti che a una richiesta venga applicato correttamente il controllo di blocco, utilizza termini di query (nella ricerca) o categorie di pagine (nella visualizzazione) corrispondenti ai termini/alle categorie forniti nel controllo creato nei passaggi precedenti.

Console

  1. Vai alla pagina Valuta nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Valuta

  2. Vai alla scheda Ricerca.

  3. Inserisci una query di test nel campo della query di ricerca.

  4. Fai clic su Anteprima ricerca.

  5. Visualizza i risultati per assicurarti che i prodotti scelti siano bloccati.

curl 

curl -s -X POST -H "Authorization: Bearer " -H "Content-Type: application/json"
--data "{'query': '','visitorId': ''}" \ "https://retail.googleapis.com/v2/projects/PROJECT/locations/global/catalogs/CATALOG/placements/default_search:search"

Vincoli per il controllo degli errori

Per il controllo degli errori, tieni presente questi vincoli:

  • Non è possibile fissare due prodotti nella stessa posizione, ovvero i prodotti "a" e "b" non possono occupare entrambi la posizione 2.
  • Al contrario, un prodotto non può essere fissato in più posizioni, ovvero il prodotto "a" non può essere fissato contemporaneamente alle posizioni 2 e 3 per la stessa query.
  • product_id deve esistere come prodotto nel catalogo, supponendo che non vengano applicati filtri o ordinamento.