Internal Ops Guide

Catena 运营数据手册

面向内部运营和项目管理。重点说明后台有哪些数据、哪些数据可信、哪些状态需要处理,以及客户反馈“看不到数据”时应该先查哪里。

Overview

后台角色分工

内部运营主要负责权限、范围、同步和解释口径,不直接修改客户 AppSecret 或对外承诺投放收益。

账号

客户账号

确认注册邮箱、公司名称、账号状态和邮箱验证状态。未开通账号不能看到真实项目数据。

范围

试玩包绑定

一个客户账号可以绑定多个试玩包。客户只能看到已绑定范围内的数据。

接口

服务商配置

项目管理员首次填 AppID 和 AppSecret。页面只显示脱敏 AppID,不回显密钥。

同步

数据回流

同步会拉取已绑定试玩包的微信回流数据,首次绑定可回填近 30 天历史。

Permission Flow

账号开通和绑定流程

处理客户开通时按以下顺序,不要先同步后绑定。

1. 确认账号检查注册邮箱、公司名、联系人和状态。状态为“待开通”时先确认合作关系。
2. 开通权限在权限管理后台把客户账号改为“已开通”。邮箱未验证时提醒客户先完成邮箱验证。
3. 登记试玩包录入试玩包 ID、展示名称、渠道、客户公司和状态。展示名称应使用市场能看懂的名字。
4. 绑定范围把客户账号和对应试玩包绑定。多个试玩包需要逐个绑定。
5. 配置接口由项目管理员在 Catena 页面填写服务商 AppID 和 AppSecret,并保存校验。
6. 同步 / 回填首次同步会触发近 30 天回填。回填期间不要反复改绑定范围,避免判断口径混乱。
Data Flow

数据链路怎么理解

Catena 当前由“微信试玩回流 + Catena 试玩包绑定 + 自定义事件字典 + AI 复盘”组成。

数据层后台位置运营需要确认
账号权限admin-catena.html 客户账号账号是否已开通、邮箱是否验证、客户公司是否正确
试玩包库admin-catena.html 试玩包登记试玩包 ID、展示名、渠道、状态是否正确
绑定范围admin-catena.html 绑定授权客户账号是否绑定了应看的试玩包,不多绑也不少绑
接口配置catena.html 项目接口配置AppID 是否已校验保存,AppSecret 是否需要项目管理员重新填写
同步记录catena.html 同步状态最近一次同步是否成功,失败信息是否可解释
市场报表catena.html 市场日报 / 素材排行数据日、样本量、绑定范围和实际回流是否一致
不要混淆两类 ID

客户看到的素材表现当前以 playable_package_id / 试玩广告 AppID 为主。广告计划、广告组、creative_id、消耗和 ROI 需要腾讯广告 Marketing API 或客户投放侧导入后才能形成完整投放层级。

Checklist

每日巡检清单

建议每天上午在客户查看前完成一次轻量巡检。

账号状态

新增注册账号是否有待处理,项目客户是否已开通。

绑定范围

客户反馈少数据时,先查绑定试玩包数量是否正确。

最新数据日

确认最新可用数据日是否符合 T+1 预期。

同步状态

失败、超时、接口空返回需要记录并反馈给项目负责人。

样本量

低样本数据只能解释为观察,不可当作强结论。

AI 状态

AI 不可用时页面会使用规则兜底,需确认是否额度或接口异常。

Troubleshooting

常见排障

客户能登录,但看不到真实数据

按顺序检查:账号是否已开通、邮箱是否验证、试玩包是否绑定、接口是否已配置、同步是否成功、当前日期是否有实际回流。

绑定了 5 个试玩包,但报表只显示 1 个

有数据素材包表示当前日期实际回流数量,不等于绑定数量。先切换近 30 日,再查同步记录和回流接口是否返回其他试玩包。

接口配置显示已配置,但同步失败

常见原因是 AppSecret 失效、接口权限变更、服务商 AppID 不匹配或微信接口暂时失败。需要项目管理员重新保存校验。

AI 复盘显示规则兜底

说明模型接口不可用、超时或额度不足。规则兜底仍可用于基础判断,但不代表双模型分析成功。

市场质疑为什么不能看广告计划

当前回流主要是试玩行为数据。广告账户、计划、广告、creative_id 和消耗需要另接腾讯广告 Marketing API 或客户侧导入。

需要给客户解释数据边界

统一口径:Catena 先判断素材是否跑通和断点在哪里;最终投放 ROI 需要结合广告平台和安装后质量。