Mercadolibre 广告看板交接

# Mercadolibre 广告看板业务文档

## 一、Mercadolibre 平台接口文档

> 本土广告：https://developers.mercadolibre.com.ar/en_us/product-ads 
>
> 原型图：https://40c0kq.axshare.com/#id=urgib1&p=mercadolibre____&g=1

## 二、业务线

Mercadolibre 广告看板页面只负责展示，其中涉及到的展示列表，需要用到的数据主要来源于三部分，具体如下：

- 商品详情
- 订单统计数据

- 商品广告指标

## 三、代码线

#### 涉及项目：

- mdc-oapi-product（入口程序）（广州）
- mdc-mercadolibre-product（mercadolibre广告核心程序）（广州）
- mdc-open-api-product （香港）
- mps-mercadolibre-product (香港)

### 广告活动涉及到的表：

- db_mercadolibre_campaign（活动表 暂时没用到）
- db_mercadolibre_campaign_product（活动商品表）
- db_mercadolibre_campaign_product_ad_metrics（活动商品指标表）
- db_mercadolibre_campaign_product_variation（活动商品变体表）
- db_sync_shop_campaign（同步店铺活动表）

### 涉及到的大数据的表

- tb_platformsku_statistics_mercadolibre （大数据的订单表）

这个表在这个地方：

![image-20230823150256905](https://happysnail.oss-cn-beijing.aliyuncs.com/Mabang/image-20230823150256905.png)

## 四、流程

### 商品列表

这个是这个广告看板最主要的接口，流程大概如下:

- 校验云类型、校验店铺信息
- 根据前面传参，分页查询活动商品表的商品数据 db_mercadolibre_campaign_product 
- 查询活动商品变体数据 db_mercadolibre_campaign_product_variation
- 查询商品指标 db_mercadolibre_campaign_product_ad_metrics
- 查询订单数据，并把指标数据和清单数据做计算，具体每一个数据计算公式是什么样，原型图里面有写，而且代码里面有非常详细的注释  tb_platformsku_statistics_mercadolibre

### 其他接口

这里几个接口比较简单，以前用到只有前两个，后面两个是后门程序，实际没有使用到，给用户补数据用。

- 获取支持站点 
- 获取店铺信息
- 同步店铺指标 （后门程序）
- 手动同步店铺商品（后门程序）

## 注意

- 计算百分比的时候，要提前保留四位小数
- 即使金额要做好四舍五入，不能少一分钱