Créer des configurations de diffusion

Cette page explique comment créer des configurations de diffusion. Une configuration de diffusion est une entité de diffusion qui associe un modèle ou un ensemble de contrôles permettant de générer vos résultats de recherche ou de recommandation.

Avant de commencer

Les configurations de diffusion des recommandations et des résultats de recherche ont des exigences et des options différentes:

• Les configurations de diffusion des recommandations nécessitent un modèle. Si vous prévoyez d'associer un modèle existant à une nouvelle configuration de diffusion, obtenez l'ID du modèle que vous prévoyez d'utiliser (obligatoire lorsque vous utilisez la méthode ServingConfig.create).

  Si vous créez la configuration de diffusion à l'aide de la console, vous pouvez créer un modèle pendant le processus de création au lieu d'y associer un modèle existant.

  Vous pourrez changer de modèle ultérieurement, à condition qu'il soit du même type.

• La recherche peut utiliser des contrôles de diffusion, mais ils ne sont pas obligatoires. Si vous prévoyez d'associer des commandes existantes à une nouvelle configuration de diffusion, obtenez les ID des commandes que vous prévoyez d'utiliser.

  Si vous créez la configuration de diffusion à l'aide de la console, vous pouvez également créer de nouvelles commandes pendant le processus de création.

  Vous pouvez modifier ou ajouter des contrôles de diffusion à votre configuration de diffusion après l'avoir créée.

Créer une configuration de diffusion

Vous pouvez créer une configuration de diffusion à l'aide des éléments suivants:

• La console Retail Search
• L'API ServingConfig.create

Vous pouvez ajouter jusqu'à 100 configurations de diffusion par catalogue.

Si vous disposez d'emplacements existants ou si vous créez de nouveaux emplacements, une configuration de diffusion associée à chaque emplacement est automatiquement créée. La création d'une configuration de diffusion ne crée pas d'emplacement correspondant. La suppression d'une configuration de diffusion entraîne la suppression de l'emplacement correspondant, et la suppression d'un emplacement entraîne la suppression de la configuration de diffusion correspondante.

Créer une configuration de diffusion dans la console

Ajoutez une configuration de diffusion sur la page Configurations de diffusion de la console Search for Retail.

Pour créer une configuration de diffusion:

1. Accédez à la page Configurations de diffusion dans la console Search for Retail.
   
   Accéder à la page "Configurations de diffusion"

2. Cliquez sur add_boxCréer une configuration de diffusion.

   Recommandations

   1. Sélectionnez Recommendation comme produit pour lequel la configuration de diffusion sera utilisée.

   2. Attribuez un nom à votre configuration de diffusion.

      Ce nom doit comporter 1 024 caractères au maximum, et ne peut contenir que des caractères alphanumériques, des traits de soulignement, des traits d'union et des espaces.

   3. Facultatif: Si nécessaire, mettez à jour l'ID.

      L'ID est généré à partir du nom que vous fournissez et doit être unique dans votre projet. Il doit comporter 50 caractères au maximum, et ne peut pas contenir d'espaces.

   4. Sélectionnez ou créez un modèle pour lequel cette configuration de diffusion doit fournir des recommandations.

      En savoir plus sur la création de modèles.

   5. Sélectionnez l'impact du reclassement de prix sur les résultats des recommandations, s'il est disponible pour le modèle que vous avez sélectionné.

      Le reclassement du prix permet de classer par prix les produits recommandés ayant une probabilité de recommandation similaire, les articles ayant le prix le plus élevé figurant en premier. La pertinence étant toujours utilisée pour trier les articles, l'activation du reclassement du prix est différente d'un simple tri des articles par prix décroissant.

   6. Indiquez si vous souhaitez utiliser une diversification basée sur des règles ou sur des données:

      • Basée sur des règles:la diversification basée sur des règles détermine si les résultats renvoyés par une requête de prédiction donnée proviennent de différentes catégories de votre catalogue de produits.

      • Basée sur les données:la diversification basée sur les données utilise le machine learning pour équilibrer la diversité et la pertinence des catégories dans vos résultats de prédiction.

      Pour en savoir plus, consultez la section Diversification.

   7. Sélectionnez le degré de diversification des résultats des recommandations.

   8. Si vous avez sélectionné un modèle d'articles similaires pour cette configuration de diffusion, indiquez si vous souhaitez activer la mise en correspondance des catégories.

      Lorsque la correspondance de catégorie est activée, les seuls résultats de produits renvoyés sont ceux qui partagent au moins une catégorie avec le produit de contexte. La correspondance de catégorie peut être utilisée en combinaison avec d'autres options de filtrage, telles que le prix, la disponibilité et les tags de filtre.

   Recherche

   1. Sur la page Créer une configuration de diffusion, sélectionnez Search (Recherche) comme produit pour lequel la configuration de diffusion sera utilisée.
   2. Attribuez un nom à votre configuration de diffusion.
      
      Ce nom doit comporter 1 024 caractères au maximum, et ne peut contenir que des caractères alphanumériques, des traits de soulignement, des traits d'union et des espaces.
   3. Facultatif: Si nécessaire, mettez à jour l'ID.
      
      L'ID est généré à partir du nom que vous fournissez et doit être unique dans votre projet. Il doit comporter 50 caractères au maximum, et ne peut pas contenir d'espaces.
   4. Cliquez sur Continuer.
   5. Choisissez d'activer ou non les attributs dynamiques pour cette configuration de diffusion.
   6. Choisissez ou créez des commandes de diffusion pour optimiser vos recherches.
      
      Pour en savoir plus sur les commandes, consultez Créer et gérer des commandes.

