Crea controlli di pubblicazione

Console Merchandising

1. Fai clic sull'URL fornito dall'amministratore. Sign in (Accedi).

   Verrà visualizzata la pagina Controlli nella console di merchandising.

2. Fai clic su add_boxCrea controllo.

3. Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.

4. Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Metti in evidenza/Nascondi.

5. Configura il controllo Boost/Bury:

   1. In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.

   2. Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.

   3. Definisci le azioni di promozione/seppellimento che vuoi attivare con questo controllo. Queste azioni sono definite da un attributo del catalogo, ad esempio colors, un criterio, ad esempio contains, e un valore, ad esempio red.

   4. Fai clic su add_boxAggiungi attributo per aggiungere altri attributi.

6. Utilizza il cursore per impostare il valore di boost/bury. I numeri negativi sono bury e i numeri positivi sono boost.

7. Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.

console Cloud

1. Vai alla pagina Controlli nella console Ricerca per il commercio.
   
   Vai alla pagina Controlli

2. Nella scheda Controlli pubblicazione, fai clic su add_boxCrea 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 di messa in evidenza/nascondimento 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 venga visualizzata una categoria specifica o venga cercata 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 dei prodotti nel campo Metti in evidenza/Nascondi prodotto.

    Utilizza la sintassi dell'espressione di filtro descritta in Filtro e ordine. 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 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 di 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 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:

• Per saperne di più su questo metodo, consulta il riferimento all'API ServingConfig.addControl.

• Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Console Merchandising

1. Fai clic sull'URL fornito dall'amministratore. Sign in (Accedi).

   Verrà visualizzata la pagina Controlli nella console di merchandising.

2. Fai clic su add_boxCrea controllo.

3. Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.

4. Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Sfoglia e poi scegli il tipo di controllo Metti in evidenza/Nascondi.

5. Configura il controllo Boost/Bury:

   1. In Trigger, inserisci le categorie di pagine che devono attivare il controllo. Se non sono configurati attributi del catalogo, questo controllo è sempre attivo.

   2. Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.

   3. Definisci le azioni di promozione/seppellimento che vuoi attivare con questo controllo. Queste azioni sono definite da un attributo del catalogo, ad esempio colors, un criterio, ad esempio contains, e un valore, ad esempio red.

   4. Fai clic su add_boxAggiungi attributo per aggiungere altri attributi.

6. Utilizza il cursore per impostare il valore di boost/bury. I numeri negativi sono inibitori, i numeri positivi sono stimolanti.

7. Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.

console Cloud

1. Vai alla pagina Controlli nella console Ricerca per il commercio.
   
   Vai alla pagina Controlli

2. Nella scheda Controlli pubblicazione, fai clic su add_boxCrea 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 di messa in evidenza/nascondimento come tipo di controllo.

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

8. Aggiungi filtri per gli attributi dei prodotti 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 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 di 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 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:

• Per saperne di più su questo metodo, consulta il riferimento all'API ServingConfig.addControl.

• Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Console Merchandising

1. Fai clic sull'URL fornito dall'amministratore. Sign in (Accedi).

   Verrà visualizzata la pagina Controlli nella console di merchandising.

2. Fai clic su add_boxCrea controllo.

3. Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.

4. Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca o Sfoglia e poi scegli il tipo di controllo Filtra.

5. Configura il controllo Filtro:

   1. In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca o una categoria di pagina correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.

   2. Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.

   3. Definisci le azioni di filtro che vuoi attivare con questo controllo. Queste azioni sono definite da un attributo del catalogo, ad esempio colors, un criterio, ad esempio contains, e un valore, ad esempio red.

   4. Fai clic su add_boxAggiungi attributo per aggiungere altri attributi.

6. Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.

console Cloud

1. Vai alla pagina Controlli nella console Ricerca per il commercio.
   
   Vai alla pagina Controlli

2. Nella scheda Controlli pubblicazione, fai clic su add_boxCrea 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 di 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:

• Per saperne di più su questo metodo, consulta il riferimento all'API ServingConfig.addControl.

• Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Console Merchandising

1. Fai clic sull'URL fornito dall'amministratore. Sign in (Accedi).

   Verrà visualizzata la pagina Controlli nella console di merchandising.

2. Fai clic su add_boxCrea controllo.

3. Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.

4. Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Reindirizzamento.

5. Configura il controllo Reindirizza:

   1. In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.

   2. Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.

   3. Definisci le azioni di reindirizzamento che vuoi attivare con questo controllo inserendo l'URL di reindirizzamento.

6. Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.

console Cloud

1. Vai alla pagina Controlli nella console Ricerca per il commercio.
   
   Vai alla pagina Controlli

2. Nella scheda Controlli pubblicazione, fai clic su add_boxCrea 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 di 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:

• Per saperne di più su questo metodo, consulta il riferimento all'API ServingConfig.addControl.

• Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Console Merchandising

1. Fai clic sull'URL fornito dall'amministratore. Sign in (Accedi).

   Verrà visualizzata la pagina Controlli nella console di merchandising.

2. Fai clic su add_boxCrea controllo.

3. Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.

4. Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Sinonimi.

5. Configura il controllo dei sinonimi bidirezionali:

   1. In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.

   2. Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.

   3. Definisci il tipo di sinonimo che vuoi attivare con questo controllo. Seleziona Bidirezionale. Per ulteriori informazioni sui tipi di sinonimi, consulta la sezione Sinonimi.

6. Fai clic su Invia. Viene visualizzata una schermata di configurazione dettagliata dei sinonimi bidirezionali.

