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 recommandations et de diffusion de recherche présentent des exigences et des options différentes:

  • recommandations pour diffuser des configurations 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 lors du processus de création au lieu d'associer un modèle existant.

    Vous pouvez changer de modèle ultérieurement, tant qu'il s'agit du même type de modèle.

  • peuvent utiliser des commandes de diffusion, mais ce n'est pas obligatoire. 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 des commandes lors du processus de création.

    Vous pouvez modifier votre configuration de diffusion ou en ajouter d'autres après l'avoir créée.

Créer une configuration de diffusion

Vous pouvez créer une configuration de diffusion à l'aide de la commande suivante:

Jusqu'à 100 configurations de diffusion sont autorisées par catalogue.

Si vous disposez déjà d'emplacements ou si vous en créez d'autres, 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 supprime l'emplacement correspondant. De plus, la suppression d'un emplacement supprime 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 Créer une configuration de diffusion.

    recommandations

    1. Sélectionnez Recommendation (Recommandation) 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. Choisissez 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 du 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 la diversification basée sur des règles ou sur les 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 même requête de prédiction 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 les résultats de vos prédictions.

      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'éléments similaires pour cette configuration de diffusion, indiquez si vous souhaitez activer la mise en correspondance des catégories.

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

    1. Sur la page Créer une configuration de diffusion, sélectionnez Rechercher comme produit pour lequel la configuration de diffusion sera utilisée.
    2. Attribuez un nom à votre configuration de diffusion.

      Le nom ne doit pas comporter plus de 1 024 caractères. Il ne peut contenir que des caractères alphanumériques, des traits de soulignement, des traits d'union et des espaces.
    3. Facultatif: mettez à jour l'ID si nécessaire.

      L'ID est généré à partir du nom que vous fournissez et doit être unique dans votre projet. Il ne doit pas comporter plus de 50 caractères et ne peut pas contenir d'espaces.
    4. Cliquez sur Continuer.
    5. Indiquez si vous souhaitez activer 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 le nom d'une configuration de diffusion, puis accédez à l'onglet Évaluer 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 API ServingConfig.create. Pour obtenir la documentation de référence de l'API sur cette méthode, consultez ServingConfig.create.

Les champs que vous utilisez varient selon que vous créez 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.

recommandations

Effectuez une requête ServingConfig.create en indiquant un ID de configuration de diffusion et une instance de ServingConfig contenue dans le corps de la requête.

  • servingConfigId : valeur obligatoire. Crée un ID pour votre ServingConfig. Cette valeur doit comporter entre 4 et 63 caractères. Caractères valides : /[a-z][0-9]-_/.
  • displayName : valeur obligatoire. Nom lisible ServingConfig affiché dans la console Search for Retail.
  • modelID : valeur obligatoire. ID du modèle à utiliser au moment de l'inférence.
  • priceRerankingLevel : facultatif. Définit l'impact du reclassement du prix sur les résultats des recommandations. Les valeurs autorisées sont no-price-reranking (valeur par défaut si elle n'est pas définie), low-price-raranking, medium-price-reranking et high-price-reranking.
  • diversityLevel : facultatif. Définit dans quelle mesure les résultats des recommandations sont divers. Les valeurs autorisées sont no-diversity (par défaut), low-diversity, medium-diversity, high-diversity et auto-diversity. Si diversityLevel n'est pas défini, la diversité est désactivée.
  • diversityType : facultatif. Définissez la valeur sur RULE_BASED_DIVERSITY pour diversifier les résultats des recommandations en fonction de la catégorie de produits. Définissez la valeur sur DATA_DRIVEN_DIVERSITY pour diversifier les recommandations en fonction des enseignements tirés des métadonnées de produits afin d'équilibrer la pertinence et la diversité des catégories. Si diversityLevel est défini, mais que diversityType n'est pas défini, diversityType est basé par défaut sur les règles. Pour en savoir plus, consultez la section Diversification.
  • enableCategoryFilterLevel : facultatif. Détermine si des filtres de catégorie supplémentaires doivent être ajoutés au modèle "Éléments similaires" Les valeurs autorisées sont relaxed-category-match (valeur par défaut si elle n'est pas définie) et no-category-match.
  • solutionTypes : valeur obligatoire. Définissez-la sur SOLUTION_TYPE_RECOMMENDATION pour les recommandations de diffusion de configurations.
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"

search

Effectuez une requête ServingConfig.create en indiquant un ID de configuration de diffusion et une instance de ServingConfig contenue dans le corps de la requête.

  • servingConfigId : valeur obligatoire. Crée un ID pour votre ServingConfig. Cette valeur doit comporter entre 4 et 63 caractères. Caractères valides : /[a-z][0-9]-_/.
  • displayName : valeur obligatoire. Nom lisible ServingConfig affiché dans la console Search for Retail.
  • facetControlIds : facultatif. Les ID des commandes pour lesquelles seul FacetSpec est défini
  • dynamicFacetSpec.mode : facultatif. Mode de la fonctionnalité DynamicFacet. Les valeurs autorisées sont DISABLED (par défaut si elles ne sont pas définies) et ENABLED.
  • boostControlIds : facultatif. ID des commandes d'optimisation de la diffusion.
  • filterControlIds : facultatif. ID des commandes de diffusion des filtres.
  • redirectControlIds : facultatif. ID des commandes de diffusion de redirection.
  • twowaySynonymsControlIds : facultatif. ID des commandes de diffusion de synonymes bidirectionnelles.
  • onewaySynonymsControlIds : facultatif. Identifiants des commandes de diffusion de synonymes à sens unique.
  • doNotAssociateControlIds : facultatif. ID des commandes de diffusion sans association.
  • replacementControlIds : facultatif. ID des commandes de diffusion de remplacement.
  • ignoreControlIds : facultatif. ID des commandes de diffusion à ignorer.
  • solutionTypes : valeur obligatoire. Définissez ce paramètre sur SOLUTION_TYPE_SEARCH pour les configurations de diffusion de recherche.
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