Esta es la documentación solo de Recomendaciones IA. Para probar Retail Search y la consola unificada de venta minorista en la fase restringida de Google Analytics, comuníquese con el equipo de Ventas de Cloud. Si no planea usar Retail Search, permanezca en la consola de Recomendaciones hasta nuevo aviso.

Si usas la versión v1beta de Recomendaciones IA, migra a la versión minorista de la API.

Administrar la información del catálogo

En esta página, se describe cómo administrar la información de tu producto después de importar un catálogo a Recomendaciones IA. Puedes leer, escribir y borrar productos en tu catálogo.

Para mantener tu catálogo actualizado a medida que cambia la información del producto, importa el catálogo de la misma manera que la primera vez. Para obtener ayuda con la importación de tu catálogo, consulta Importa información del catálogo.

Sube un producto

curl

Crea un elemento de producto único con el método REST products.create.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
      "title": "product-title",
      "categories": "Shoes & Accessories > Shoes"
    }' \
    "https://retail.googleapis.com/v2/projects/[PROJECT_NUMBER]/locations/global/catalogs/default_catalog/branches/0/products?productID=[PRODUCT_ID]"

Si la solicitud se realiza correctamente, se muestra el objeto del producto, como en el siguiente ejemplo.

{
  "name": "projects/[PROJECT_NUMBER]/locations/global/catalogs/default_catalog/branches/0/products/[PRODUCT_ID]",
  "id": "[PRODUCT_ID]",
  "primaryProductId": "[PRODUCT_ID]",
  "type": "PRIMARY",
  "categories": [
    "Shoes & Accessories \u003e Shoes"
  ],
  "title": "product title",
  "availability": "IN_STOCK"
}

Actualiza la información de los productos

A medida que tu catálogo de productos cambia, puedes actualizarlo para subir cambios en productos como productos nuevos, precios y el estado de las acciones en tiempo real. Solo puedes subir productos que se hayan agregado o modificado. No es necesario volver a cargar todo el catálogo.

curl

Actualiza la información del producto mediante el método products.patch.

En el siguiente ejemplo, se actualiza el título de un producto específico:

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data "{
       "title": "new-title-value",
       "categories": "Shoes & Accessories > Shoes"
    }" \
    "https://retail.googleapis.com/v2/projects/[PROJECT_NUMBER]/locations/global/catalogs/default_catalog/branches/0/products/product-id?updateMask=title"

Si la solicitud se realiza correctamente, se muestra el objeto del producto, como en el siguiente ejemplo.

{
  "name": "projects/[PROJECT_NUMBER]/locations/global/catalogs/default_catalog/branches/0/products/[PRODUCT_ID]",
  "id": "[PRODUCT_ID]",
  "primaryProductId": "[PRODUCT_ID]",
  "type": "PRIMARY",
  "categories": [
    "Shoes & Accessories \u003e Shoes"
  ],
  "title": "new product title",
  "availability": "IN_STOCK"
}

Borra información del producto

Aunque Recomendaciones IA proporciona una forma de borrar productos de tu catálogo, ten en cuenta que, si registras un evento del usuario que se relaciona con un elemento de producto que se borró, Recomendaciones IA no puede procesar el evento del usuario correctamente y este podría borrarse. Además, incluir datos históricos de catálogos mejora la calidad de tu modelo y es fundamental para el rendimiento de la predicción.

Debes establecer el availability de los productos obsoletos en OUT_OF_STOCK en lugar de borrarlos.

curl

Para borrar un producto, usa el método delete y reemplaza [PRODUCT_ID] por el ID del elemento que deseas borrar.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    "https://retail.googleapis.com/v2/projects/[PROJECT_NUMBER]/locations/global/catalogs/default_catalog/branches/0/products/[PRODUCT_ID]"

Recupera un elemento de producto

curl

Para recuperar un elemento de producto, realiza una solicitud GET al extremo products y reemplaza [PRODUCT_ID] por el ID del producto que deseas recuperar:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)"  \
    "https://retail.googleapis.com/v2/projects/[PROJECT_NUMBER]/locations/global/catalogs/default_catalog/branches/0/products/[PRODUCT_ID]"