3. Cliquez sur Créer pour créer une configuration.

   La nouvelle configuration s'affiche sur la page Configurations de diffusion.

   Quelques minutes peuvent être nécessaires pour que la configuration soit disponible dans les requêtes de recherche. Elle est immédiatement disponible pour les recommandations.

4. Facultatif: sur la page "Configurations de diffusion", cliquez sur un nom de configuration de diffusion, puis accédez à son onglet Évaluation pour prévisualiser les produits qui seraient renvoyés pour cette configuration.

   L'aperçu d'évaluation peut vous aider à vérifier que votre configuration fonctionne comme prévu.

Créer une configuration de diffusion avec ServingConfig.create

Vous pouvez créer une configuration de diffusion avec la méthode d'API ServingConfig.create. Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API ServingConfig.create.

Les champs que vous utilisez dépendent de la création d'une configuration de diffusion pour les recommandations ou la recherche.

Pour en savoir plus sur les champs ServingConfig, consultez la documentation de référence de l'API ServingConfigs.

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",
              "modelId": "MODEL_ID",
              "priceRerankingLevel": "PRICE_RERANKING_LEVEL",
              "diversityType": "DIVERSITY_TYPE",
              "diversityLevel": "DIVERSITY_LEVEL",
              "enableCategoryFilterLevel": "CATEGORY_FILTER_LEVEL",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ]
            }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
  

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,
              "facetControlIds": [
                "FACET_CONTROL_ID_1",
                "FACET_CONTROL_ID_2"
              ],
              "dynamicFacetSpec": {
                "mode": "DYNAMIC_FACET_MODE"
              },
              "boostControlIds": [
                "BOOST_CONTROL_ID_1",
                "BOOST_CONTROL_ID_2"
              ],
              "filterControlIds": [
                "FILTER_CONTROL_ID_1",
                "FILTER_CONTROL_ID_2"
              ],
              "redirectControlIds": [
                "REDIRECT_CONTROL_ID_1",
                "REDIRECT_CONTROL_ID_2"
              ],
              "twowaySynonymsControlIds": [
                "TWO_WAY_SYNONYM_CONTROL_ID_1",
                "TWO_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "onewaySynonymsControlIds": [
                "ONE_WAY_SYNONYM_CONTROL_ID_1",
                "ONE_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "doNotAssociateControlIds": [
                "DO_NOT_ASSOCIATE_CONTROL_ID_1",
                "DO_NOT_ASSOCIATE_CONTROL_ID_2"
              ],
              "replacementControlIds": [
                "REPLACEMENT_CONTROL_ID_1",
                "REPLACEMENT_CONTROL_ID_2"
              ],
              "ignoreControlIds": [
                "IGNORE_CONTROL_ID_1",
                "IGNORE_CONTROL_ID_2"
              ],
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ]
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
  

Étapes suivantes

• Demandez des prédictions à partir de votre nouvel emplacement.