Qualidade das publicações

O recurso /health permite ao integrador mostrar a seus vendedores a qualidade de suas publicações, sabendo quais objetivos foram cumpridos e os que ainda estão pendentes, permitindo concluir todos os ajustes de cadastro e aumentando a qualidade da publicação melhorando assim a exposição do item e também a experiência de venda e compra.

Conteúdos

→Níveis de qualidade por site
→Detalhe de qualidade por item
→Ações necessárias para melhorar a qualidade de um item


Níveis de qualidade por site

O recurso /health_level permite identificar o range de pontuação necessário para cada nível de publicação por país.

Chamada:

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

Exemplo:

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

Resposta:

[
   {
       "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 da resposta

level: identificação do nível de qualidade em que se encontra a publicação: basic, standard e professional.
health_min e health_max: representam respectivamente os valores mínimos e máximos do range de pontuação utilizado para identificar o nível de qualidade em que a publicação está.


Detalhe de qualidade por item

Para conhecer o nível de qualidade de um item, disponibilizamos o recurso /health. Nele apresentaremos a porcentagem de qualidade do item e o nível em que se enquadra. O percentual de qualidade é calculado dividindo a quantidade objetivos cumpridos pela quantidade objetivos aplicáveis.

Chamada:

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

Exemplo:

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

Resposta:

{
    "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 da resposta

id: identificador do objetivo.
name: nome descritivo.
apply: indica se o objetivo é aplicável para o item.
completed: mostra a data na qual o objetivo foi cumprido. Caso ele ainda não tenha sido cuprido ou não seja aplicável, esse campo será oculto.
progress_max: número inteiro que indica o maior valor de progresso possível para esse objetivo.
progress: número inteiro que indica o valor atual do progresso no objetivo. Quando ele for igual ao progress_max, significa que o objetivo foi cumprido.
health: representa o percentagem de qualidade do item.


Ações necessárias para melhorar a qualidade de um item

Após identificar o nível de qualidade do item, em casos aplicáveis, é possível verificar quais são os objetivos que o vendedor ainda tem pendentes e pode ajustar para melhorar a qualidade da publicação e ganhar mais exposição.

Chamada:

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

Exemplo:

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

Resposta:

{
   "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 a ação de ID "classic" tem nome "installments_free".
- Para MLV, MPE y MLU a ação de ID "premium" tem nome "installments_free".

Descritivo das ações

Em actions você encontrará todas as ações que ajudarão a melhorar a qualidade da publicação. Listamos todas as possíveis e indicamos os recursos que devem ser verificados para fazer os ajustes:

technical_specification: verificar a qualidade dos atributos e completar ficha técnica.
buybox: publicar em catálogo.
variations: utilizar variações para a publicação.
product_identifiers: informar código universal do produto.
picture: verifique qualidade das imagens.
price: publicar com preço mais competitivo, caso seja aplicável, vamos indicar o range de preço que pode ser utilizado.
me2: utilizar Mercado Envios na publicação.
free_shipping: oferecer frete grátis.
flex: utilizar Mercado Envios Flex.
immediate_payment: utilizar Mercado Pago (tag immediate_payment).
classic: publicar um anúncio com exposição clássico.
premium (installments_free): publicar anúncio como premium.
size_chart: informar a tabela de medidas.
publish: objetivo referente a publicação do item, concluído automaticamente ao publicar.

ou registre-se para receber as últimas notícias sobre nossa API