Obtener recomendaciones

En esta página se describe cómo solicitar recomendaciones de productos para un usuario y un evento de usuario específicos.

Una vez que haya subido sus productos y registrado eventos de usuario, podrá solicitar recomendaciones de productos para usuarios específicos en función de los eventos de usuario registrados y de su actividad actual. Los nuevos productos y eventos de usuario pueden tardar hasta 48 horas en reflejarse en el modelo de recomendación.

Vertex AI Search para el sector del comercio devuelve una lista de identificadores de productos clasificados. Usted es responsable de mostrar los resultados en su sitio web con imágenes y texto.

No almacenes en caché los resultados personalizados de un usuario final y no devuelvas resultados personalizados a otro usuario final.

Antes de empezar

Debes crear un Google Cloud proyecto y configurar la autenticación siguiendo los pasos detallados en Antes de empezar.

Además, antes de poder solicitar predicciones de recomendaciones, necesitas un modelo de recomendación preparado y optimizado y al menos una configuración de servicio activa.

Evaluar recomendaciones

Antes de actualizar el código de su sitio web para solicitar recomendaciones, puede usar la vista previa de los resultados de las predicciones para confirmar que su modelo y su configuración de servicio funcionan como espera.

Para obtener más información sobre las configuraciones de servicio, consulta Acerca de las configuraciones de servicio.

Puede previsualizar los resultados de la configuración de servicio desde la página Evaluar o desde la página Detalles de la configuración de servicio en la consola. Para ello, haga clic en la pestaña Evaluar. Sigue estos pasos para obtener una vista previa desde la página Evaluar.

Para obtener una vista previa de las recomendaciones devueltas por tu configuración de publicación, sigue estos pasos:

1. Ve a la página Evaluar de la consola de búsqueda para comercio.
   
   Ve a la página Evaluar.

2. Haga clic en la pestaña Recomendaciones si aún no está seleccionada.

3. Selecciona la configuración de publicación que quieras previsualizar.

4. Opcional: Introduce un ID de visitante para previsualizar las recomendaciones de ese usuario.

5. Si se muestra la sección Artículos asociados, haga clic en Añadir artículo e introduzca un ID de producto para obtener recomendaciones asociadas a ese artículo. Puedes añadir varios elementos asociados.

   Solo se pueden añadir elementos si el tipo de modelo de la configuración de servicio seleccionada requiere productos como entrada para las recomendaciones. Los modelos Recomendaciones para ti no requieren que se introduzcan artículos asociados.

6. Haz clic en Vista previa de la predicción para ver los resultados de la predicción.

Para ver la página Detalles de la configuración de servicio que estás previsualizando, haz clic en Ver configuración de servicio en el campo Seleccionar configuración de servicio.

Recibir una recomendación

La API Recommendations tiene límites en el número de elementos devueltos. Sin embargo, hay soluciones alternativas para aumentar el número de elementos devueltos.

Aumentar los límites

• El límite de resultados de Vertex AI Search para el sector del comercio es de 120.

• La API Recommendations admite la reordenación de hasta 2000 elementos.

• Aunque la latencia aumenta, es posible aumentar el tamaño de la página hasta 500 o 1000.

Soluciones

En las páginas de categorías, puedes personalizar y volver a clasificar los elementos mediante recomendaciones personales. Para evitar el límite de 120 resultados, haz varias llamadas simultáneas para el primer número de páginas determinado y, después, combina los resultados para que parezca una página grande.

Para restringir manualmente el conjunto de recomendaciones que se devuelven a los usuarios finales, puedes añadir criterios de filtro en las consultas PredictRequest.params.

Marque los atributos seleccionados como filtrables mediante la API y, a continuación, haga referencia a ellos directamente en sus solicitudes de predicción.

Para obtener información detallada sobre los costes de las predicciones, consulta la página Precios.

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data '{
              "filter": "FILTER_STRING",
              "validateOnly": false,
              "userEvent": {
                  "eventType": "detail-page-view",
                  "visitorId": "VISITOR_ID",
                  "userInfo": {
                      "userId": "USER_ID",
                      "ipAddress": "IP_ADDRESS",
                      "userAgent": "USER_AGENT"
                  },
                  "experimentIds": "EXPERIMENT_GROUP",
                  "productDetails": [{
                      "product": {
                        "id": "PRODUCT_ID"
                     }
                  }]
              }
            }' \
https://retail.googleapis.com/v2/projects/PROJECT_ID/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:predict

