Compare commits

..

1 Commits

Author SHA1 Message Date
linkeyu 4f43450afa 修复:按加权口径展示分类 eCPM 2026-07-26 19:58:13 +08:00
2 changed files with 102 additions and 166 deletions
+89 -149
View File
@@ -9,6 +9,7 @@ import {
Card,
Col,
DatePicker,
Descriptions,
Divider,
InputNumber,
Modal,
@@ -42,8 +43,6 @@ import type {
import UserAdRevenueDrawer from './UserAdRevenueDrawer';
const { RangePicker } = DatePicker;
const DEFAULT_PAGE_SIZE = 50;
const ALL_FILTER_VALUE = '__all__';
// 广告类型标签
const TYPE_TAG: Record<string, { color: string; label: string }> = {
@@ -82,12 +81,20 @@ const PLAYBACK_STATUS_TAG: Record<string, { color: string; label: string }> = {
unknown: { color: 'default', label: '未知' },
};
const ZERO_REVENUE_REWARD_VIDEO_STATUSES = new Set(['closed_early', 'too_short']);
function rewardStatuses(row: AdRevenueRow): string[] {
if (row.sub_rewards?.length) return row.sub_rewards.map((reward) => reward.status);
return row.status ? [row.status] : [];
}
function effectiveRevenueYuan(row: AdRevenueRow): number {
if (
row.ad_type === 'reward_video'
&& rewardStatuses(row).some((status) => ZERO_REVENUE_REWARD_VIDEO_STATUSES.has(status))
) {
return 0;
}
return row.row_revenue_yuan ?? row.revenue_yuan;
}
@@ -183,59 +190,11 @@ const LT_FACTOR_ROWS = [
{ key: '5', lt: '第 11 条及以后', factor: 1.0 },
];
type AdRevenueDetailRow = AdRevenueRecord & {
source_adn?: string | null;
is_impression_only?: boolean;
};
// 未发奖记录保留「-」以避免把潜在奖励误读为实际计算结果;悬停时说明为何没有因子。
function renderFormulaValue(value: string | number, row: AdRevenueDetailRow) {
if (value !== '-' || row.status === 'granted') return value;
const reason = row.is_impression_only
? '该记录只有广告展示,没有对应发奖记录'
: REWARD_STATUS_HINT[row.status] ?? `发奖状态为 ${row.status}`;
return (
<Tooltip title={`${reason};未进入金币计算,不占用 LT 累计条数,因此不展示因子。`}>
<span>-</span>
</Tooltip>
);
}
function impressionOnlyDetail(row: AdRevenueRow): AdRevenueDetailRow {
return {
// 每个展开表只有这一条纯展示明细,使用稳定的本行唯一键即可。
record_id: 0,
created_at: row.created_at,
status: 'impression_only',
ecpm: row.ecpm,
ecpm_factor: null,
units: 0,
lt_index_start: null,
lt_index_end: null,
lt_factor_start: null,
lt_factor_end: null,
expected_coin: 0,
actual_coin: 0,
matched: true,
adn: row.adn,
slot_id: row.slot_id,
source_adn: row.adn,
is_impression_only: true,
};
}
type AdRevenueDetailRow = AdRevenueRecord & { source_adn?: string | null };
// 展开行(逐条事件展开)- 该条的发奖复算明细(还原金币审计的 eCPM/因子1/份数/LT/因子2 等列)
const DETAIL_COLUMNS: ColumnsType<AdRevenueDetailRow> = [
{
title: '来源广告网络',
dataIndex: 'source_adn',
width: 110,
render: (value: string | null) => value?.trim() || (
<Tooltip title="该历史记录没有可唯一确认的 SDK 广告来源,未猜测填充。">
<span></span>
</Tooltip>
),
},
{ title: '来源广告网络', dataIndex: 'source_adn', width: 110, render: (value: string | null) => value || '-' },
{
title: 'eCPM(元)',
dataIndex: 'ecpm',
@@ -249,40 +208,33 @@ const DETAIL_COLUMNS: ColumnsType<AdRevenueDetailRow> = [
render: (v: string | null) => (v == null || Number.isNaN(Number(v)) ? '-' : (Number(v) / 100 / 1000).toFixed(4)),
},
{ title: '实发金币数', dataIndex: 'actual_coin', width: 100 },
{
title: '因子1',
dataIndex: 'ecpm_factor',
width: 70,
render: (v: number | null, r: AdRevenueDetailRow) => renderFormulaValue(v ?? '-', r),
},
{ title: '因子1', dataIndex: 'ecpm_factor', width: 70, render: (v: number | null) => v ?? '-' },
{
title: '因子2',
key: 'lt_factor',
width: 90,
render: (_: unknown, r: AdRevenueDetailRow) =>
renderFormulaValue(fmtFactorRange(r.lt_factor_start, r.lt_factor_end), r),
render: (_: unknown, r: AdRevenueDetailRow) => fmtFactorRange(r.lt_factor_start, r.lt_factor_end),
},
{
title: 'LT累计条数',
key: 'lt_index',
width: 100,
render: (_: unknown, r: AdRevenueDetailRow) =>
renderFormulaValue(fmtIndexRange(r.lt_index_start, r.lt_index_end), r),
render: (_: unknown, r: AdRevenueDetailRow) => fmtIndexRange(r.lt_index_start, r.lt_index_end),
},
];
// 趋势图(纯 SVG,零依赖):柱=展示条数(左轴),橙线=客户端预估收益元(右轴),
// 绿线=GroMore 排序价预估元(右轴,仅按天且有数据时出现)。x 轴按传入点序。
// 绿线=穿山甲后台预估收益元(右轴,仅按天且有数据时出现)。x 轴按传入点序。
const CHART_BAR = '#69b1ff';
const CHART_LINE = '#fa8c16';
const CHART_LINE2 = '#52c41a'; // GroMore 排序价预估线
const CHART_LINE2 = '#52c41a'; // 穿山甲后台收益线
interface TrendPoint {
label: string; // x 轴刻度文案(小时数 / MM-DD)
tip: string; // hover 原生 tooltip 全文
impressions: number;
revenue: number;
pangleRevenue: number | null; // GroMore 排序价预估(元);无则 null(不画绿线点)
pangleRevenue: number | null; // 穿山甲后台预估收益(元);无则 null(不画绿线点)
}
// 按小时聚合(023),数据源是 hourly(后端全量聚合,不受分页影响)。穿山甲为天级,小时视图无该线。
@@ -303,7 +255,7 @@ function aggregateHourly(rows: AdRevenueHourly[]): TrendPoint[] {
}
// 按天聚合,数据源是 daily(全量,不受 limit 影响);用 from..to 补齐空缺日为 0,轴连续。
// GroMore 排序价预估(pangle_revenue_yuan)为 null 时该日不画绿线点(T+1 未出/非全量视图)。
// 穿山甲收益(pangle_revenue_yuan)为 null 时该日不画绿线点(T+1 未出/非全量视图)。
function aggregateDaily(dateFrom: string, dateTo: string, daily: AdRevenueDaily[]): TrendPoint[] {
const map = new Map(daily.map((d) => [d.date, d]));
const out: TrendPoint[] = [];
@@ -392,7 +344,7 @@ function TrendChart({ points }: { points: TrendPoint[] }) {
<title>{p.tip}</title>
</circle>
))}
{/* GroMore 排序价预估线(绿,仅非 null 的天画;按天且已同步 T+1 数据时出现) */}
{/* 穿山甲后台收益线(绿,仅非 null 的天画;按天且已同步 T+1 数据时出现) */}
{(() => {
const pp = points
.map((p, i) => ({ i, v: p.pangleRevenue, tip: p.tip }))
@@ -435,13 +387,13 @@ export default function AdRevenueReportPage() {
const [scene, setScene] = useState<string | undefined>();
const [granularity, setGranularity] = useState<'day' | 'hour'>('day');
const [sortBy, setSortBy] = useState<'time' | 'ecpm'>('time'); // 明细排序:time=时间倒序 / ecpm=eCPM 倒序
const [limit, setLimit] = useState<number>(DEFAULT_PAGE_SIZE);
const [limit, setLimit] = useState<number>(1000); // 默认拉满接口单页上限,供单次流程广告数分位统计
const [page, setPage] = useState<number>(1); // 当前页码(后端分页;1 起)
const [queriedGranularity, setQueriedGranularity] = useState<'day' | 'hour'>('day'); // 本次结果对应的粒度,决定是否显示「小时」列
const [queriedMultiDay, setQueriedMultiDay] = useState(false); // 本次结果是否跨多天,决定显示「日期」列 + 按天/按小时图
const [data, setData] = useState<AdRevenueReport | null>(null);
const [allFlowItems, setAllFlowItems] = useState<AdRevenueRow[]>([]);
const [queriedLimit, setQueriedLimit] = useState<number>(DEFAULT_PAGE_SIZE);
const [queriedLimit, setQueriedLimit] = useState<number>(1000);
const [loading, setLoading] = useState(false);
const [formulaOpen, setFormulaOpen] = useState(false);
// 点用户手机号弹出的「用户广告收益详情」半屏抽屉(userId + 手机号;null=关闭)
@@ -606,6 +558,7 @@ export default function AdRevenueReportPage() {
width: 110,
align: 'right',
// 一次比价/领券聚合行用 row_revenue_yuan(该次发奖广告 eCPM 折算之和),其它行用展示侧 revenue_yuan
// 激励视频提前关闭/时长不足时防御性显示 0,与后端有效收益口径一致。
render: (_v: number, r: AdRevenueRow) => effectiveRevenueYuan(r).toFixed(4),
},
{
@@ -684,8 +637,6 @@ export default function AdRevenueReportPage() {
// 应发实发差额(金币)= 应发−实发(正=少发/负=多发);ARPU = 区间预估收益÷区间活跃用户(见 dau)。
const derived = data
? {
// ADN Reporting API 只覆盖已配置回传的广告源,不能据此推导全量 ARPU / 毛利。
// 在接入最终结算单前,核心经营指标始终使用 SDK 展示预估,并明确标注其性质。
payoutYuan: data.total_actual_coin / COIN_PER_YUAN,
grossProfit: data.total_revenue_yuan - data.total_actual_coin / COIN_PER_YUAN,
payoutRatioPct:
@@ -693,6 +644,7 @@ export default function AdRevenueReportPage() {
? (data.total_actual_coin / COIN_PER_YUAN / data.total_revenue_yuan) * 100
: null,
coinGap: data.total_expected_coin - data.total_actual_coin,
// ARPU = 区间预估广告收益 ÷ 区间去重活跃用户(dau,口径同数据大盘);dau 为 0 时不可算 → null,显示「-」。
arpu: data.dau && data.dau > 0 ? data.total_revenue_yuan / data.dau : null,
}
: null;
@@ -709,15 +661,17 @@ export default function AdRevenueReportPage() {
: data.date_from
: `${data.date_from} ~ ${data.date_to}`;
// 经营分类由后端统一:Draw = draw + 历史 feed;看视频 = 福利视频 + 提现视频
// eCPM 同时按每次展示的 SDK 原始值加权,不能从前端漏项后再临时平均。
const drawStat = data?.category_stats?.draw;
const videoStat = data?.category_stats?.video;
const videoLabel = adType === 'withdrawal_video'
? '提现看视频'
: adType === 'reward_video'
? '福利看视频'
: '看视频(福利+提现)';
// eCPM 优先使用后端按真实展示加权的经营分类口径;兼容旧后端时才用收益÷展示数回退
const drawStat = data?.type_stats?.draw;
const rvStat = data?.type_stats?.reward_video;
const withdrawalVideoStat = data?.type_stats?.withdrawal_video;
const drawEcpmStat = data?.category_stats?.draw ?? drawStat;
const videoEcpmStat = data?.category_stats?.video ?? {
impressions: (rvStat?.impressions ?? 0) + (withdrawalVideoStat?.impressions ?? 0),
revenue_yuan: (rvStat?.revenue_yuan ?? 0) + (withdrawalVideoStat?.revenue_yuan ?? 0),
};
const ecpmOf = (s?: AdRevenueTypeStat) =>
s?.ecpm_yuan ?? (s && s.impressions > 0 ? (s.revenue_yuan / s.impressions) * 1000 : 0);
// 明细直接用后端返回的当前页 items(「场景」已由后端 feed_scene 全局过滤,前端不再二次筛)。
const items = data?.items ?? [];
@@ -756,19 +710,14 @@ export default function AdRevenueReportPage() {
( / eCPM / ),+
<br />
<br />
SDK 广(onAdShow) eCPM ( ÷1000
1 沿 0) eCPM
<b> ADN </b>
广(onAdShow) eCPM ( ÷1000
);<b> 0 </b>, eCPM 穿,
<b>穿</b> 0广ID / ,
<br />
<br />
<b>GroMore </b> revenue/
<b>ADN Reporting API </b>广 api_revenue 14:00
广 ARPU
<br />
<br />
<b>Draw = draw + feed</b><b> = + </b>
eCPM SDK eCPM eCPM ÷
GroMore //<b></b>(//)
<b>穿(T+1)</b>穿 GroMore API(,):
<b>穿</b>= revenue<b>API</b>= ADN 穿//,
<b></b>(//);穿
+ ;广
</div>
}
@@ -832,11 +781,12 @@ export default function AdRevenueReportPage() {
<Space size={6}>
<Typography.Text type="secondary"></Typography.Text>
<Select
value={adType ?? ALL_FILTER_VALUE}
onChange={(value) => setAdType(value === ALL_FILTER_VALUE ? undefined : value)}
placeholder="全部"
value={adType}
onChange={setAdType}
allowClear
style={{ width: 150 }}
options={[
{ value: ALL_FILTER_VALUE, label: '全部' },
{ value: 'reward_video', label: '看视频' },
{ value: 'draw', label: 'Draw 信息流' },
{ value: 'withdrawal_video', label: '提现看视频' },
@@ -846,11 +796,12 @@ export default function AdRevenueReportPage() {
<Space size={6}>
<Typography.Text type="secondary"></Typography.Text>
<Select
value={scene ?? ALL_FILTER_VALUE}
onChange={(value) => setScene(value === ALL_FILTER_VALUE ? undefined : value)}
placeholder="全部"
value={scene}
onChange={setScene}
allowClear
style={{ width: 130 }}
options={[
{ value: ALL_FILTER_VALUE, label: '全部' },
{ value: 'comparison', label: '比价' },
{ value: 'coupon', label: '领券' },
{ value: 'welfare', label: '福利' },
@@ -913,16 +864,16 @@ export default function AdRevenueReportPage() {
</Divider>
<Row gutter={[16, 12]}>
<Col flex="1 1 0">
<Statistic title="客户端 SDK 展示预估(元)" value={data.total_revenue_yuan} precision={4} />
<Statistic title="预估收益合计(元)" value={data.total_revenue_yuan} precision={4} />
</Col>
<Col flex="1 1 0">
<Statistic
title={
<Tooltip
title={`客户端 SDK 展示预估 ÷ 区间去重活跃用户。ADN Reporting API 可能只覆盖已配置回传的广告源,不能作为全量 ARPU。统计区间:${dauRangeLabel || '—'}`}
title={`每活跃用户广告预估收入 = 区间预估收益 ÷ 区间去重活跃用户(口径同数据大盘)。统计区间:${dauRangeLabel || '—'}`}
>
<span>
SDK ARPU
{dauRangeIsToday ? 'ARPU(今日)' : 'ARPU'}
<InfoCircleOutlined style={{ marginLeft: 4 }} />
</span>
</Tooltip>
@@ -951,7 +902,7 @@ export default function AdRevenueReportPage() {
</Col>
<Col flex="1 1 0">
<Statistic
title="SDK 预估广告毛利(元)"
title="预估广告毛利(元)"
value={derived.grossProfit}
precision={4}
prefix={derived.grossProfit >= 0 ? <RiseOutlined /> : <FallOutlined />}
@@ -964,9 +915,9 @@ export default function AdRevenueReportPage() {
</Col>
</Row>
<Divider orientation="left" plain style={{ marginTop: 20, marginBottom: 16 }}>
<Tooltip title="来自 GroMore 天级数据 API。revenue 是排序价/竞价实时价预估;api_revenue 是已配置 ADN 的 Reporting 回传收益。D+1 14:00 后仅表示 API 同步窗口完成,不代表全部广告源或最终结算。">
<Tooltip title="来自穿山甲 GroMore 数据 API(后台结算口径,T+1 次日出数)。穿山甲不提供分用户/类型/场景维度,故仅在「全量视图」(未按用户/类型/场景筛选)展示;按代码位×应用×日期汇总。revenue=预估收益、收益API=各 ADN 回传更接近结算。">
<Typography.Text type="secondary" style={{ fontSize: 12 }}>
GroMore / ADN (T+1)
穿(T+1)
<InfoCircleOutlined style={{ marginLeft: 4 }} />
</Typography.Text>
</Tooltip>
@@ -975,41 +926,29 @@ export default function AdRevenueReportPage() {
<Row gutter={[16, 12]}>
<Col flex="1 1 0">
<Statistic
title="GroMore 排序价预估(元)"
title="穿山甲预估收益(元)"
value={data.total_pangle_revenue_yuan ?? 0}
precision={4}
/>
</Col>
<Col flex="1 1 0">
<Statistic
title="ADN Reporting API 收益(元)"
title="穿山甲收益API(元)"
value={data.total_pangle_api_revenue_yuan ?? '-'}
precision={data.total_pangle_api_revenue_yuan == null ? undefined : 4}
/>
{data.total_pangle_api_revenue_yuan == null ? (
{data.total_pangle_api_revenue_yuan == null && (
<Typography.Text type="secondary" style={{ fontSize: 12 }}>
Reporting
</Typography.Text>
) : (
<Typography.Text
type={data.pangle_api_revenue_complete ? 'success' : 'warning'}
style={{ fontSize: 12 }}
>
{data.pangle_api_revenue_complete
? '已完成 API 同步(不代表全量结算)'
: '暂估,等待 14:30 API 同步'}
{data.pangle_latest_synced_at
? ` · 同步于 ${formatUtcTime(data.pangle_latest_synced_at)}`
: ''}
Reporting /
</Typography.Text>
)}
</Col>
<Col flex="1 1 0">
<Statistic
title={
<Tooltip title="客户端 SDK 展示预估相对 GroMore 排序价预估的差异;两者都是估算,只用于检查埋点和排序价口径,不代表结算差异">
<Tooltip title="客户端预估相对穿山甲预估的高估幅度 =(客户端预估 − 穿山甲预估)÷ 穿山甲预估;客户端按 onAdShow 计、不滤无效曝光,通常偏高">
<span>
SDK / GroMore
<InfoCircleOutlined style={{ marginLeft: 4 }} />
</span>
</Tooltip>
@@ -1034,7 +973,8 @@ export default function AdRevenueReportPage() {
</Row>
) : (
<Typography.Text type="secondary" style={{ fontSize: 13 }}>
GroMore/ADN
本视图无穿山甲后台收益:(//)
穿 T+1 , <Typography.Text code>scripts/sync_pangle_revenue</Typography.Text>
</Typography.Text>
)}
<Divider orientation="left" plain style={{ marginTop: 20, marginBottom: 16 }}>
@@ -1047,19 +987,19 @@ export default function AdRevenueReportPage() {
<Statistic title="Draw 信息流收益(元)" value={drawStat?.revenue_yuan ?? 0} precision={4} />
</Col>
<Col span={4}>
<Statistic title="Draw 信息流 eCPM(元/千次)" value={drawStat?.ecpm_yuan ?? 0} precision={2} />
<Statistic title="Draw 信息流 eCPM(元/千次)" value={ecpmOf(drawEcpmStat)} precision={2} />
</Col>
<Col span={4}>
<Statistic title="Draw 信息流条数" value={drawStat?.impressions ?? 0} />
</Col>
<Col span={4}>
<Statistic title={`${videoLabel}收益(元)`} value={videoStat?.revenue_yuan ?? 0} precision={4} />
<Statistic title="看视频收益(元)" value={rvStat?.revenue_yuan ?? 0} precision={4} />
</Col>
<Col span={4}>
<Statistic title={`${videoLabel} eCPM(元/千次)`} value={videoStat?.ecpm_yuan ?? 0} precision={2} />
<Statistic title="看视频 eCPM(元/千次)" value={ecpmOf(videoEcpmStat)} precision={2} />
</Col>
<Col span={4}>
<Statistic title={`${videoLabel}条数`} value={videoStat?.impressions ?? 0} />
<Statistic title="看视频条数" value={rvStat?.impressions ?? 0} />
</Col>
</Row>
<Divider orientation="left" plain style={{ marginTop: 20, marginBottom: 16 }}>
@@ -1124,7 +1064,7 @@ export default function AdRevenueReportPage() {
verticalAlign: 'middle',
}}
/>
GroMore ()
穿()
</span>
)}
</Space>
@@ -1168,11 +1108,7 @@ export default function AdRevenueReportPage() {
style={{ marginTop: 8 }}
rowKey="record_id"
columns={DETAIL_COLUMNS}
dataSource={r.sub_rewards.map((detail) => ({
...detail,
// 一次比价/领券可能由不同 ADN 连续填充,必须优先显示本条发奖记录的来源。
source_adn: detail.adn ?? r.adn,
}))}
dataSource={r.sub_rewards.map((detail) => ({ ...detail, source_adn: r.adn }))}
pagination={false}
size="small"
scroll={{ x: 900 }}
@@ -1180,18 +1116,15 @@ export default function AdRevenueReportPage() {
</div>
) : r.reward_detail ? (
<div>
<Typography.Text strong>广</Typography.Text>{' '}
<Typography.Text strong></Typography.Text>{' '}
<Typography.Text type="secondary">
( 1 · {r.reward_detail.expected_coin} / {r.reward_detail.actual_coin})
(广 {r.reward_detail.expected_coin} / {r.reward_detail.actual_coin})
</Typography.Text>
<Table<AdRevenueDetailRow>
style={{ marginTop: 8 }}
rowKey="record_id"
columns={DETAIL_COLUMNS}
dataSource={[{
...r.reward_detail,
source_adn: r.reward_detail.adn ?? r.adn,
}]}
dataSource={[{ ...r.reward_detail, source_adn: r.adn }]}
pagination={false}
size="small"
scroll={{ x: 900 }}
@@ -1199,17 +1132,24 @@ export default function AdRevenueReportPage() {
</div>
) : (
<div>
<Typography.Text strong>广</Typography.Text>{' '}
<Typography.Text type="secondary">( 1 · 0 / 0)</Typography.Text>
<Table<AdRevenueDetailRow>
style={{ marginTop: 8 }}
rowKey="record_id"
columns={DETAIL_COLUMNS}
dataSource={[impressionOnlyDetail(r)]}
pagination={false}
size="small"
scroll={{ x: 900 }}
/>
<Typography.Text strong></Typography.Text>{' '}
<Typography.Text type="secondary">(,,)</Typography.Text>
<Descriptions size="small" column={3} bordered style={{ marginTop: 8 }}>
<Descriptions.Item label="时间">{formatUtcTime(r.created_at)}</Descriptions.Item>
<Descriptions.Item label="eCPM(分)">{r.ecpm ?? '-'}</Descriptions.Item>
<Descriptions.Item label="eCPM(元)">
{r.ecpm != null && !Number.isNaN(Number(r.ecpm))
? (Number(r.ecpm) / 100).toFixed(2)
: '-'}
</Descriptions.Item>
<Descriptions.Item label="预估收益(元)">
{r.has_impression ? r.revenue_yuan.toFixed(4) : '-'}
</Descriptions.Item>
<Descriptions.Item label="底层 ADN">{r.adn ?? '-'}</Descriptions.Item>
<Descriptions.Item label="底层代码位(rit)">{r.slot_id ?? '-'}</Descriptions.Item>
<Descriptions.Item label="我方代码位">{r.our_code_id ?? '-'}</Descriptions.Item>
<Descriptions.Item label="来源应用">{r.app_env ?? '-'}</Descriptions.Item>
</Descriptions>
</div>
),
}}
+13 -17
View File
@@ -542,8 +542,6 @@ export interface AdRevenueRecord {
expected_coin: number;
actual_coin: number;
matched: boolean;
adn: string | null; // 本条发奖的实际填充 ADN(不能只取整场聚合父行)
slot_id: string | null; // 本条发奖的底层 mediation rit
}
// 广告收益报表:按日期汇总的一天(按天趋势图用;全量,不受分页影响)
@@ -551,8 +549,8 @@ export interface AdRevenueDaily {
date: string; // 北京时间 YYYY-MM-DD
impressions: number;
revenue_yuan: number; // 客户端预估收益(eCPM 折算)
pangle_revenue_yuan: number | null; // GroMore 排序价预估(revenue);非全量视图/无数据为 null
pangle_api_revenue_yuan: number | null; // ADN Reporting API 收益;未配/当天/无数据为 null
pangle_revenue_yuan: number | null; // 穿山甲后台预估收益(GroMore revenue);非全量视图/无数据为 null
pangle_api_revenue_yuan: number | null; // 穿山甲收益API(更接近结算);未配/当天/无数据为 null
expected_coin: number;
actual_coin: number;
}
@@ -566,11 +564,11 @@ export interface AdRevenueHourly {
actual_coin: number;
}
// 广告收益报表:展示条数、SDK 展示预估收益与按展示次数加权的 SDK eCPM。
// 广告收益报表:按广告类型(ad_type)的小计(展示条数 + 预估收益;eCPM 前端用 收益÷展示×1000 算)
export interface AdRevenueTypeStat {
impressions: number; // 该类型展示条数合计
revenue_yuan: number; // 该类型预估收益合计(元)
ecpm_yuan: number; // 加权 SDK eCPM(元/千次)
ecpm_yuan?: number; // 按真实展示次数加权 SDK eCPM(元/千次)
}
// 广告收益报表:一次广告事件(逐条一行)。激励视频展示+发奖按 ad_session_id 合并;信息流展示/发奖各自成行。
@@ -589,10 +587,10 @@ export interface AdRevenueRow {
has_impression: boolean; // 是否有广告展示(信息流逐条展示=true,纯发奖行=false)
impressions: number; // 本行展示条数 1/0(供日汇总、趋势图复用)
ecpm: string | null; // 分/千次;展示行取展示值,纯发奖行取发奖采用值
revenue_yuan: number; // 本次 SDK 展示预估收益(元);是否满足发奖条件不改变已产生的展示收入预估
revenue_yuan: number; // 本次有效展示预估收益(元);纯发奖、激励视频提前关闭/时长不足=0
row_revenue_yuan?: number | null; // 主表逐行显示用:一次比价/领券聚合行=该次发奖广告 eCPM 折算之和;其它行空(回退 revenue_yuan)
adn: string | null; // 实际填充 ADN;历史或未上报展示来源为空
slot_id: string | null; // 底层 mediation rit;历史或未上报展示来源为空
adn: string | null; // 实际填充 ADN;纯发奖行为空
slot_id: string | null; // 底层 mediation rit;纯发奖行为空
// ── 发奖侧 ──
has_reward: boolean; // 是否有发奖(激励视频合并行/信息流整场发奖行=true;纯展示=false)
status: string | null; // 发奖状态 granted/closed_early/…;纯展示为空
@@ -609,8 +607,8 @@ export interface AdRevenueReport {
date_to: string; // 结束日 北京时间 YYYY-MM-DD(闭区间;单日时与 date_from 相同)
daily: AdRevenueDaily[]; // 按日期汇总序列(全量,供按天趋势图)
hourly: AdRevenueHourly[]; // 按小时汇总序列(全量,供按小时趋势图;按天查询时为空)
type_stats: Record<string, AdRevenueTypeStat>; // 按原始广告类型小计
category_stats?: Record<string, AdRevenueTypeStat>; // draw=draw+历史feedvideo=福利视频+提现视频(兼容后端滚动发布)
type_stats: Record<string, AdRevenueTypeStat>; // 按广告类型小计;前端取 draw / reward_video
category_stats?: Record<string, AdRevenueTypeStat>; // draw=draw+历史feedvideo=福利视频+提现视频
// 按信息流场景小计(comparison/coupon/welfare;全量,不受分页截断)。数据大盘「领券广告/比价广告」卡
// 优先读它:2026-07-02 后端起 items 不再含信息流逐条展示行(唯一带收益+场景的行),按 items 现算恒 0。
// 可选(`?.` 探测)以兼容未升级后端,缺失时回退 items 现算。
@@ -625,12 +623,10 @@ export interface AdRevenueReport {
total: number; // 当前筛选下的分页总条数(全量,不受分页影响)
truncated: boolean; // 当前页之后是否还有更多事件(分页后前端不再据此报警)
total_impressions: number;
total_revenue_yuan: number; // 客户端 SDK 展示预估合计(后端留存 eCPM 折算)
total_pangle_revenue_yuan: number | null; // GroMore 排序价预估合计(revenue);非全量视图/无数据为 null
total_pangle_api_revenue_yuan: number | null; // ADN Reporting API 收益合计;未配/当天/非全量视图为 null
pangle_api_revenue_complete: boolean; // 每一天均在 D+1 14:00 后完成 API 同步窗口,不代表全量结算
pangle_latest_synced_at: string | null; // GroMore 日报最近同步时间
pangle_revenue_available: boolean; // 本次结果是否带 GroMore/ADN 收益(全量视图且已同步到数据)
total_revenue_yuan: number; // 客户端预估收益合计(eCPM 折算)
total_pangle_revenue_yuan: number | null; // 穿山甲后台预估收益合计(GroMore revenue);非全量视图/无数据为 null
total_pangle_api_revenue_yuan: number | null; // 穿山甲收益API合计(更接近结算);未配/当天/非全量视图为 null
pangle_revenue_available: boolean; // 本次结果是否带穿山甲后台收益(全量视图且已同步到数据)
total_expected_coin: number;
total_actual_coin: number;
mismatch_count: number; // 应发≠实发的发奖条数