7. Inserisci i sinonimi nel campo Azioni di sinonimi bidirezionali. Questa azione collega i termini in modo bidirezionale in modo che vengano trattati allo stesso modo nei risultati di ricerca, in modo che una query su divano rosso restituisca divano rosso bordeaux, ma le query su divano bordeaux vengano espanse per includere tutti i tipi di divani rossi, come cremisi o rosa.

8. Fai clic di nuovo su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.

console Cloud

1. Vai alla pagina Controlli nella console Ricerca per il commercio.
   
   Vai alla pagina Controlli

2. Nella scheda Controlli pubblicazione, fai clic su add_boxCrea 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 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 di 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.

Console Merchandising

1. Fai clic sull'URL fornito dall'amministratore. Sign in (Accedi).

   Verrà visualizzata la pagina Controlli nella console di merchandising.

2. Fai clic su add_boxCrea controllo.

3. Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.

4. Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Sinonimi.

5. Configura il controllo Sinonimi unidirezionali:

   1. In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.

   2. Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.

   3. Definisci il tipo di sinonimo che vuoi attivare con questo controllo. Seleziona Solo andata. Per ulteriori informazioni sui tipi di sinonimi, consulta la sezione Sinonimi.

6. Fai clic su Invia. Viene visualizzata una schermata di configurazione dettagliata dei sinonimi unidirezionali.

7. Inserisci i sinonimi nel campo sotto Azioni di sinonimi unidirezionali. Questa azione collega i termini in modo unidirezionale in modo che vengano trattati allo stesso modo nei risultati di ricerca, in modo che una query su divani rossi includa i divani marrone, ma una query su divani marrone non restituisca altri tipi di divani rossi, limitando i risultati solo ai divani marrone.

8. Fai di nuovo clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.

console Cloud

1. Vai alla pagina Controlli nella console Ricerca per il commercio.
   
   Vai alla pagina Controlli

2. Nella scheda Controlli pubblicazione, fai clic su add_boxCrea 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 di 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 es. 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 di 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:

• Per saperne di più su questo metodo, consulta il riferimento all'API ServingConfig.addControl.

• Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Console Merchandising

1. Fai clic sull'URL fornito dall'amministratore. Sign in (Accedi).

   Verrà visualizzata la pagina Controlli nella console di merchandising.

2. Fai clic su add_boxCrea controllo.

3. Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.

4. Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Non associa.

5. Configura il controllo Non associa:

   1. In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.

   2. Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.

   3. In Non associare azioni,specifica i termini che non devono essere associati ai termini di query inseriti nella sezione Trigger precedente. Inseriscili rispettivamente nei campi Termini di query e Termini disaggiunti.

6. Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.

console Cloud

1. Vai alla pagina Controlli nella console Ricerca per il commercio.
   
   Vai alla pagina Controlli

2. Nella scheda Controlli pubblicazione, fai clic su add_boxCrea 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 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 di 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:

• Per saperne di più su questo metodo, consulta il riferimento all'API ServingConfig.addControl.

• Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Console Merchandising

1. Fai clic sull'URL fornito dall'amministratore. Sign in (Accedi).

   Verrà visualizzata la pagina Controlli nella console di merchandising.

2. Fai clic su add_boxCrea controllo.

3. Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.

4. Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Ignora.

5. Configura il controllo Ignora:

   1. In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.

   2. Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.

   3. Inserisci i termini che vuoi ignorare in Azioni di ignoramento.

6. Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.

console Cloud

1. Vai alla pagina Controlli nella console Ricerca per il commercio.
   
   Vai alla pagina Controlli

2. Nella scheda Controlli pubblicazione, fai clic su add_boxCrea 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 es. 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 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 di 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:

• Per saperne di più su questo metodo, consulta il riferimento all'API ServingConfig.addControl.

• Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Console Merchandising

1. Fai clic sull'URL fornito dall'amministratore. Sign in (Accedi).

   Verrà visualizzata la pagina Controlli nella console di merchandising.

2. Fai clic su add_boxCrea controllo.

3. Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.

4. Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Sostituto.

5. Configura il controllo Sostituto:

   1. In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.

   2. Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.

   3. In Azioni di sostituzione, definisci i termini di query da sostituire nel primo campo e i relativi sostituti nel secondo campo.

6. Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.

console Cloud

1. Vai alla pagina Controlli nella console Ricerca per il commercio.
   
   Vai alla pagina Controlli

2. Nella scheda Controlli pubblicazione, fai clic su add_boxCrea 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 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 di 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:

• Per saperne di più su questo metodo, consulta il riferimento all'API ServingConfig.addControl.

• Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Console Merchandising

1. Fai clic sull'URL fornito dall'amministratore. Sign in (Accedi).

   Verrà visualizzata la pagina Controlli nella console di merchandising.

2. Fai clic su add_boxCrea controllo.

3. Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.

4. Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Fissaggio.

5. Configura il controllo Fissa:

   1. In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.

   2. Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.

   3. Definisci le azioni di blocco che vuoi attivare con questo controllo. Queste azioni sono definite dall'ID prodotto e dalla posizione del pin, preferibilmente un numero inferiore a 120 (le dimensioni tipiche di una pagina). Puoi fare clic su add_boxAggiungi prodotto e aggiungerne fino a 10.

6. Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.

console Cloud

1. Vai alla pagina Controlli nella console Ricerca per il commercio.
   
   Vai alla pagina Controlli

2. Nella scheda Controlli pubblicazione, fai clic su add_boxCrea 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 l'e-commerce consente 10 elementi nella mappa di elementi di qualsiasi singolo controllo. La posizione può essere un valore qualsiasi 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 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 di 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, associa 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:

• Per saperne di più su questo metodo, consulta il riferimento all'API ServingConfig.addControl.

• Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

console Cloud

1. Vai alla pagina Valuta nella console Ricerca per il commercio.
   
   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"