Mercado Ads

É uma ferramenta que permite criar campanhas de publicidade para ajudar você com a promoção de seus anúncios no Mercado Livre a fim de obter mais visitas e vendas. Através de publicidade, você pode promover o desempenho de seus anúncios, aumentando suas vendas. Saiba mais e aumente as suas vendas com Product Ads.

Conteúdos

→Limites de orçamento
→Campanhas
→Criar uma campanha
→Parâmetros
→Restrições para a criação de campanhas por um usuário
→Alterar uma campanha
→Consultar uma campanha
→Pesquisa de campanhas por usuário
→Métricas de campanha
→Vendas diretas e vendas assistidas
→Product Ads
→Consultar um Product Ad associado a um item do usuário
→Alterar o status de um Product Ad em uma campanha
→Pesquisa de Product Ads por usuário
→Parâmetros


Limites de orçamento

Se você quiser começar a trabalhar com Product Ads no Mercado Livre, o primeiro que deverá conhecer, para depois montar sua própria campanha, são os limites de orçamento para seu usuário. Cada usuário tem um investimento mínimo e máximo alocado em publicidade. Você pode escolher livremente seu investimento diário dentro dessa faixa.

Para conhecer os limites de orçamento de seu usuário:

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

Resposta:

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

É expresso na moeda local de cada site. Seu orçamento deverá estar dentro dessa faixa. Os valores dos limites são orçamentos válidos.

Os limites para um usuário podem mudar ao longo do tempo.


Campanhas

Todos seus anúncios estarão reunidos dentro de uma campanha, cujo orçamento será dividido entre todos os anúncios que estiverem dentro dela.


Criar uma campanha

O primeiro é habilitar uma campanha para um usuário.

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, deve estar dentro dos limites de orçamento de seu usuário.
  • Status: campo opcional, tem valor "active" por default.

Resposta:

{
    "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"
}

Restrições para a criação de campanhas por um usuário

Caso haja documentação pendente. O usuário visualizará um link para completá-la. Aplica no MLB, MLV e MCO.


Alterar uma campanha

Podem ser alterados os 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 uma campanha

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"
}

Pesquisa de campanhas por usuário

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 campanha

As métricas de uma campanha podem ser consultadas dentro de um intervalo de tempo não superior a 90 dias.

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, com formato “aaaa-mm-dd”, exemplo 2018-08-01
  • date_to: campo requerido, com formato “aaaa-mm-dd”, exemplo 2018-08-10
  • campaign_id: campo requerido, ID da campanha

Resposta:

{  
   "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 da resposta, referidos às métricas de toda a campanha:

  • "impressions": número de impressões no site recebidas pela campanha.
  • "clicks": número de cliques recebidos pela campanha.
  • "ctr": click through rate, expresso em porcentagem, a divisão entre cliques e impressions.
  • "cost": custo total de cliques do período, em moeda local
  • “cpc”: custo médio de cada clique, em moeda local.
  • "sold_quantity_direct": número de vendas diretas.
  • "sold_quantity_indirect": número de vendas assistidas.
  • "sold_quantity_total": número de vendas total.
  • "amount_direct": Soma do valor das vendas diretas obtidas através de seus Product Ads, em moeda local.
  • "amount_indirect": Suma del valor de las ventas asistidas obtenidas a través de tus Product Ads, en moneda local.
  • "amount_indirect": Soma do valor das vendas assistidas obtidas através de seus Product Ads, em moeda local.
  • "amount_total": Soma do valor das vendas obtidas através de seus Product Ads, em moeda local.
  • "advertising_fee": expressa em porcentagem, a divisão entre investimento em publicidade sobre as rendas obtidas. cost / amount_total. Um valor inferior equivale a melhor desempenho.

Vendas diretas e vendas assistidas

Uma venda é direta quando um usuário clica seu Product Ad e compra o produto. Uma venda é assistida quando um usuário clica seu Product Ad e compra outro de seus produtos.


Product Ads

Métricas de um Product Ad Aplicando multiget, podem ser consultados até 50 Product Ads em uma mesma request. Deverá também ser enviado um intervalo de datas não superior a 90 dias.

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, com formato “aaaa-mm-dd”, exemplo 2018-08-01
  • date_to: campo requerido, com formato “aaaa-mm-dd”, exemplo 2018-08-10
  • campaign_id: campo requerido, id da campanha
  • ids: campo requerido, lista de até 50 itens ids separados por vírgula, exemplo MLA1234, MLA4321

Resposta:

[  
   {  
      "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 da resposta, referidos às métricas de cada pad:

  • "impressions": número de impressões no site do Product Ad.
  • "clicks": número de cliques recebidos pelo Product Ad.
  • "ctr": click through rate, expressa em porcentagem, a divisão entre cliques e impressions.
  • "cost": custo total de cliques do período, em moeda local.
  • “cpc”: custo médio de cada clique, em moeda local.
  • "sold_quantity_direct": número de vendas diretas do Product Ad.
  • "sold_quantity_indirect": número de vendas indiretas do Product Ad.
  • "sold_quantity_total": número total de vendas do Product Ad.
  • "amount_direct": Soma do valor das vendas diretas obtidas de seu Product Ad, em moeda local.
  • "amount_indirect": Soma do valor das vendas assistidas obtidas de seu Product Ad, em moeda local.
  • "amount_total": Soma do valor das vendas obtidas de seu Product Ad, em moeda local.
  • "advertising_fee": expressa em porcentagem, a divisão entre investimento em publicidade sobre as rendas obtidas. cost / amount_total. Um valor inferior equivale a melhor desempenho.

Consultar um Product Ad associado a um item do usuário

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"
}

Alterar o status de um Product Ad em uma campanha

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

Pesquisa de Product Ads por usuário

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, é o status dos Product Ads.
  • title: opcional, são palavras incluídas no título do Product Ad.
  • campaigns: opcional, recebe um campaign id.
  • offset e limit: opcionais. O limit não poderá ser maior a 100.
ou registre-se para receber as últimas notícias sobre nossa API