Tutorial de tipos de publicación y obtener mayor exposición

De acuerdo con el nivel de exposición que desees para tus artículos, podrás elegir entre diferentes tipos de publicación. Cada tipo de publicación tiene sus propias características y feeds. Veamos cómo trabajar correctamente con ellos.

Contenidos:

Tipos de publicación por site

En primer lugar, debes saber que cada site tiene sus propios tipos de publicación. Para ver todos los tipos de publicación disponibles en un site, debes realizar una solicitud GET a los recursos listing_types con el Site_id:

Ejemplo:

https://api.mercadolibre.com/sites/MLC/listing_types

Respuesta:

[
  {
    "site_id": "MLC",
    "id": "gold_pro",
    "name": "Premium"
  },
  {
    "site_id": "MLC",
    "id": "gold_premium",
    "name": "Oro Premium"
  },
  {
    "site_id": "MLC",
    "id": "gold_special",
    "name": "Clásica"
  },
  {
    "site_id": "MLC",
    "id": "gold",
    "name": "Oro"
  },
  {
    "site_id": "MLC",
    "id": "silver",
    "name": "Plata"
  },
  {
    "site_id": "MLC",
    "id": "bronze",
    "name": "Bronce"
  },
  {
    "site_id": "MLC",
    "id": "free",
    "name": "Gratuita"
  }
]

En algunos sites los tipos de publicación sufrieron cambios, para saber cuáles son te sugerimos que revises la siguiente noticia.

No obstante, en la API se siguen listando los combos históricos que se mapean automáticamente para que no obtengas errores en tu integración.
Sugerimos publicar de la siguiente forma:

MLA, MLB, MLC, MLM, MCO

gold_pro: Premium
gold_special: Clasica
free: Gratuita

MPE, MLV, MLU

gold_special: Premium
bronze: Clasica
free: Gratuita
Notas:

  • En resto de los sites se pueden utilizar cualquiera de los listings listados en la API.

Especificación del tipo de publicación

Si deseas más información sobre un listing_type específico, incluye el listing_type en la llamada GET:
Ejemplo:

https://api.mercadolibre.com/sites/MLA/listing_types/bronze

Respuesta:

{
  "id": "bronze",
  "not_available_in_categories": [
    "MLA1743",
    "MLA1459"
  ],
  "configuration": {
    "name": "Bronce",
    "listing_exposure": "low",
    "requires_picture": false,
    "max_stock_per_item": 9999,
    "deduction_profile_id": null,
    "differential_pricing_id": null,
    "duration_days": {
      "buy_it_now": 60,
      "auction": 7,
      "classified": null
    },
    "immediate_payment": {
      "buy_it_now": false,
      "auction": false,
      "classified": false
    },
    "mercado_pago": "mandatory",
    "listing_fee_criteria": {
      "min_fee_amount": 0,
      "max_fee_amount": 0,
      "percentage_of_fee_amount": 0,
      "currency": "ARS"
    },
    "sale_fee_criteria": {
      "min_fee_amount": 0,
      "max_fee_amount": 100000000000000000,
      "percentage_of_fee_amount": 11,
      "currency": "ARS"
    }
  },
  "exceptions_by_category": [
    {
      "category_id": "MLA1540",
      "category_name": "Servicios",
      "configuration": {
        "name": "Básico 90",
        "listing_exposure": "mid",
        "requires_picture": false,
        "max_stock_per_item": 999,
        "deduction_profile_id": null,
        "differential_pricing_id": null,
        "duration_days": {
          "buy_it_now": null,
          "auction": null,
          "classified": 90
        },
        "immediate_payment": {
          "buy_it_now": false,
          "auction": false,
          "classified": false
        },
        "mercado_pago": "not_available",
        "listing_fee_criteria": {
          "min_fee_amount": 347,
          "max_fee_amount": 347,
          "percentage_of_fee_amount": 0,
          "currency": "ARS"
        },
        "sale_fee_criteria": {
          "min_fee_amount": 0,
          "max_fee_amount": 0,
          "percentage_of_fee_amount": 0,
          "currency": null
        }
      },
      "exceptions_by_category": [
      ]
    }
  ]
}



Los artículos Clásica y Premium tendrán una duración ilimitada; puedes consultarlo en el campo stop_time:

curl -X GET https://api.mercadolibre.com/items/MCO415406202?attributes=stop_time

Además, se pausarán estas publicaciones si el stock está en 0 y se activarán cuando agregues una nueva cantidad. Verás el artículo de la siguiente manera:

"status": "paused",
  "sub_status": [
    "out_of_stock"
  ]

Si deseas agregar stock y activar nuevamente el artículo, deberías hacer lo siguiente:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "available_quantity": 1
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Recuerda que el tipo de publicación Gratuita mantendrá el flujo actual.

El vendedor podría cambiar entre los tipos de publicación Clásica y Premium cada vez que lo desee sin cargo alguno, y podría poner los artículos en pausa y terminar de la misma manera en que funciona ahora.

