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 associer un modèle existant à une nouvelle configuration de diffusion, obtenez l'ID Le modèle que vous prévoyez d'utiliser (obligatoire lorsque vous utilisez 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 :

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 le la page Configurations de diffusion de la Recherchez la console Retail.

Pour créer une configuration de diffusion :

  1. Accédez à la page Configurations de diffusion de 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 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 le modèle auquel vous souhaitez attribuer cette configuration de diffusion pour lesquelles vous fournissez 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é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 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.

    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.

      Il est généré à partir du nom que vous fournissez et doit être unique dans votre projet. Il doit être 50 ne doit pas comporter plus de 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 pour plus d'informations sur les commandes, consultez la page 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 et 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 l'API ServingConfig.create. . Pour obtenir la documentation de référence de l'API pour cette méthode, consultez ServingConfig.create

Les champs que vous utilisez varient selon que vous créez ou non une configuration de diffusion pour recommandations ou la recherche.

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

Recommandations

Envoyez une requête ServingConfig.create avec 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. Ce doit comporter entre 4 et 63 caractères. Les caractères valides sont /[a-z][0-9]-_/.
  • displayName : valeur obligatoire. Nom ServingConfig lisible par l'humain affiché dans la console Search for Retail.
  • modelID : valeur obligatoire. ID du modèle à utiliser lors de l'inférence.
  • priceRerankingLevel : facultatif. Définit l'impact du reclassement de prix sur les résultats des recommandations. Les valeurs autorisées sont no-price-reranking (valeur par défaut si non définie), low-price-raranking, medium-price-reranking et high-price-reranking.
  • diversityLevel : facultatif. Définit le degré de diversification des résultats des recommandations. 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éfinir sur RULE_BASED_DIVERSITY pour diversifier résultats de recommandations en fonction de la catégorie de produits. Définissez la valeur sur DATA_DRIVEN_DIVERSITY pour diversifier les recommandations en fonction des apprentissages issus des métadonnées de produit afin d'équilibrer la pertinence et la diversité des catégories. Si diversityLevel est défini, mais que diversityType n'est pas défini, alors : Par défaut, diversityType est basé sur les règles. Pour en savoir plus, consultez la section Diversification.
  • enableCategoryFilterLevel : facultatif. Détermine si d'autres par catégorie sur le modèle "Articles similaires". Les valeurs autorisées sont relaxed-category-match (valeur par défaut si non définie) et no-category-match.
  • solutionTypes : valeur obligatoire. Définir sur SOLUTION_TYPE_RECOMMENDATION pour et les configurations de diffusion des recommandations.
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"

Recherche

Envoyez une requête ServingConfig.create avec 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. Ce doit comporter entre 4 et 63 caractères. Les caractères valides sont /[a-z][0-9]-_/.
  • displayName : valeur obligatoire. Nom ServingConfig lisible par l'humain affiché dans la console Search for Retail.
  • facetControlIds : facultatif. 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 non définie) et ENABLED.
  • boostControlIds : facultatif. ID des commandes de diffusion optimisée.
  • filterControlIds : facultatif. ID des commandes de diffusion des filtres.
  • redirectControlIds : facultatif. Identifiants des commandes de diffusion de redirection.
  • twowaySynonymsControlIds : facultatif. ID des commandes de diffusion de synonymes bidirectionnels.
  • onewaySynonymsControlIds : facultatif. ID des contrôles de diffusion de synonymes unidirectionnels.
  • doNotAssociateControlIds : facultatif. Identifiants de diffusion sans association .
  • replacementControlIds : facultatif. Identifiants des commandes de diffusion de remplacement.
  • ignoreControlIds : facultatif. ID des commandes de diffusion à ignorer.
  • solutionTypes : valeur obligatoire. Définir sur SOLUTION_TYPE_SEARCH pour 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