Bonificações para Product Ads

Tipos de bonificações

O programa de Bonificações de Product Ads contempla diferentes tipos de benefícios destinados a incentivar a adoção e o uso estratégico das soluções de publicidade dentro do ecossistema Mercado Livre.

Esses benefícios são aplicados de acordo com critérios específicos, como nível de reputação, volume de investimento, certificações, participação em programas de incentivo ou ações de negócio pontuais. Cada tipo de bonificação possui condições e regras próprias de elegibilidade.

Seguem os principais tipos de benefícios atualmente vigentes no programa:

• CERTIFICAÇÃO: Benefício concedido a usuários que se certificam na Ads Academy (Product Ads) e possuem contrato ativo de Product Ads. O valor definido para o benefício de certificação depende do site.
• SELLER STARTUP PROGRAM: Benefício destinado a apoiar novos vendedores que fazem parte do programa de despegue e contratam Product Ads.
• SMART BENEFITS: Benefício concedido a usuários que criam uma campanha durante uma temporada específica de publicidade e que sejam público-alvo da bonificação.
• MANUAL: Benefício concedido pela equipe de negócios.

Consultar bonificação

Este endpoint permite consultar as bonificações ativas ou inativas associadas a um anunciante específico. Através dessa chamada, é possível obter informações detalhadas sobre os benefícios aplicados a nível de conta e de campanha de Product Ads, incluindo o valor concedido, o saldo restante, o período de vigência e o status da campanha vinculada (quando aplicável).

Chamada:

curl -L -X GET 'https://api.mercadolibre.com/advertising/advertisers/bonifications' \
-H 'Authorization: Bearer $ACCESS_TOKEN'

Exemplo de resposta bonificação nível campanha:

{
  "bonification": [
    {
      "status": "ACTIVE",
      "creation_date": "2025-09-30T20:00:14Z",
      "end_date": "2025-10-10T16:00:04Z",
      "campaign_name": "Liquida 10.10",
      "currency_id": "BRL",
      "level": "Campaign",
      "amount": 10000,
      "balance": 10000,
      "days_remaining": 1,
      "campaign_id": 354548091,
      "campaign_status": "deleted",
      "benefit_name": "smart_benefit"
    }
  ]
}

Exemplo de resposta bonificação nível conta:

{
    "bonification": [
        {
            "status": "ACTIVE",
            "creation_date": "2025-10-30T04:00:00Z",
            "end_date": "2025-12-31T04:00:00Z",
            "currency_id": "BRL",
            "level": "Account",
            "amount": 10,
            "balance": 10,
            "days_remaining": 54,
            "campaign_id": 0,
            "benefit_name": "manual"
        }
    ]
}

Campos de resposta

Campo	Valores possíveis	Descrição
status	ACTIVE	Estado atual da bonificação
creation_date		Data de criação da bonificação
end_date		Data de finalização da bonificação
campaign_name		Nome da campanha associada à bonificação. Visível somente quando o benefício foi concedido em nível de campanha
currency_id	ARS BRL MXN UYU COP PEN USD CLP	Identificador da moeda utilizada na bonificação
level	Campaign Account	Define se foi atribuída por campanha ou por conta
amount		Valor total da bonificação
balance		Saldo atual da bonificação
campaign_id		Identificador único da campanha associada
campaign_status	Active Paused Finished Deleted	Estado atual da campanha associada. Visível somente quando o benefício foi concedido em nível de campanha
benefit_name	Certification Seller-startup-program Smart-benefit Manual	Tipo de bonificação

Resposta quando não há bonificações

Para o vendedor que não possui bonificações ativas ou históricas, a resposta será apenas um 200 - OK com o array bonification vazio.

{
  "bonification": []
}

Possíveis erros ao consultar bonificações

Access token inválido ou expirado:

{
    "status": 401,
    "error_code": "unauthorized",
    "display_message": "invalid access token"
}