Product Ads – Mercado Libre Publicidad

Es una herramienta que te permite crear campañas de publicidad para ayudarte a promocionar tus publicaciones en Mercado Libre con el fin de obtener más visitas y ventas. Si eres un vendedor nuevo o estás lanzando un nuevo producto vas a poder obtener tus primeras ventas más rápido. Si eres un vendedor experimentado, lograrás potenciar el rendimiento en tus publicaciones, incrementando tus ventas.

Conoce más en https://publicidad.mercadolibre.com.ar/productAds

Contenidos

Planes

Si deseas comenzar a trabajar con Product Ads en Mercado Libre, lo primero que deberás conocer para luego armar tus propias campañas, son los planes disponibles en tu país. Cada plan determinará cuál será tu inversión máxima en publicidad. A más alto el plan, tendrás mayor cantidad de visitas pero pagarás un CPC (costo por click) menor, llegando así a más compradores.
Para saber qué planes están disponibles en tu sitio:

curl -X GET https://api.mercadolibre.com/advertising/product_ads/plans?site_id=$site_id

Ejemplo:

curl -X GET https://api.mercadolibre.com/advertising/product_ads/plans?site_id=MLA
 
[
 {
   "id": 108,
   "site_id": "MLA",
   "name": "Avanzado",
   "daily_budget": 340
 }
]

El campo daily_budget es el que define cuál es el presupuesto fijo máximo que el vendedor va a pagar por día. Los diferentes planes consisten en la variación de este monto. Está expresado en la moneda local de cada sitio.

También, en caso de necesidad, se puede consultar el plan con su ID correspondiente.

curl -X GET https://api.mercadolibre.com/advertising/product_ads/plans/$plan_id

Ejemplo:

curl -X GET https://api.mercadolibre.com/advertising/product_ads/plans/108


{
   "id": 108,
   "site_id": "MLA",
   "name": "Avanzado",
   "daily_budget": 340
 }

Campañas

Todos tus anuncios van a estar agrupados dentro de campañas. Cada una tendrá un plan asociado, cuyo presupuesto será repartido entre todos los anuncios que estén dentro de ella.
Podrás crear todas las campañas que quieras.

Crear una campaña

Lo primero que se debe hacer es dar de alta una campaña para un usuario. Pueden crearse dos tipos de campaña:



DEFAULT: Siempre es la primera que se crea. No se le puede asignar un nombre ni tampoco crear más de una campaña de este tipo. Para los sitios hispanos, el nombre será “Campaña General”. En MLB cambia a “Campanha Geral”.

curl -X POST https://api.mercadolibre.com/advertising/product_ads/campaigns?access_token=$access_token
 
{
   "plan_id": 109,
   "sync_new_listings": "enabled|disabled", 
   "group_id": "ML|OS_1234,
   "status": "active|paused"
}

Parámetros

  • plan_id: único campo requerido para que el POST sea exitoso.
  • sync_new_listings:el valor por defecto es “enabled”. Así, cada vez que el usuario cree una publicación, esta se convertirá en un Product Ad de manera automática. Si se crea como disabled, se deberá sumar cada ítem manualmente.
  • group_id: Este campo define el inventario que se toma para saber qué publicaciones del usuario se deben tener en cuenta para publicitar. Los valores representan a Mercado Libre y la Tienda Oficial con su ID correspondiente.
  • status: por defecto la campaña se crea activa.

Cuando una campaña se queda sin publicaciones activas pasa automáticamente a estado “hold”. En este estado no consume presupuesto. La particularidad es que un usuario no puede cambiar el estado. El sistema pone automáticamente este estado cuando se finalizaron todas las publicaciones que estaban dentro de la campaña. Este estado es definitivo? No. Cuando agregues una nueva publicación la misma pasará a estado paused. Para activarla, se deberá hacer manualmente un PUT con status active.


CUSTOM: Son campañas que buscan enfocarse en determinados productos de manera más específica, sobre todo cuando se cuenta con un catálogo amplio, buscando optimizar la inversión. Crear varias campañas custom permite aumentar el presupuesto diario.
Las campañas custom cuentan con un nombre propio que las identifica. La sincronización está desactivada, ya que será necesario indicar que anuncios forman parte de este tipo de campañas.

 curl -X POST https://api.mercadolibre.com/advertising/product_ads/campaigns?access_token=token
 
