Compare commits

...

1 Commits

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