Calidad de publicaciones

El recurso /health te permite mostrarle a los usuarios (vendedores) la calidad de las publicaciones, sabiendo qué acciones están cumplidas y las pendientes. De esta manera, pueden alcanzar los objetivos de publicación y aumentar la calidad de las publicaciones, mejorando la exposición del ítem y también la experiencia de venta y compra.

Contenidos

→Niveles de calidad por sitio
→Detalle de calidad por ítem
→Acciones necesarias para mejorar la calidad de un ítem


Niveles de calidad por sitio

El recurso /health_level te permite identificar el rango de puntuación necesario para cada nivel de publicación por país.

Llamada:

curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/health_levels

Ejemplo:

curl -X GET https://api.mercadolibre.com/sites/MLB/health_levels

Respuesta:

[
   {
       "level": "basic",
       "health_min": 0,
       "health_max": 0.69
   },
   {
       "level": "standard",
       "health_min": 0.7,
       "health_max": 0.98
   },
   {
       "level": "professional",
       "health_min": 0.99,
       "health_max": 1
   }
]

Campos de la respuesta

level: identificación del nivel de calidad en que se encuentra la publicación: basic, standard y professional.
health_min e health_max: representan respectivamente los valores mínimos y máximos del rango de puntuación utilizado para identificar el nivel de calidad en el que la publicación esté.


Detalle de la calidad por ítem

Para conocer el nivel de calidad de un ítem, dispones del recurso /health. En este, puedes ver el porcentaje de calidad del ítem, el cual es calculado dividiendo la cantidad de objetivos cumplidos por la calidad de objetivos aplicables. Y además, conoces el nivel en el que se encuadra.

Llamada:

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/health?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET https://api.mercadolibre.com/items/MLM735814032/health?access_token=$ACCESS_TOKEN

Respuesta:

{
    "item_id": "MLM735814032",
    "health": 0.66,
    "level": "basic",
    "goals": [
        {
            "progress": 0,
            "progress_max": 0,
            "id": "buybox",
            "name": "buybox",
            "apply": false
        },
        {
            "progress": 3,
            "progress_max": 9,
            "id": "technical_specification",
            "name": "technical_specification",
            "apply": true
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "variations",
            "name": "variations",
            "apply": false
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "product_identifiers",
            "name": "product_identifiers",
            "apply": true
        },
        {
            "progress": 1,
            "progress_max": 1,
            "id": "picture",
            "name": "picture",
            "apply": true,
            "completed": "2019-11-28T09:34:05.437Z"
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "price",
            "name": "price",
            "apply": false
        },
        {
            "progress": 1,
            "progress_max": 1,
            "id": "me2",
            "name": "me2",
            "apply": true,
            "completed": "2019-11-28T09:34:05.416Z"
        },
        {
            "progress": 1,
            "progress_max": 1,
            "id": "free_shipping",
            "name": "free_shipping",
            "apply": true,
            "completed": "2019-11-28T09:34:05.416Z"
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "flex",
            "name": "flex",
            "apply": false
        },
        {
            "progress": 1,
            "progress_max": 1,
            "id": "immediate_payment",
            "name": "immediate_payment",
            "apply": true,
            "completed": "2019-11-28T09:34:05.288Z"
        },
        {
            "progress": 1,
            "progress_max": 1,
            "id": "classic",
            "name": "classic",
            "apply": true,
            "completed": "2019-11-28T09:34:05.289Z",
            "data": {
                "listing_type": "clásica"
            }
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "premium",
            "name": "installments_free",
            "apply": true,
            "data": {
                "listing_type": "premium"
            }
        },
        {
            "progress": 1,
            "progress_max": 1,
            "id": "publish",
            "name": "publish",
            "apply": true,
            "completed": "2019-11-28T09:34:05.288Z"
        },
        {
            "progress": 0,
            "progress_max": 1,
            "id": "size_chart",
            "name": "size_chart",
            "apply": false
        }
    ]
}

Campos de la respuesta

id: identificador del objetivo.
name: nombre descriptivo.
apply: indica si el objetivo es aplicable para el ítem.
completed: muestra la fecha en la cual el objetivo fue cumplido. En caso de que este aún no haya sido cumplido o no aplique, este campo estará oculto.
progress_max: es el número que indica el mayor valor de progreso posible para ese objetivo.
progress: es el número que indica el valor actual del progreso en el objetivo. Cuando fuera igual al valor progress_max, significa que el objetivo fue alcanzado.
health: representa el porcentaje de calidad del ítem.


Acciones necesarias para mejorar la calidad de un ítem

Luego de identificar el nivel de calidad del ítem, en casos aplicables, es posible verificar cuáles son los objetivos que el vendedor aún tiene pendientes y puede ajustar para mejorar la calidad de publicación de la publicación y ganar más exposición.

Llamada:

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/health/actions?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET https://api.mercadolibre.com/items/MLM735814032/health/actions?access_token=$ACCESS_TOKEN

Respuesta:

{
   "item_id": "MLM735814032",
   "health": 0.66,
   "actions": [
       {
           "id": "technical_specification",
           "name": "technical_specification"
       },
       {
           "id": "product_identifiers",
           "name": "product_identifiers"
       },
       {
           "id": "premium",
           "name": "installments_free"
       }
   ]
}
Notas:
- Para MLU, la acción del ID "classic" es "installments_free".
- Para MLV, MPE y MLU, la acción del ID "premium" es "installments_free".

Descripción de las acciones

En actions puedes encontrar todas las acciones que te ayudarán a mejorar la calidad de la publicación. A continuación, puedes conocer todas las acciones posibles y los recursos que deberían ser verificados para realizar las mejoras:

technical_specification: verifica la calidad de los atributos y completa la ficha técnica.
buybox: publica en catálogo.
variations: utiliza variaciones para la publicación.
product_identifiers: informar código universal del producto.
picture: verifica la calidad de las imágenes.
price: publica con precio más competitivo, y en caso de que aplique, te vamos a indica el rango de precio que puedes utilizar.
me2: utiliza Mercado Envíos en las publicaciones.
free_shipping: ofrece envíos gratis.
flex: utiliza Mercado Envíos Flex.
immediate_payment: utiliza Mercado Pago (tag immediate_payment).
classic: realiza una publicación con exposición al menos clásica.
premium (installments_free): Realiza una publicación como premium.
size_chart: informa una guía de talles.
publish: es el objetivo relacionado a la publicación del ítem, realizado automáticamente al publicar.

o regístrate para recibir las últimas novedades sobre nuestra API