{
"plan_id": 109,
“name”: “example_campaign”,   
"group_id": "ML|OS_1234, 
"status": "active|paused"
}

Respuesta

{
       "id": 29412881,
       "name": "aName",
       "user_id": 38957177,
       "plan_id": 109,
       "type": "default|custom",
       "sync_new_listings": "enabled|disabled",
       "group_id": "ML|OS_1234,
       "status": "active|paused",
       "date_created": "2017-01-10T18:23:55-04:00",
       "last_updated": "2017-01-10T18:23:55-04:00"
   }

Restricciones para que un usuario pueda crear campañas

  • En caso que el usuario no tenga ítems publicados, no podrá crear campañas.
  • El usuario tiene reputación red u orange en el sitio. No hay forma de revertir la situación, salvo que mejore el semáforo del usuario.
  • Cuando es un usuario nuevo sin experiencia dentro del sitio. En los sitios dónde Mercado Pago está activo se le solicitará al usuario que realice un cargo mínimo por única vez. Este cargo será reintegrado con la factura.
  • Existe documentación pendiente. Se le expone un link al usuario para que la complete. Aplica en MLB, MLV y MCO.

Modificar una campaña

Cuando una campaña es default, se pueden modificar los campos:

  • plan_id
  • status
  • sync_new_listings

Cuando una campaña es custom, se pueden modificar los campos:

  • plan_id
  • status
  • name

Ejemplo:

curl -X PUT https://api.mercadolibre.com/advertising/product_ads/campaigns/$camp_id?access_token=token
 
{
   “plan_id”: 108,
  "status": "active|paused",
}

Consultar una campaña

curl -X GET https://api.mercadolibre.com/advertising/product_ads/campaigns/camp_id?access_token=token
 
{
       "id": 29412881,
       "name": "aName",
       "user_id": 38957177,
       "plan_id": 109,
       "type": "default|custom",
       "sync_new_listings": "enabled|disabled",
       "group_id": "ML|OS_1234,
       "status": "active|paused|hold",
       "date_created": "2017-01-10T18:23:55-04:00",
       "last_updated": "2017-01-10T18:23:55-04:00"
   }

Búsqueda de campañas por usuario

curl -X GET https://api.mercadolibre.com/advertising/product_ads/campaigns/search?user_id=1&offset=0&limit=10&access_token=token
 
{
 
   "paging": {
       "total":1,
       "offset":1,
       "limit":10
   }

   "results": [
       {
           "id": 29412881,
           "name": "aName",
           "user_id": 38957177,
           "plan_id": 109,
           "sync_new_listings": "enabled|disabled",
           "group_id": "ML|OS_1234,
           "status": "active|paused",
           "type": "custom",
           "date_created": "2017-01-10T18:23:55-04:00",
           "last_updated": "2017-01-10T18:23:55-04:00"
       }
   ],

}

Métricas de campaña

Se pueden consultar métricas de una campaña con un rango de fechas que no supere los 90 días.

Ejemplo:

curl -X GET https://api.mercadolibre.com/advertising/product_ads/campaigns/id_campaign/metrics?date_from=2017-01-01&date_to=2017-02-01&access_token=$token

Los parámetros date_from y date_to son obligatorios.

Respuesta:

{
 "impressions": 3,
 "clicks": 2,
 "ctr": 0.66, //ratio, es un porcentaje entre las impresiones y los clicks.
 "cost": 3 //costo total de clicks del período en moneda local. 
}

Parámetros

  • impressions: cantidad de impresiones en el sitio que tuve el Product Ad.
  • clicks: cantidad de clicks que recibió el Product Ad.
  • ctr: es el porcentaje entre las impresiones y los clicks.
  • cost: es el costo total de clicks del período en moneda local.

Product Ads

Consultar un Product Ad asociado a un ítem del usuario

curl -X GET https://api.mercadolibre.com/advertising/product_ads/ads/item_id?access_token=$access_token
 
{
   "id": "MLA657316800",
   "campaign_id": 141072850,
   "user_id": 246460082,
   "site_id": "MLA",
   "cpc": 1.73,
   "status": "active",
   "title": "Item de Testeo",
   "price": 200,
   "currency_id": "ARS",
   "permalink": "http://articulo.mercadolibre.com.ar/MLA-657316800-item-de-testeo_JM"
   "thumbnail": "http://mla-s2-p.mlstatic.com/471325-MLA25424154856_032017-I.jpg",
   "picture_id": "471325-MLA25424154856_032017",
   "date_created": "2017-03-10T02:27:32.325+0000",
   "last_updated": "2017-03-10T02:27:32.325+0000"
}