{
  "results": [{"id": "sample-id-1"}, {"id": "sample-id-2"}],
  "attribution_token": "sample-atr-token"
}

public static PredictResponse predictWithNextPageToken(UserEvent userEvent, int pageSize,
    String nextPageToken)
    throws IOException, InterruptedException {
  PredictionServiceClient predictionClient = getPredictionServiceClient();

  PredictRequest request = PredictRequest.newBuilder()
      .setPlacement(HOME_PAGE_PLACEMENT_NAME)
      .setUserEvent(userEvent)
      .setPageSize(pageSize)
      .setPageToken(nextPageToken)
      .setValidateOnly(true)
      .build();

  PredictResponse response = predictionClient.predict(request);

  predictionClient.shutdownNow();
  predictionClient.awaitTermination(2, TimeUnit.SECONDS);

  return response;
}

Reclasificación de precios

Si reclasificas los precios, los productos recomendados que tengan una probabilidad de recomendación similar se ordenarán por precio, y aparecerán en primer lugar los que tengan un precio más alto. La relevancia también se sigue usando para ordenar los artículos, por lo que habilitar la reordenación por precio no es lo mismo que ordenar por precio.

El cambio de orden de los precios se puede definir a nivel de configuración de servicio o por solicitud de predicción.

Cuando eliges un ajuste de cambio de orden de los precios al crear una configuración de publicación en la consola de búsqueda de comercio, ese ajuste se aplica a todas las recomendaciones publicadas por esa configuración, sin que tengas que hacer nada más.

Si necesitas controlar la reclasificación por precio de una recomendación concreta, puedes hacerlo mediante el campo PredictRequest.params. De esta forma, se anula cualquier ajuste de reordenación a nivel de configuración que se aplicaría a esta recomendación.

Diversidad de recomendaciones

La diversificación de recomendaciones influye en si los resultados que devuelve una única solicitud de predicción proceden de distintas categorías de tu catálogo de productos.

La diversificación de recomendaciones se puede definir a nivel de configuración de servicio o por solicitud de predicción.

Cuando eliges un ajuste de diversificación de recomendaciones al crear una configuración de servicio en la consola de búsqueda de comercio, ese ajuste se aplica de forma predeterminada a todas las predicciones que se sirven con esa configuración, sin que tengas que hacer nada más.

Si necesitas controlar la diversidad de una recomendación concreta, puedes hacerlo con el campo PredictRequest.params. De esta forma, se anula cualquier ajuste de diversificación a nivel de configuración que se aplicaría a esta recomendación. Consulta los valores aceptados.

Usar filtros de recomendaciones

Puedes filtrar las recomendaciones devueltas por recomendaciones mediante el campo filter del método predict. Para obtener más información, consulta Filtrar recomendaciones.

Llamadas de predicción con modelos de optimización a nivel de página

Para proporcionar recomendaciones mediante la optimización a nivel de página, se necesita un paso adicional de llamada de predicción.

Haz una llamada de predicción inicial con una configuración de servicio que contenga el modelo de optimización a nivel de página. La respuesta de predicción devuelve una lista ordenada de IDs de configuración de publicación que representan el modelo que se debe usar en cada panel.

A continuación, haz una llamada de predicción para cada panel con el ID de configuración de servicio que el modelo de optimización a nivel de página haya recomendado. La respuesta de predicción contiene el nombre del modelo (por ejemplo, "Recomendado para ti") y la lista de elementos recomendados que se deben mostrar en ese panel.

El cambio de orden de los precios, la diversidad de las recomendaciones y los filtros de recomendaciones no están disponibles en las configuraciones de servicio que usan el modelo de optimización a nivel de página.

Monitorizar y solucionar problemas de las recomendaciones

Una vez que haya configurado su sitio web para recibir recomendaciones, le recomendamos que configure alertas. Consulta Configurar una alerta de errores de predicción.

Para solucionar errores, consulta Monitorizar y solucionar problemas.