foldcc/Commercialization.topon

Files

CORE-FOLDCC\Core 09bb05be44 release: 1.4.9

2026-04-23 17:15:19 +08:00

3.2 KiB

Raw Blame History

IAA Ad Debug Sample

文件位置

场景：
- Assets/Samples/IAAAdDebugSample/Scenes/IAAAdDebugSample.unity
示例配置：
- Assets/Samples/IAAAdDebugSample/Configs/IAAAdDebugSampleConfig.asset

使用步骤

打开示例配置资产 IAAAdDebugSampleConfig.asset
填入以下字段：
- Id = Taku AppId
- Key = Taku AppKey
- BaseAwardAdKeyValue.value = 激励视频广告位ID
- BaseInteractionAdKeyValue.value = 插屏广告位ID
打开示例场景 IAAAdDebugSample.unity
运行到 Android 手机测试

当前默认策略

SDK Debug
- topon.debug=true
- topon.auto_open_debugger_ui=false
激励视频
- 自动加载：开启
- 初始化预热：开启
- 最大加载尝试次数：3
- 首轮失败补偿：1000ms
插屏广告
- 自动加载：开启
- 初始化预热：开启
- 最大加载尝试次数：2
- 首轮失败补偿：500ms

场景里的 IMGUI 面板支持

初始化 ADManager
打开官方 DebugUI
手动 Enter Rewarded / Interstitial Scene
手动 Load 激励 / 插屏
AsyncPlay 激励 / 插屏
查看当前屏幕分辨率和 SafeArea
查看当前策略状态
手动刷新状态快照，避免高频状态查询刷满日志
查看 Rewarded / Interstitial 的状态 JSON
一键复制全部日志
自动写入本地 session log 文件
一键导出当前面板可见日志到单独文件
一键复制日志文件路径
查看诊断日志

关于 Debug 模式

topon.debug=true 只用于打开 SDK 调试日志
不会再因为 debug 模式自动弹出官方 DebugUI
官方 DebugUI 改为手动点击 Open DebugUI

场景到达测试方式

推荐验证两条链路：

先点击 Enter Rewarded Scene，再点击 Async Play Rewarded
不点击 Enter Rewarded Scene，直接点击 Async Play Rewarded

当前实现逻辑：

如果提前调用了 EnterAdScenario
- 播放时不会重复上报场景
如果没有提前调用
- 播放时不再自动补“场景到达”统计

建议测试流程

打开场景并运行到真机
点击 Initialize ADManager
点击 Open DebugUI，确认 SDK Debug 面板可打开
点击 Enter Rewarded Scene
点击 Async Play Rewarded
点击 Enter Interstitial Scene
点击 Async Play Interstitial
点击 Copy All Logs
将日志直接粘贴给 Codex 分析

如果日志太长，不适合走剪贴板：

点击 Export Logs To File
点击 Copy Log File Path
到真机的 Application.persistentDataPath/IAAAdDebugLogs 下取出日志文件
将文件内容发给 Codex 分析

关于分辨率

当前 IMGUI 布局按 1080 x 2340 纵向手机做参考设计，并根据 SafeArea 自动缩放，适合作为真机调试面板。

关于签名

当前示例只负责在 Unity 内和 Android 调试时验证广告链路。

不需要官方提供签名
只有在你要正式导出 APK / AAB 时，才需要你自己的包名和签名配置

关于日志文件位置

运行时会自动创建一份 session log
目录：Application.persistentDataPath/IAAAdDebugLogs
Android 上通常类似：
- /storage/emulated/0/Android/data/<包名>/files/IAAAdDebugLogs
当前测试包名是：
- com.foldcc.starveg