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. A través de publicidad lograrás potenciar el rendimiento en tus publicaciones, incrementando tus ventas. Conoce más cómo aumentar tus ventas con Products Ads.

Contenidos

→Límites de presupuesto
→Campañas
→Crear una campaña
→Parámetros
→Restricciones para que un usuario pueda crear campañas
→Modificar una campaña
→Consultar una campaña
→Búsqueda de campañas por usuario
→Métricas de campaña
→Ventas directas y ventas asistidas
→Product Ads
→Consultar un Product Ad asociado a un ítem del usuario
→Cambiar el status de un Product Ad en una campaña
→Búsqueda de Product Ads por usuario


Límites de presupuesto

Si deseas comenzar a trabajar con Product Ads en Mercado Libre, lo primero que deberás conocer para luego armar tu propia campaña, son los límites de presupuesto para tu usuario. Cada usuario tiene asignado una inversión mínima y máxima en publicidad. Puedes elegir libremente tu inversión diaria dentro de este rango.

Para saber los límites de presupuesto de tu usuario:

curl -X GET https://api.mercadolibre.com/advertising/product_ads_2/budgets/limits?campaign_type=default&access_token=$access_token

Respuesta:

[
  {
    "campaign_type": "default",
    "minimum": 10,
    "maximum": 60
  }
]

Está expresado en la moneda local de cada sitio. Tu presupuesto deberá estar dentro de ese rango. Los valores de los límites son presupuestos válidos.

Los límites pueden cambiar a lo largo del tiempo para un usuario.


Campañas

Todos tus anuncios van a estar agrupados dentro de una campaña, cuyo presupuesto será repartido entre todos los anuncios que estén dentro de ella.


Crear una campaña

Lo primero que se debe hacer es dar de alta una campaña para un usuario.

curl -X POST https://api.mercadolibre.com/advertising/product_ads_2/campaigns?access_token=$access_token

BODY:

{
  "budget": 20,
  "status": "active"|"paused",
}

Parámetros

  • Budget: campo requerido, debe estar dentro de los límites de presupuesto de tu usuario.
  • Status: campo opcional, tiene valor "active" por defecto.

Respuesta:

{
    "id": 223493019,
    "name": "Campanha Principal",
    "user_id": 348252660,
    "type": "default",
    "status": "active",
    "budget": 225,
    "last_updated": "2018-08-23T18:31:11.897Z",
    "date_created": "2018-08-23T18:31:11.897Z"
}

Restricciones para que un usuario pueda crear campañas

Si 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

Se pueden modificar los campos:
status: budget

curl -X PUT https://api.mercadolibre.com/advertising/product_ads_2/campaigns/{campaign_id}?access_token={access_token}

BODY

{
"status": "active"|"paused",
"budget":225
}

Consultar una campaña

curl -X  GET 
https://api.mercadolibre.com/advertising/product_ads_2/campaigns/{campaign_id}?access_token={access_token}


{
    "id": 223493019,
    "name": "Campanha Principal",
    "user_id": 348252660,
    "type": "default",
    "status": "active",
    "budget": 225,
    "last_updated": "2018-08-23T18:56:33.000Z",
    "date_created": "2018-08-23T04:00:00.000Z"
}

Búsqueda de campañas por usuario

curl -X  GET 
https://api.mercadolibre.com/advertising/product_ads_2/campaigns/search?user_id={user_id}&access_token={access_token}


{  
   "paging":{  
      "total":1,
      "offset":0,
      "limit":10
   },
   "results":[  
      {  
         "id":223703005,
         "name":"Campanha Principal",
         "user_id":301254033,
         "type":"default",
         "status":"active",
         "budget":225.0,
         "last_updated":"2018-08-24T04:00:00.000Z",
         "date_created":"2018-08-24T04:00:00.000Z"
      }
   ]
}

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.

curl -X  GET https://api.mercadolibre.com/advertising/product_ads_2/campaigns/{campaign_id}/metrics?date_from={date_from}&date_to={date_to}&access_token={access_token}
  • date_from: campo requerido, con formato “aaaa-mm-dd”, ejemplo 2018-08-01
  • date_to: campo requerido, con formato “aaaa-mm-dd”, ejemplo 2018-08-10
  • campaign_id: campo requerido, id de la campaña

Respuesta:

