Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.
Documentação do
Product Ads para Catálogo e User Products
Com a evolução dos nossos produtos, o Product Ads agora exige que os usuários que trabalham com itens de Catálogo e User Products agrupem seus anúncios de forma eficiente.
Tipos de agrupamento em anúncios
Novo fluxo de Product Ads com variantes unificadas
A partir deste novo fluxo, todas as variantes de um produto, incluindo aquelas publicadas via catálogo, passam a ser gerenciadas dentro de uma única campanha de Product Ads. Isso representa uma mudança importante na estrutura de campanha, pois elimina a fragmentação de campanhas entre diferentes variantes do mesmo produto.
O que mudou no fluxo?
Antes:
- Variantes de um mesmo produto (por exemplo, cores ou tamanhos) eram promovidas separadamente, podendo estar associadas a campanhas distintas.
- Os produtos publicados via User Products e Catálogo exigiam campanhas individuais, com gestão isolada.
Agora:
- Todas as variantes estão unificadas em uma mesma campanha, centralizada no produto principal.
- A variante com melhor desempenho define a base da campanha.
- As ações executadas na campanha (edições, pausas, ativações, etc.) passam a afetar todas as variantes simultaneamente.
Fluxo técnico recomendado
A seguir, consulte os novos endpoints de anúncios que você deve substituir:
| Funcionalidade | Fluxo anterior | Novo fluxo |
|---|---|---|
| Consultar anunciante | Consultar anunciante (advertiser) | Sem alterações |
| Anúncios | Detalhe do anúncio |
|
| Métricas | Métricas de anúncios | Substituído pelas métricas de Ad Group. |
| Métricas | Métricas de campanhas | Sem alterações |
| Métricas | — |
|
Consultar anunciante
Os anunciantes (advertiser_id) são aqueles que investem um orçamento para a criação e distribuição de anúncios publicitários, com o objetivo de promover seus produtos ou serviços. Consulte a lista de anunciantes que têm acesso a um usuário, dependendo do tipo de produto requerido.
Parâmetros obrigatórios:
- product_id: tipo de produto. Valores disponíveis: PADS (Product Ads), DISPLAY, BADS (Brand Ads).
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -H 'Api-Version: 1'
https://api.mercadolibre.com/advertising/advertisers?product_id=$PRODUCT_IDExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -H 'Api-Version: 1'
https://api.mercadolibre.com/advertising/advertisers?product_id=PADSResposta:
{
"advertisers": [
{
"advertiser_id": 000,
"site_id": "MLB",
"advertiser_name": "Advertiser AAA",
"account_name": "MLB - XZY"
},
{
"advertiser_id": 111,
"site_id": "MLM",
"advertiser_name": "Advertiser BBB",
"account_name": "MLM - XYZ"
},
{
"advertiser_id": 222,
"site_id": "MLA",
"advertiser_name": "Advertiser CCC",
"account_name": "MLA - XYZ"
},
{
"advertiser_id": 333,
"site_id": "MLC",
"advertiser_name": "Advertiser DDD",
"account_name": "MLC - XYZ"
}
]
}Parâmetros de resposta:
- advertiser_id: identificador do anunciante. Você o utilizará para o restante das solicitações.
- site_id: identificador do país. Consulte a nomenclatura dos sites do Mercado Livre e suas respectivas moedas.
- advertiser_name: nome do anunciante.
- account_name: nome da conta.
Buscar Ad Groups por itens
A partir deste novo fluxo, a identificação dos anúncios nas campanhas é realizada por meio de um novo identificador, o ad_group_id. Esse identificador será utilizado nas chamadas para consultar os detalhes dos ad groups e as métricas dos anúncios.
Para buscar o ad_group_id a partir de um ou mais item_ids, utilize o filtro filters[item_ids] (plural) sobre o endpoint de busca de Ad Groups.
Chamada Current
curl -L -g -X GET 'https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/advertisers/$ADVERTISER_ID/product_ads/ad_groups/search?filters[item_ids]=$ITEM_ID,$ITEM_ID' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-H 'api-version: 2'
Exemplo:
curl -L -g -X GET 'https://api.mercadolibre.com/advertising/MLA/advertisers/882927/product_ads/ad_groups/search?filters[item_ids]=MLA2283350014,MLA2288350754' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-H 'api-version: 2'
Resposta:
{
"paging": {
"offset": 0,
"total": 2,
"limit": 50
},
"results": [
{
"id": 1194808653,
"ad_group_external_id": "MLA2283350014",
"status": "ACTIVE",
"campaign_id": 353605357,
"advertiser_id": 882927,
"ad_group_type": "ITEM"
},
{
"id": 1194727929,
"ad_group_external_id": "MLA2288350754",
"status": "ACTIVE",
"campaign_id": 353605357,
"advertiser_id": 882927,
"ad_group_type": "ITEM"
}
]
}Chamada Deprecated
curl -L -g -X GET 'https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/advertisers/$ADVERTISER_ID/product_ads/ads/search?filters[item_id]=MLM1234567898' \
-H 'Authorization: Bearer $ACCESS_TOKEN'
-H 'api-version: 2'
Consultar detalhe do Ad Group
Este recurso permite obter todas as informações detalhadas de um Ad Group específico.
Parâmetros:
- site_id: Identificador do site.
- ad_group_id: Identificador do Ad Group.
- date_to: a data final da busca.
- date_from: a data inicial da busca.
- channel (opcional): filtro para selecionar o canal do Ad Group.
- marketplace (padrão)
- filters[campaign_id] (opcional): filtro que utiliza ids de campanhas dos Ad Groups.
- aggregation_type (opcional):
- adgroup (padrão) → para adGroup não enviar o parâmetro
- daily
- metrics: as métricas desejadas.
- CLICKS
- PRINTS
- COST
- CPC
- CTR
- DIRECT_AMOUNT
- INDIRECT_AMOUNT
- TOTAL_AMOUNT
- DIRECT_UNITS_QUANTITY
- INDIRECT_UNITS_QUANTITY
- UNITS_QUANTITY
- DIRECT_ITEMS_QUANTITY
- INDIRECT_ITEMS_QUANTITY
- ADVERTISING_ITEMS_QUANTITY
- ORGANIC_UNITS_QUANTITY
- ORGANIC_UNITS_AMOUNT
- ORGANIC_ITEMS_QUANTITY
Chamada:
curl -L -X GET \
-H "Authorization: Bearer $ACCESS_TOKEN" \
"https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/product_ads/ad_groups/$AD_GROUP_ID"Exemplo:
curl -L -X GET 'https://api.mercadolibre.com/advertising/MLM/product_ads/ad_groups/65867?date_from=2025-08-31&date_to=2025-09-30&metrics=CLICKS,PRINTS,COST,CPC,CTR,DIRECT_AMOUNT,INDIRECT_AMOUNT,TOTAL_AMOUNT,DIRECT_UNITS_QUANTITY,INDIRECT_UNITS_QUANTITY,UNITS_QUANTITY,DIRECT_ITEMS_QUANTITY,INDIRECT_ITEMS_QUANTITY,ADVERTISING_ITEMS_QUANTITY,ORGANIC_UNITS_QUANTITY,ORGANIC_UNITS_AMOUNT,ORGANIC_ITEMS_QUANTITY,ACOS' \
-H 'Authorization: Bearer $ACCESS_TOKEN'
Resposta:
{
"channel": "MARKETPLACE",
"catalog_listing": true,
"title": "Espejo rectangular de pared DECOROSA 1",
"advertiser_id": 706921,
"ad_group_type": "CATALOG",
"domain_id": "MLC-MIRRORS",
"official_store_id": 0,
"id": 976667081,
"campaign_id": 352858339,
"original_advertiser_id": 706921,
"thumbnail": "https://http2.mlstatic.com/D_NQ_NP_747848-MLA86888423870_072025-F.jpg",
"date_created": "2025-07-03T12:00:04Z",
"ad_group_external_id": "MLC52015944",
"current_advertiser_id": 706921,
"sll": true,
"brand_value_id": "55570491",
"status": "ACTIVE",
"metrics": {
"clicks": 47,
"prints": 2660,
"cost": 3992.0,
"cpc": 84.94,
"direct_amount": 15608.0,
"indirect_amount": 0.0,
"total_amount": 15608.0,
"direct_units_quantity": 1,
"indirect_units_quantity": 0,
"units_quantity": 1,
"direct_items_quantity": 1,
"indirect_items_quantity": 0,
"advertising_items_quantity": 1,
"organic_units_quantity": 0,
"organic_items_quantity": 0,
"acos": 25.58,
"organic_units_amount": 0.0
}
}
Parâmetros de resposta:
- channel: canal das campanhas.
- catalog_listing: true ou false. Indica se o item é de catálogo.
- advertiser_id: identificador do anunciante. Você o utilizará para o restante das solicitações.
- ad_group_type: tipos de agrupadores de anúncio (CATALOG, FAMILY ou ITEM).
- ad_group_id: identificador do Ad Group do item.
- ad_group_external_id: identificador da entidade de cada tipo de item:
- Itens de catálogo → utiliza o valor de parent_id.
- Itens de User Product → utiliza o valor de family_id.
- Itens tradicionais → utiliza o próprio identificador do item (item_id).
- brand_value_id: identificador da marca.
Métricas de campanhas
Parâmetros opcionais
limit: limite de elementos a exibir
offset: atributo de paginação dos resultados, permite percorrer as páginas da lista do 0 até o múltiplo do total de elementos com o limite por página.
date_from: data de início (YYYY-MM-DD). Validado como obrigatório se métricas forem solicitadas.
date_to: data de término (YYYY-MM-DD). Validado como obrigatório se métricas forem solicitadas.
metrics: lista separada por vírgula (Ex. clicks, prints). Indica os campos que serão retornados na resposta. Valores possíveis:
- clicks, prints, ctr, cost, cpc, acos, organic_units_quantity, organic_units_amount, organic_items_quantity, direct_items_quantity, indirect_items_quantity, advertising_items_quantity, cvr, roas, sov, direct_units_quantity, indirect_units_quantity, units_quantity, direct_amount, indirect_amount, total_amount
aggregation: agregação pela qual os resultados serão apresentados. Por padrão, sum.
aggregation_type: tipo de agregação na qual os resultados serão apresentados. Por padrão, campaign.
metrics_summary: solicita sumarização de métricas. Deve ser usado em conjunto com metrics. Por padrão, false.
Filtros disponíveis
Para utilizar os filtros você deve seguir a estrutura ?filters[nome do filtro]= valor
campaign_ids: filtro por id de campanhas separado por vírgulas.
campaign_id: filtro por id de uma campanha, obtém todos os itens que estiveram na campanha para o intervalo de datas.
status: estado das campanhas, separado por vírgulas. Valores disponíveis: active, paused.
channel: canal das campanhas. Valor padrão: marketplace.
Consultar campanhas
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'api-version: 2' https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/advertisers/$ADVERTISER_ID/product_ads/campaigns/searchExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'api-version: 2'
https://api.mercadolibre.com/advertising/MLM/advertisers/12345/product_ads/campaigns/search?filters[status]=activeResposta:
{
"paging": {
"offset": 0,
"total": 4,
"limit": 50
},
"results": [
{
"id": 111111,
"name": "TEST NAME",
"status": "active",
"last_updated": "2024-09-20T16:23:51.000Z",
"date_created": "2024-05-16T20:17:01.000Z",
"channel": "marketplace",
"daily_budget": 28.0,
"budget": 28.0,
"currency_id": "BRL",
"acos_target": 9.0,
"strategy": "PROFITABILITY"
},
{
"id": 222222,
"name": "TEST NAME 2",
"status": "active",
"last_updated": "2024-09-21T07:05:51.000Z",
"date_created": "2024-05-16T20:20:34.000Z",
"channel": "marketplace",
"daily_budget": 15.0,
"budget": 15.0,
"currency_id": "BRL",
"acos_target": 12.0,
"strategy": "PROFITABILITY"
},
{
"id": 3333333,
"name": "TEST NAME 3",
"status": "active",
"last_updated": "2024-09-20T16:26:31.000Z",
"date_created": "2024-05-16T20:22:31.000Z",
"channel": "marketplace",
"daily_budget": 8.67,
"budget": 8.67,
"currency_id": "BRL",
"acos_target": 14.0,
"strategy": "INCREASE"
},
{
"id": 4444444,
"name": "TEST NAME 4",
"status": "active",
"last_updated": "2024-09-23T07:48:44.000Z",
"date_created": "2024-07-12T04:58:26.000Z",
"channel": "marketplace",
"daily_budget": 8.33,
"budget": 8.33,
"currency_id": "BRL",
"acos_target": 14.0,
"strategy": "PROFITABILITY"
}
]
}Busca e métricas de campanhas
Obtenha todas as campanhas de um anunciante e também suas métricas correspondentes.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'api-version: 2' https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/advertisers/$ADVERTISER_ID/product_ads/campaigns/searchExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'api-version: 2'
https://api.mercadolibre.com/advertising/MLA/advertisers/882927/product_ads/campaigns/search?limit=1&offset=0&date_from=2025-12-01&date_to=2025-12-30&metrics=clicks,prints,ctr,cost,cpc,acos,organic_units_quantity,organic_units_amount,organic_items_quantity,direct_items_quantity,indirect_items_quantity,advertising_items_quantity,cvr,roas,sov,direct_units_quantity,indirect_units_quantity,units_quantity,direct_amount,indirect_amount,total_amountResposta:
{
"paging": {
"offset": 0,
"total": 15,
"limit": 1
},
"results": [
{
"id": 355189450,
"name": "Campaña",
"status": "active",
"last_updated": "2025-11-25T21:12:59.000Z",
"date_created": "2025-11-25T21:12:59.000Z",
"strategy": "VISIBILITY",
"acos_target": 50.0,
"acos_top_search_target": 0.0,
"roas_target": 2.0,
"channel": "marketplace",
"advertiser_id": 882927,
"salesforce_event_id": 14,
"budget": 900.0,
"automatic_budget": false,
"metrics": {
"clicks": 0,
"prints": 0,
"cost": 0.0,
"cpc": 0.0,
"ctr": 0.0,
"direct_amount": 0.0,
"indirect_amount": 0.0,
"total_amount": 0.0,
"direct_units_quantity": 0,
"indirect_units_quantity": 0,
"units_quantity": 0,
"direct_items_quantity": 0,
"indirect_items_quantity": 0,
"advertising_items_quantity": 0,
"organic_units_quantity": 0,
"organic_units_amount": 0.0,
"organic_items_quantity": 0,
"acos": 0.0,
"cvr": 0.0,
"roas": 0.0,
"sov": 0.0
}
}
]
}Métricas diárias de campanhas
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'api-version: 2' https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/advertisers/$ADVERTISER_ID/product_ads/campaigns/search?limit=2&offset=0&date_from=2024-01-01&date_to=2024-02-28&metrics=clicks,prints,ctr,cost,cpc,acos,organic_units_quantity,organic_units_amount,organic_items_quantity,direct_items_quantity,indirect_items_quantity,advertising_items_quantity,cvr,roas,sov,direct_units_quantity,indirect_units_quantity,units_quantity,direct_amount,indirect_amount,total_amount&aggregation_type=DAILYResposta:
{
"paging": {
"total": 50,
"offset": 0,
"limit": 2
},
"results": [
{
"date": "2024-01-01",
"clicks": 0,
"prints": 0,
"ctr": 0.01,
"cost": 0.01,
"cpc": 0.01,
"acos": 0.01,
"organic_units_quantity": 0,
"organic_units_amount": 0,
"organic_items_quantity": 0,
"direct_items_quantity": 0,
"indirect_items_quantity": 0,
"advertising_items_quantity": 0,
"cvr": 0,
"roas": 0,
"sov": 0,
"direct_units_quantity": 0,
"indirect_units_quantity": 0,
"units_quantity": 0,
"direct_amount": 0.01,
"indirect_amount": 0.01,
"total_amount": 0.01
},
{
"date": "2024-01-01",
"clicks": 0,
"prints": 0,
"ctr": 0.01,
"cost": 0.01,
"cpc": 0.01,
"acos": 0.01,
"organic_units_quantity": 0,
"organic_units_amount": 0,
"organic_items_quantity": 0,
"direct_items_quantity": 0,
"indirect_items_quantity": 0,
"advertising_items_quantity": 0,
"cvr": 0,
"roas": 0,
"sov": 0,
"direct_units_quantity": 0,
"indirect_units_quantity": 0,
"units_quantity": 0,
"direct_amount": 0.01,
"indirect_amount": 0.01,
"total_amount": 0.01
}
]
}Métricas sumarizadas de campanhas
Utilize o mesmo endpoint para consultar métricas de campanhas adicionando o parâmetro metrics_summary=true.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'api-version: 2' https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/advertisers/$ADVERTISER_ID/product_ads/campaigns/search?limit=1&offset=0&date_from=2025-12-01&date_to=2025-12-30&metrics=clicks,prints,ctr,cost,cpc,acos,organic_units_quantity,organic_units_amount,organic_items_quantity,direct_items_quantity,indirect_items_quantity,advertising_items_quantity,cvr,roas,sov,direct_units_quantity,indirect_units_quantity,units_quantity,direct_amount,indirect_amount,total_amount&metrics_summary=trueResposta:
{
"paging": {
"offset": 0,
"total": 15,
"limit": 1
},
"results": [
{
"id": 355189450,
"name": "Campaña",
"status": "active",
"last_updated": "2025-11-25T21:12:59.000Z",
"date_created": "2025-11-25T21:12:59.000Z",
"strategy": "VISIBILITY",
"acos_target": 50.0,
"acos_top_search_target": 0.0,
"roas_target": 2.0,
"channel": "marketplace",
"advertiser_id": 882927,
"salesforce_event_id": 14,
"budget": 900.0,
"automatic_budget": false,
"metrics": {
"clicks": 0,
"prints": 0,
"cost": 0.0,
"cpc": 0.0,
"ctr": 0.0,
"direct_amount": 0.0,
"indirect_amount": 0.0,
"total_amount": 0.0,
"direct_units_quantity": 0,
"indirect_units_quantity": 0,
"units_quantity": 0,
"direct_items_quantity": 0,
"indirect_items_quantity": 0,
"advertising_items_quantity": 0,
"organic_units_quantity": 0,
"organic_units_amount": 0.0,
"organic_items_quantity": 0,
"acos": 0.0,
"cvr": 0.0,
"roas": 0.0,
"sov": 0.0
}
}
],
"metrics_summary": {
"clicks": 0,
"prints": 0,
"cost": 0.0,
"cpc": 0.0,
"ctr": 0.0,
"direct_amount": 0.0,
"indirect_amount": 0.0,
"total_amount": 0.0,
"direct_units_quantity": 0,
"indirect_units_quantity": 0,
"units_quantity": 0,
"direct_items_quantity": 0,
"indirect_items_quantity": 0,
"advertising_items_quantity": 0,
"organic_units_quantity": 0,
"organic_units_amount": 0.0,
"organic_items_quantity": 0,
"acos": 0.0,
"cvr": 0.0,
"roas": 0.0,
"sov": 0.0
}
}Detalhe e métricas de uma campanha
Parâmetros opcionais:
- date_from: data de início (YYYY-MM-DD). Validado como obrigatório se campos de métricas forem solicitados.
- date_to: data de término (YYYY-MM-DD). Validado como obrigatório se campos de métricas forem solicitados.
- metrics: lista separada por vírgula (Ex. clicks,prints) indica os campos que serão retornados na resposta. Valores possíveis:
clicks, prints, ctr, cost, cpc, acos, organic_units_quantity, organic_units_amount, organic_items_quantity, direct_items_quantity, indirect_items_quantity, advertising_items_quantity, cvr, roas, sov, direct_units_quantity, indirect_units_quantity, units_quantity, direct_amount, indirect_amount, total_amount, impression_share, top_impression_share, lost_impression_share_by_budget, lost_impression_share_by_ad_rank, acos_benchmark. - aggregation: agregação pela qual os resultados serão apresentados. Padrão: sum.
- aggregation_type: tipo de agregação na qual os resultados serão apresentados. Padrão: campaign.
Filtros disponíveis:
- channel: canal das campanhas. Valor padrão: marketplace.
Chamada:
curl GET -H 'api-version: 2' -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/product_ads/campaigns/$CAMPAIGN_ID?date_from=2025-12-01&date_to=2025-12-30&metrics=clicks,prints,ctr,cost,cpc,acos,organic_units_quantity,organic_units_amount,organic_items_quantity,direct_items_quantity,indirect_items_quantity,advertising_items_quantity,cvr,roas,sov,direct_units_quantity,indirect_units_quantity,units_quantity,direct_amount,indirect_amount,total_amount,impression_share,top_impression_share,lost_impression_share_by_budget,lost_impression_share_by_ad_rank,acos_benchmarkResposta:
{
"id": 355189450,
"name": "Campaña",
"status": "active",
"last_updated": "2025-11-25T21:12:59.000Z",
"date_created": "2025-11-25T21:12:59.000Z",
"strategy": "VISIBILITY",
"acos_target": 50.0,
"acos_top_search_target": 0.0,
"roas_target": 2.0,
"channel": "marketplace",
"budget": 900.0,
"currency_id": "ARS",
"metrics": {
"clicks": 0,
"prints": 0,
"cost": 0.0,
"cpc": 0.0,
"ctr": 0.0,
"direct_amount": 0.0,
"indirect_amount": 0.0,
"total_amount": 0.0,
"direct_units_quantity": 0,
"indirect_units_quantity": 0,
"units_quantity": 0,
"direct_items_quantity": 0,
"indirect_items_quantity": 0,
"advertising_items_quantity": 0,
"organic_units_quantity": 0,
"organic_units_amount": 0.0,
"organic_items_quantity": 0,
"acos": 0.0,
"cvr": 0.0,
"roas": 0.0,
"sov": 0.0,
"impression_share": 0.0,
"top_impression_share": 0.0,
"lost_impression_share_by_budget": 0.0,
"lost_impression_share_by_ad_rank": 0.0,
"acos_benchmark": 0.0
}
}Métricas diárias de uma campanha
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'api-version: 2'
https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/product_ads/campaigns/$CAMPAIGN_ID?date_from=2024-01-01&date_to=2024-02-28&metrics=clicks,prints,ctr,cost,cpc,acos,organic_units_quantity,organic_units_amount,organic_items_quantity,direct_items_quantity,indirect_items_quantity,advertising_items_quantity,cvr,roas,sov,direct_units_quantity,indirect_units_quantity,units_quantity,direct_amount,indirect_amount,total_amount,impression_share,top_impression_share,lost_impression_share_by_budget,lost_impression_share_by_ad_rank,acos_benchmark&aggregation_type=DAILYResposta:
[
{
"date": "2024-01-01",
"clicks": 0,
"prints": 0,
"ctr": 0.01,
"cost": 0.01,
"cpc": 0.01,
"acos": 0.01,
"organic_units_quantity": 0,
"organic_units_amount": 0,
"organic_items_quantity": 0,
"direct_items_quantity": 0,
"indirect_items_quantity": 0,
"advertising_items_quantity": 0,
"cvr": 0,
"roas": 0,
"sov": 0,
"direct_units_quantity": 0,
"indirect_units_quantity": 0,
"units_quantity": 0,
"direct_amount": 0.01,
"indirect_amount": 0.01,
"total_amount": 0.01,
"impression_share": 0,
"top_impression_share": 0,
"lost_impression_share_by_budget": 0.01,
"lost_impression_share_by_ad_rank": 0.01,
"acos_benchmark": 123
}
]Métricas de anúncios
Search e métricas de todos os anúncios
Obtenha todos os anúncios e as métricas correspondentes a eles.
Chamada Deprecated
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'api-version: 2' https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/advertisers/$ADVERTISER_ID/product_ads/ads/search?limit=1&offset=0&date_from=2024-01-01&date_to=2024-02-28&metrics=clicks,prints,ctr,cost,cpc,acos,organic_units_quantity,organic_units_amount,organic_items_quantity,direct_items_quantity,indirect_items_quantity,advertising_items_quantity,cvr,roas,sov,direct_units_quantity,indirect_units_quantity,units_quantity,direct_amount,indirect_amount,total_amountMétricas diárias de anúncios
Chamada Deprecated
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'api-version: 2' https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/advertisers/$ADVERTISER_ID/product_ads/ads/search?limit=1&offset=0&date_from=2024-01-01&date_to=2024-02-28&metrics=clicks,prints,ctr,cost,cpc,acos,organic_units_quantity,organic_units_amount,organic_items_quantity,direct_items_quantity,indirect_items_quantity,advertising_items_quantity,cvr,roas,sov,direct_units_quantity,indirect_units_quantity,units_quantity,direct_amount,indirect_amount,total_amount&aggregation_type=DAILYMétricas sumarizadas de anúncios
Chamada Deprecated
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'api-version: 2' https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/advertisers/$ADVERTISER_ID/product_ads/ads/search?limit=1&offset=0&date_from=2024-01-01&date_to=2024-02-28&metrics=clicks,prints,ctr,cost,cpc,acos,organic_units_quantity,organic_units_amount,organic_items_quantity,direct_items_quantity,indirect_items_quantity,advertising_items_quantity,cvr,roas,sov,direct_units_quantity,indirect_units_quantity,units_quantity,direct_amount,indirect_amount,total_amount&metrics_summary=trueMétricas diárias de anúncios de uma campanha
Obtenha métricas de todos os anúncios de uma campanha no intervalo de datas especificado, indicando os item_ids que deseja consultar por meio do filtro filters[item_ids].
Chamada Deprecated
curl -L -g -X GET 'https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/advertisers/$ADVERTISER_ID/product_ads/campaigns/$CAMPAIGN_ID/ads/metrics?date_from=2025-10-28&date_to=2025-10-29&filters[item_ids]=MLM3930085076&metrics=clicks,prints,cost,cpc,acos,organic_units_quantity,organic_units_amount,organic_items_quantity,direct_items_quantity,indirect_items_quantity,advertising_items_quantity,direct_units_quantity,indirect_units_quantity,units_quantity,direct_amount,indirect_amount,total_amount' \
-H 'Authorization: Bearer $ACCESS_TOKEN'
Métricas de Ad Groups de uma campanha
Obtém métricas de todos os Ad Groups de uma campanha para o período de um dia (date_to igual a date_from). Para períodos superiores a um dia, especifique o filtro filters[ad_group_ids].
Chamada Current
curl -L -g -X GET 'https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/product_ads/campaigns/$CAMPAIGN_ID/ad_groups/metrics?date_from=2026-04-01&date_to=2026-04-01&metrics=clicks,prints,cost,cpc,ctr,direct_amount,indirect_amount,total_amount,direct_units_quantity,indirect_units_quantity,units_quantity,direct_items_quantity,indirect_items_quantity,advertising_items_quantity,organic_units_quantity,organic_units_amount,organic_items_quantity,acos,sov,roas,cvr,tacos' \
-H 'Authorization: Bearer $ACCESS_TOKEN'
-H 'api-version: 2'Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'api-version: 2'
https://api.mercadolibre.com/advertising/MCO/product_ads/campaigns/355771832/ad_groups/metrics?date_from=2026-04-01&date_to=2026-04-01&metrics=clicks,prints,cost,cpc,ctr,direct_amount,indirect_amount,total_amount,direct_units_quantity,indirect_units_quantity,units_quantity,direct_items_quantity,indirect_items_quantity,advertising_items_quantity,organic_units_quantity,organic_units_amount,organic_items_quantity,acos,sov,roas,cvr,tacosResposta:
{
"date": "2026-04-01",
"results": [
{
"ad_group_id": 1406314785,
"metrics": {
"clicks": 0,
"prints": 11,
"cost": 0.0,
"cpc": 0.0,
"ctr": 0.0,
"direct_amount": 0.0,
"indirect_amount": 0.0,
"total_amount": 0.0,
"direct_units_quantity": 0,
"indirect_units_quantity": 0,
"units_quantity": 0,
"direct_items_quantity": 0,
"indirect_items_quantity": 0,
"advertising_items_quantity": 0,
"organic_units_quantity": 0,
"organic_items_quantity": 0,
"acos": 0.0,
"tacos": 0.0,
"organic_units_amount": 0.0,
"sov": 0.0,
"cvr": 0.0,
"roas": 0.0
}
}
]
}Métricas dos anúncios pertencentes ao Ad Group
Retorna métricas de desempenho dos anúncios pertencentes a um Ad Group específico, no intervalo de datas indicado.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'api-version: 2'
https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/product_ads/ad_groups/$AD_GROUP_ID/ads?date_from=2025-09-20&date_to=2025-10-08&metrics=clicks,prints,cost,cpc,ctr,direct_amount,indirect_amount,total_amount,direct_units_quantity,indirect_units_quantity,units_quantity,direct_items_quantity,indirect_items_quantity,advertising_items_quantity,organic_units_quantity,organic_units_amount,organic_items_quantity,acos,tacos,sov,cvr,roas
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'api-version: 2'
https://api.mercadolibre.com/advertising/MLM/product_ads/ad_groups/1142185192/ads?date_from=2025-09-20&date_to=2025-10-08&metrics=clicks,prints,cost,cpc,ctr,direct_amount,indirect_amount,total_amount,direct_units_quantity,indirect_units_quantity,units_quantity,direct_items_quantity,indirect_items_quantity,advertising_items_quantity,organic_units_quantity,organic_units_amount,organic_items_quantity,acos,tacos,sov,cvr,roas
Resposta:
{
"paging": {
"offset": 0,
"total": 3,
"limit": 50
},
"results": [
{
"item_id": "MLM3930085076",
"campaign_id": 353605357,
"ad_group_id": 1142185192,
"price": 500.0,
"price_usd": 0.0,
"title": "Camisa Hombre - No Ofertar Azul G",
"status": "active",
"has_discount": false,
"catalog_listing": false,
"logistic_type": "xd_drop_off",
"listing_type_id": "gold_special",
"domain_id": "MLM-SHIRTS",
"date_created": "2025-08-13T01:28:01Z",
"buy_box_winner": false,
"channel": "marketplace",
"advertiser_id": 348449,
"original_advertiser_id": 348449,
"brand_value_id": "276243",
"brand_value_name": "Genérica",
"condition": "new",
"current_level": "unknown",
"deferred_stock": false,
"thumbnail": "http://http2.mlstatic.com/D_823560-MLM89977402289_082025-I.jpg",
"permalink": "https://articulo.mercadolibre.com.mx/MLM-3930085076-camisa-hombre-no-ofertar-azul-g-_JM",
"recommended": false,
"image_quality": "good_quality_thumbnail",
"metrics": {
"clicks": 0,
"prints": 0,
"cost": 0.0,
"cpc": 0.0,
"direct_amount": 0.0,
"indirect_amount": 0.0,
"total_amount": 0.0,
"direct_units_quantity": 0,
"indirect_units_quantity": 0,
"units_quantity": 0,
"direct_items_quantity": 0,
"indirect_items_quantity": 0,
"advertising_items_quantity": 0,
"organic_units_quantity": 0,
"organic_items_quantity": 0,
"acos": 0.0,
"tacos": 0.0,
"organic_units_amount": 0.0,
"sov": 0.0,
"ctr": 0.0,
"cvr": 0.0,
"roas": 0.0
},
"status_raw": "A",
"family_id": 3080359231396376,
"family_name": "Camisa Hombre - No Ofertar",
"user_product_id": "MLMU3361694576",
"user_product_name": "Camisa Hombre - No Ofertar Azul G"
},
{
"item_id": "MLM3930021010",
"campaign_id": 353605357,
"ad_group_id": 1142185192,
"price": 500.0,
"price_usd": 0.0,
"title": "Camisa Hombre - No Ofertar Rojo G",
"status": "active",
"has_discount": false,
"catalog_listing": false,
"logistic_type": "xd_drop_off",
"listing_type_id": "gold_special",
"domain_id": "MLM-SHIRTS",
"date_created": "2025-08-13T01:28:01Z",
"buy_box_winner": false,
"channel": "marketplace",
"advertiser_id": 348449,
"original_advertiser_id": 348449,
"brand_value_id": "276243",
"brand_value_name": "Genérica",
"condition": "new",
"current_level": "newbie",
"deferred_stock": false,
"thumbnail": "http://http2.mlstatic.com/D_925659-MLM89604452328_082025-I.jpg",
"permalink": "https://articulo.mercadolibre.com.mx/MLM-3930021010-camisa-hombre-no-ofertar-rojo-g-_JM",
"recommended": false,
"image_quality": "good_quality_thumbnail",
"metrics": {
"clicks": 0,
"prints": 0,
"cost": 0.0,
"cpc": 0.0,
"direct_amount": 0.0,
"indirect_amount": 0.0,
"total_amount": 0.0,
"direct_units_quantity": 0,
"indirect_units_quantity": 0,
"units_quantity": 0,
"direct_items_quantity": 0,
"indirect_items_quantity": 0,
"advertising_items_quantity": 0,
"organic_units_quantity": 0,
"organic_items_quantity": 0,
"acos": 0.0,
"tacos": 0.0,
"organic_units_amount": 0.0,
"sov": 0.0,
"ctr": 0.0,
"cvr": 0.0,
"roas": 0.0
},
"status_raw": "A",
"family_id": 3080359231396376,
"family_name": "Camisa Hombre - No Ofertar",
"user_product_id": "MLMU3355646079",
"user_product_name": "Camisa Hombre - No Ofertar Rojo G"
},
{
"item_id": "MLM2406804973",
"campaign_id": 353605357,
"ad_group_id": 1142185192,
"price": 500.0,
"price_usd": 0.0,
"title": "Camisa Hombre - No Ofertar Amarillo G",
"status": "active",
"has_discount": false,
"catalog_listing": false,
"logistic_type": "xd_drop_off",
"listing_type_id": "gold_special",
"domain_id": "MLM-SHIRTS",
"date_created": "2025-08-13T01:28:01Z",
"buy_box_winner": false,
"channel": "marketplace",
"advertiser_id": 348449,
"original_advertiser_id": 348449,
"brand_value_id": "276243",
"brand_value_name": "Genérica",
"condition": "new",
"current_level": "newbie",
"deferred_stock": false,
"thumbnail": "http://http2.mlstatic.com/D_663458-MLM89604679576_082025-I.jpg",
"permalink": "https://articulo.mercadolibre.com.mx/MLM-2406804973-camisa-hombre-no-ofertar-amarillo-g-_JM",
"recommended": false,
"image_quality": "good_quality_thumbnail",
"metrics": {
"clicks": 0,
"prints": 0,
"cost": 0.0,
"cpc": 0.0,
"direct_amount": 0.0,
"indirect_amount": 0.0,
"total_amount": 0.0,
"direct_units_quantity": 0,
"indirect_units_quantity": 0,
"units_quantity": 0,
"direct_items_quantity": 0,
"indirect_items_quantity": 0,
"advertising_items_quantity": 0,
"organic_units_quantity": 0,
"organic_items_quantity": 0,
"acos": 0.0,
"tacos": 0.0,
"organic_units_amount": 0.0,
"sov": 0.0,
"ctr": 0.0,
"cvr": 0.0,
"roas": 0.0
},
"status_raw": "A",
"family_id": 3080359231396376,
"family_name": "Camisa Hombre - No Ofertar",
"user_product_id": "MLMU3355646081",
"user_product_name": "Camisa Hombre - No Ofertar Amarillo G"
}
]
}
Detalhes e métricas de Ad Group por advertiser
Obtém métricas e detalhes dos Ad Groups pertencentes a um advertiser no intervalo de datas especificado.
Chamada:
curl -X GET \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/advertising/$ADVERTISER_SITE_ID/advertisers/$ADVERTISER_ID/product_ads/ad_groups/search?date_to=2025-09-30&date_from=2025-08-01&limit=800&sort=desc&sort_by=clicks&metrics=CLICKS,PRINTS,COST,CPC,CTR,DIRECT_AMOUNT,INDIRECT_AMOUNT,TOTAL_AMOUNT,DIRECT_UNITS_QUANTITY,INDIRECT_UNITS_QUANTITY,UNITS_QUANTITY,DIRECT_ITEMS_QUANTITY,INDIRECT_ITEMS_QUANTITY,ADVERTISING_ITEMS_QUANTITY,ORGANIC_UNITS_QUANTITY,ORGANIC_UNITS_AMOUNT,ORGANIC_ITEMS_QUANTITY,ACOS,TACOS,SOV,CVR,ROAS&metrics_summary=true&filters[ad_group_id]=65867&sll=false&filters[original_advertiser_id]=348449&filters[campaigns]=353072052&filters[statuses]=active&filters[q]=Ofertar&filters[domains]=MLM-UNCLASSIFIED_PRODUCTS&filters[official_stores]=3782&filters[channel]=marketplace'Exemplo:
curl -X GET \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/advertising/MLM/advertisers/4622/product_ads/ad_groups/search?date_to=2025-09-30&date_from=2025-08-01&limit=800&sort=desc&sort_by=clicks&metrics=CLICKS,PRINTS,COST,CPC,CTR,DIRECT_AMOUNT,INDIRECT_AMOUNT,TOTAL_AMOUNT,DIRECT_UNITS_QUANTITY,INDIRECT_UNITS_QUANTITY,UNITS_QUANTITY,DIRECT_ITEMS_QUANTITY,INDIRECT_ITEMS_QUANTITY,ADVERTISING_ITEMS_QUANTITY,ORGANIC_UNITS_QUANTITY,ORGANIC_UNITS_AMOUNT,ORGANIC_ITEMS_QUANTITY,ACOS,TACOS,SOV,CVR,ROAS&metrics_summary=true&filters[ad_group_id]=65867&sll=false&filters[original_advertiser_id]=348449&filters[campaigns]=353072052&filters[statuses]=active&filters[q]=Ofertar&filters[domains]=MLM-UNCLASSIFIED_PRODUCTS&filters[official_stores]=3782&filters[channel]=marketplace'Resposta:
{
"paging": {
"offset": 0,
"total": 1,
"limit": 800
},
"results": [
{
"channel": "MARKETPLACE",
"title": "Termometro Digital Para Baño Philips Avent Sch480/00",
"advertiser_id": 4622,
"ad_group_type": "FAMILY",
"domain_id": "MLC-BABY_BATH_THERMOMETERS",
"official_store_id": 647,
"id": 960468947,
"campaign_id": 348413165,
"original_advertiser_id": 79196,
"thumbnail": "https://http2.mlstatic.com/D_653570-MLC54380685959_032023-O.jpg",
"date_created": "2025-06-23T23:40:16Z",
"ad_group_external_id": "1243844975276562",
"current_advertiser_id": 4622,
"sll": false,
"brand_value_id": "35924451",
"status": "ACTIVE",
"metrics": {
"clicks": 2,
"prints": 143,
"cost": 728.0,
"cpc": 364.0,
"direct_amount": 0.0,
"indirect_amount": 0.0,
"total_amount": 0.0,
"direct_units_quantity": 0,
"indirect_units_quantity": 0,
"units_quantity": 0,
"direct_items_quantity": 0,
"indirect_items_quantity": 0,
"advertising_items_quantity": 0,
"organic_units_quantity": 2,
"organic_items_quantity": 2,
"acos": 0.0,
"tacos": 1.82,
"organic_units_amount": 39980.0,
"sov": 0.0,
"ctr": 1.4,
"cvr": 0.0,
"roas": 0.0
}
}
],
"metrics_summary": {
"clicks": 248,
"prints": 67931,
"cost": 58660.0,
"cpc": 236.53,
"direct_amount": 192897.0,
"indirect_amount": 109351.0,
"total_amount": 302248.0,
"direct_units_quantity": 11,
"indirect_units_quantity": 10,
"units_quantity": 21,
"direct_items_quantity": 11,
"indirect_items_quantity": 7,
"advertising_items_quantity": 18,
"organic_units_quantity": 28,
"organic_items_quantity": 28,
"acos": 19.41,
"tacos": 7.24,
"organic_units_amount": 508094.0,
"sov": 39.13,
"ctr": 0.37,
"cvr": 8.47,
"roas": 5.15
}
}
Glossário
total: total de registros obtidos.
offset: valor padrão: 0.
limit: limite de elementos na lista de campanhas. Padrão: 50.
results: resultados obtidos.
id: identificador do anúncio ou campanha.
budget: média diária do orçamento (mensal) da campanha, ou seja, se o orçamento não for consumido durante o dia, o restante será utilizado nos dias seguintes até o final do mês. Atualizado diariamente às 4:00 hs GMT -3.
last_updated: data da última modificação da campanha.
date_created: data de criação da campanha.
price: preço do item associado.
title: nome da publicação.
has_discount: se possui desconto. Este valor é identificado com base na diferença entre os campos regular amount e amount entregados pela Prices API.
catalog_listing: é uma publicação de catálogo.
logistic_type: tipo de logística para o envio do item.
listing_type_id: identificador do tipo de publicação.
domain_id: domínio.
date_created: data de criação do anúncio.
official_store_id: identificador da loja oficial.
buy_box_winner: é vencedor do Catálogo.
channel: canal da campanha (marketplace).
campaign_id: identificador da campanha. Se o campaign id for zero, significa que o item não está em nenhuma campanha no momento.
condition: condição do item.
current_level: reputação.
deferred_stock: estoque do produto disponível. Um item com manufacturing_time (tempo de disponibilidade) faz com que o anúncio não seja exibido, priorizando assim os anúncios que têm estoque imediato.
thumbnail: link para a imagem em miniatura.
permalink: link para a publicação.
brand_value_id: identificador da marca associada ao item.
brand_value_name: nome da marca associada ao item.
status: estado do anúncio ou campanha.
recommended: o anúncio é recomendado.
image_quality: Qualidade da imagem de capa: good_quality_thumbnail.
user_product_id: User Product (UP) é um novo conceito dentro do Mercado Livre que tem como objetivo permitir ao vendedor a escolha de diferentes condições de venda para cada variante de um mesmo produto. Saiba mais sobre User Product.
user_product_name: nome do user product (UP).
family_id: id de família. Cada User Product pertence a uma família (family_id), e cada família agrupa vários UPs.
metrics: métricas do item ou campanha.
prints: quantidade de impressões (vezes em que o anúncio é exibido).
sov: porcentagem de vendas por publicidade sobre as vendas totais.
clicks: quantidade de vezes que os usuários do Mercado Livre clicaram nos seus anúncios promovidos de Product Ads.
ctr: taxa de cliques.
cost (Investimento): investimento da campanha. Soma do custo dos cliques que os anúncios promovidos de Product Ads receberam.
cpc: custo por clique.
acos: porcentagem de investimento em publicidade sobre a receita obtida. É a relação entre o que você investe na sua campanha e a receita que gera com ela.
Vendas sem publicidade: são as vendas das suas publicações promovidas que não foram geradas a partir de cliques nos seus anúncios.
- organic_units_quantity: quantidade de unidades vendidas sem publicidade.
- organic_units_amount: valor das vendas de pedidos orgânicos.
- organic_items_quantity: quantidade de vendas sem publicidade.
Vendas por publicidade: são vendas recebidas a partir de cliques nos seus anúncios. Cada produto diferente no carrinho conta como uma venda, independentemente da quantidade de unidades vendidas. Podem ser diretas ou indiretas.
- Vendas diretas: referem-se às compras realizadas por uma pessoa após clicar no anúncio.
- direct_items_quantity: quantidade de vendas diretas por publicidade.
- direct_units_quantity: quantidade de unidades vendidas em vendas diretas.
- direct_amount: soma do valor das vendas diretas obtidas do seu Product Ad, em moeda local.
- Vendas indiretas: ocorrem quando uma pessoa clica em um anúncio, mas compra outro dos seus produtos.
- indirect_items_quantity: quantidade de vendas indiretas por publicidade.
- indirect_units_quantity: quantidade de unidades vendidas em vendas assistidas.
- indirect_amount: soma do valor das vendas assistidas obtidas do seu Product Ad, em moeda local.
advertising_items_quantity: quantidade de vendas por publicidade.
cvr: taxa de conversão.
roas: retorno sobre o gasto publicitário.
units_quantity: quantidade total de vendas.
direct_amount: soma do valor das vendas diretas obtidas do seu Product Ad, em moeda local.
indirect_amount: soma do valor das vendas assistidas obtidas do seu Product Ad, em moeda local.
total_amount(Receita): soma do valor das vendas obtidas do seu Product Ad, em moeda local. São as receitas que você obtém por vendas diretas ou indiretas por meio dos anúncios promovidos de Product Ads.
impression_share (Impressões): porcentagem de vezes que os anúncios são exibidos considerando todas as vezes que podem ser mostrados.
Métricas de competitividade
Essas métricas são calculadas de acordo com o número de impressões (a quantidade de vezes que um anúncio é exibido). Indicam a participação da sua campanha de Product Ads nos espaços publicitários. Ou seja, permitem entender quantas impressões seus anúncios obtêm e quantas você poderia ter obtido em relação às oportunidades geradas em um determinado período.
top_impression_share(impressões ganhas): porcentagem de leilões ganhos nas primeiras posições da busca em relação à quantidade de leilões nos quais pôde participar. Por exemplo, se for 70, significa que a campanha ganhou 70% dos leilões possíveis. Ou seja, o anúncio foi exibido em 7 de cada 10 oportunidades.
lost_impression_share_by_budget (impressões perdidas por orçamento): porcentagem de vezes que os anúncios não são exibidos considerando todas as vezes que poderiam ser mostrados e que não ocorreu porque o orçamento diário é muito baixo. Essa porcentagem indicará se o orçamento da sua campanha é insuficiente para aproveitar todas as impressões disponíveis.
- Se a campanha estiver ativa com orçamento insuficiente, significa que não será considerada para participar de um leilão e, portanto, não poderá competir para ser exibida.
- Se a campanha estiver consumindo 100% do orçamento, é possível que seja gerada uma maior porcentagem de impressões perdidas. Por isso, é recomendável aumentar o orçamento da sua campanha para que essa porcentagem diminua.
lost_impression_share_by_ad_rank (impressões perdidas por ranking): porcentagem de vezes que os anúncios não são exibidos considerando todas as vezes que podem ser mostrados e que não ocorreu porque o seu ranking é mais baixo do que o de outros vendedores. Indica quantas vezes seus anúncios não foram exibidos por terem um ranking mais baixo do que o de outros vendedores.
Essa porcentagem ajuda a identificar se é necessário aumentar o ACOS objetivo da sua campanha. Assim, as ofertas com as quais você participa dos leilões serão mais competitivas e você aumentará sua possibilidade de vencê-los.
Essa métrica representa a quantidade de vezes que seus anúncios não foram impressos por não terem um ranking suficiente (boa qualidade e ACOS Objetivo alto), em relação à quantidade de vezes que poderiam ter sido impressos em todos os espaços publicitários. Essa situação ocorre quando um anúncio participa de um leilão porque a campanha tem orçamento suficiente, mas o anúncio não tem ranking suficiente para ser impresso.
Algumas recomendações para esses casos: aumentar o ACOS, ativar anúncios de melhor qualidade, adicionar à sua campanha anúncios que tenham um melhor nível de conversão e pausar os que você considerar que em certo tempo não geram os resultados que você busca.
acos_benchmark: o ACOS objetivo usado por anúncios com bons resultados em impressões e vendas.
picture_id: id de imagem do item a nível Mercado Livre.
acos_target: custo publicitário de vendas (ACOS) target utilizado por anúncios com bons resultados em impressões e vendas.
strategy: tipo de estratégia de campanha. Pode ser PROFITABILITY, INCREASE e VISIBILITY.
roas_target: Retorno sobre o investimento publicitário (ROAS Objetivo). É a receita gerada pela campanha/anúncio por cada unidade monetária investida em publicidade (receita atribuível / gasto publicitário). Deve ser maior ou igual a 1x e inferior ou igual a 35x.
Como interpreto a relação entre o ROAS que defino e meus resultados?
ROAS Objetivo baixo: Busca gerar mais vendas e ter maior alcance, mesmo que a rentabilidade por cada venda seja menor.