Qualidade das Publicações

Níveis de Qualidade por País

Como primeiro passo, vamos revisar os níveis de qualidade por site, utilizando o recurso /health_levels, que permite identificar a faixa de pontuação necessária para cada nível de publicação.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/sites/$SITE_ID/health_levels

Parâmetros da solicitação

Resposta:

[
  {
    "level": "basic",
    "health_min": 0,
    "health_max": 0.49
  },
  {
    "level": "standard",
    "health_min": 0.5,
    "health_max": 0.65
  },
  {
    "level": "professional",
    "health_min": 0.66,
    "health_max": 1
  }
]

Campos da resposta

Níveis de Qualidade por Item

Sabendo os intervalos de qualidade por nível para um país específico, o recurso /health permite identificar o nível de qualidade de uma publicação. Além disso, esse recurso mostra o percentual de qualidade do item, calculado como a divisão entre o número de objetivos cumpridos e o número total de objetivos aplicáveis.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/items/$ITEM_ID/health

Parâmetros da solicitação

Resposta:

{
  "item_id": "MLA123456",
  "health": 0.25,
  "level": "basic",
  "goals": [
    {
      "progress": 0,
      "progress_max": 1,
      "id": "picture",
      "name": "picture",
      "apply": true,
      "data": {
        "min": 12
      }
    },
    ...
  ]
}

Campos da resposta

Analisando os resultados, observa-se que, para a publicação do item consultado, por exemplo, no primeiro objetivo picture, o progresso é 0 de 1. Esse parâmetro, aplicável ao item, requer um mínimo de 12 imagens na publicação para melhorar o percentual de qualidade. A seguir, veremos mais sobre essas ações.

Ações para melhorar a qualidade de uma publicação

Como mencionado anteriormente, após identificar o nível de qualidade do item, é possível verificar quais são os objetivos pendentes que o vendedor ainda pode ajustar para aprimorar a qualidade da publicação e aumentar sua exposição.

Para conhecer as ações que podem ser aplicadas, execute o seguinte comando com o ID do item e seu token correspondente.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/items/$ITEM_ID/health/actions

Você receberá uma resposta apresentando a pontuação atual de qualidade da sua publicação e os elementos que podem ser melhorados.

Exemplo de resposta:

{
  "item_id": "MLA123456",
  "health": 0.25,
  "actions": [
    { "id": "picture", "name": "picture" },
    { "id": "technical_specification", "name": "technical_specification" },
    { "id": "video", "name": "video" }
  ]
}

Campos da resposta

Com base nesta resposta e na anterior, é possível implementar ações mais específicas em determinados campos. Isso permitirá otimizar a qualidade das publicações e maximizar seu potencial para alcançar maior visibilidade.

Para alguns atributos e categorias específicas, são apresentadas recomendações e guias que você pode utilizar como apoio para melhorar a qualidade das publicações.

1. Imagens (Pictures)

A qualidade de uma publicação é diretamente afetada pelo número mínimo de imagens. Existem três grupos com requisitos diferentes, dependendo do tipo de imóvel:

• Grupo 1: Para Casas, Apartamentos, Escritórios ou Terrenos, é exigido um mínimo de 12 fotos ou imagens.
• Grupo 2: No caso de Lojas, Áreas Rurais, Galpões e Lotes, o mínimo é de 6 fotos ou imagens.
• Grupo 3: Para Estacionamentos, o mínimo estabelecido é de 4 fotos ou imagens.

2. Atributos técnicos

Certifique-se de preencher todos os atributos obrigatórios e relevantes da sua publicação, a fim de expor todas as características importantes e atrativas do imóvel. Consulte mais informações no guia de atributos para imóveis ou no guia de atributos gerais.

3. Vídeo

Para enriquecer sua publicação, considere adicionar um vídeo ou tour virtual da propriedade, usando o campo video_id. Esse campo requer uma string composta pelo identificador do recurso multimídia e o identificador do provedor da mídia.

Formato do campo video_id

• video_id = id_do_recurso_multimidia;id_do_provedor_multimidia

São aceitos dois tipos de recursos multimídia:

• YouTube (somente vídeos): O parâmetro deve seguir este formato: video_id:"gqkEN9poKM;youtube".
• Matterport (somente tours virtuais): O parâmetro deve seguir este formato: video_id:"gqkEN9poKM;matterport".

4. Publicações de venda e aluguel

• Imóveis à venda: É necessário cumprir todos os objetivos para alcançar 100% de qualidade. Embora não seja obrigatório cumprir todos (como incluir vídeo), esses elementos adicionais ajudam a melhorar a avaliação geral.
• Imóveis para aluguel: É exigido o cumprimento de menos objetivos para atingir 100% de qualidade, devendo ser avaliado com os recursos mostrados anteriormente.

Leituras recomendadas

• Atualize seu imóvel.

Atualizações de versão

Esta seção fornece informações sobre as atualizações da API, incluindo:

Histórico de alterações