海外短剧榜单检索台

新剧 30 天榜（顶部第 2 个页签） —— 核心定义：上线当天起 30 个自然日内，有效播放量 ≥ 2000 万，按有效播放量由高到低排列。
    · 时间窗口：D0（上线当天）~ D29，共 30 个自然日，不是「近 30 天滚动」。
    · 有效播放量：OA 后台 innerfeedVv（站内信息流播放）真值，按 T+3 落库，快照 2026-11-04；取平台真值，不估算、不推算。
    · 阈值：≥ 2000 万即上榜（含正好等于）。
    · 「数据至第 N 天」：这个数覆盖到上线后第 N 个自然日，N 按 OA 的 statDate 归属日算，不是页面查看日——所以它比日历上的「上线第几天」少 3 天（T+3 落库）。
    · 没满 30 天怎么算：上线不足 30 天的剧，其累计有效播放本身就全部落在窗口内，直接取累计值，标「N/30 天」；满 30 天的取 D29 当天累计值，标「30/30 天」，不多算第 31 天。
    · 归档区（顶部第 3 个页签）：满 30 天后自动转入归档，数值固定在 D29 累计、不再变化；只保留 3 天内数据，第 4 天移出。
    · 收录范围：OA 在库的公司剧集（只有这些剧有平台有效播放口径）。TK 全站收录的剧目没有 OA 有效播放数据，不进本榜。
    · 窗口区间：2026-10-06 ~ 2026-11-04。点任意一行，会自动回到主页面定位并展开该剧。