Debería ver un resultado similar al siguiente:

{
    "name": "projects/[PROJECT_NUMBER]/locations/global/catalogs/default_catalog/branches/0/products/[PRODUCT_ID]"
    "id": "[PRODUCT_ID]",
    "primaryProductId": "[PRODUCT_ID]",
    "type": "PRIMARY",
    "categories": [
      "Shoes & Accessories \u003e Shoes"
    ],
    "title": "product title",
    "availability": "IN_STOCK"
}

Visualiza la información agregada sobre tu catálogo

Puedes ver la información agregada sobre tu catálogo y obtener una vista previa de los elementos de producto subidos en la pestaña Catálogo en la página Datos de Recomendaciones IA.

Datos de importación de catálogos de Recomendaciones IA

Vuelve a unirte a eventos del catálogo

Puedes volver a unirte a eventos del catálogo mediante una solicitud POST al extremo userEvents:rejoin.

Debes tener la función de IAM de Administrador de IA de venta minorista.

curl

Configura userEventRejoinScope según los tipos de eventos a los que deseas volver a unirte:

  • USER_EVENT_REJOIN_SCOPE_UNSPECIFIED: Predeterminado. Activa la opción de volver a unirse para eventos a los que te uniste y a los que no.
  • JOINED_EVENTS: Activa la opción de volver a unirse solo para eventos a los que te uniste.
  • UNJOINED_EVENTS: Activa la opción de volver a unirse solo para eventos a los que no te uniste.

En el siguiente ejemplo, se activa la opción de volver a unirse solo para eventos a los que no te uniste:

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data "{
     'userEventRejoinScope': 'UNJOINED_EVENTS'
     }" \
    "https://retail.googleapis.com/v2/projects/[PROJECT_ID]/locations/global/catalogs/default_catalog/userEvents:rejoin"

Deberías recibir un objeto de respuesta similar al siguiente:

{
  "name": "projects/[PROJECT_ID]/locations/global/catalogs/default_catalog/operations/[OPERATION_ID]"
}

Puedes verificar el estado de la opción de volver a unirse. Reemplaza OPERATION_ID por el ID del ID de la operación que muestra el método para volver a unirse:

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://retail.googleapis.com/v2/projects/[PROJECT_ID]/locations/global/catalogs/default_catalog/operations/OPERATION_ID"

Cuando se completa la operación, el estado de la operación se muestra como done:

{
  "name": "projects/[PROJECT_ID]/locations/global/catalogs/default_catalog/operations/[OPERATION_ID]",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.retail.v2main.RejoinUserEventsResponse",
    "rejoinedUserEventsCount": "1"
  }
}

Cambia la configuración a nivel de producto

Cuando importes un catálogo, debes especificar si los elementos del catálogo son primarios o variantes. Si estos niveles de producto cambian o se especificaron de forma incorrecta, usa el siguiente procedimiento para corregir su configuración. Debes tener la función de IAM de Administrador de Recomendaciones IA.

  1. Asegúrate de que no se realicen importaciones mientras vuelves a configurar los niveles del catálogo. Esto garantiza que los datos no se suban en el nivel incorrecto.

  2. Si planeas cambiar los niveles de elementos del catálogo de eventos, borra definitivamente todos los eventos de usuario mediante el método de eliminación definitiva.

  3. Borra todos los elementos de productos. Consulta Cómo borrar elementos de productos. El catálogo debe estar completamente vacío antes de continuar con el siguiente paso.

  4. Cambia la configuración a nivel del producto:

    Este procedimiento depende de cómo importes. Sigue el procedimiento adecuado en Importa información del catálogo para establecer los niveles del catálogo en su configuración nueva.

  5. Termina de importar el catálogo nuevo con la configuración del nivel modificada mediante el procedimiento que elegiste en Importa información del catálogo.

  6. Ajusta todos los modelos existentes.

    Para ajustar un modelo, ve a la página Modelos, haz clic en el nombre del modelo para ver su página de detalles y, luego, en Ajuste manual en la barra de botones.

    Ir a la página Modelos de Recomendaciones IA

    Para ajustar los detalles de los costos, consulta Precios.