{  
   "clicks":1590,
   "impressions":1929487,
   "ctr":0.08,
   "cost":700.19,
   "cpc":0.44,
   "sold_quantity_direct":38,
   "sold_quantity_indirect":13,
   "sold_quantity_total":51,
   "amount_direct":9775,
   "amount_indirect":6815,
   "amount_total":16590,
   "advertising_fee":4.22
}

Campos de la respuesta, refieren a las métricas de toda la campaña:

  • "impressions": cantidad de impresiones en el sitio que recibió la campaña.
  • "clicks": cantidad de clicks que recibió la campaña.
  • "ctr": click through rate, expresado en porcentaje, la división entre clicks e impressions.
  • "cost": es el costo total de clicks del período, en moneda local.
  • “cpc”: el costo promedio de cada click, en moneda local.
  • "sold_quantity_direct": cantidad de ventas directas.
  • "sold_quantity_indirect": cantidad de ventas asistidas.
  • "sold_quantity_total": cantidad de ventas en total.
  • "amount_direct": Suma del valor de las ventas directas obtenidas a través de tus Product Ads, en moneda local.
  • "amount_indirect": Suma del valor de las ventas asistidas obtenidas a través de tus Product Ads, en moneda local.
  • "amount_total": Suma del valor de las ventas obtenidas a través de tus Product Ads, en moneda local.
  • ""advertising_fee": expresado en porcentaje, la división entre inversión en publicidad sobre los ingresos obtenidos. cost / amount_total. Un valor más bajo implica un mejor rendimiento.

Ventas directas y ventas asistidas

Tienes una venta directa cuando un usuario hace clic en tu Product Ad y compra ese producto. En cambio, tienes una venta asistida cuando un usuario hace clic en tu Product Ad y compra otro de tus productos.


Product Ads

Métricas de un Product Ad 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.

curl -X GET https://api.mercadolibre.com/advertising/product_ads_2/campaigns/{campaign_id}/ads/metrics?date_from={date_from}&date_to={date_to}&ids={item_id_1},{item_id_2}&access_token={access_token}
  • date_from: campo requerido, con formato “aaaa-mm-dd”, ejemplo 2018-08-01.
  • date_to: campo requerido, con formato “aaaa-mm-dd”, ejemplo 2018-08-10.
  • campaign_id: campo requerido, id de la campaña.
  • ids: campo requerido, lista de hasta 50 item ids separados por coma, ejemplo MLA1234, MLA4321.

Respuesta:

[  
   {  
      "id":"MLA740084255",
      "clicks":73,
      "impressions":160930,
      "ctr":0.05,
      "cost":32.85,
      "cpc":0.45,
      "sold_quantity_direct":19,
      "sold_quantity_indirect":0,
      "sold_quantity_total":19,
      "amount_direct":3610,
      "amount_indirect":0,
      "amount_total":3610,
      "advertising_fee":0.91
   }
]

Campos de la respuesta, refieren a las métricas de cada pad:

  • "impressions": cantidad de impresiones en el sitio que tuvo el Product Ad.
  • "clicks": cantidad de clicks que recibió el Product Ad.
  • "ctr": click through rate, expresado en porcentaje, la división entre clicks e impressions.
  • "cost": es el costo total de clicks del período, en moneda local.
  • “cpc”: el costo promedio de cada click, en moneda local.
  • "sold_quantity_direct": cantidad de ventas directas que tuvo el Product Ad.
  • "sold_quantity_indirect": cantidad de ventas asistidas que tuvo el Product Ad.
  • "sold_quantity_total": cantidad de ventas en total que tuvo el Product Ad.
  • "amount_direct": Suma del valor de las ventas directas obtenidas de tu Product Ad, en moneda local.
  • "amount_indirect": Suma del valor de las ventas asistidas obtenidas de tu Product Ad, en moneda local.
  • "amount_total": Suma del valor de las ventas obtenidas de tu Product Ad, en moneda local.
  • "advertising_fee": expresado en porcentaje, la división entre inversión en publicidad sobre los ingresos obtenidos. cost / amount_total. Un valor más bajo implica un mejor rendimiento.

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 Teste",
    "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 status de un Product Ad en una campaña

curl -X PUT
https://api.mercadolibre.com/advertising/product_ads/ads/{item_id}?access_token={access_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}&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, recibe un campaign id.
  • offset y limit: opcionales. El limit no podrá ser mayor a 100.

Forma parte de nuestra comunidad