-
背景（谁？什么问题？有什么影响？为什么？）
UI图：https://www.figma.com/design/R8QFuJz7Qqvn7gxfdVxCs9/TikTok%E4%B8%93%E7%89%88?node-id=10646-2283&p=f&t=wKgWlwcSlgYYsKzt-0
-
需求（做什么？怎么做？有什么要注意的？）
-
新增GMV MAX广告页面
接口：https://business-api.tiktok.com/portal/docs?id=1822000968821762
|
系统字段
|
接口字段
|
备注
|
？提示详细描述
|
|
广告账户
|
advertiser_id
|
|
|
|
广告系列状态
|
operation_status
|
DISABLE：未启用。
ENABLE：启用。
FROZEN：冻结。冻结的推广系列不支持重新启用。
|
|
|
广告系列id
|
campaign_id
|
|
|
|
广告系列名称
|
campaign_name
|
|
|
|
店铺ID
|
store_id
|
|
|
|
店铺名称
|
显示账号授权中的账号别名
|
通过shopi id关联获取店铺别名
|
|
|
商务中心
|
store_authorized_bc_id
|
|
|
|
广告系列类型
|
shopping_ads_type
|
PRODUCT：商品 GMV Max 。
LIVE：直播 GMV Max。
|
|
|
推广商品维度
|
product_specific_type
|
ALL：所有商品
CUSTOMIZED_PRODUCTS：特定商品
UNSET：未设置
|
所有商品：允许 TikTok 从 TikTok Shop 所有商品中动态选择。
特定商品：选择 TikTok Shop 中自定义数量的特定商品。
未设置：未设置商品。
|
|
商品
|
item_group_ids
|
通过product id+店铺id关联显示商品名称、商品售价和可售数
|
|
|
优化目标
|
optimization_goal
|
总收入
|
|
|
出价策略
|
deep_bid_type
|
最低 ROAS。在有 ROI 目标的条件下出价
|
|
|
ROI 目标
|
roas_bid
|
|
|
|
每日预算
|
budget
|
|
|
|
排期类型
|
schedule_type
|
SCHEDULE_FROM_NOW：在排定的开始时间之后持续投放推广系列。
SCHEDULE_START_END:在排定的开始时间和结束时间之间投放推广系列。
|
|
|
排期时间-起始
|
schedule_start_time
|
按照schedule_type 显示排期时间。
当schedule_type 为SCHEDULE_FROM_NOW则显示起始时间+持续投放标识
当schedule_type 为SCHEDULE_START_END则显示起始时间+结束时间
|
|
|
排期时间-结束
|
schedule_end_time
|
|
|
|
广告地区
|
location_ids
|
枚举值：https://business-api.tiktok.com/portal/docs?id=1739311040498689
|
|
|
广告年龄对象
|
age_groups
|
年龄枚举值：https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-%E5%8F%97%E4%BC%97%E5%B9%B4%E9%BE%84%E5%8C%BA%E9%97%B4
|
|
|
视频选择模式
|
product_video_specific_type
|
AUTO_SELECTION：自动选择视频。
CUSTOM_SELECTION：手动选择视频。
UNSET：未设置。
|
|
|
达人授权视频
|
item_list
.item_id
|
将id拼接到链接中https://www.tiktok.com/@elcapitano3/video/7420534389043399979?shop_region=US
|
与该 GMV Max 推广系列绑定的已授权 TikTok 作品（即 TikTok 帖子）。已授权的作品代表来自您的 TikTok 账号或通过视频代码授权您使用，能够充分展示你所选商品的现有作品。视频ID，需要将此视频id转化为可以点击的视频链接
|
|
达人授权视频-视频描述
|
item_list
.text
|
作为视频名称显示在列表中
|
|
|
达人授权视频-视频关联商品
|
item_list
.spu_id_list
|
仅保存
|
|
|
自定义视频
|
custom_anchor_video_list.item_id
|
将id拼接到链接中https://www.tiktok.com/@elcapitano3/video/7420534389043399979?shop_region=US
|
与该 GMV Max 推广系列绑定的自定义 TikTok 作品（即 TikTok 帖 子）。自定义的作品代表带有自定义商品链接的作品。
|
|
自定义视频-视频描述
|
custom_anchor_video_list.text
|
作为视频名称显示在列表中
|
|
|
自定义视频-视频关联商品
|
custom_anchor_video_list.spu_id_list
|
仅保存
|
|
2.操作
（1）启动/关闭/删除
接口：https://business-api.tiktok.com/portal/docs?id=1739320994354178
此接口和广告推广中的广告系列的启动/关闭/删除功能是一样，所以对应接口调用和交互方式和广告系列中的方式保持一致。
（2）编辑ROI。弹窗如下，调用接口编辑roas_bid。
接口：https://business-api.tiktok.com/portal/docs?id=1822001009002497
编辑成功则弹出toast提示：编辑成功。
编辑失败则弹出toast提示：编辑失败。“平台返回的失败原因”
（3）编辑预算。弹窗如下，调用接口编辑budget。
接口：https://business-api.tiktok.com/portal/docs?id=1822001009002497
编辑成功则弹出toast提示：编辑成功。
编辑失败则弹出toast提示：编辑失败。“平台返回的失败原因”
3.筛选项：
（1）广告主账号：筛选项支持多选筛选。并且支持搜索广告主账号别名
（2）广告账户：筛选项支持多选筛选。并且支持搜索广告账户名称或广告账户ID
（3）店铺：筛选项支持多选筛选。并且支持搜索店铺名称
（4）商务中心：支持商务中心id模糊搜索
（5）广告系列名称：支持广告系列名称模糊搜索
（6）广告系列id：支持广告系列id模糊搜索
（7）操作状态：枚举值：开启/关闭/冻结。支持多选搜索