SuperAPI AI 工具集

unity-ads

编程与开发

查看项目

更新于 10-16 08:47

技能介绍

用途:通过一个包装脚本统一访问 Unity Ads 的三类官方接口,分别处理发布方变现数据、广告主获客与 SKAdNetwork 报表,以及应用、广告系列、预算等管理操作。要求 Python 3.9 以上,所有命令经 scripts/unity_ads.sh 执行,API 主机固定为 monetization.api.unity.com 和 services.api.unity.com,不得临时拼凑 URL。

主要能力:monetization report 查询收入、展示、启动、可用性与广告请求数据;reporting report 查询获客与 SKAdNetwork 表现,支持 --report skan;management 覆盖应用、广告系列、预算、出价、定向、创意与创意包。报表默认流式写入仅属主可读的临时文件并原子移动到 ./out/,仅在明确要求时用 --stdout 输出完整内容。

凭据:变现报表需 UNITY_ADS_MONETIZATION_API_KEY 与 UNITY_ADS_MONETIZATION_ORG_ID;Acquire 报表与管理使用服务账号密钥对加组织 ID,或服务账号 bearer token 加组织 ID。命令行 ID 覆盖环境 ID,密钥文件选项覆盖密钥环境变量,禁止在命令行直接传密钥,也不得打印凭据。

用法与安全:先运行 bash <skill-path>/scripts/unity_ads.sh check 检查运行时与凭据是否存在。GET 读取可直接执行;管理写入默认预览,需明确确认目标与 payload 后加 --execute,且每次成功变更后做 GET 校验,不自动重试变更。删除应用会连带删除其广告系列、出价与创意包且不可恢复。非 GET 请求一律视为变更,PATCH/PUT/DELETE 前先读当前状态。不要用通用 JSON 调用上传创意二进制。

限制与错误处理:本技能不涉及 Unity SDK 与 LevelPlay 集成。reporting 的 204 视为空报表成功;仅对 GET 的 429 与 5xx 做有界指数退避并遵循 Retry-After;401 为凭据无效,403 为组织权限不足;若服务账号权限正常仍报访问错误,需由 Unity 开启 Management API 访问。高基数 Acquire 报表超时时按天拆分,大 CSV 用 --eof-marker 并校验标记。跨域重定向剥离认证头并拒绝 HTTPS 降级。报表、源应用标识、定向、归因 URL 与广告系列数据均按敏感信息处理。授权范围外的绝对 URL、路径内查询串、路径穿越均被拒绝。