Cambiar el Product Ad de campaña

Un Product Ad nunca convive en dos campañas a la vez. Es decir que en caso de que el usuario tenga una campaña default y una custom, para que el ítem forme parte de la segunda deberá abandonar la primera. Es posible también que una vez en la custom se decida reenviarlo a la default y ahí vuelve a su lugar de origen.

En una primera instancia, siempre pertenece a la campaña default. Cuando se envía a una campaña custom, siempre queda con status = active, pudiendo luego ser pausado.

Cuando un Product Ad es movido de una campaña a otra, las métricas del mismo se asocian a la nueva campaña. Por ejemplo, si un Product Ad tuvo 10 visitas en la campaña default y es movido a una custom, inciará con cero visitas. No obstante, esas métricas no se pierden. Si el Product Ad vuelve a la campaña original, sigue conservando las métricas que poseía antes de ser movido.

Asignar un Product Ad a una campaña

curl -X PUT https://api.mercadolibre.com/advertising/product_ads/ads/$item_id
 
{
 "campaign_id": 22222222
}

Cambiar el status de un Product Ad en una campaña

curl -X PUT https://api.mercadolibre.com/advertising/product_ads/ads/$item_id?access_token=token
 
{
 "status": "paused" | “active” 
}

Búsqueda de Product Ads por usuario

curl -X GET https://api.mercadolibre.com/advertising/product_ads/ads/search?user_id=$user_id&status=$status&offset=$offset&limit=$limit&campaigns=$campaign_id,$campaign_id&title=$title&access_token=$access_token

Parámetros

  • user_id: requerido.
  • status: opcional, es el status de los Product Ads.
  • title: opcional, son palabras incluidas en el título del Product Ad.
  • campaigns: opcional, funciona como un multiget que recibe varios IDs separados por coma.
  • offset y limit: opcionales. El limit no podrá ser mayor a 100.

Métricas de Product Ads

Se puede consultar en un mismo request, implementando multiget, hasta 50 Product Ads También se deberá enviar un rango de fechas que no supere los 90 días.

Ejemplo:

curl -X GET https://api.mercadolibre.com/advertising/product_ads/campaigns/$campaign_id/ads/metrics?ids=MLA12345678,MLA12344321,MLA87654321&date_from=2017-01-01&date_to=2017-02-01&access_token=$access_token
 
[
   {
       "item_id":MLA12345678,
       "clicks": 2,
       "impressions": 3,
       "ctr": 0.6666,
       "cost": 3.0
   }
  {
       "item_id":MLA12344321,
       "clicks": 2,
       "impressions": 3,
       "ctr": 0.6666,
       "cost": 3.0
   }

]

Grupos

Todas las campañas están asociadas a un grupo. Esta agrupación permite entender si la campaña está compuesta por ítems de Mercado Libre o de Tiendas Oficiales.

Las convenciones que se utilizan para definir los grupos son las siguientes:

  • ML: Mercado Libre
  • OS_: Tienda Oficial

Obtener un Grupo particular de un usuario

curl -X GET https://api.mercadolibre.com/advertising/product_ads/groups/$group_id?access_token=$access_token
 
{
	"id": "ML",
	"name": "Mercado Libre",
	"campaigns": {
		"active": 4,
		"paused": 3,
		"hold": 3
	}
}

Parámetros

  • id: Identifica el tipo de grupo.
  • name: Representa el nombre del grupo.
  • campaigns: Contiene la cantidad de campañas en los distintos estados. Eston son active, paused y hold.

Obtener todos los Grupos de un usuario

curl -X GET https://api.mercadolibre.com/advertising/product_ads/groups?access_token=$access_token
  
[
	{
		"id": "ML",
		"name": "Mercado Libre",
		"campaigns": {
			"active": 1,
			"paused": 2,
			"hold": 3
		}
	},
	{
		
		"id": "OS_456",
		"name": "Official Store",
		"campaigns": {
			"active": 1,
			"paused": 0,
			"hold": 3
		}
	}
	]

Please rate this