Product Ads – Mercado Livre Publicidade

É 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. Se você for um vendedor novo ou estiver lançando um novo produto, poderá concretizar suas primeiras vendas mais rapidamente. Se você já for um vendedor experiente, conseguirá potencializar o desempenho de seus anúncios, aumentando suas vendas.

Saiba mais em https://publicidad.mercadolibre.com.ar/productAds

Conteúdoss

Planos

Se você quiser começar a trabalhar com Product Ads no Mercado Livre, o primeiro que deverá conhecer, para depois montar suas próprias campanhas, são os planos disponíveis em seu país. Cada plano determinará qual será seu investimento máximo em publicidade. Quanto mais alto for o plano, você receberá maior quantidade de visitas, porém, pagará um CPC (custo por clique) menor, atingindo, assim, mais compradores.
Para saber quais são os planos disponíveis em seu site:

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

Exemplo:

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

O campo daily_budget define qual a tarifa fixa máxima que o vendedor vai pagar por dia. Os diferentes planos consistem na variação deste valor. É expresso na moeda local de cada site.

Se for necessário, você também pode consultar o plano com seu ID.

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

Exemplo:

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


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

Campanhas

Todos seus anúncios serão agrupados dentro de campanhas. Cada uma terá um plano associado, cuja tarifa será dividida entre todos os anúncios dentro dela.
Você poderá criar todas as campanhas que quiser.

Criar uma campanha

O primeiro é habilitar uma campanha para um usuário. Dois tipos de campanhas podem ser criados:



DEFAULT: É sempre a primeira a ser criada. Não é possível dar um nome a ela nem criar mais de uma campanha desse tipo. Para os sites hispanos, o nome será “Campaña General”. No MLB o nome é “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 a POST seja bem-sucedida.
  • sync_new_listings: o valor por default é “enabled”. Assim, cada vez que o usuário criar um anúncio, este se transformará em um Product Ad de maneira automática. se for criado como disabled, cada item deverá ser adicionado manualmente.
  • group_id: este campo define o estoque tomado para saber quais anúncios do usuário devem ser levados em conta na publicidade. Os valores representam Mercado Livre e Loja Oficial com seu próprio ID.
  • status: por default, a campanha é criada como ativa.

Quando uma campanha não tem mais anúncios ativos, automaticamente passa para o status “hold”. Nesse status, a tarifa não é consumida. A particularidade é que um usuário não pode alterar o status. O sistema atribui o status automaticamente quando todos os anúncios dentro da campanha finalizam. Esse status é definitivo? Não. Quando você adicionar um novo anúncio, este passará para status paused. Para ativá-lo, deverá fazer manualmente um PUT com status active.


CUSTOM: São campanhas que procuram focar determinados produtos de maneira mais específica, especialmente, quando o catálogo é amplo, procurando otimizar o investimento. Criar várias campanhas custom permite aumentar a tarifa diária.
As campanhas custom têm um nome próprio para sua identificação. A sincronização está desativada, pois será necessário indicar quais anúncios fazem parte desse tipo de campanhas.

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

Resposta

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

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

  • Se o usuário não tiver itens anunciados, não poderá criar campanhas.
  • O usuário tiver reputação red ou orange no site. Não há forma de reverter essa situação, só melhorando a qualificação do usuário.
  • Quando o usuário for novo, sem experiência dentro do site. Nos sites em que o Mercado Pago estiver ativo, o usuário será requisitado para realizar um pagamento mínimo por única vez. Este pagamento será devolvido com a nota fiscal.
  • Houver documentação pendente. O usuário visualizará um link para completá-la. Aplica no MLB, MLV e MCO.

Alterar uma campanha

Em campanhas default, é possível alterar os campos:

  • plan_id
  • status
  • sync_new_listings

Em campanhas custom, é possível alterar os campos:

  • plan_id
  • status
  • name

Exemplo:

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

Consultar uma campanha

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

Pesquisa de campanhas por usuário

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 campanha

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

Exemplo:

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

Os parâmetros date_from e date_to são obrigatórios.

Resposta:

{
 "impressions": 3,
 "clicks": 2,
 "ctr": 0.66, //ratio, porcentagem entre impressões e cliques.
 "cost": 3 //custo total de cliques do período em moeda local. 
}

Parâmetros

  • impressions: número de impressões no site que o Product Ad teve.
  • clicks: número de cliques que o Product Ad recebeu.
  • ctr: porcentagem entre impressões e cliques.
  • cost: total de cliques do período em moeda local.

Product Ads

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

Trocar o Product Ad de campanha

Um Product Ad nunca faz parte de duas campanhas ao mesmo tempo. Quer dizer que, se o usuário tiver uma campanha default e uma custom, para o item fazer parte da segunda, deverá sair da primeira. Também é possível que, após ter passado para a custom, o usuário decidir reincorporá-lo na default, voltando para seu lugar original.

Em um primeiro momento, sempre faz parte da campanha default. Quando é enviado para uma campanha custom, seu status será sempre active, podendo depois ser pausado.

Quando um Product Ad é movimentado de uma campanha para outra, suas métricas ficam associadas à nova campanha. Por exemplo, se um Product Ad recebeu 10 visitas na campanha default e for passado para uma custom, iniciará com zero visitas. Mesmo assim, essas métricas não se perdem. Se o Product Ad retornar para a campanha original, ainda conserva as métricas que tinha antes de ser movimentado.

Alocar um Product Ad a uma campanha

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

Trocar o status de um Product Ad em uma campanha

curl -X PUT https://api.mercadolibre.com/advertising/product_ads/ads/$item_id?access_token=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,$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, funciona como um multiget que recebe diversos IDs separados por vírgula.
  • offset y limit: opcionais. O limit não poderá ser maior a 100.

Métricas de Product Ads

Aplicando multiget, podem ser consultados até 50 Product Ads em uma mesma request.

Exemplo:

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 as campanhas são associadas a um grupo. Esse agrupamento permite entender se a campanha é composta por itens do Mercado Livre ou Lojas Oficiais.

As convenções utilizadas para definir os grupos são:

  • ML: Mercado Livre
  • OS_: Loja Oficial

Obter um Grupo particular de um usuário

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 o tipo de grupo.
  • name: representa o nome do grupo.
  • campaigns: contém o número de campanhas dos diferentes status. Estes são active, paused e hold.

Obter todos os Grupos de um usuário

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