三个板块的口径各自独立，不要混读：
① App 内剧集榜：DramaBox / ReelShort / FlickReels / GoodShort 等 12 个 App 的官方榜单（Top Picks / New Releases / Trending 等 27 个榜型），字段为平台原始名次与热度值，每榜每日仅存前 20 名。
② TikTok 热播榜：DataEye 按端原生播放增量排序，每行是「剧 × 剧场号」，名次为全站真实名次，本台只取前 30。
③ 累计播放量（官方在册剧场号口径，T+1）
    · 定义（2026-10-28 定稿）：该剧名在 TikTok 官方登记的全部剧场号，各自那份剧集页面的播放量之和，直接取 /api/drama/user/drama_list 的官方真值，抓于 2026-11-08，不估算、不推算。全库统计条「累计播放合计」57.49 亿；其中 352 部剧取到官方数据。
    · 在册就计入：不看这个号发没发过推广视频、上没上过榜——只要官方后台把它登记成这部剧的剧场号、它的剧集页面有播放量，就加进累计。这里统计的是「官方认这部剧属于谁」，不是「谁在投」。
    · 中英文名是同一部剧：TikTok 官方剧名跟着访问语言变（同一 dramaID，英文环境叫 Seducing the Untouchable Duke，繁中环境叫「復仇女僕誘惑高冷公爵」）。本台分英文 / 繁中两种语言各抓一遍官方剧单，按 dramaID 合并，所以中英文名都能对上、都能归到同一部剧，而不会重复累加。当前 312 部剧同时拿到中/外文双名（其中 254 部是中文名，个别剧在中文环境回落日文原名）。
    · 多副本怎么算：同一个账号可能把同一部剧上传成多个 dramaID（各是一个独立剧集页面，播放量各自真实），这些都算进去；不同剧场号镜像上架同一部剧（各自一个 dramaID）也算进去。唯一去重的是同一个 dramaID——它在英文和中文环境各出现一次，只算一次。
    · 账号身份：以 TikTok secUid 为唯一键。剧场号会改名，页面只显示平台当前的最新昵称（旧昵称不再出现，但同一 secUid 的累计不会重复计）；同名但不同号（如多个 dramablue）是两个真实账号，各自独立累加。
    · 日期（T+1）：官方剧集播放按 T+1 结算，今天拿到的是截至昨天的累计值，抓于 2026-11-08；OA 累计播放与有效播放按 T+3 落库，快照 2026-11-04。两者不同源、不同日，不相减、不算覆盖率。
    · OA 累计播放（并列对照，不可相减）：同卡另列 OA 后台「播放量」列（vv，平台剧集口径，T+3，全库 60.57 亿，快照 2026-11-04）。它统计的是该剧集在全渠道的累计播放；本台「累计播放量」统计的是官方在册剧场号各自剧集页面的播放。两个数口径不同、日期也不同，所以不做比率、不互相替代。
    · 逐号明细在哪看：页面只给累计值、不铺明细。逐号明细（剧场号 × dramaID × 集数 × 官方播放）见 outputs/官方账号剧单全量.csv，按剧汇总见 outputs/剧目累计播放量.csv。
    · 主编 / 编剧：取自 OA 短剧采买 / 销售 → 剧本管理（剧本库 1462 条：原创 1111 / IP 改编 88 / 外采 263），按剧名与剧本库的英文发行名对齐，当前 241 部剧已带上主编与编剧；剧本库里只有中文原名、没有登记英文发行名的剧显示「—」，不推测、不套用同名剧。该接口只有「主编」「编剧」两个字段，没有总编（总编是组织架构岗位，不挂在剧本上）。
    · TK 全站剧目（非公司版权）：这类剧没有 OA 剧集口径；能匹配到官方在册剧场号的按官方账号累计算，匹配不到的才回落到 DataEye 矩阵合计（全库 1946.67 亿，标签 tooltip 里会写明是矩阵口径）。当前收录 4383 部。
    · 同名剧收敛：一个剧名在平台上往往对应几十条 playletId——多语言版本、多次上架（同一部剧，应当合并），也可能只是同名的另一部剧（不能合并；实例：Mistakenly Married to the CEO 同名候选 39 个，集数 20~100，上线日横跨 5 个月）。本台按 ①集数一致 → ②推广账号归属 认定：全公司矩阵只有 66 个去重推广号，同一批号会推我们很多部剧，所以「这个 playletId 的推广号是否也出现在我方其它剧里」是极干净的判据——我方真身的账号重合度普遍 100%，同名的竞争对手剧普遍 0%。命中后只认这一个 playletId，全部按 secUid 去重、按「账号 × 上传副本」取历史最高值累加；对不上的同名记录一律不计入，避免把别人的剧算进来虚增。
    · 上线时间：剧集发布时间，精确到分（如 2026-08-02 00:00）。
    · 有效播放量（紫色标签 有效 xx）：自剧集上线起，到数据抓取的最新时刻，有效播放量的累计总和（平台 innerfeedVv，即站内信息流播放）。取平台真值，不做任何推算。与「OA 累计播放」同源同快照（OA 中台、同一剧集、同一 2026-11-04，T+3），详情页「站内有效率」= 有效 ÷ OA 累计播放——这是页面上唯一合法的比率（同源、同日、分母同口径）。
    · 人均播放时长（青色标签 人均 xx）：自上线起到最新时刻，单个用户平均累计观看时长，平台原值（总观看时长 ÷ 去重用户），不做二次换算。
    · 完播量（仅详情页）：平台 vvFinish，完整看完一集的播放次数累计，不等于有效播放量。
④ 快照口径：App 榜每个榜每天只留 10:00 一次快照的前 20 位，TikTok 榜留前 30。短时冲榜、当日内掉榜的名次无法回溯；遇到业务侧与平台口径不一致时，本台如实留空并标注原因，不做补造。
⑤ 仅 App 上榜：在剧场 App 榜有记录、但 TikTok 端完全没有记录（未进 TK 热播榜、也不在 TK 全量剧目库）的剧目，单独归为一类。 这类剧没有官方在册剧场号，只有 App 榜名次与 App 侧披露的估算播放量；App 榜不公布集数，故不显示集数。
三个源的剧名体系不同（App 内常换名），因此同一部剧可能只在其中一个板块有数据，不做强行关联。