TikTok > 广告推广
共 40 条需求，按创建时间倒序。产品经理：陈家宜
当前最新逻辑
（待人工总结：以最新一条已完成需求的描述为准）
需求历史
2025-06-09 ｜ 已完成 ｜ ECERPH-28988
标题：Tiktok项目》GMV MAX广告页面新增【创建广告】的功能
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-订单模块 ｜ 迭代：20250715-常规-7月第三迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
平台插件对接说明：https://bytedance.us.larkoffice.com/docx/X5DMdC9Z4oFe8NxP94PuIchqs6e
插件测试使用的密钥
-
Partner name: ECCANG
-
Secret: 39f8f48ceb42acb95078e88d6504532a2af036bb
-
需求（做什么？怎么做？有什么要注意的？）
销售》GMV MAX广告
- GMV MAX广告上新增【创建广告】按钮，点击弹窗如下。
【图片】
（1）店铺为系统用户授权的所有店铺，仅支持单选。需要根据系统情况查询出店铺关联的广告账户id。
【图片】
①如果店铺关联广告账户的情况下，点击【去创建】则插件只提供shop_ids和adv_ids给插件，并且新开tab页面显示插件页面
②如果店铺关联不到广告账户的情况下，点击【去创建】
弹出如下的暂无广告账户的弹窗
【图片】
（1） 选择没有授权到系统，点击【确定】则跳转到“平台店铺授权页面”
（2）选择已经关联广告账户，点击【确定】则只提供shop_ids给插件，并且新开tab页面显示插件页面
（3）选择没有广告账户，点击【确定】则跳转到如下的创建广告的弹窗。
【图片】
点击确定的情况下按照以下内容提供给插件
传参说明：
| Data Field | Format | Required | Description | Example | 系统取值 |
| --- | --- | --- | --- | --- | --- |
| external_business_id | string | Yes | External identifier of the business in the merchant platform’s system. This ID is provided by the merchant platform as a URL parameter when the onboarding flow is started. | “12332155667” | 每个系统的客户代码 |
| business_platform | string | Yes | Business platform name. This field is provided by the merchant platform as a URL parameter when the onboarding flow is started. Make sure to always use the same value.
We will validate there is no business with the same external_business_id and business_platform combination.
Format: CAPITAL_LETTERS_AND_UNDERSCORES | “SHOPIFY” | 固定为Eccang |
| iat | number | Yes | Current time in Unix. Will be used by TikTok for session expiration.
Format: unix epoch time | 1257894000 | |
| store_name | string | No | The merchant store’s name | “Frank’s candy store” | 授权中店铺名称
【图片】 |
| country_region | string | No | The merchant's business registered country or region.
ISO-Alpha-2
It is important that this reflects the merchant's business-registered country. This enables TikTok to determine the merchant's eligibility for features and incentive programs. | “VN”
See the Appendix section for the list of countries we support today. | 根据【创建广告账户】内用户填写的内容。
国家的枚举值见国家和货币表格 |
| industry_id | string | No | Industry of the merchant’s store from the TikTok industry ontology. Please refer to the Appendix -> Industry ID Mapping section. | "292104" | 根据【创建广告账户】内用户填写的内容
行业的枚举值见类目 |
| timezone | string | No | The merchant's business registered country timezone. In GMT+/-hh:mm format.
GMT Time Zone Designations
Only support full hour (e.g. “GMT-07:00”), do not support half hour (e.g. “GMT-07:30”) for now.
It is important that this reflects the merchant's business-registered country. | “GMT-07:00” | 根据【创建广告账户】内用户填写的内容
见下时区表格 |
| phone_number | string | No | The merchant telephone number. Should be in the same country as merchant's business registered country. | | |
Merchant platform should make sure the phone number starts with ‘+’ symbol, and follow with the country code.
Format: country code concatenated with number. Country phone code
Recommended to use https://www.npmjs.com/package/libphonenumber-js
| It is important that this reflects the merchant's phone number for the business-registered country. | “+160471238123” |
| --- | --- |
| 根据【创建广告账户】内用户填写的内容 | |
| 枚举值见下区号表格 | |
| email | string |
| | No |
| | The merchant email address |
| | “email_123@example.com” |
| | 根据【创建广告账户】内用户填写的内容 |
| currency | string |
| | No |
| | The merchant store’s currency. ISO-4217 |
| | “EUR” |
| See the Appendix section for the list of currencies we support today. We also perform validation on country & currency combinations. See the Appendix section for more. | 根据【创建广告账户】内用户填写的内容 |
| website_urls | array[string] |
| | No |
| | The list of merchant's websites that they support. Please include the protocol (http or https). |
| | “https://www.store123.com” |
| | 根据【创建广告账户】内用户填写的内容 |
| version | string |
| | No |
| | Version for the tiktok business plugin. |
| Pass in “1.0” for the Business Plugin V1.0 version | “1.0” (You can use default value) |
| | 默认为1.0 |
| locale | string |
| | No |
| | The locale will determine the language that is displayed in the TiKTok Businss Plugin - if the value passed in with external data does not map to a supported locale value we will fall back to English |
| Please refer to the locale mapping section. | "en" |
| | 默认为“zh” |
| env | string |
| | No |
| | The "env" field can be used to differentiate between production, test, staging, or any additional testing environments if different redirect_uris are needed. |
| If this field is omitted from the payload, it will default to production. | "test" |
| shop_ids | array[string] |
| | No |
| | List of TikTok Shop IDs created through seller center |
| | ["123445"] |
| | 根据用户选择的店铺传值 |
| adv_ids | array[string] |
| | No |
| | List of Advertiser IDs merchant has already created |
| | ["562345"] |
| | 店铺能关联到广告账户在提供对应的广告账户id，如果不能的话则不提供 |
| 国家和货币
国家 | 国家 |
| | 货币 |
| VN | 越南 |
| | VND |
| USD | |
| KR | 韩国 |
| | KRW |
| USD | |
| AE | 阿拉伯联合酋长国 |
| | AED |
| USD | |
| EG | 埃及 |
| | EGP |
| USD | |
| SA | 沙特阿拉伯 |
| | SAR |
| USD | |
| TW | 中国台湾地区 |
| | TWD |
| USD | |
| RU | 俄罗斯 |
| | RUB |
| ID | 印度尼西亚 |
| | IDR |
| USD | |
| TH | 泰国 |
| | THB |
| USD | |
| MY | 马来西亚 |
| | MYR |
| USD | |
| JP | 日本 |
| | JPY |
| USD | |
| TR | 土耳其 |
| | TRY |
| USD | |
| IL | 以色列 |
| | USD |
| AU | 澳大利亚 |
| | AUD |
| USD | |
| US | 美国 |
| | USD |
| EUR | |
| GBP | |
| GB | 英国 |
| | GBP |
| EUR | |
| USD | |
| FR | 法国 |
| | EUR |
| USD | |
| GBP | |
| IT | 意大利 |
| | EUR |
| USD | |
| GBP | |
| ES | 西班牙 |
| | EUR |
| USD | |
| GBP | |
| SG | 新加坡 |
| | SGD |
| USD | |
| DE | 德国 |
| | EUR |
| USD | |
| GBP | |
| CA | 加拿大 |
| | CAD |
| USD | |
| CN | 中国 |
| | CNY |
| USD | |
| 行业类目
Industry name | Industry id |
| | industry name |
| | 行业名称 |
| Sports & Entertainment
体育与娱乐 | 292104 |
| | Musical Instruments |
| | 乐器 |
| 292103 | Stationary, Toys & Gifts |
| | 文具、玩具及礼品 |
| 292106 | Fitness |
| | 健身 |
| 292107 | Sporting Equipment |
| | 体育器材 |
| 292105 | Indoor Recreation |
| | 室内娱乐 |
| 292113 | Other |
| | 其他 |
| Education & Training
教育与培训 | 291002 |
| | Primary & Secondary Education |
| | 中小学教育 |
| 291003 | College Education |
| | 高等教育 |
| 291001 | Early Childhood Education |
| | 幼儿教育 |
| 291006 | Vocational Education |
| | 职业教育 |
| 291007 | Corporate Development |
| | 企业培训 |
| 291004 | Language Learning & Study Abroad |
| | 语言学习与留学 |
| 291005 | Interest & Hobby Training |
| | 兴趣与爱好培训 |
| 291008 | Other |
| | 其他 |
| 291009 | Special Needs Education |
| | 特殊需求教育 |
| Media & Content Creation
媒体与内容创作 | 292210 |
| | Other |
| | 其他 |
| 292205 | Books & Magazines |
| | 书籍与杂志 |
| 292204 | Audio & Video Production |
| | 音视频制作 |
| 292206 | News |
| | 新闻 |
| E-commerce
电子商务 | 290505 |
| | Medicine |
| | 医疗 |
| 290506 | Health & Personal Care |
| | 健康与个人护理 |
| 290216 | Pet Supplies |
| | 宠物用品 |
| 290210 | Cosmetics & Personal Care |
| | 化妆品与个人护理 |
| 291408 | Other |
| | 其他 |
| 290303 | Alcoholic Beverages |
| | 酒精饮料 |
| 290301 | Food & Snacks |
| | 食品与零食 |
| 290306 | Non-alcoholic Beverages |
| | 非酒精饮料 |
| 290405 | Watches |
| | 手表 |
| 290407 | Jewelry |
| | 珠宝 |
| 290401 | Clothing & Shoes |
| | 服装与鞋类 |
| 290403 | Glasses, Bags & Accessories |
| | 眼镜、箱包及配饰 |
| 290101 | Electrical Appliances |
| | 家用电器 |
| 290108 | 3C (Computers, Communications & Consumer) |
| | 3C（计算机、通信及消费电子） |
| 290904 | Furniture |
| | 家具 |
| 290905 | Home Decor & Accessories |
| | 家居装饰与配件 |
| Other
其他 | 291903 |
| | Electrical |
| | 电工器材 |
| 291905 | Other |
| | 其他 |
| 292001 | General Mechanical Equipment |
| | 通用机械设备 |
| 291202 | Nonprofit & NGOs |
| | 非营利组织与 NGO |
| Games
游戏 | 291310 |
| | Parent & Child Games |
| | 亲子游戏 |
| 291311 | Adventure Games |
| | 冒险游戏 |
| 291309 | Other |
| | 其他 |
| 291308 | Multiplayer Online Games |
| | 多人在线游戏 |
| 291301 | Casual Games |
| | 休闲游戏 |
| 291303 | RPGs (Roleplaying Games) |
| | 角色扮演游戏（RPG） |
| 291302 | Tabletop Games |
| | 桌游 |
| 291305 | Racing & Sports Games |
| | 竞速与体育游戏 |
| 291304 | Action & Shooting Games |
| | 动作与射击游戏 |
| 291307 | Strategy Games |
| | 策略游戏 |
| 291306 | Simulation Games |
| | 模拟经营游戏 |
| Services
服务行业 | 291102 |
| | Hospitality |
| | 酒店与住宿 |
| 290614 | Others |
| | 其他 |
| 290608 | Design |
| | 设计 |
| 290606 | Advertising & PR services |
| | 广告与公关服务 |
| 290605 | Consulting Services |
| | 咨询服务 |
| 290603 | Packaging & Printing |
| | 包装与印刷 |
| 290602 | Publishing |
| | 出版 |
| 290601 | Safety & Security Services |
| | 安全与安防服务 |
| 292701 | Catering Services |
| | 餐饮服务 |
| 290706 | Beauty Services |
| | 美容服务 |
| 290705 | Photography |
| | 摄影 |
| 291706 | Agriculture, Forestry, Fishing & Hunting |
| | 农业、林业、渔业与狩猎 |
| 290803 | Property Management |
| | 物业管理 |
| 290802 | Real Estate & Rental |
| | 房地产与租赁 |
| 291604 | Automotive Services |
| | 汽车服务 |
| 291104 | Travel Agencies |
| | 旅行社 |
| Offline Retail
线下零售 | 290501 |
| | Health & Personal Care |
| | 健康与个人护理 |
| 290502 | Medicine |
| | 医疗 |
| 290910 | Furniture |
| | 家具 |
| 290211 | Cosmetics & Personal Care |
| | 化妆品与个人护理 |
| 291805 | Other |
| | 其他 |
| 290206 | Pet Supplies |
| | 宠物用品 |
| 290302 | Alcoholic Beverages |
| | 酒精饮料 |
| 290305 | Food & Snacks |
| | 食品与零食 |
| 290312 | Non-alcoholic Beverages |
| | 非酒精饮料 |
| 290408 | Jewelry |
| | 珠宝 |
| 290404 | Glasses, Bags & Accessories |
| | 眼镜、箱包及配饰 |
| 290406 | Watches |
| | 手表 |
| 290402 | Clothing & Shoes |
| | 服装与鞋类 |
| 290102 | Electrical Appliances |
| | 家用电器 |
| 290109 | 3C (Computers, Communications & Consumer) |
| | 3C（计算机、通信及消费电子） |
| 290901 | Home Decor & Accessories |
| | 家居装饰与配件 |
| Utility Software
实用软件 | 292802 |
| | Multimedia Processing |
| | 多媒体处理 |
| 292804 | Utility Tools |
| | 实用工具 |
| 292803 | Social Media & Instant Messaging |
| | 社交媒体与即时通讯 |
| 292801 | Software Tools |
| | 软件工具 |
| 292805 | Other |
| | 其他 |
| 时区：
时区 | |
| GMT-12:00 | |
| GMT-11:00 | |
| GMT-10:00 | |
| GMT-09:00 | |
| GMT-08:00 | |
| GMT-07:00 | |
| GMT-06:00 | |
| GMT-05:00 | |
| GMT-04:00 | |
| GMT-03:00 | |
| GMT-02:00 | |
| GMT-01:00 | |
| GMT±00:00 | |
| GMT+01:00 | |
| GMT+02:00 | |
| GMT+03:00 | |
| GMT+04:00 | |
| GMT+05:00 | |
| GMT+06:00 | |
| GMT+07:00 | |
| GMT+08:00 | |
| GMT+09:00 | |
| GMT+10:00 | |
| GMT+11:00 | |
| GMT+12:00 | |
| GMT+13:00 | |
| GMT+14:00 | |
| 电话区号
国家/地区 | 国际电话区号 |
| 越南 (VN) | +84 |
| 韩国 (KR) | +82 |
| 阿拉伯联合酋长国 (AE) | +971 |
| 埃及 (EG) | +20 |
| 沙特阿拉伯 (SA) | +966 |
| 中国台湾地区 (TW) | +886 |
| 俄罗斯 (RU) | +7 |
| 印度尼西亚 (ID) | +62 |
| 泰国 (TH) | +66 |
| 马来西亚 (MY) | +60 |
| 日本 (JP) | +81 |
| 土耳其 (TR) | +90 |
| 以色列 (IL) | +972 |
| 澳大利亚 (AU) | +61 |
| 美国 (US) | +1 |
| 英国 (GB) | +44 |
| 法国 (FR) | +33 |
| 意大利 (IT) | +39 |
| 西班牙 (ES) | +34 |
| 新加坡 (SG) | +65 |
| 德国 (DE) | +49 |
| 加拿大 (CA) | +1 |
| 中国 (CN) | +86 |
2025-03-17 ｜ 已完成 ｜ ECERPH-24736
标题：Tiktok》GMV MAX广告的报错提示说明
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
如果出现提示[40002]Shop must belong to a Business Center account 的时候需要在后续跟上以下提示：
授权到系统的账户缺失编辑权限，请在商务中心中为授权到系统的账号设置以下权限：
-
将 TikTok Shop 添加到商务中心。
-
确保授权到系统的账号具有商务中心的管理员权限。
-
确保授权到系统的账号 具有想要用于创建 GMV Max 推广系列的 TikTok Shop 的访问权限。
-
确保授权到系统的账号具有想要用于创建 GMV Max 推广系列的广告账户的操作员或管理员权限。
2025-03-14 ｜ 已完成 ｜ ECERPH-24655
标题：Tiktok》GMV MAX新增详情弹窗（预估 7 月开发）
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20250731-紧急-7月紧急迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
- 需求（做什么？怎么做？有什么要注意的？）
销售》GMV MAX
1GMV MAX的广告系列名称前同广告推广中广告系列名称一样新增显示一个折线图标识。 【图片】 2.点击折线图出现侧边弹窗如下： （1）总览，显示选择时间端内的广告系列每日的指标数据。 显示以下指标：总消耗、净消耗、总收入、平均下单成本、订单数、ROI. 鼠标悬停的提示同列表上对应字段的提示是一样的， 时间默认选中最近7天，切换tab的时候时间组件区间是统一的。 【图片】
(2)商品，显示选择时间端内的广告系列下商品的指标数据。如果推广商品维度为所有商品的情况下则无商品，无需显示商品指标。
点击操作：查看创意 则跳转到创意tab页面，然后填入商品id筛选出对应商品的创意视频。
| 指标字段 | 系统字段 | 取值方式 | ？提示 | 总计 |
| --- | --- | --- | --- | --- |
| product_name | 商品名称 | | | |
| item_group_id | 商品product id | | | |
| product_image_url | 商品图片 URL | | | |
| product_status | 商品状态 | | | |
| bid_type | 优化模式 | 枚举值：
- CUSTOM：目标 ROI
- NO_BID：最大投放量。 | | |
| orders | 订单数 | | 广告系列排期期间完成的此商品的各 SKU 付费和自然订单的数量，不含通过直播创建的 SKU 订单。 | 求和 |
| gross_revenue | 总收入 | | 广告系列排期期间的 TikTok Shop 付费和自然订单的总收入（不含直播订单）。通过用户付款金额加上 TikTok Shop 平台为这些用户提供的所有商品补贴计算得出。 | 求和 |
| cost | 总消耗 | | | 求和 |
| cost_per_order | 平均下单成本 | | | 总消耗/订单数 |
| roi | ROI | | | 总收入/总消耗 |
| （3）创意，显示时间段内广告系列中所有创意视频的指标数据。
指标字段 | 系统字段 | 取值方式 | ？提示 | 总计 |
| title | 创意名称 | 如果shop_content_type 为 PRODUCT_CARD 时创意名称统一为商品卡。否则的话则显示对应的创意名称 | | |
| item_id | 创意 ID | 如果shop_content_type 为 PRODUCT_CARD 时不显示id。否则的话则显示创建ID | | |
| tt_account_name | TikTok 账号名称 | | | |
| tt_account_profile_image_url | TikTok 账号头像图片 URL | | | |
| tt_account_authorization_type | 授权类型 | 枚举值: | | |
-
TTS_TT: TikTok Shop 官方账号。
-
AFFILIATE: 联盟批量授权。
-
TT_USER: 企业号。
-
BC_AUTH_TT: 商务中心。
-
AUTH_CODE: 视频代码。 | - UNSET: N/A。 | | | | | --- | --- | --- | --- | | shop_content_type | 店铺内容类型 | 枚举值:
- VIDEO: 视频。
- PRODUCT_CARD: 商品卡片。 | | | | | orders | 订单数 | | | | 广告系列排期期间完成的各 SKU 付费和自然订单的数量，不含通过直播创建的 SKU 订单。 | 求和 | | | gross_revenue | 总收入 | | | | 广告系列排期期间的 TikTok Shop 付费和自然订单的总收入（不含直播订单），通过用户付款金额加上 TikTok Shop 平台为这些用户提供的所有商品补贴计算得出。 | 求和 | | | product_impressions | 商品广告曝光数 | | 在商品 GMV Max 广告系列排期期间，此视频中所选商品通过付费和自然流量获得的总曝光数，不包括直播商品曝光数。 | | | 求和 | product_clicks | 商品广告点击数 | | | | 在商品 GMV Max 广告系列排期期间，此视频中所选商品通过付费和自然流量获得的总点击数，不包括直播商品点击数。 | 求和 | | | product_click_rate | 商品广告点击率 | | | | 在商品 GMV Max 广告系列排期期间，此视频中所选商品通过付费和自然流量获得的点击率（不包含直播点击），计算方法是商品总点击数除以商品总曝光数。 | 商品广告点击数/商品广告曝光数 | | | ad_click_rate | 广告点击率 | | 在商品 GMV Max 广告系列排期期间，此视频中所选商品通过付费流量所获曝光数（不包含付费直播曝光）的点击率，计算方法是总点击数除以总曝光数。 | | | 商品广告点击数/商品广告曝光数 | ad_conversion_rate | 广告转化率 | | | | 在商品 GMV Max 广告系列排期期间，此视频中所选商品通过付费流量所获点击（不包含付费直播点击）的转化率，计算方法是总转化数除以总点击数。 | 订单数/商品广告点击数 | | | ad_video_view_rate_2s | 2 秒广告视频播放率 | | | | 在广告系列排期期间，所选商品的视频播放至少 2 秒的次数占比，计算方法是 2 秒视频播放量除以总视频播放量。每次视频播放均单独计数，且重复播放不纳入统计。 | | | | ad_video_view_rate_6s | 6 秒广告视频播放率 | | 在广告系列排期期间，所选商品的视频播放至少 6 秒的次数占比，计算方法是 6 秒视频播放量除以总视频播放量。每次视频播放均单独计数，且重复播放不纳入统计。 | | | | ad_video_view_rate_p25 | 25% 广告视频播放率 | | | | 在广告系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 25% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。 | | | | ad_video_view_rate_p50 | 50% 广告视频播放率 | | | | 在广告系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 50% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。 | | | | ad_video_view_rate_p75 | 75% 广告视频播放率 | | 在广告系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 75% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。 | | | | ad_video_view_rate_p100 | 100% 广告视频播放率 | | | | 在广告系列排期期间，所选商品的视频在付费流量促成的播放中至少播放总时长 100% 的次数占比。每次视频播放均单独计数，且重复播放不纳入统计。 | |
①筛选项 product ID/商品名称/视频ID/视频名称/Tiktok账号名称 支持模糊搜索
3.导出 导出弹窗调整如下： 【图片】 勾选不同维度则导出不同维度的csv文件，每个维度一份CSV文件，此导出功能需要对接导出中心 （1）广告系列维度导出内容同现在已经实现的导出内容保持一致。 导出文件名称：GMV MAX广告（广告系列）-20250308
（2）商品维度导出数据字段如下：
导出文件名称：GMV MAX广告（商品）-20250308
| 字段 | 备注 |
| --- | --- |
| 广告系列ID | |
| 广告系列名称 | |
| 广告账户 | |
| 店铺 | |
| Product ID | |
| 商品名称 | |
| 订单数 | |
| 总收入 | |
| 总消耗 | |
| 平均下单成本 | |
| ROI | |
| 币种 | 取值广告账户的币种 |
| （3）广告创意导出维度
字段 | 备注 |
| 广告系列ID | |
| 广告系列名称 | |
| 广告账户 | |
| 店铺 | |
| Product ID | |
| 商品名称 | |
| 视频ID | |
| 视频名称 | |
| 创意类型 | 视频/商品卡 |
| Tiktok账号 | |
| 订单数 | |
| 总收入 | |
| 商品广告曝光数 | |
| 商品广告点击数 | |
| 商品广告点击率 | |
| 广告点击率 | |
| 广告转化率 | |
| 2 秒广告视频播放率 | |
| 6 秒广告视频播放率 | |
| 25% 广告视频播放率 | |
| 50% 广告视频播放率 | |
| 75% 广告视频播放率 | |
| 100% 广告视频播放率 | |
| 币种 | 广告账户的币种 |
2025-03-13 ｜ 已完成 ｜ ECERPH-24553
标题：Tiktok》销售统计新增GMV面板
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
商品表现和店铺表现内的原订单金额的面板调整名称为GMV。并且？提示调整为：参考Tiktok店铺后台Analytics的GMV进行统计。GMV：所选期间内订单的商品实际销售金额加上运费，但不包括税费和其他杂费。
【图片】
2.商品表现和店铺表现都新增一个面板叫订单金额。取值时间端内所有订单的实际支付金额。？提示为：所选期间内订单的实际支持金额之和，包含税费和其他杂费，统计的订单中包括退款和取消订单。
3.【设置统计】中调整为默认选中新增的订单金额面板，GMV面板调整为默认不勾选项
2025-03-10 ｜ 已完成 ｜ ECERPH-24371
标题：tiktok广告》GMV MAX新增广告状态字段
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
1.GMV MAX新增状态字段，样式同广告推广的样式。 【图片】 | 主要状态项目 | TikTok广告管理平台上的对应状态 | 次要状态枚举值 | | --- | --- | --- | | （推广系列体系） | TikTok广告管理平台上的对应状态 | | | STATUS_ALL | / | 所有推广系列二级状态 | | | / | | | STATUS_NOT_DELETE | / | 其次CAMPAIGN_STATUS_DELETE的推广系列二级状态 | | | / | | | STATUS_DELETE | 已删除 | CAMPAIGN_STATUS_DELETE | | | 广告系列已删除 | | | STATUS_NOT_DELIVERY | 未投放 | CAMPAIGN_STATUS_TTS_TT_ASSET_UNAVAILABLE | | | 资产不可用 | | | STATUS_NOT_DELIVERY | 未投放 | CAMPAIGN_STATUS_TTS_TT_IDENTITY_UNAVAILABLE | | | TikTok 账号不可用 | | | STATUS_NOT_DELIVERY | 未投放 | CAMPAIGN_STATUS_TIKTOK_SHOP_UNAVAILABLE | | | TikTok 店铺不可用 | | | STATUS_NOT_DELIVERY | 未投放 | CAMPAIGN_STATUS_REVIEW_DISAPPROVED | | | 否决 | | | STATUS_NOT_DELIVERY | 未投放 | CAMPAIGN_STATUS_AD_UNAVAILABLE | | | 无可用广告 | | | STATUS_NOT_DELIVERY | 未投放 | CAMPAIGN_STATUS_PRODUCT_UNAVAILABLE | | | 商品不可用 | | | STATUS_NOT_DELIVERY | 未投放 | CAMPAIGN_STATUS_ADVERTISER_AUDIT_DENY | | | 主账号未通过审核 | | | STATUS_NOT_DELIVERY | 未投放 | CAMPAIGN_STATUS_ADVERTISER_AUDIT | | | 广告主账号审核中 | | | STATUS_NOT_DELIVERY | 未投放 | ADVERTISER_CONTRACT_PENDING | | | 合同未生效 | | | STATUS_NOT_DELIVERY | 未投放 | ADVERTISER_ACCOUNT_PUNISH | | | 竞价排名被取消 | | | STATUS_NOT_DELIVERY | 未投放 | CAMPAIGN_STATUS_BUDGET_EXCEED | | | 广告系列扩展计划 | | | STATUS_NOT_DELIVERY | 未投放 | CAMPAIGN_STATUS_IDENTITY_USED_BY_GMV_MAX_AD | | | 被其他GMV MAX占用 | | | STATUS_DISABLE | 已暂停 | CAMPAIGN_STATUS_DISABLE | | | 广告系列已暂停 | | | STATUS_DISABLE | 已暂停 | CAMPAIGN_STATUS_LIVE_GMV_MAX_AUTHORIZATION_CANCEL | | | TikTok 账号已授权给另外广告账户 | | | STATUS_DISABLE | 已暂停 | CAMPAIGN_STATUS_PRODUCT_GMV_MAX_AUTHORIZATION_CANCEL | | | TikTok 商店限已授权给另外广告账户 | | | STATUS_DISABLE | 已暂停 | CAMPAIGN_STATUS_IDENTITY_USED_BY_LIVE_GMV_MAX | | | 由于存在使用此 TikTok 账号创建的Live GMV Max 的投放中广告计划 | | | STATUS_DISABLE | 已暂停 | CAMPAIGN_STATUS_PRODUCT_USED_BY_PRODUCT_GMV_MAX | | | 由于存在为此商店创建的Product GMV Max 的投放中广告计划 | | | STATUS_DISABLE | 已暂停 | CAMPAIGN_STATUS_AWAITING_RELEASE | | | 等待释放 | | | STATUS_DELIVERY_OK | 投放中 | CAMPAIGN_STATUS_ENABLE | | | 投放中 | |
2.拉取GMV MAX广告系列的时候只拉取投放中的广告系列。
3.新增店铺的筛选项。支持多选筛选。 【图片】
4.店铺字段，支持显示店铺id和店铺名称 如果系统没有关联授权的店铺，则仅显示店铺ID，店铺名称显示为空 【图片】
5.自定义视频中的视频描述前缀去掉 【图片】
6.框选中这几个字段增加排序功能 【图片】
7.操作状态默认选中开启
8.去掉截图中框选的文字 【图片】
2025-03-04 ｜ 已完成 ｜ ECERPH-24098
标题：灵帆小程序》新增GMV MAX广告数据管理页面
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
小程序广告页面新增tab切换选项：TikTok for Business/GMV MAX。默认为TikTok for Business。选中为TikTok for Business的时候则显示原有的广告页面，选中GMV MAX则显示本次新增的GMV MAX页面
【图片】
2.新增GMV MAX列表页面如下： 【图片】 （1）筛选项： ①广告账户：显示所有广告账户支持多选 ②店铺：显示所有店铺支持多选。 ③币种：USD/RMB 默认为USD ④时间：默认选中今天。
（2）实时概览，根据选择时间/广告账户/店铺显示以下数据指标。 【图片】
(3)广告表现 ①支持以下筛选下： 操作状态：开启/关闭/全部。默认显示开启状态的广告系列 排序：总收入/总消耗/ROI/平均下单成本。默认按照总收入排序
②广告系列列表 显示以下字段：广告系列、店铺、ROI、总收入、总消耗、订单数、平均下单成本 净消耗
3.新增GMV MAX广告系列详情页面： 【图片】
（1）筛选：时间，需要将列表页选中的时间带入详情页 （2）显示字段： 广告系列名称 操作状态 每日预算 排期 总收入 总消耗 净消耗 ROI 平均下单成本 订单数 （3）操作 ①开启/关闭广告系列 【图片】 ②编辑ROI 【图片】 ③编辑预算 【图片】
2025-03-03 ｜ 已完成 ｜ ECERPH-24018
标题：Tiktok》GMV Max广告新增获取指标结果
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
- 需求（做什么？怎么做？有什么要注意的？）
中台需求：https://devops.aliyun.com/projex/req/ECERPJ-6913# 《中台》对接GMV MAX报表接口》
- 新增指标字段
| 系统字段 | 接口字段 | ？提示 | 总计 |
| --- | --- | --- | --- |
| 总消耗 | cost | 在广告系列排期内您已在广告上花费的预估总金额。 | 求和 |
| 净消耗 | net_cost | 不包含广告赠款和优惠券的广告消耗（总成本）。 | 求和 |
| 总收入 | gross_revenue | 归因于推广系列的 TikTok Shop 订单的总收入。包括用户支付的金额加上 TikTok Shop 平台向用户提供的所有补贴。 | 求和 |
| 平均下单成本 | cost_per_order | 每次下单所产生的平均成本。计算方法是广告总消耗（总成本）除以推广系列排期内的订单数。（广告消耗/订单数） | 总消耗/订单数 |
| 订单数 | orders | GMV Max 推广系列期间完成的各 SKU 订单的数量。 | 求和 |
| ROI | roi | 归因于推广系列的所有 TikTok Shop 订单的总投资回报率 （ROI） | 总收入/总消耗 |
| 2.自定义列中需要新增以上指标
3.新增导出功能
导出的字段如下
表头 | 备注 | 广告账户 | | | 广告系列状态 | | 广告系列id | | | 广告系列名称 | | 店铺ID | | | 店铺名称 | | 商务中心 | | | 广告系列类型 | | 推广商品维度 | | | 商品 | 显示多个商品的product id并且用，隔开 | 优化目标 | | | 出价策略 | | ROI 目标 | | | 每日预算 | | 排期类型 | | | 排期时间-起始 | | 排期时间-结束 | | | 广告地区 | | 广告年龄对象 | | | 视频选择模式 | | 达人授权视频 | 显示视频id，多个视频id的话则用，隔开 | | 自定义视频 | 显示视频id，多个视频id的话则用，隔开 | 总消耗 | | | 净消耗 | | 总收入 | | | 平均下单成本 | | 订单数 | | | ROI | | | | 4.GMV MAX页面如果为空则需要同广告推广页面一样判断当前用户是否授权或者是否设置广告账户的可见权限。 广告推广页面对应需求如下 https://devops.aliyun.com/projex/req/ECERPH-20592# 《Tiktok广告》广告推广页面新增授权引导提示》
5.新增时间筛选，设置筛选项后以下字段会随着时间切换变化 | 时间默认选中近7天的时间。 | 系统字段 \ | --- \ | 总消耗 \ | 净消耗 \ | 总收入 \ | 平均下单成本 \ | 订单数 \ | ROI \ | | --- | --- | --- | --- | --- | --- | --- | --- | --- |
2025-02-20 ｜ 已完成 ｜ ECERPH-23565 🚀【0-1】
标题：Tiktok》新增GMV MAX广告
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 最后更新：2026-05-18
原始需求：01_原始需求\ECERPH-23565_Tiktok》新增GMV MAX广告\原始需求.md
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
新增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）操作状态：枚举值：开启/关闭/冻结。支持多选搜索
2025-02-19 ｜ 已完成 ｜ ECERPH-23471
标题：Tiktok》广告推广中心新增显示商务中心
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20250311-常规-3月第二迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
1.广告账户支持显示广告账号ID并且支持在广告账号内搜索广告账号id。 【图片】
2.在广告推广页面新增商务中心字段，显示商务中心的ID。自定义列也需要新增商务中心字段。 【图片】 【图片】
3.新增商务中心的输入框搜索项。 【图片】
2025-01-16 ｜ 已完成 ｜ ECERPH-22425
标题：Tiktok》tikto广告管理的页面新用户默认开启广告服务
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20250225-常规-2月第三迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
tikto广告管理的页面新用户默认开启广告服务
2024-12-26 ｜ 已完成 ｜ ECERPH-21573
标题：Tiktok广告》针对已暂停的广告也主动获取广告指标结果
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20241231-紧急-12月紧急迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
1.每天更新一次更新时间为最近7天的已完成、已关闭、已暂停状态的广告、广告组、广告系列 【图片】
2024-12-06 ｜ 已完成 ｜ ECERPH-20592
标题：Tiktok广告》广告推广页面新增授权引导提示
负责人：曾宪森 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20250114-常规-1月第二迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
销售》广告推广
- 如果用户已经开启广告服务但是还没有进行授权的时候则在页面顶部显示提示：目前还未有任何广告授权，请前往设置》平台店铺授权- Tiktok for Business平台进行广告授权，去授权>>。
如果客户已经有任意一个广告主账号授权则不显示以下提示。 【图片】 点击去授权则跳转到平台店铺授权页面。如果当前用户没有这个页面的权限则出现以下弹窗 【图片】
2.如果系统有广告账号授权，但是当前账户没有广告数据显示则提示:目前您还未有任何的广告账户的权限无法查看到广告数据，请让管理员在销售》广告权限中将您设置为对应广告账户的可见人员，去设置>> 如果当前用户已经有任意一个广告账户的可见权限的话，则无需显示这个提示。 【图片】 点击去设置，如果没有广告权限页面的权限则出现以下提示： 【图片】
3.以上的2个提示，优先显示第一个无广告授权的提示，在已有广告授权的情况下再显示第二个提示
2024-11-20 ｜ 已完成 ｜ ECERPH-19816
标题：Tikttok广告》新增广告权限页面控制广告账户数据权限
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
新增广告权限页面-广告成员
（1）广告成员列表
【图片】
| 系统字段 | 取值来源 | 接口字段 | 取值逻辑 | ？提示 |
| --- | --- | --- | --- | --- |
| 用户ID | https://business-api.tiktok.com/portal/docs?id=1739659558931458 | user_id | 同一个用户在不同商务中心下的邮箱和用户id是一样的，使用用户id作为唯一值判断， | |
| 名称 | https://business-api.tiktok.com/portal/docs?id=1739659558931458 | user_name | 需要按照广告账户的维度分别保存用户名称 | 一个用户在不同广告账户中的名称会不同，系统将随机取一个名称进行显示。 |
| 邮箱 | https://business-api.tiktok.com/portal/docs?id=1739659558931458 | user_email | | |
| 商务中心 | https://business-api.tiktok.com/portal/docs?id=1737115687501826 | bc_id | | |
| 广告账户 | https://business-api.tiktok.com/portal/docs?id=1739432717798401 | asset_id | ADMIN 管理员
OPERATOR 操作员
ANALYST 分析员 | |
| 角色 | https://business-api.tiktok.com/portal/docs?id=1739659558931458 | advertiser_role | | |
| 广告账户数量 | 系统统计 | | 统计一个用户id在多少个广告账户下存在 | |
| 映射人员 | | | 系统中映射的人员，一个用户id只能映射一个人员。映射成功后，此映射人员则具有此用户id关联的所有广告账户的数据查看权限 | |
（2）查看详情
①点击广告数量出现查看详情的侧弹窗
②点击操作栏下的查看详情按钮出现查看详情的侧弹窗
【图片】
（3）【映射人员】和【编辑映射】
编辑映射内的人员选项为系统内所有人员的下拉选项。仅支持单选。
设置映射成功后，此映射人员则具有此用户id关联的所有广告账户的数据查看权限
【图片】
（4）取消映射
取消映射则将原映射人员的关联此用户id的数据权限清空。
【图片】
（5）日志
| 操作人 | 操作场景 | 日志内容 | |
| --- | --- | --- | --- |
| 用户 | 设置映射 | 将映射人员设置为：XXX | |
| 用户 | 取消映射 | 取消XXX人员与用户ID的映射关系 | |
| 用户 | 导入映射 | 导入映射，将映射人员设置为：XXX | |
| 【图片】
（6）导入映射人员
【图片】
①模板列表
用户id | 邮箱 | 名称 | 映射人员 |
②导出模板，支持导出未映射人员的模板和所有人员的模板。
2.新增广告权限页面-广告账户 【图片】 （1）列表数据内容取值同广告成员 （2）分配人员 支持多选人员。 【图片】
（3） 导入分配人员 【图片】 导出模板内容 | 广告账户名称 | 可见人员 | | --- | --- |
（1）导入报表表头和模板表头不一致的时候提示：请使用和模板一样的表格进行导入。 （2）导入报表的时候如果广告账户名称在系统不存在则提示“第X行的广告账户在系统不存在请检查后再尝试” （3）导入报表的时候如果可见人员名称在系统不存在则提示：“可见人员名称：XXX、YYY、ZZZ在系统不存在，已跳过，请检查后再尝试”
（4）日志 | 操作人 | 操作场景 | 日志内容 | | --- | --- | --- | | 用户 | 分配人员 | 将可见人员设置为：XXX，YYY | | 用户 | 导入分配 | 导入可见人员为：XXX，YYY |
2024-11-18 ｜ 已完成 ｜ ECERPH-19637
标题：Tiktok》广告推广中的商品新增显示listing标题和店铺筛选项
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20241130-紧急-11月紧急迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
广告推广下的新增店铺的筛选项，系统授权店铺的枚举值的基础上增加一个无店铺的枚举值，用于筛选出没有关联店铺的广告组。
（此筛选项暂只支持在广告组维度下生效） 【图片】
2.广告下的商品弹窗新增一列名称，取值对应listing 的标题显示。 【图片】
2024-11-14 ｜ 开发中 ｜ ECERPH-19521
标题：Tiktok》广告推广页面币种增加原币种切换功能
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 最后更新：2026-05-18
需求描述：
（无描述）
2024-10-30 ｜ 已完成 ｜ ECERPH-18671
标题：Tiktok小程序》广告页面新增提示和调整组件
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-订单模块 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
新增未开启广告推广服务的页面。当用户未开启广告服务的时候出现以下页面提示。
【图片】
2.原有的无授权和无权限的页面的文案调整如下 【图片】 无授权： 无已授权的Tiktok广告账号，无数据展示.如果想要授权请在电脑端的易仓系统内的设置》平台店铺授权内找到Tiktok广告平台进行广告授权 无权限：无广告推广页面权限，请找管理员开通电脑端易仓系统内的销售》广告推广页面的页面权限
3.广告面板中所有的页面的广告账户组件调整为支持点击全部按钮可以全选所有广告账户，再次点击全选可以取消全选广告账户。 组件中增加【反选】按钮，支持用户反选广告账户 【图片】
4.其他非首页、销售实时概览、SKU销售统计页面上的站点筛选仅支持选择美国站点。
2024-10-17 ｜ 已完成 ｜ ECERPH-18110
标题：Tiktok广告》如果通过接口查询不到广告则认为此广告已被删除
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20241022-常规-10月第三迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
1.通过接口无法查询到对应广告信息则认为此广告已被删除，需要将状态调整为已删除 如果广告系列确定是已被删除则下层的广告组和广告也认为已被删除，状态更新为已删除
2024-09-27 ｜ 已完成 ｜ ECERPH-17307
标题：Tiktok广告》新增主账号权限和按钮权限控制
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20241022-常规-10月第三迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
新增广告主账号权限，根据账号中心设置的广告主账号权限控制可以查看的广告主账号数据。只有具有对应广告主账号权限的用户才能看到对应广告主账号的数据
-
新增按钮权限，控制【编辑预算】【编辑出价】【删除】【启动】【停止】按钮
【图片】 如果没有【编辑预算】按钮权限的情况下，不显示【编辑预算】按钮和单个编辑预算的icon 没有【编辑出价】按钮权限的情况同上。
只有同时具有【启动】/【停止】按钮权限的话才能显示每列的开关按钮。 【图片】
2024-09-27 ｜ 已完成 ｜ ECERPH-17311
标题：Tiktok广告》联动关闭和联动开启的逻辑调整
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20241008-常规-10月第一迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
联动关闭，如果上一层级被操作关闭了，则下一层机联动一起关闭。
例如广告系列被关闭了，则关联的广告组、广告也联动关闭
2.联动开启，如果上一层级被操作开启了，下一层级中操作状态为开启的广告组/广告也需要联动开启 例如广告组A操作状态为关闭、广告组B的操作状态为开启。 此时当这2个广告组上一层级的广告系列开启的情况下，广告组A还是维持状态为暂停中，广告组B则状态更新为投放中
2024-09-27 ｜ 已完成 ｜ ECERPH-17321
标题：Tiktok首页》新增广告推广页面的跳转链接
负责人：曾宪森 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20241008-常规-10月第一迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
【图片】
新增文案 销售》广告推广 查看多个账号的广告数据，支持批量操作编辑预算、出价、暂停广告。
销售》广告推广 hover变成蓝色，点击新开广告推广菜单的tab页面
2024-09-27 ｜ 已完成 ｜ ECERPH-17290
标题：Tiktok广告》禁用出价类型下的广告组不能编辑出价
负责人：曾宪森 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20241008-常规-10月第一迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
【图片】
-
需求（做什么？怎么做？有什么要注意的？）
-
自动出价的判断条件调整为当bid_type为bid_type_no_bid的情况下则为自动出价。
【图片】
2.自动出价的情况下不显示编辑按钮。 【图片】
3.当用户勾选自动出价的广告组进行编辑出价的时候如果勾选到了自动出价的广告组的时候，自动出价广告组的新出价输入框置灰，无法进行编辑，提交编辑的时候需要跳过自动出价的广告组 【图片】
2024-09-26 ｜ 已完成 ｜ ECERPH-17257
标题：Tiktok广告》广告详情页关闭样式调整并且在列表选择广告系列或者广告组的时候对应更新详情内数据
负责人：曾宪森 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20241008-常规-10月第一迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
取消广告详情页外层的遮罩，调整为使用广告详情页上新增的关闭按钮关闭详情页页面。
-
投放状态调整为放到标题的尾部
【图片】
3.列表上点击广告账户/广告系列/广告组/广告对应的查看数据的icon的时候可以查看到点击广告账户/广告系列/广告组/广告的详情内容
4.详情页时间选区默认选中最近3天的数据。列表排序默认按照时间降序进行排列 【图片】
2024-09-25 ｜ 已完成 ｜ ECERPH-17148
标题：Tiktok小程序》广告系列和广告组详情页新增开关和编辑预算/编辑出价的功能
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20240930-紧急-9月紧急迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
广告系列和广告组详情页新增开关控制是否开启广告系列和广告组
(1）显示按钮如下，固定悬浮在底部。 【图片】【图片】 （2）操作开关的时候出现提示：是否关闭广告系列/广告组 【图片】 ①加载中，显示loading弹窗 【图片】 ②操作成功：出现Tost提示：已开启/关闭广告系列。并且将开关按钮的状态调整为切换为对应的状态。 【图片】 ③操作失败：出现Toast：关闭/开启广告系列失败，请重试。
（2）点击编辑预算按钮出现如下的编辑预算的页面。此处的编辑预算指的是实时更新预算 【图片】【图片】 ①加载中，显示loading弹窗 【图片】 ②操作成功：编辑成功则返回对应的详情页并且显示获取最新的数据显示更新后的预算 ③操作失败：编辑失败则出现编辑结果页面，显示编辑失败的原因内容。编辑结果的页面点击返回则返回对应的编辑预算/编辑出价的页面 【图片】
(3)点击编辑出价的页面如下 【图片】 ①加载中，显示loading弹窗 【图片】 ②操作成功：编辑成功则返回对应的详情页并且显示获取最新的数据显示更新后的出价 ③操作失败：编辑失败则出现编辑结果页面，显示编辑失败的原因内容。编辑结果的页面点击返回则返回对应的编辑预算/编辑出价的页面 【图片】
2.广告账户、广告系列、广告组详情页上新增状态标识和状态筛选功能 （1）广告账户详情页面上新增广告系列和广告组的状态筛选条件，进入页面的时候默认筛选投放中的广告系列和广告组 【图片】 （2）广告系列详情页上新增广告组的状态筛选条件 【图片】 （3）在广告系列和广告组详情页上显示状态 【图片】 【图片】
2024-09-24 ｜ 已完成 ｜ ECERPH-17060
标题：Tiktok小程序》新增广告账户详情页
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20240930-紧急-9月紧急迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
【图片】
-
需求（做什么？怎么做？有什么要注意的？）
-
通过广告菜单页面中的广告账户名称可以点击进入对应的广告账户详情页
【图片】
2.广告账户详情页 【图片】 （1）指标面板同广告菜单页面上的实时概览一样支持设置自定义字段 【图片】 （2） 广告系列/广告组面板支持切换显示不同维度的广告信息。默认为广告系列。 ①切换到广告系列的时候显示投放中状态的广告系列 并且首列显示广告系列名称并且固定 ②切换到广告组的时候显示投放中状态的广告组 并且首列显示广告组名称并且固定 （3）支持按照总收入和总消耗进行排序显示。 （4）列表数据 广告系列数据同web端广告推广页面下的广告系列数据 广告组数据同web端广告组页面的广告组数据
2024-09-24 ｜ 已完成 ｜ ECERPH-17071
标题：Tiktok小程序》新增广告系列详情页和广告组详情页
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20240930-紧急-9月紧急迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
通过广告账户页面下的广告系列和广告组的列点击可以进入广告系列详情页和广告组详情页。
【图片】
2.广告系列详情页 【图片】 （1） 指标面板同广告菜单页面上的实时概览一样支持设置自定义字段 【图片】
（2）支持按照总收入和总消耗进行排序显示。 （4）列表数据 广告组数据同web端广告组页面的广告组数据 （5）点击广告组名称可以进入对应广告组的广告组详情页。
3.广告组详情页 【图片】 （1） 指标面板同广告菜单页面上的实时概览一样支持设置自定义字段 （2）支持按照总收入和总消耗进行排序显示。 （3）列表数据 广告组数据同web端广告组页面的广告组数据 （4）选择今天/昨天 仅一天的时间的时候显示当天按照小时维度的数据，如果有个时间段所有数据都为空则不显示对应时间段的数据。 如果选择是一个日期区间则显示的是这个日期区间内对应每天的数据，如果有个时间段所有数据都为空则不显示对应时间段的数据。
4.如果没有授权任何广告账号的情况下，点击广告则出现以下页面。 【图片】
2024-09-23 ｜ 开发中 ｜ ECERPH-16999
标题：Tiktok广告》广告的自定义列新增编辑的功能
负责人：曾宪森 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 最后更新：2026-05-18
需求描述：
（无描述）
2024-09-18 ｜ 已完成 ｜ ECERPH-16752 🚀【0-1】
标题：Tiktok小程序》新增广告模块（广告账户维度）
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20240930-紧急-9月紧急迭代 ｜ 最后更新：2026-05-18
原始需求：01_原始需求\ECERPH-16752_Tiktok小程序》新增广告模块（广告账户维度）\原始需求.md
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
新增广告页面。
【图片】 （1）筛选条件 ①广告账户的筛选项：默认选中全部广告账户。显示当前用户的所有广告账户，支持多选筛选查看。 ②时间筛选项：今天/昨天/近7天/近30天。默认选中今天，不区分时区，按照系统时间判断今天/昨天。 （2）实时概览 ①按照广告账户和时间的筛选项显示对应的广告账户的选中周期和上一周期的数据。 ②点击设置icon可以自定义显示的指标。 [1]默认选中显示总收入(商店)、付费数(商店)、ROAS(商店)、总消耗、CPM、CTR。 [2]没有选中任务指标点击确定的时候toast提示：请至少选择1项 [3]选中超过6项点击确定则toast提示：至多选择6项。 toast提示样式：https://mobile.ant.design/zh/components/toast [4]指标按钮长按可以调整位置，调整位置后，按照位置显示在页面上显示勾选的指标。 【图片】
2.广告表现 （1）广告表现的字段同web端自定义列中默认项的字段显示一样 【图片】 （2）默认按照总收入进行排序，支持切换为按照总消耗进行排序
2024-09-13 ｜ 已完成 ｜ ECERPH-16631
标题：Tiktok广告》新增单个编辑预算和出价的功能
负责人：曾宪森 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20240924-常规-9月第四迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
鼠标悬停在对应列的时候显示编辑的icon
【图片】
2.点击单个编辑预算的弹窗如下 （1）如果是广告系列或者未启用定死预算的情况下，显示的弹窗如下 【图片】 （2）如果广告组内开启的定时预算的情况下，则在弹窗内显示定时预算的说明，如下。 弹窗内显示定时预算预计生效时间和生效结果。同时显示【编辑】定时预算和【删除】定时预算的按钮。 ①点击【编辑】定时预算出现定时预算编辑弹窗 ②点击【删除】定时预算出现删除确认弹窗。点击确认后使用toast显示删除结果。 【图片】
3.点击编辑出价的弹窗如下，点击确定后 如果编辑成功，出现toast：编辑成功 如果编辑失败，出现toast：编辑失败，失败原因：平台返回的失败原因 【图片】
4.高亮绿色的 效果调整为使用这个颜色：#EBFFF4 【图片】
2024-09-12 ｜ 已完成 ｜ ECERPH-16527
标题：Tiktok广告》新增勾选广告则对应筛选下一层级关联信息的功能
负责人：曾宪森 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-订单模块 ｜ 迭代：20240918-常规-9月第三迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
1、广告账户勾选点击交互效果调整说明 （1）广告账户维度新增复选框 （2）勾选广告账户的等同筛选这个广告账户下的广告数据。 ①切换到下一层级则筛选出上一层级选中的数据的关联的数据。 ②如果多层都勾选的情况下，则按照广告账户-广告账户-广告组这个优先级，显示后续Tab名称 例如广告账户、广告系列都勾选了商品的情况下，广告组和广告的tab名称都显示为一个广告账户中的广告组、一个广告账户中的广告。 【图片】 交互效果如下 【图片】 ④已选筛选项点击关闭的情况下则等同于取消勾选项的筛选效果，如果最高层级的筛选被取消，则后续广告层级的筛选项选中也取消 【图片】
（3）广告账户、广告系列、广告组 支持点击，点击等同选中对应的广告账户并且进行筛选对应广告账户的数据同时切换到下一层级的广告系列上，此时tab名称调整为一个广告账户中的广告系列。 【图片】 交互效果如下 【图片】
（4）广告系列、广告组的勾选和点击效果同广告账户一样。
2.广告组下店铺的店铺ID和店铺名称的上下交换，并且颜色也进行交换。 【图片】
3.每次用户调整的列宽都需要保存到线上，刷新后列宽不变 【图片】
2024-09-12 ｜ 已完成 ｜ ECERPH-16546
标题：Tiktok广告》批量编辑预算、出价、状态的结果返回效果调整
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-订单模块 ｜ 迭代：20240930-紧急-9月紧急迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
广告组的【编辑预算】、【暂停】、【开启】、【删除】需要调整为每20个广告组请求一次，因为批量请求的接口一次只能请求20个。
https://business-api.tiktok.com/portal/docs?id=1739591716326402 【图片】
2.广告系列、广告组的【编辑预算】、【编辑出价】、【暂停】、【开启】、【删除】编辑成功/失败后的弹窗如下： 显示后端返回的结果信息以及失败原因 【图片】
2.广告账户tab页面也显示完整的筛选项。并且不要在切换到广告账户的重置去掉筛选投放中选项。
实际按照页面的筛选项的选中的内容进行筛选即可 【图片】
2024-09-11 ｜ 已完成 ｜ ECERPH-16489
标题：Tiktok广告》tiktok广告交互细节调整
负责人：曾宪森 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-订单模块 ｜ 迭代：20240918-常规-9月第三迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
https://alidocs.dingtalk.com/i/nodes/YQBnd5ExVEwxq91MuyQZ1oDZ8yeZqMmz?corpId=ding3b383d9e0957f8b7&utm_medium=im_card&iframeQuery=utm_medium%3Dim_card%26utm_source%3Dim&utm_scene=team_space&utm_source=im&cid=57728383585
| 模块 | 优先级 | 迭代点 | 参考 |
| --- | --- | --- | --- |
| 广告系列 | 低 | 左侧红色框框需要拉宽点，太紧凑了@曾宪森@陈家宜(陈+1)#09-11 | |
| 所有TAB | 低 | 多余的线条，需要处理掉，另背景层需要处理@曾宪森@陈家宜(陈+1)#09-11 | |
| 置顶列边距 | 低 | 过于紧凑，需拉宽@曾宪森@陈家宜(陈+1)#09-11 | |
| 列展示 | 低 | 提示重叠@曾宪森@陈家宜(陈+1)#09-11 | |
| 列展示 | 高 | 编辑预算、出价，默认按照列表的排序展示
@陈家宜(陈+1)@曾宪森#09-11
【此行不用实现】 | |
| 广告系列、广告组、广告 | 高 | 编辑预算、编辑出价、暂停、开启、删除按钮的数量限制由20个调整为100个 | 【图片】 |
2024-09-11 ｜ 已完成 ｜ ECERPH-16503
标题：Tittok广告》新增10分钟后自动刷新页面更新数据的功能。
负责人：曾宪森 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-订单模块 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
列表上新增开关：10分钟自动刷新数据。默认关闭。
鼠标悬停出现提示：每隔10分钟系统会自动刷新页面数据显示最新的指标数据。
开启后每隔10分钟则自动刷新当前页面内上的数据获取最新的数据指标 【图片】
2.刷新icon上鼠标悬停出现提示：最近刷新时间 最近刷新时间为最近一次用户刷新页面的时间 【图片】
2024-09-05 ｜ 已完成 ｜ ECERPH-16232
标题：Tiktok广告》广告的自定义列字段小数点取值调整和tab切换的时候不刷新更新字段宽度
负责人：曾宪森 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20240918-常规-9月第三迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
1.当选择日/周/月的时候不显示对应的操作开关和日志按钮。 【图片】 出价的0也需要隐藏掉。 【图片】
2.金额相关字段显示为2位小数。0则显示为0.00 比率的字段显示也为2位小数。0.00% 数值类则显示整数。0 【图片】
3.自定义列切换广告维度tab的时候不要刷新页面将页面宽度更新掉。
4.广告系列上的账户余额增加汇总功能
5.切换TAB的时候排序内容不进行刷新 注意：广告账户上的账户余额的筛选需要过滤不带到其他的tab页面上 【图片】
6.字段边框拖拉的icon和排序的icon之间保留一点宽度，不要重叠覆盖到 【图片】
2024-09-05 ｜ 已完成 ｜ ECERPH-16243
标题：Tiktok广告》调整广告组定时更新预算按钮功能
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-订单模块 ｜ 迭代：20240918-常规-9月第三迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
广告组下【编辑预算】的按钮放弃，弃用，不用再显示出来了
-
广告组预算旁边需要判断scheduled_budget，显示时钟标识
如果scheduled_budget返回为0.0则说明此广告组没有定时预算，不显示时钟标识 如果scheduled_budget返回的为非0数值，则显示时钟标识。 鼠标悬停在时钟标识显示定时预算执行的时间和更新的金额如下：预算大约会在 2024-09-06 00:00 (Etc/GMT+4 明天) 更改为 30.01USD。
更新时间为当前时间换算为对应的时区时间后加一天后的00:00. 更新后的金额为scheduled_budget的值。 【图片】
- 新增广告账户的筛选下支持多选筛选。
枚举值为广告账户名称。 每个广告维度都支持按照广告账户筛选 【图片】
- 广告组下【定时更新预算】按钮调整名称为【编辑预算】。调整弹窗如下
（1）编辑日预算，在原本弹窗上新增开关：设置定时预算。默认此开关为关闭的 【图片】
（2）如果开启设置定时预算则为编辑广告组的定时预算内容，出现如下弹窗 【图片】
①当前定时预算字段，取值接口返回的scheduled_budget ②定时更新开关，根据scheduled_budget判断，如果scheduled_budget大于0则为开启状态。如果scheduled_budget等于0则为关闭状态 ③新增定时新预算输入框，此输入框仅在定时更新开关为开启的情况下显示输入框。 ④批量操作上新增定时更新开关，默认为关闭，如果点击应用则所有广告组的定时更新开关设置为关闭。 如果设置定时更新开关为开启，则显示对应的定时预算设置输入框，支持设为/提高/降低 3种模式设置定时预算。点击应用则所有的广告组开启定时更新开关并且更是定时预算内容 【图片】
⑤如果定时更新开关的为关闭的情况下，提交的时候scheduled_budget传值0.0进行更新 如果定时更新开关为开启的情况下,scheduled_budget传值定时预算内的值
（3）提交成功则提示 【图片】 提交失败则提示 【图片】 另外需要更新系统对应的广告组的预算和定时预算内容。如果定时预算内容存在大于0的值的时候需要显示时钟的icon
（4）总预算、无法修改维持原有样式，因为总预算无法设置定时预算
（5）当设置总预算/日预算提高或者减少的情况下，后面显示的单位支持选择金额/百分比。默认选中金额。 日预算/总预算选择设置为的情况下，仅能选择金额作为单位。 新增支持按照百分比计算得出新预算。 预算提高：新预算=（1+输入百分比）当前预算 预算减少：新预算=（1-输入百分比）当前预算 【图片】
（6）预算提高/减少的交互调整 ①初次进入编辑预算弹窗内的时候，新预算输入框为空 ②预算提高/减少操作的时候每次计算都使用当前预算进行计算。
2024-09-04 ｜ 已完成 ｜ ECERPH-16109
标题：Tiktok广告》新增实时编辑预算功能
负责人：陈洁超 ｜ 需求类型：客户需求 ｜ 模块：TikTok-订单模块 ｜ 迭代：20240910-常规-9月第二迭代 ｜ 最后更新：2024-09-05
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
新增【编辑预算】的按钮。原【编辑预算按钮】调整为【定时更新预算】按钮。
（1）使用更新广告组接口：https://business-api.tiktok.com/portal/docs?id=1739586761631745。 编辑预算的时候统一调整budget字段 【图片】 （2）操作上还是需要区分日预算、总预算、无法修改几个情况让客户进行操作。 【图片】 （3）由于是一次性请求多个广告组一起编辑，所以处理结果显示如下 【图片】
2.原本【编辑预算】名称调整为【定时更新预算】按钮。此按钮仅在广告组页面上显示 （1）定时更新预算的弹窗内新增提示入选： （2）新增广告账户时区时间时间：需要按照用户勾选广告组所属的广告账户时区换算出对应时区的时间并且显示对应时区。 【图片】
3.勾选多个广告系列/广告组/广告点击启动/关闭的时候才出现确认弹窗。 如果仅操作广告系列/广告组/广告进行启动/关闭的时候无需出现确认弹窗。操作完成后也无需出现操作成功提示。仅需要出现toast提示：更新操作状态成功。 如果操作失败的情况下则toast：更新操作状态失败，失败原因：......... 【图片】
4.当将广告系列或广告组开启/关闭成功后，需要更新对应的广告维度本身和关联的子广告。 （1）将广告系列/广告组/广告设置为关闭后，需要将本身投放状态以及其关联的子广告组/广告设置的投放状态更新为主要状态：已暂停。次要状态：广告系列/广告组/广告已暂停。 （2）将广告系列/广告组/广告为开启后，需要将本身投放状态以及其关联的子广告组/广告设置投放状态更新为主要状态：投放中。 （3）将广告系列/广告组/广告删除后，需要本身投放状态以及其关联的子广告组/广告设置投放状态更新为主要状态：已删除。次要状态：广告系列/广告组/广告已删除。
2024-09-04 ｜ 已完成 ｜ ECERPH-16151
标题：Tiktok广告》新增字段并且调整自定义列功能
负责人：曾宪森 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-订单模块 ｜ 迭代：20240910-常规-9月第二迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
在广告组维度下，出价样式调整
【图片】
（1）如果bid_type为：BID_TYPE_CUSTOM则此时为手动出价，显示出价的具体数据
如果bid_type为：BID_TYPE_NO_BID 则此时为自动出价，不显示具体出价显示为--。
这种情况下鼠标悬停数值或者--上的时候提示“手动出价”/“自动出价”
（2）获取优化目标：optimization_goal 显示在出价字段下
| 枚举值 | 优化目标描述 |
| --- | --- |
| CLICK | 点击数。 |
| CONVERT | 转化/付费数/开始结账数 |
| INSTALL | 安装。 |
| IN_APP_EVENT | 应用内事件 |
| SHOW | 展示 |
| REACH | 覆盖人数 |
| LEAD_GENERATION | 线索量 |
| CONVERSATION | 会话数 |
| FOLLOWERS | 账号关注 |
| PROFILE_VIEWS即将废弃 | 主页访问 |
| PAGE_VISIT | TikTok 页面访问。 |
| VALUE | 价值/总收入。 |
| AUTOMATIC_VALUE_OPTIMIZATION | 自动价值优化。 |
| GMV | GMV |
| PURCHASES | 购买数 |
| INITIATE_CHECKOUTS | 启动结账 |
| MT_LIVE_ROOM | 直播间观众留存。 |
| PRODUCT_CLICK_IN_LIVE | LIVE商品点击数。 |
| ENGAGED_VIEW | 观看6秒次数（专注观看）。 |
| ENGAGED_VIEW_FIFTEEN | 观看15秒次数（专注观看）。 |
| TRAFFIC_LANDING_PAGE_VIEW | 落地页浏览量。 |
| DESTINATION_VISIT | 目标页面访问。 |
| PREFERRED_LEAD | 偏好的潜在客户。 |
| 2.自定义列新增基础属性如下。如果属性字段只属于特定广告维度后，用户勾选后也无需在对应列表上显示
字段名称 | 所属广告维度 |
| 广告账户 | 广告账户/广告系列/广告组/广告 |
| 时区 | 广告账户/广告系列/广告组/广告 |
| 账户余额（广告账户） | 广告账户 |
| 状态（广告账户） | 广告账户 |
| 广告主账号 | 广告账户/广告系列/广告组/广告 |
| 广告系列 | 广告系列/广告组/广告 |
| 广告组 | 广告组/广告 |
| 广告组数量（广告系列） | 广告系列 |
| 投放状态 | 广告系列/广告组/广告 |
| 广告数量（广告组） | 广告组 |
| 预算 | 广告系列/广告组 |
| 投放时间（广告组） | 广告组 |
| 出价（广告组） | 广告组 |
| 店铺（广告组） | 广告组 |
| 商品（广告） | 广告 |
| 视频ID（广告） | 广告 |
| 3.自定义列调整为可以在本地做缓存，修改和编辑的时候更新本地和到远程存储，换了电脑的时候从接口获取一次就好了，这样能最大限度的使用本地，换了电脑也不会丢掉设置
4.导出报表上需要按照维度增加以下字段
字段名称 | 所属广告维度 |
| 广告账户 | 广告账户/广告系列/广告组/广告 |
| 时区 | 广告账户/广告系列/广告组/广告 |
| 账户余额（广告账户） | 广告账户 |
| 状态（广告账户） | 广告账户 |
| 广告主账号 | 广告账户/广告系列/广告组/广告 |
| 广告系列 | 广告系列/广告组/广告 |
| 广告组 | 广告组/广告 |
| 广告组数量（广告系列） | 广告系列 |
| 投放状态 | 广告系列/广告组/广告 |
| 广告数量（广告组） | 广告组 |
| 预算 | 广告系列/广告组 |
| 投放时间（广告组） | 广告组 |
| 出价（广告组） | 广告组 |
| 店铺（广告组） | 广告组 |
| 商品（广告） | 广告 |
| 视频ID（广告） | 广告 |
5.自定义列表的默认项调整为如下 （1）指标使用以下字段作为默认值 {"presets":[{"key":"广告监控","label":"广告监控","columns":[{"field":"conversion_rate_v2","fixed":false,"title":"转化率(CVR)(展示)"},{"field":"onsite_shopping_roas","fixed":false,"title":"ROAS(商店)"},{"field":"total_onsite_shopping_value","fixed":false,"title":"总收入(商店)"},{"field":"spend","fixed":false,"title":"总消耗"},{"field":"impressions","fixed":false,"title":"展示数"},{"field":"clicks","title":"点击量(目标页面)"},{"field":"ctr","title":"CTR(目标页面)"},{"field":"cpc","title":"CPC(目标页面)"},{"field":"cpm","title":"CPM"},{"field":"onsite_on_web_detail","title":"商品页浏览数(商店)"},{"field":"onsite_on_web_cart","title":"加入购物车数(商店)"},{"field":"onsite_on_web_cart_rate","title":"加入购物车率(商店)"},{"field":"onsite_initiate_checkout_count","title":"开始结账数(商店)"},{"field":"onsite_initiate_checkout_count_rate","title":"开始结账率(商店)"},{"field":"onsite_shopping","title":"付费数(商店)"},{"field":"onsite_shopping_rate","title":"付费率(商店)"},{"field":"cost_per_onsite_shopping","title":"平均付费成本(商店)"},{"field":"video_play_actions","title":"视频播放量"},{"field":"video_views_p100_play_actions_rate","title":"完播率"},{"field":"engaged_view_play_actions_rate","title":"6秒完播率"},{"field":"video_watched_2s_play_actions_rate","title":"2秒完播率"},{"field":"video_watched_2s","title":"播放2s次数"},{"field":"video_watched_6s","title":"播放6s次数"},{"field":"video_views_p25","title":"播放25%次数"},{"field":"video_views_p50","title":"播放50%次数"},{"field":"video_views_p75","title":"播放75%次数"},{"field":"video_views_p100","title":"播放完成次数"},{"field":"video_play_actions_impressions_rate","title":"人群播放率"},{"field":"video_views_p25_play_actions_rate","title":"播放量25%占比"},{"field":"video_views_p50_play_actions_rate","title":"播放量50%占比"},{"field":"video_views_p75_play_actions_rate","title":"播放量75%占比"}]}],"defaultColumns":[{"field":"conversion_rate_v2","fixed":false,"title":"转化率(CVR)(展示)"},{"field":"onsite_shopping_roas","fixed":false,"title":"ROAS(商店)"},{"field":"total_onsite_shopping_value","fixed":false,"title":"总收入(商店)"},{"field":"spend","fixed":false,"title":"总消耗"},{"field":"impressions","fixed":false,"title":"展示数"},{"field":"clicks","title":"点击量(目标页面)"},{"field":"ctr","title":"CTR(目标页面)"},{"field":"cpc","title":"CPC(目标页面)"},{"field":"cpm","title":"CPM"},{"field":"onsite_on_web_detail","title":"商品页浏览数(商店)"},{"field":"onsite_on_web_cart","title":"加入购物车数(商店)"},{"field":"onsite_initiate_checkout_count","title":"开始结账数(商店)"},{"field":"onsite_shopping","title":"付费数(商店)"},{"field":"onsite_shopping_rate","title":"付费率(商店)"},{"field":"cost_per_onsite_shopping","title":"平均付费成本(商店)"},{"field":"video_play_actions","title":"视频播放量"},{"field":"video_views_p100_play_actions_rate","title":"完播率"},{"field":"engaged_view_play_actions_rate","title":"6秒完播率"},{"field":"video_watched_2s_play_actions_rate","title":"2秒完播率"},{"field":"video_watched_2s","title":"播放2s次数"},{"field":"video_watched_6s","title":"播放6s次数"},{"field":"video_views_p100","title":"播放完成次数"},{"field":"video_views_p25","title":"播放25%次数"},{"field":"video_views_p50","title":"播放50%次数"},{"field":"video_views_p75","title":"播放75%次数"},{"field":"video_play_actions_impressions_rate","title":"人群播放率"},{"field":"video_views_p25_play_actions_rate","title":"播放量25%占比"},{"field":"video_views_p50_play_actions_rate","title":"播放量50%占比"},{"field":"video_views_p75_play_actions_rate","title":"播放量75%占比"}],"curGroup":"广告监控"}
（2）基础属性默认字段 按照不同广告维度使用不同基础属性字段 广告账户： 广告账户、时区、广告主账号、状态、账户余额、 广告系列： 广告系列、投放状态、广告账户、预算 广告组： 广告组名称、投放状态、广告账户、预算、出价、投放时间、店铺 广告： 广告名称、投放状态、广告账户、商品、视频ID
2024-08-30 ｜ 已完成 ｜ ECERPH-15915
标题：Tiktok广告》广告推广新增广告详情页
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
- 需求（做什么？怎么做？有什么要注意的？）
tiktok广告推广
1.对接广告各个维度小时层级的广告数据
2.广告账户、广告系列、广告组、广告的名称调整为可点击状态，鼠标悬停显示为蓝色可点击状态。 【图片】
3.点击广告账户出现以下的侧弹窗 【图片】 （1）标题上需要按照广告账户/广告系列/广告组/广告这样的层级显示对应的名称。，默认显示15个字符超过的则显示.... （2）需要按照不同广告层级显示广告详情内字段 ①广告账户 今日消耗是指最新一天总消耗的值 【图片】 ②广告系列 【图片】 ③广告组 【图片】 ④广告 【图片】
（3）小时详细数据 时间筛选项：默认选中最近的一天，系统仅支持选中最近3天的数据显示，3天前的时间内容置灰不能选择。 （4）自定义列下拉框 自定义列的下拉框和列表的自定义列保持一致，支持用户选择再列上新增的自定义列项。 （5）小时详细数据列表.字段同列表字段，鼠标悬停也同列表一样显示字段说明文案。支持排序功能 【图片】
2024-08-27 ｜ 已完成 ｜ ECERPH-15706
标题：Tiktok》广告推广页面上调整自定义列的组件
负责人：曾宪森 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20240903-常规-9月第一迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
调整广告推广页面的自定义列的组件同平台的组件一致
- 需求（做什么？怎么做？有什么要注意的？）
平台自定义列组件如下
1.支持点击进入自定义列弹窗 【图片】
【图片】 实现以下功能： ①自定义列组合支持生产模板 ②自定义列模板支持编辑和删除 ③自定义列弹窗内支持模糊搜索字段名称 ④支持手动调整自定义列的筛选排序 ⑤右侧边显示每个字段的分组，点击分组锚点到对应分组字段 ⑥选中的字段显示在右侧栏，支持关闭变回未勾选状态。支持固定，固定后位置不能变更 【图片】
2024-08-02 ｜ 已完成 ｜ ECERPH-14378 🚀【0-1】
标题：tiktok》新增tiktok广告推广列表页面
负责人：陈家宜 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20240918-常规-9月第三迭代 ｜ 最后更新：2026-05-18
原始需求：01_原始需求\ECERPH-14378_tiktok》新增tiktok广告推广列表页面\原始需求.md
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
对接中心接口
（1）中台接口需求：https://devops.aliyun.com/projex/req/ECERPJ-4298# 《中台》Tiktok广告接口对接》
（2）接口请求频率说明
| 接口名称 | 作用 | 请求说明 |
| --- | --- | --- |
| 获取账号信息 | 获取账号状态、时区、币种 | 每天请求一次 |
| 获取广告系列列表 | 获取广告系列基础信息 | 1. 按照账号时区换算成时区的当前时间然后按照创建时间进行获取 |
2.初次请求拉取最近 30 天的创建的广告系列
3.自动更新逻辑：
今天数据15分钟更新一次。
昨天、前天数据30分钟更新一次
4-7天的数据1小时更新一次
8-14天的数据3小时更新一次
14-30天的数据12小时更新
30天-60天的数据1天更新一次
60天以上的数据停止自动更新，用户有需要自行手动更新
| 3.暂不开放手动更新的按钮（二期安排） | |
| --- | --- |
| 获取广告组列表 | 获取广告组基础信息 |
| | 1. 按照campaign_ids获取对应广告系列下的广告组 |
| 2.自动更新逻辑同上 | |
| 获取广告 | 获取广告基础信息 |
| | 1. 按照campaign_ids获取对应广告系列下的广告 |
| 2.自动更新逻辑同上 | |
| 获取基础报表 | 获取基础报表的数据 |
| | 1. 按照系统内的广告系列、广告组、广告查询基础数据 |
| 2.按照天的维度获取数据。
3.自动更新逻辑同上。 | |
| 更新广告 | 更新广告基础属性 |
| | 根据用户操作触发 |
| 更新广告状态 | 关停，开启或者删除广告 |
| | 根据用户操作触发 |
| 更新广告组预算 | 更新广告组的总预算或设置广告组日预算或动态日预算 |
| | 根据用户操作触发 |
| 更新广告组 | 更改广告组属性 |
| | 根据用户操作触发 |
| 更新广告组状态 | 关停，开启或者删除广告组 |
| | 根据用户操作触发 |
| 更新广告系列 | 更新推广系列的预算 |
| | 根据用户操作触发 |
| 更新广告系列操作状态 | 关停，开启或者删除广告系列 |
| | 根据用户操作触发 |
| 2.广告推广列表字段说明
（1）属性字段：每个广告层级的属性字段，这些字段无法进行合计计算是每个广告层级的基础属性说明。仅需要获取最新数据更新即可
①广告账户
系统字段 | 数据来源 |
| | 接口字段 |
| | 备注 |
| | 是否默认显示 |
| 广告账号iD | 获取账号信息 |
| | advertiser_id |
| | 是 |
| 广告账号名称 | 获取账号信息 |
| | name |
| | 是 |
| 广告账号公司名称 | 获取账号信息 |
| | company |
| | 是 |
| 广告账号国家 | 获取账号信息 |
| | country |
| 广告账号币种 | 获取账号信息 |
| | currency |
| | 是 |
| 广告账号行业 | 获取账号信息 |
| | industry |
| 广告账号状态 | 获取账号信息 |
| | status |
| | 状态枚举值 |
| STATUS_DISABLE 已关闭 | |
STATUS_PENDING_CONFIRM 申请待审核
STATUS_PENDING_VERIFIED 待验证
STATUS_CONFIRM_FAIL 审核失败
STATUS_ENABLE 已批准
STATUS_CONFIRM_FAIL_END CRM审核失败
STATUS_PENDING_CONFIRM_MODIFY 修改待审核
STATUS_CONFIRM_MODIFY_FAIL 修改审核失败
STATUS_LIMIT 受到处罚
STATUS_WAIT_FOR_BPM_AUDIT CRM系统待审核
STATUS_WAIT_FOR_PUBLIC_AUTH 银行账户待验证
STATUS_SELF_SERVICE_UNAUDITED 自助服务账户资格待验证
| STATUS_CONTRACT_PENDING 合同尚未生效 | 是 | |
| --- | --- | --- |
| 广告账号时区 | 获取账号信息 | timezone |
| | | 是 |
| | 广告账号时区名称 | 获取账号信息 |
| | display_timezone | |
| | 是 | |
| 广告账号可用余额 | 获取账号信息 | balance |
| | | 是 |
| | 创建时间 | 获取账号信息 |
| | create_time | |
| 广告系列数量 | 系统统计 | |
| | 点击跳转到广告系列tab页面并且选中对应的广告账户，筛选出对应的广告系列 | |
| | 广告主账号 | 系统 |
| | 系统授权的广告账号 | 显示账号别名和账号英文名 |
| | 是 | |
| ②广告系列
系统字段名称 | 数据来源 | 接口字段 |
| | 备注 | 是否默认显示 |
| | 广告账户 | 获取广告系列列表 |
| | advertiser_id | |
| 广告系列id | 获取广告系列列表 | campaign_id |
| | | 是 |
| | 创建时间 | 获取广告系列列表 |
| | create_time | |
| 更新时间 | 获取广告系列列表 | modify_time |
| | 广告系列名称 | 获取广告系列列表 |
| | campaign_name | |
| | 是 | |
| 投放策略 | 获取广告系列列表 | bid_type |
| | 预算方式 | 获取广告系列列表 |
| | budget_mode | 枚举值： |
| BUDGET_MODE_INFINITE: Unlimited budget.（无限预算）
BUDGET_MODE_TOTAL: Lifetime budget.（生命周期预算）
BUDGET_MODE_DAY : Daily budget.（每日预算）
BUDGET_MODE_DYNAMIC_DAILY_BUDGET: （动态每日预算） | 是 | |
| 操作状态 | 获取广告系列列表 | operation_status |
| | 枚举值：
ENABLE 开启
DISABLE 关闭 | 是 |
| | 次要状态 | 获取广告系列列表 |
| | secondary_status | 枚举值看campign状态说明 |
| | 是 | |
| 预算 | 获取广告系列列表 | budget |
| | 广告组数量 | 系统统计 |
| | | 点击跳转到广告组tab页面并且筛选广告系列id筛选出该广告系列下所有的广告组 |
| 广告主账号 | 系统 | 系统授权的广告账号 |
| | 显示账号别名和账号英文名 | |
| | 广告系列次要状态和系统字段：广告系列投放状态的映射关系
广告系列状态枚举值 | 次要状态返回参数 |
| | 次要状态系统名称 | |
| 未投放 | CAMPAIGN_STATUS_ADVERTISER_AUDIT_DENY | 广告主账号审核未通过 |
| | 未投放 | CAMPAIGN_STATUS_ADVERTISER_AUDIT |
| | 广告主账号审核中 | |
| 未投放 | ADVERTISER_CONTRACT_PENDING | 合同未生效 |
| | 未投放 | ADVERTISER_ACCOUNT_PUNISH |
| | 广告主账户被惩罚 | |
| 投放中 | CAMPAIGN_STATUS_ENABLE | 广告系列投放中 |
| | 已删除 | CAMPAIGN_STATUS_DELETE |
| | 推广系列已删除 | |
| 未投放 | CAMPAIGN_STATUS_ADVERTISER_AUDIT_DENY | 广告主账号审核未通过 |
| | 未投放 | CAMPAIGN_STATUS_ADVERTISER_AUDIT |
| | 广告主账号审核中 | |
| 未投放 | ADVERTISER_CONTRACT_PENDING | 合同未生效 |
| | 未投放 | ADVERTISER_ACCOUNT_PUNISH |
| | 广告主账户被惩罚 | |
| 未投放 | CAMPAIGN_STATUS_BUDGET_EXCEED | 推广系列超出预算 |
| | 未投放 | CAMPAIGN_STATUS_IDENTITY_USED_BY_GMV_MAX_AD |
| | 发布身份不可用，因为已被其他最大成交额广告使用。 | |
| 已暂停 | CAMPAIGN_STATUS_DISABLE | 推广系列已暂停 |
| | 已暂停 | CAMPAIGN_STATUS_AWAITING_RELEASE |
| | 等待释放 | |
| 投放中 | CAMPAIGN STATUS_ENABLE | 广告系列投放中 |
| | ③广告组字段说明
系统字段名称 | 数据来源 |
| | 接口字段 | 备注 |
| | 是否默认显示 | |
| 广告账户 | 获取广告组列表 | advertiser_id |
| | 广告系列id | 获取广告组列表 |
| | campaign_id | |
| 广告组id | 获取广告组列表 | adgroup_ids |
| | | 是 |
| | 创建时间 | 获取广告组列表 |
| | create_time | |
| 更新时间 | 获取广告组列表 | modify_time |
| | 广告组名称 | 获取广告组列表 |
| | adgroup_name | |
| | 是 | |
| 操作状态 | 获取广告组列表 | operation_status |
| | ENABLE : The ad is enabled (in 'ON' status). 开
DISABLE: The ad is disabled (in 'OFF' status). 关
FROZEN: The ad is terminated and cannot be enabled. 关并且不能再开启 | 是 |
| | 主状态 | 获取广告组列表 |
| | primary_status | 主要状态保存在库即可 |
| 次要状态 | 获取广告组列表 | secondary_status |
| | 次要状态需要翻译后显示在界面上 | 是 |
| | 竞价策略 | 获取广告组列表 |
| | bid_strategy | BID_TYPE_CUSTOM 成本上限 |
| BID_TYPE_NO_BID 最大投放量 | 是 | |
| 出价 | 获取广告组列表 | bid_price |
| | | 是 |
| | 广告投放时间（起始） | 获取广告组列表 |
| | schedules.start_time | |
| | 是 | |
| 广告投放时间（结束） | 获取广告组列表 | schedules.end_time |
| | | 是 |
| | 店铺ID | 获取广告组列表 |
| | store_id | 需要使用这个店铺ID去关联系统的内授权的tk店铺。能关联到的请看下则显示店铺别名和店铺ID。如果无法正常关联的话则只显示店铺id，店铺别名处显示-- |
| 店铺授权id | 获取广告组列表 | store_authorized_bc_id |
| | 仅保存 | |
| | 预算模式 | 获取广告组列表 |
| | budget_mode | BUDGET_MODE_TOTAL：总预算 |
| BUDGET_MODE_DYNAMIC_DAILY_BUDGET：动态每日预算
BUDGET_MODE_DAY：每日预算 | 是 | |
| 广告投放时间类型。 | 获取广告组列表 | schedule_type |
| | SCHEDULE_FROM_NOW：持续投放
SCHEDULE_START_END：时间段内投放 | |
| | 广告数量 | 系统统计 |
| | | 点击挑战到广告tab页面并且筛选上填入广告组id筛选出广告组下的所有广告 |
| 广告主账号 | 系统 | 系统授权的广告账号 |
| | 显示账号别名和账号英文名 | |
| | 主要状态和次要状态枚举值说明
主状态枚举值 | 系统广告组投放状态 |
| | 支持的secondary_status值
（广告组层级） | 次要状态系统名称 |
| | STATUS_DELETE | 已删除 |
| | ADGROUP_STATUS_CAMPAIGN_DELETE | 推广系列已删除 |
| | STATUS_DELETE | 已删除 |
| | ADGROUP_STATUS_DELETE | 广告组已删除 |
| | STATUS_DISABLE | 已暂停 |
| | ADGROUP_STATUS_CAMPAIGN_DISABLE | 推广系列已暂停 |
| | STATUS_DISABLE | 已暂停 |
| | ADGROUP_STATUS_DISABLE | 广告组已暂停 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_ADVERTISER_AUDIT_DENY | 广告主账号审核未通过 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_ADVERTISER_AUDIT | 广告主账号审核中 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADVERTISER_CONTRACT_PENDING | 合同未生效 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADVERTISER_ACCOUNT_PUNISH | 广告主账户被惩罚 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_BALANCE_EXCEED | 账户余额不足/付费失败 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_CREATE | 暂无创意 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_TRANSCODING_FAIL | 无法转换视频，请重新上传。 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_AUDIT | 新建审核中 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_REAUDIT | 修改审核中 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_AUDIT_DENY | 审核未通过 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_PARTIAL_AUDIT_NO_DELIVERY | 广告组部分审核中，且不在投放中 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_LIVE_NOT_START | LIVE 尚未开始 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_INDUSTRY_QUALIFICATION_MISSING | 待补充资质 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_INDUSTRY_QUALIFICATION_EXPIRED | 资质已过期 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_INDUSTRY_QUALIFICATION_DENY | 资质不通过 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_CAMPAIGN_EXCEED | 推广系列超出预算 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_BUDGET_EXCEED | 广告组超出预算 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_ADGROUP_PRE_ONLINE | 广告组处于预上线状态，尚未开始投放。 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_FROZEN | 广告组被冻结 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_NOT_START | 未在排期内 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_ASSET_AUTHORIZATION_LOST | 素材不可用或相关授权已被撤销 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_PIXEL_UNBIND | Pixel解绑 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_ADGROUP_QUOTA_LIMIT | 已超出配额。如要继续，请暂停某个投放中的广告组。 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_IDENTITY_USED_BY_GMV_MAX_AD | 发布身份不可用，因为已被其他最大成交额广告使用。 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_SEARCH_KEYWORDS_IN_REVIEW | 关键词审核中 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_SEARCH_KEYWORDS_NOT_AVAILABLE | 关键词不可用 |
| | STATUS_DELIVERY_OK | 投放中 |
| | ADGROUP_STATUS_SEARCH_KEYWORDS_PARTIAL_APPROVED | 关键词部分通过审核 |
| | STATUS_DELIVERY_OK | 投放中 |
| | ADGROUP_STATUS_PARTIAL_AUDIT_DELIVERY_OK | 广告组部分审核中，且在投放中 |
| | STATUS_DELIVERY_OK | 投放中 |
| | ADGROUP_STATUS_SHADOW_ADGROUP_REAUDIT | 修改审核中 |
| | STATUS_DELIVERY_OK | 投放中 |
| | ADGROUP_STATUS_DELIVERY_OK | 投放中 |
| | STATUS_TIME_DONE | 已完成 |
| | ADGROUP_STATUS_TIME_DONE
注意：本状态代表该广告组在所设置的投放结束时间结束投放。 | 已结束 |
| | STATUS_RF_CLOSED | 已关闭 |
| | ADGROUP_STATUS_RF_DEDUCTION_FAILED | 余额不足 |
| | STATUS_RF_CLOSED | 已关闭 |
| | ADGROUP_STATUS_RF_NO_VALID_CREATIVE | 无有效广告 |
| | STATUS_RF_CLOSED | 已关闭 |
| | ADGROUP_STATUS_RF_CLOSED_OTHERS | 广告组已关闭 |
| | STATUS_RF_CLOSED | 已关闭 |
| | ADGROUP_STATUS_RF_AD_AUDIT_DENY | 广告审核失败 |
| | STATUS_RF_CLOSED | 已关闭 |
| | ADVERTISER_ACCOUNT_INVALID | 无效账号状态 |
| | STATUS_RF_CLOSED | 已关闭 |
| | ADGROUP_STATUS_RF_ADGROUP_INVALID | 覆盖和频次广告组不存在或为其他异常状态 |
| | STATUS_RF_CLOSED | 已关闭 |
| | ADGROUP_STATUS_RF_WITHDRAW_ORDER | 预定已取消 |
| | STATUS_TIME_DONE | 已完成 |
| | ADGROUP_STATUS_RF_TERMINATE | 广告组已终止 |
| | STATUS_TIME_DONE | 已完成 |
| | ADGROUP_STATUS_RF_TIME_DONE
注意：本状态代表该覆盖和频次广告组由于预算不足或账户余额不足，在所设置的投放结束时间前结束了投放。 | 已完成 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_RF_NO_DELIVERY_CREATIVE | 暂无有效创意 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_RF_SHORT_BALANCE | 账户余额低于扣款金额 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_RF_BOOKING | 已预订 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADGROUP_STATUS_RF_SCHEDULE | 已排期 |
| | ④广告字段说明
系统字段名称 | 数据来源 |
| | 接口字段 | 备注 |
| | 是否默认显示 | |
| 广告账户 | 获取广告 | advertiser_id |
| | 广告系列id | 获取广告 |
| | campaign_id | |
| 广告组id | 获取广告 | adgroup_ids |
| | 创建时间 | 获取广告 |
| | create_time | |
| 更新时间 | 获取广告 | modify_time |
| | 广告系列名称 | 获取广告 |
| | campaign_name | |
| 广告组名称 | 获取广告 | adgroup_name |
| | 广告ID | 获取广告 |
| | ad_id | |
| | 是 | |
| 广告名称 | 获取广告 | ad_name |
| | | 是 |
| | 商品 | 获取广告 |
| | item_group_ids | 存在多个商品的情况,，需要使用此id去关联系统内所有商品的product id。匹配到product id后关联显示商品的图片、店铺、售价、可售数。如果关联不到product id的话则显示--，图片则显示无图占位图 |
| | 是 | |
| 产品集ID | 获取广告 | product_set_id |
| | 仅保存 | |
| | SKU | 获取广告 |
| | sku_ids | 仅保存 |
| 橱窗商品 | 获取广告 | showcase_products.item_group_id |
| | 使用橱窗内商品才会出现这个商品。需要使用此id去关联系统内所有商品的product id。匹配到product id后关联显示商品的图片、店铺、售价、可售数。如果关联不到product id的话则显示--，图片则显示无图占位图 | |
| | 橱窗店铺ID | 获取广告 |
| | showcase_products.store_id | 使用橱窗内商品才会出现这个店铺。关联系统授权店铺，关联上则显示店铺别名。无法关联上则显示店铺id，店铺别名显示-- |
| 视频 ID | 获取广告 | video_id |
| | 使用视频id拼接就能跳转到tiktok对应的视频上。要么这个字段有值要么是tiktok_item_id有值 | 是 |
| | 图片ID | 获取广告 |
| | image_ids | |
| 主状态 | 获取广告 | primary_status |
| | 枚举值看ad状态说明 | |
| | 次要状态 | 获取广告 |
| | secondary_status | 枚举值看ad状态说明 |
| | 是 | |
| 操作状态 | 获取广告 | operation_status |
| | ENABLE : The ad is enabled (in 'ON' status).
DISABLE: The ad is disabled (in 'OFF' status).
FROZEN: The ad is terminated and cannot be enabled. | 是 |
| | 转化事件 | 获取广告 |
| | optimization_event | https://business-api.tiktok.com/portal/docs?id=1739361474981889 |
| Tiktok视频id | 获取广告 | tiktok_item_id |
| | 使用视频id拼接就能跳转到tiktok对应的视频上 | |
| | 推广目标 | 获取广告 |
| | objective_type | APP_PROMOTION 应用推广 |
| WEB_CONVERSIONS 网站转化量 | | |
REACH 竞价覆盖。
TRAFFIC 访问量
VIDEO_VIEWS 视频播放量
PRODUCT_SALES 商品销量
ENGAGEMENT 社区互动
LEAD_GENERATION 线索收集
RF_REACH （白名单功能） 合约覆盖和频次或 TikTok Pulse
| TOPVIEW_REACH 合约 TopView | | |
| --- | --- | --- |
| 广告主账号 | 系统 | 系统授权的广告账号 |
| | 显示账号别名和账号英文名 | |
| | 主要状态和次要状态枚举值说明
主要状态 | 广告投放状态枚举值 |
| | 次要状态返回参数 | 次要状态系统名称 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_ADVERTISER_AUDIT_DENY | 广告主账号审核未通过 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_ADVERTISER_AUDIT | 广告主账号审核中 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADVERTISER_CONTRACT_PENDING | 合同未生效 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADVERTISER_ACCOUNT_PUNISH | 广告主账户被惩罚 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_AUDIT | 新建审核中 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_NOT_START | 未设置排期 |
| | STATUS_DELIVERY_OK | 投放中 |
| | AD_STATUS_PARTIAL_AUDIT_DELIVERY_OK | 广告部分审核中，且在投放中 |
| | STATUS_DELIVERY_OK | 投放中 |
| | AD_STATUS_DELIVERY_OK | 广告投放中 |
| | STATUS_TIME_DONE | 已完成 |
| | AD_STATUS_DONE | 已完成 |
| | STATUS_RF_CLOSED | 已关闭 |
| | AD_STATUS_PROMOTE_AD_OFFLINE_AUDIT | 审核未通过 |
| | STATUS_RF_CLOSED | 已关闭 |
| | AD_STATUS_PROMOTE_ADGROUP_CLOSED | 广告组已关闭 |
| | STATUS_DELETE | 已删除 |
| | AD_STATUS_CAMPAIGN_DELETE | 推广系列已删除 |
| | STATUS_DELETE | 已删除 |
| | AD_STATUS_ADGROUP_DELETE | 广告组已删除 |
| | STATUS_DELETE | 已删除 |
| | AD_STATUS_DELETE | 创意已删除 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_ADVERTISER_AUDIT_DENY | 广告主账号审核未通过 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_ADVERTISER_AUDIT | 广告主账号审核中 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADVERTISER_CONTRACT_PENDING | 合同未生效 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | ADVERTISER_ACCOUNT_PUNISH | 广告主账户被惩罚 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_LIVE_OFFLINE | 直播未开始 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_BALANCE_EXCEED | 账户余额不足/付费失败 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_ADGROUP_PARTIAL_AUDIT_NO_DELIVERY | 新建审核中 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_PARTIAL_AUDIT_NO_DELIVERY | 新建审核中 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_ADGROUP_AUDIT_DENY | 审核未通过 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_ADGROUP_INDUSTRY_QUALIFICATION_MISSING | 待补充资质 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_ADGROUP_INDUSTRY_QUALIFICATION_EXPIRED | 资质不通过 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_ADGROUP_INDUSTRY_QUALIFICATION_DENY | 资质已过期 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_MUSIC_AUTHORIZATION_MISSING | 缺失音乐资质 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_TRANSCODING_FAIL | 请替换广告组中出错的视频 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_AUDIT | 新建审核中 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_REAUDIT | 修改审核中 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_AUDIT_DENY | 审核未通过 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_PROCESS_AUDIO | 音频处理中，如果此状态持续时间过长，请重新上传素材。 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_CAMPAIGN_EXCEED | 推广系列超出预算 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_BUDGET_EXCEED | 广告组超出预算 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_AD_PRE_ONLINE | 广告处于预上线状态，尚未开始投放。 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_NOT_START | 未设置排期 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_ADGROUP_ASSET_AUTHORIZATION_LOST | 素材不可用或相关授权已被撤销 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_ASSET_AUTHORIZATION_LOST | 素材不可用或相关授权已被撤销 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STAUS_PIXEL_UNBIND | Pixel解绑 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_AD_QUOTA_LIMIT | 由于你的账户已超出配额，广告组被暂停。如要继续，请暂停某个投放中的广告组。 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_PRODUCT_UNAVAILABLE | 商品不可用。 请尝试修改此广告，以了解原因。 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_ANCHOR_UNAVAILABLE | 商品链接不可用。请尝试修改此广告，了解原因。 |
| | STATUS_NOT_DELIVERY | 未投放 |
| | AD_STATUS_NO_AUTHORIZATION_OF_SHOWCASE | 广告发布身份不可用。请修改广告以查看详情。 |
| | STATUS_DELIVERY_OK | 投放中 |
| | AD_STATUS_PARTIAL_AUDIT_DELIVERY_OK | 广告部分审核中，且在投放中 |
| | STATUS_DELIVERY_OK | 投放中 |
| | AD_STATUS_DELIVERY_OK | 广告投放中 |
| | STATUS_DISABLE | 已暂停 |
| | AD_STATUS_CAMPAIGN_DISABLE | 推广系列已暂停 |
| | STATUS_DISABLE | 已暂停 |
| | AD_STATUS_ADGROUP_DISABLE | 广告组已暂停 |
| | STATUS_DISABLE | 已暂停 |
| | AD_STATUS_DISABLE | 广告暂停 |
| | STATUS_FROZEN | 投放中 |
| | ADGROUP_STATUS_FROZEN | 广告组被冻结 |
| | STATUS_TIME_DONE | 已完成 |
| | AD_STATUS_DONE | 已完成 |
| | STATUS_RF_CLOSED | 已关闭 |
| | AD_STATUS_RF_ADGROUP_CLOSED | 广告组已关闭 |
| | （2）基础数据指标字段
指标名称 | 系统名称 |
| | 数据类型 | 详细描述 |
| | 汇总计算公式 | 是否默认显示 |
| | 广告主 | 广告系列 |
| | 广告组 | 广告 |
| | spend | 总消耗 |
| | string | 在所选择的时间内投放广告产生的花费金额。 |
| | 求和 | 是 |
| | true | true |
| | true | true |
| | billed_cost | 净消耗 |
| | string | 不包含广告赠款和优惠券的广告消耗。 |
| 注意：
此指标仅支持在同步基础报表中使用。
此指标可能会延迟11小时，并且它在2023年9月1日后才开始有数据。 | 求和 | |
| | true | true |
| | true | true |
| | cash_spend | 现金消耗 |
| | string | 所选时间范围内投放广告产生的现金消耗。仅支持广告主层级和分天查询，不支持 lifetime，不支持分时查询。 |
| 注意：指标更新可能有 24-48 小时的延迟。 | 求和 | |
| | true | false |
| | false | false |
| | cpc | CPC（目标页面） |
| | string | 广告花费平均到单次点击（目标页面）的成本。 |
| 注意：从 7 月 6 日开始，异步报表中的指标名称已从“CPC”更新为“CPC（目标页面）”。 | CPC=总消耗/点击量（目标页面）
CPC=spend/clicks | |
| | true | true |
| | true | true |
| | cpm | CPM |
| | string | 每千次展现您所产生的平均花费。 |
| | CPM=（总消耗/展示数）1000
CPM=（spend/impressions）1000 | |
| | true | true |
| | true | true |
| | impressions | 展示数 |
| | string | 广告展现次数。 |
| | 求和 | 是 |
| | true | true |
| | true | true |
| | clicks | 点击量（目标页面） |
| | string | 用户点击广告并进入广告主指定的目标页面的次数。 |
| 注意：从 7 月 6 日开始，异步报表中的指标名称已从“点击量”更新为“点击量（目标页面）”。 | 求和 | 是 |
| | true | true |
| | true | true |
| | ctr | CTR（目标页面） |
| | string | 广告展现中产生了点击（目标页面）的次数占比。 |
| 注意：从 7 月 6 日开始，异步报表中的指标名称已从“CTR”更新为“CTR（目标页面）”。 | CTR=（点击量（目标页面）/展示数）× 100%
CTR=（clicks/impressions）× 100% | |
| | true | true |
| | true | true |
| | reach | 总覆盖人数 |
| | string | 至少看过一次广告的人数。该指标为预估所得。 |
| | 求和 | 是 |
| | true | true |
| | true | true |
| | cost_per_1000_reached | 覆盖千人成本 |
| | string | 覆盖每一千人的平均成本。该指标为预估所得 |
| | Cost per 1,000 People Reached =(总消耗/总覆盖人数)1000
Cost per 1,000 People Reached =(spend/reach)1000 | |
| | true | true |
| | true | true |
| | conversion | 转化数 |
| | string | 广告达成目标转化的次数，目标转化会根据创建时的投放设置有所不同（计数结果基于展示时间点统计）。 |
| | 求和 | 是 |
| | true | true |
| | true | true |
| | cost_per_conversion | 转化成本 |
| | string | 广告花费平均到单次转化的成本（计数结果基于展示时间点统计）。 |
| | CPA
=（总消耗/转化数）× 100%
CPA=（spend/conversion）× 100% | 是 |
| | true | true |
| | true | true |
| | conversion_rate_v2 | 转化率（展示） |
| | string | 转化次数占广告获得的总展示次数的百分比。 |
| （总计数是根据每次广告展示的时间计算的。） | 转化率=（转化数/展示数）× 100%
CVR (Impression=（conversion/impressions）× 100% | 是 |
| | true | true |
| | true | true |
| | real_time_conversion | 实时转化 |
| | string | 广告达成目标转化的次数，目标转化会根据创建时的投放设置有所不同（计数结果基于转化事件发生的时间统计） |
| | 求和 | |
| | true | true |
| | true | true |
| | real_time_cost_per_conversion | 实时单次转化费用 |
| | string | 广告花费平均到单次转化的成本（计数结果基于转化事件发生的时间统计） |
| | Real-time CPA
=（总消耗/实时转化）× 100%
Real-time CPA =（spend/real_time_conversion）× 100% | |
| | true | true |
| | true | true |
| | real_time_conversion_rate_v2 | 实时转化率（展示） |
| | string | 转化次数占广告获得的总展示次数的百分比。 |
| （总计数取决于实际发生转化的时间。） | Real-time转化率=（实时转化/展示数）× 100%
Real-timeCVR (Impression=（real_time_conversion/impressions）× 100% | |
| | true | true |
| | true | true |
| | result | 成效 |
| | string | 广告最终实现成效的次数，与您的优化目标相对应。不支持广告主维度和推广系列维度查询（计数结果基于展示时间点统计） |
| | 求和 | |
| | false | false |
| | true | true |
| | cost_per_result | 单次成效费用 |
| | string | 获得单次成效的成本。（计数结果基于展示时间点统计）不支持广告主维度和推广系列维度查询。 |
| | Cost per result
=（总消耗/成效）× 100%
Cost per result=（spend/result）× 100% | |
| | false | false |
| | true | true |
| | result_rate | 成效率 (%) |
| | string | 广告观看或点击过程中获得成效的占比。（计数结果基于展示时间点统计）不支持广告主维度和推广系列维度查询。 |
| | result_rate=（成效/展示数）× 100%
result_rate=（result/impressions）× 100% | |
| | false | false |
| | true | true |
| | real_time_result | 实时成效 |
| | string | 广告最终实现成效的次数，与您的优化目标相对应。不支持广告主维度和推广系列维度查询（计数结果基于转化事件发生的时间统计） |
| | 求和 | |
| | false | false |
| | true | true |
| | real_time_cost_per_result | 实时单次成效费用 |
| | string | 获得单次成效的成本。（计数结果基于转化事件发生的时间统计）不支持广告主维度和推广系列维度查询。 |
| | Real-time cost per result=（总消耗/实时成效）× 100%
Real-time cost per result=（spend/real_time_result）× 100% | |
| | false | false |
| | true | true |
| | real_time_result_rate | 实时成效率 (%) |
| | string | 广告观看或点击过程中获得成效的占比。（计数结果基于转化事件发生的时间统计）不支持广告主维度和推广系列维度查询。 |
| | Real-time result rate =（实时成效/展示数）× 100%
Real-time result rate =（实时成效/impressions）× 100% | |
| | false | false |
| | true | true |
| | frequency | 频次 |
| | string | 平均每个被覆盖用户的观看次数。 |
| | frequency=展示数/总覆盖人数
frequency=impressions/reach | |
| | true | true |
| | true | false |
| | currency | 货币 |
| | string | 货币代码，比如USD。请注意如果要使用currency作为指标，则请求中的dimensions字段必须包含adgroup_id/ad_id/campaign_id/advertiser_id。 |
| | 保存即可 | |
| | true | true |
| | true | true |
| | （3）视频播放数据指标
指标名称 | 系统名称 |
| | 数据类型 | 详细描述 |
| | 汇总计算公式 | |
| video_play_actions | 播放次数 | string |
| | 视频播放的次数，不计重播。 | 求和 |
| | video_watched_2s | 播放2s次数 |
| | string | 视频播放达2s的次数，不计重播。 |
| | 求和 | |
| video_watched_continuous_2s | 连续观看 2 秒次数 | string |
| | 视频至少连续播放 2 秒且至少 50% 的视频像素处于可见区域内的次数。 | 求和 |
| | video_watched_6s | 播放6s次数 |
| | string | 视频播放达6s或播放完成的次数，不计重播。 |
| | 求和 | |
| average_video_play | 平均视频播放时长 | string |
| | 视频平均每次播放时长，包括重播时长。 | 平均数=求和/非0天的天数 |
| | average_video_play_per_user | 平均每人播放时长 |
| | string | 视频平均每人播放时长，包括重播时长。该指标为预估所得。 |
| | 平均数=求和/非0天的天数 | |
| video_views_p25 | 播放25%次数 | string |
| | 视频播放到25%的次数，不计重播。 | 求和 |
| | video_views_p50 | 播放50%次数 |
| | string | 视频播放到50%的次数，不计重播。 |
| | 求和 | |
| video_views_p75 | 播放75%次数 | string |
| | 视频播放到75%的次数，不计重播。 | 求和 |
| | video_views_p100 | 播放100%次数 |
| | string | 视频播放到100%的次数，不计重播。 |
| | 求和 | |
| engaged_view | 观看6秒次数（专注观看） | string |
| | 用户观看视频时长达到6秒，或观看付费广告的一天内与视频互动至少一次。纳入统计的互动包括：点赞，分享，关注，访问主页，点击，话题标签点击，音乐点击，锚点点击，以及创新互动样式行为点击。 | 求和 |
| | engaged_view_15s | 观看15秒次数（专注观看） |
| | string | 用户观看视频时长达到15秒，或观看付费广告的一天内与视频互动至少一次。纳入统计的互动包括：点赞，分享，关注，访问主页，点击，话题标签点击，音乐点击，锚点点击，以及创新互动样式行为点击。 |
| | 求和 | |
| （4）商店事件指标
指标名称 | 系统名称 | 详细描述 |
| | 汇总计算公式 | |
| ROAS（商店） | | |
| onsite_shopping_roas | ROAS（商店） | 归因于广告的 TikTok Shop 总收入的广告支出回报率 (ROAS)。总计数是根据每次广告展示的时间计算的。 |
| | ROAS =总收入（商店）/总消耗
ROAS =total_onsite_shopping_value/spend | |
| 付费数（商店） | | |
| onsite_shopping | 付费数（商店） | 归因于广告的 TikTok Shop 订单提交操作数。总计数是根据每次广告展示的时间计算的。 |
| | 求和 | |
| cost_per_onsite_shopping | 平均付费成本（商店） | 归因于广告的每次 TikTok Shop 付费的平均成本。总计数是根据每次广告展示的时间计算的。 |
| | Cost per purchase (Shop) =总消耗/付费数（商店）
Cost per purchase (Shop) =spend/onsite_shopping | |
| onsite_shopping_rate | 付费率（商店） (%) | TikTok Shop 付费数占广告点击数的百分比。总计数是根据每次广告展示的时间计算的。 |
| | Purchase rate (Shop) =付费数（商店）/点击量（目标页面）100
Purchase rate (Shop)=onsite_shopping/clicks | |
| value_per_onsite_shopping | 平均订单价值（商店） | 归因于广告的每次 TikTok Shop 付费的平均订单价值。总计数是根据每次广告展示的时间计算的。 |
| | Average order value (Shop) =总收入（商店）/付费数（商店）
Average order value (Shop)=total_onsite_shopping_value/onsite_shopping | |
| total_onsite_shopping_value | 总收入（商店） | 归因于广告的 TikTok Shop 订单的总收入。用户支付的金额加上 TikTok Shop 平台向用户提供的所有折扣。总计数是根据每次广告展示的时间计算的。 |
| | 求和 | |
| 开始结账数（商店） | | |
| onsite_initiate_checkout_count | 开始结账数（商店） | 归因于广告的 TikTok Shop 开始结账操作数，例如商品页面上的"立即购买"和"使用优惠券购买"按钮获得的点击数。总计数是根据每次广告展示的时间计算的。 |
| | 求和 | |
| cost_per_onsite_initiate_checkout_count | 开始结账平均成本（商店） | 归因于广告的 TikTok Shop 开始结账操作的平均成本。总计数是根据每次广告展示的时间计算的。 |
| | Cost per checkout initiated (Shop) =总消耗/开始结账数（商店）
Cost per checkout initiated (Shop) =spend/onsite_initiate_checkout_count | |
| onsite_initiate_checkout_count_rate | 开始结账率（商店） (%) | TikTok Shop 开始结账操作数占广告点击数的百分比。总计数是根据每次广告展示的时间计算的。 |
| | Checkout initiation rate (Shop) =开始结账数（商店）/点击量（目标页面）100
Checkout initiation rate (Shop) =onsite_initiate_checkout_count/clicks | |
| value_per_onsite_initiate_checkout_count | 开始结账平均价值（商店） | 归因于广告的 TikTok Shop 开始结账操作的平均价值。总计数是根据每次广告展示的时间计算的。 |
| | Value per checkout initiated (Shop) =开始结账价值（商店）/开始结账数（商店）
Value per checkout initiated (Shop) =value_per_onsite_initiate_checkout_count/onsite_shopping | |
| total_onsite_initiate_checkout_count_value | 开始结账价值（商店） | 归因于广告的 TikTok Shop 开始结账操作的总价值。总计数是根据每次广告展示的时间计算的。 |
| | 求和 | |
| 商品页浏览数（商店） | | |
| onsite_on_web_detail | 商品页浏览数（商店） | 归因于广告的 TikTok Shop 商品详情页浏览数。总计数是根据每次广告展示的时间计算的。 |
| | 求和 | |
| cost_per_onsite_on_web_detail | 商品页浏览平均成本（商店） | 归因于广告的每次 TikTok Shop 商品详情页浏览的平均成本。总计数是根据每次广告展示的时间计算的。 |
| | Cost per product page view (Shop) =总消耗/商品页浏览数（商店）
Cost per product page view (Shop) =spend/onsite_on_web_detail | |
| onsite_on_web_detail_rate | 商品页浏览率（商店） (%) | TikTok Shop 商品详情页浏览数占广告点击数的百分比。总计数是根据每次广告展示的时间计算的。 |
| | Product page view rate (Shop) =商品页浏览数（商店）/点击量（目标页面）100
Product page view rate (Shop) =onsite_on_web_detail/clicks | |
| value_per_onsite_on_web_detail | 商品页浏览平均价值（商店） | 归因于广告的每次 TikTok Shop 商品详情页浏览的平均价值。总计数是根据每次广告展示的时间计算的。 |
| | Value per product page view (Shop) =商品页浏览价值（商店）/商品页浏览数（商店）
Value per product page view (Shop) =total_onsite_on_web_detail_value/onsite_on_web_detail | |
| total_onsite_on_web_detail_value | 商品页浏览价值（商店） | 归因于广告的 TikTok Shop 商品详情页浏览的总价值。总计数是根据每次广告展示的时间计算的。 |
| | 求和 | |
| 加入购物车数（商店） | | |
| onsite_on_web_cart | 加入购物车数（商店） | 归因于广告的 TikTok Shop 加入购物车操作数。总计数是根据每次广告展示的时间计算的。 |
| | 求和 | |
| cost_per_onsite_on_web_cart | 加入购物车平均成本（商店） | 归因于广告的 TikTok Shop 加入购物车操作的平均成本。总计数是根据每次广告展示的时间计算的。 |
| | Cost per add to cart (Shop) =总消耗/加入购物车数（商店）
Cost per add to cart (Shop) =spend/onsite_on_web_cart | |
| onsite_on_web_cart_rate | 加入购物车率（商店） (%) | TikTok Shop 加入购物车操作数占广告点击数的百分比。总计数是根据每次广告展示的时间计算的。 |
| | Add to cart rate (Shop) =加入购物车数（商店）/点击量（目标页面）100
Add to cart rate (Shop) =onsite_on_web_cart/clicks | |
| value_per_onsite_on_web_cart | 加入购物车平均价值（商店） | 归因于广告的 TikTok Shop 加入购物车操作的平均价值。总计数是根据每次广告展示的时间计算的。 |
| | Value per add to cart (Shop) =加入购物车数（商店）/加入购物车价值（商店）
Value per add to cart (Shop) =onsite_on_web_cart/total_onsite_on_web_cart_value | |
| total_onsite_on_web_cart_value | 加入购物车价值（商店） | 归因于广告的 TikTok Shop 加入购物车操作的总价值。总计数是根据每次广告展示的时间计算的。 |
| | 求和 | |
| （5）live指标
指标名称 | 简要描述 | 详细描述 |
| | 汇总计算公式 | |
| live_views | LIVE 播放量 | 观众访问您的 LIVE 的次数。 包含重复访问。 |
| | 求和 | |
| live_unique_views | LIVE 去重播放量 | 进入您的 LIVE 的去重观众的数量。 |
| | 求和 | |
| live_effective_views | LIVE 有效播放量 | 观众访问您的 LIVE 超过 10 秒的次数。 包含重复访问。 |
| | 求和 | |
| live_product_clicks | LIVE 商品点击数 | 观众在 LIVE 播放过程中点击商品查看商品详细信息页面的次数。 |
| | 求和 | |
| 3.广告列表的操作说明
操作 | 调用接口 | 支持操作的广告层级 |
| | 操作场景 | |
| 编辑预算 | （1）广告系列则调用更新广告系列接口
（2）广告组调用更新广告组预算接口 | 广告系列 |
| 广告组 | （1）单个编辑 | |
【图片】
（2）批量编辑预算
①勾选了不同的广告账户的广告组点击批量编辑则toast提示“请勿勾选不同广告账户的广告系列/广告组进行编辑”
②仅支持勾选20个进行编辑预算，点击超过20个则弹出toast提示“一次只能勾选20条进行操作”
③勾选同个广告账户的广告组点击批量编辑的情况下出现以下弹窗
日预算：budget_mode=BUDGET_MODE_DAY、BUDGET_MODE_DYNAMIC_DAILY_BUDGET
总预算：budget_mode=BUDGET_MODE_TOTAL
无法修改：覆盖和频次广告系列 + SPC +CBO 不支持修改预算
广告系列下buying_types为RESERVATION_RF、RESERVATION_TOP_VIEW 或者is_smart_performance_campaign为ture、budget_optimize_on为ture的广告系列以及下层的广告组都不能进行预算修改
【图片】
无法修改的广告系列/广告组显示在此无法进行编辑
【图片】
如果此次勾选的广告系列和广告组没有对应预算类型则显示如下
【图片】
提交后显示处理结果如下：
| 【图片】 | |
| --- | --- |
| 编辑出价 | （1）广告组调用更新广告组接口更新bid_price |
| | 广告组 |
| | （1）单个编辑 |
| 【图片】 | |
（2）批量编辑
①仅支持勾选10个进行编辑出价，点击超过20个则弹出toast提示“一次只能勾选10条进行操作”
②勾选了不同的广告账户的广告组点击批量编辑则toast提示“请勿勾选不同广告账户的广告组进行编辑”
③勾选同个广告账户的广告组点击批量编辑的情况下出现以下弹窗
提交编辑的时候
如果billing_event = OCPM 和 bid_type = BID_TYPE_CUSTOM的情况下, 编辑conversion_bid_price
其他情况下，编辑bid_price
【图片】
提交后显示处理结果如下：
| 【图片】 | |
| --- | --- |
| 启动/停止/删除 | （1）广告系列调用接口更新广告系列操作状态 |
| （2）广告组调用接口更新广告组状态
（3）广告调用接口更新广告状态 | 广告系列 |
| 广告组
广告 | 仅支持勾选20个进行编辑预算，提示“一次只能勾选20条进行操作” |
| 启动/停止/删除 | |
【图片】
提交成功
【图片】
提交失败
| 【图片】 | |
| --- | --- |
| 日志 | 系统记录 |
| | 广告系列 |
| 广告组
广告 | 系统固定的日志弹窗。弹窗内容见下的日志场景说明 |
| 日志说明
操作人 | 操作场景 |
| | 操作文案 |
| 系统/用户 | 平台/用户更新预算 |
| | 预算由23.00 USD更新为78.12 USD。 |
| 系统/用户 | 平台/用户更新出价 |
| | 出价由23.00 USD更新为78.12 USD。 |
| 系统/用户 | 平台更新操作状态 |
| | 操作状态更新为关闭/开启/删除 |
| 系统 | 平台更新投放状态 |
| | 广告投放状态更新为投放中-超出预算。 |
4.筛选项 （1）数据显示维度：汇总/日/周/月 汇总：显示筛选时间所有数据的汇总 日：筛选时间内所有的数据按照天的维度分别显示每天的数据 周：筛选时间内数据按照自然周分别显示每周的数据 （2）广告主账号：系统授权账号。下拉显示账号别名并且支持搜索和多选筛选 （3）广告账户：下拉显示广告账户名称支持筛选并且多选筛选 （4）以下字段支持模糊搜索。 广告系列名称 广告组名称 广告名称 广告系列ID 广告组ID 广告ID （5）广告系列投放状态。支持以下枚举值，支持多选 未投放 投放中 已删除 已暂停 （6）广告组投放状态，支持以下枚举值，支持多选 投放中 未投放 已暂停 已完成 已删除 已关闭 （7）广告投放状态，支持以下枚举值，支持多选 投放中 未投放 已暂停 已完成 已删除 已关闭
5.导出 【图片】 （1）导出的文件名称格式为日期+时间+5位自增数例如2024080817191100001 （2）在哪个页面上点击导出则导出对应广告维度的数据 （3）导出的时候按照勾选的维度导出对应维度的字段。 （4）导出当前广告维度按照筛选结果中最近的1万条数据。
2024-07-29 ｜ 已完成 ｜ ECERPH-14095 🚀【0-1】
标题：账号授权》新增TIKTOK广告授权页面
负责人：梁康太 ｜ 需求类型：客户需求 ｜ 模块：TikTok-达人模块 ｜ 迭代：20240813-常规-8月第二迭代 ｜ 最后更新：2024-08-13
原始需求：01_原始需求\ECERPH-14095_账号授权》新增TIKTOK广告授权页面\原始需求.md
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
将tiktok广告授权作为一个新的平台对接。 支持用户授权广告主账号。授权后广告主账号下所有层级的数据都能访问
广告层级关系 层级为：广告主账号》广告管理中心》广告系列》广告组》广告 【图片】
-
需求（做什么？怎么做？有什么要注意的？）
-
新平台名称：Tiktok for Business（图标见附件）
-
官方授权说明：
https://business-api.tiktok.com/portal/docs?id=1738373141733378 （注意：翻墙才能访问）
注意事项 （1）广告开发者账号已注册并且审核通过。具体请找@陈家宜(陈+1) （2）广告开发者不区分美国和非美国，一个广告开发者账号支持被全球广告主授权 （3）授权的主体是广告主，授权后广告主帐号下有权限的所有广告管理平台帐号和商务中心帐号一起授权的，所以后续这个广告主的tt4b有了其他广告账号的权限，对应的access token也是可以同时访问新的广告账号。 2.沙盒和postman postman：https://business-api.tiktok.com/portal/docs?id=1747849403155521 沙盒：https://business-api.tiktok.com/portal/docs?id=1738855331457026 申请的沙盒账号： 广告主ID：7395503070970691601 token：9057743ff56189206bd51a2bb815b2f44337d108
3.授权界面原型 (1)将新增Tiktok for Business的平台的授权页面如下 【图片】
（2）点击【添加广告账号】的弹窗如下 【图片】
（3）点击弹窗内的“开始授权”跳转tiktok的授权页面/登录页面（取决于客户有无登录） 【图片】
（4）确认授权后跳转到系统再确认生成广告账号信息 【图片】
（5）授权成功后调用接口：https://business-api.tiktok.com/portal/docs?id=1739593083610113 将币种和时区都推送给业务系统 【图片】