美客多广告管理调研

# 文档
```
https://developers.mercadolibre.com.ar/en_us/manage-promotion

https://developers.mercadolibre.com.ar/en_us/product-ads
```

# 待对接接口  -  广告
1、获取每日预算限制
每个用户都有最大和最小预算限制，创建的广告设置的预算必须在这个限制区间
```
GET https://api.mercadolibre.com/advertising/product_ads_2/budgets/limits?campaign_type=default
```

2、创建广告
```
POST https://api.mercadolibre.com/advertising/product_ads_2/campaigns
```

3、修改广告（预算和状态：开启/关闭）
```
PUT https://api.mercadolibre.com/advertising/product_ads_2/campaigns/$CAMPAIGN_ID
```

4、获取广告详情
```
GET https://api.mercadolibre.com/advertising/product_ads_2/campaigns/$CAMPAIGN_ID
```

5、按用户搜索广告
```
https://api.mercadolibre.com/advertising/product_ads_2/campaigns/search?user_id=$USER_ID
```

6、查询商品所在广告
```
https://api.mercadolibre.com/advertising/product_ads/ads/{item_id}
```

7、修改广告下商品状态
```
https://api.mercadolibre.com/advertising/product_ads/ads/$ITEM_ID
{
  "status": "paused" | "active"
}
```

# 待对接接口  -  促销活动
> 营销活动包含多种形式，以下是平台提供的一些促销活动。

![](/media/202308/2023-08-31_154550_1354820.7655772859414132.png)

> 促销活动有以下限制：

![](/media/202308/2023-08-31_152940_1856750.45910230659653584.png)

> 当然，除了平台的一些促销活动，客户也可以自己创建促销活动。

1、创建促销活动
```
POST https://api.mercadolibre.com/seller-promotions/promotions?app_version=v2
{
   "promotion_type": "SELLER_CAMPAIGN",
   "name": "test campana del seller",
   "sub_type": "FIXED_PERCENTAGE",
   "fixed_percentage": 15,
   "loyalty_percentage": 30,
   "start_date": "2023-07-17T00:00:00",
   "finish_date": "2023-07-20T00:00:00"
}
```

2、编辑促销活动
```
PUT https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTION_ID?app_version=v2
{
   "promotion_type": "SELLER_CAMPAIGN",
   "name": "new name 10",
   "sub_type": "FIXED_PERCENTAGE",
   "fixed_percentage": 18,
   "loyalty_percentage": 33,
   "start_date": "2023-07-18T00:00:00",
   "finish_date": "2023-07-19T00:00:00",
   "remove_loyalty": false
}
```

3、删除促销活动
```
DELETE https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTION_ID?promotion_type=SELLER_CAMPAIGN&app_version=v2
```

4、查看活动详情
```
GET https://api.mercadolibre.com/seller-promotions/promotions/C-MLB300?promotion_type=SELLER_CAMPAIGN&app_version=v2
```

5、查看活动中的商品
```
GET https://api.mercadolibre.com/seller-promotions/promotions/C-MLB300/items?promotion_type=SELLER_CAMPAIGN&app_version=v2
```

6、给活动添加商品
```
POST 
-d '{
    "promotion_id":"C-MLB302",
    "promotion_type":"SELLER_CAMPAIGN",
    "deal_price": 3500,
    "top_deal_price": 3000
 
  }'
  https://api.mercadolibre.com/seller-promotions/items/MLB3538191898?app_version=v2
```

7、删除活动中的商品
```
DELETE https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?promotion_type=$PROMOTION_TYPE&promotion_id=$PROMOTION&app_version=v2
```

8、促销活动列表
```
GET https://api.mercadolibre.com/seller-promotions/users/$USER_ID?app_version=v2
```