Si deseas cambiar de Premium a Clásica, deberás seguir estos pasos:

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "id": "gold"
}
https://api.mercadolibre.com/items/{Item_id}/listing_type?access_token=$ACCESS_TOKEN

Tipos de publicación disponibles

Puedes consultar los tipos de publicación disponibles por usuario y para un category_id determinado.

Ejemplo:

https://api.mercadolibre.com/users/{Cust_id}/available_listing_types?category_id={Category_id}&access_token=$ACCESS_TOKEN

Respuesta:

{
  "category_id": "MLC3530",
  "available": [
	{
  	"site_id": "MLC",
  	"id": "gold_premium",
  	"name": "Oro Premium",
  	"remaining_listings": null
	},
	{
  	"site_id": "MLC",
  	"id": "gold",
  	"name": "Oro",
  	"remaining_listings": null
	},
	{
  	"site_id": "MLC",
  	"id": "silver",
  	"name": "Plata",
  	"remaining_listings": null
	},
	{
  	"site_id": "MLC",
  	"id": "bronze",
  	"name": "Bronce",
  	"remaining_listings": null
	},
	{
  	"site_id": "MLC",
  	"id": "free",
  	"name": "Gratuita",
  	"remaining_listings": null
	}
  ]
}

Si no puedes publicar en cierto tipo de publicación y quieres saber por qué no está disponible para ti, puedes realizar esta llamada GET para averiguar el motivo:

Ejemplo:

https://api.mercadolibre.com/users/{Cust_id}/available_listing_type/free?category_id={Category_id}&access_token=$ACCESS_TOKEN

Respuesta:

{
  "available": false,
  "cause": "You have more than 5 transactions in the last year.",
  "code": "list.transactions.exceeded"
}

Nota:

  • Los upgrades sólo están disponibles en MLB, para el resto de los sites deberás finalizar la publicación y republicar con el listing type deseado.

Exposiciones de las publicaciones

Esta API devuelve información sobre los niveles de exposición asociados a todos los tipos de publicaciones en MercadoLibre.
Puedes consultar todas las exposiciones disponibles para las publicaciones por site, con una simple llamada GET.

Ejemplo:

https://api.mercadolibre.com/sites/MLA/listing_exposures

Respuesta:

{[
  {
	"id": "lowest",
	"name": "Última",
	"home_page": false,
	"category_home_page": false,
    "advertising_on_listing_page": true,
	"priority_in_search": 4
  },
  {
	"id": "low",
	"name": "Inferior",
	"home_page": false,
	"category_home_page": false,
    "advertising_on_listing_page": false,
	"priority_in_search": 3
  },
  {
	"id": "mid",
	"name": "Media",
	"home_page": false,
	"category_home_page": true,
	"advertising_on_listing_page": false,
	"priority_in_search": 2
  },
  {
	"id": "high",
	"name": "Alta",
	"home_page": false,
	"category_home_page": true,
    "advertising_on_listing_page": false,
	"priority_in_search": 1
  },
  {
	"id": "highest",
	"name": "Superior",
	"home_page": true,
	"category_home_page": true,
    "advertising_on_listing_page": false,
	"priority_in_search": 0
  }
]

Y consultar cada una por su ID:

Ejemplo:

https://api.mercadolibre.com/sites/MLA/listing_exposures/high

Respuesta:

{
  "id": "high",
  "name": "Alta",
  "home_page": false,
  "category_home_page": true,
  "advertising_on_listing_page": false,
  "priority_in_search": 1
}

Actualizaciones disponibles

Puedes realizar una actualización a un tipo de publicación superior una vez.
Si necesitas realizar una actualización, puedes ver qué tipos de publicación están disponibles para tu artículo.

Ejemplo:

https://api.mercadolibre.com/items/{Item_id}/available_upgrades?access_token=$ACCESS_TOKEN

Respuesta:

[
  {
	"site_id": "MLC",
	"id": "gold_premium",
	"name": "Oro Premium"
  },
  {
	"site_id": "MLC",
	"id": "gold",
	"name": "Oro"
  },
  {
	"site_id": "MLC",
	"id": "silver",
	"name": "Plata"
  }
]

¡Eso es! Ahora estás listo para acceder a la exposición correcta para tus productos y realizar actualizaciones de artículos.

Como sabemos que a veces necesitas más de un intento para realizar tu publicación, te ofrecemos la posibilidad de consultar si tu publicación quedó exactamente cómo la querías antes de publicarla. Por favor lee este artículo para más información sobre el validador de publicaciones.

Bajar un artículo a un tipo de publicación inferior (downgrades)

Downgrade es reducir la exposición de tu artículo al actualizarlo en un tipo de publicación inferior. Está disponible para algunos casos particulares:

  • En MLB (Brasil) está permitido realizar downgrades en las publicaciones entre gold_pro a gold_special y viceversa en cualquier momento.
  • Antes de que comiencen, se pueden realizar downgrades para las publicaciones en payment_required.
  • No está permitido realizar el downgrade de una publicación a gratis.

Please rate this