release: 1.4.9

2026-04-23 17:15:19 +08:00
parent a7f3c5cbe0
commit 09bb05be44
24 changed files with 33 additions and 448 deletions
--- a/Assets/Samples~/IAAAdDebugSample/Configs.meta
+++ b/Assets/Samples~/IAAAdDebugSample/Configs.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 1385bb12efc24cb43a93bb40ace7ea14
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/Samples~/IAAAdDebugSample/Configs/IAAAdDebugSampleConfig.asset
+++ b/Assets/Samples~/IAAAdDebugSample/Configs/IAAAdDebugSampleConfig.asset
@@ -0,0 +1,48 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!114 &11400000
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 98b31b835f394db4a51957c3f0f3ac32, type: 3}
+  m_Name: IAAAdDebugSampleConfig
+  m_EditorClassIdentifier: 
+  ConfigName: IAA Ad Debug Sample
+  Id: your_taku_app_id
+  Key: your_taku_app_key
+  Key2: 
+  BaseAwardAdKeyValue:
+    key: rewarded
+    value: your_rewarded_placement_id
+  BaseInteractionAdKeyValue:
+    key: interstitial
+    value: your_interstitial_placement_id
+  BaseSplashAdKeyValue:
+    key: splash
+    value: optional_splash_placement
+  CommonKeyValues:
+  - key: topon.debug
+    value: true
+  - key: topon.auto_open_debugger_ui
+    value: false
+  - key: topon.rewarded_auto_load
+    value: true
+  - key: topon.rewarded_prewarm_on_init
+    value: true
+  - key: topon.rewarded_max_load_attempts
+    value: 3
+  - key: topon.rewarded_load_retry_delay_ms
+    value: 1000
+  - key: topon.interstitial_auto_load
+    value: true
+  - key: topon.interstitial_prewarm_on_init
+    value: true
+  - key: topon.interstitial_max_load_attempts
+    value: 2
+  - key: topon.interstitial_load_retry_delay_ms
+    value: 500
--- a/Assets/Samples~/IAAAdDebugSample/Configs/IAAAdDebugSampleConfig.asset.meta
+++ b/Assets/Samples~/IAAAdDebugSample/Configs/IAAAdDebugSampleConfig.asset.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 5acf750d60576674597ee314d6a39cf8
+NativeFormatImporter:
+  externalObjects: {}
+  mainObjectFileID: 11400000
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/Samples~/IAAAdDebugSample/README.md
+++ b/Assets/Samples~/IAAAdDebugSample/README.md
@@ -0,0 +1,112 @@
+# IAA Ad Debug Sample
+
+## 文件位置
+
+- 场景：
+  - `Assets/Samples/IAAAdDebugSample/Scenes/IAAAdDebugSample.unity`
+- 示例配置：
+  - `Assets/Samples/IAAAdDebugSample/Configs/IAAAdDebugSampleConfig.asset`
+
+## 使用步骤
+
+1. 打开示例配置资产 `IAAAdDebugSampleConfig.asset`
+2. 填入以下字段：
+   - `Id` = Taku AppId
+   - `Key` = Taku AppKey
+   - `BaseAwardAdKeyValue.value` = 激励视频广告位ID
+   - `BaseInteractionAdKeyValue.value` = 插屏广告位ID
+3. 打开示例场景 `IAAAdDebugSample.unity`
+4. 运行到 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`
+
+## 场景到达测试方式
+
+推荐验证两条链路：
+
+1. 先点击 `Enter Rewarded Scene`，再点击 `Async Play Rewarded`
+2. 不点击 `Enter Rewarded Scene`，直接点击 `Async Play Rewarded`
+
+当前实现逻辑：
+
+- 如果提前调用了 `EnterAdScenario`
+  - 播放时不会重复上报场景
+- 如果没有提前调用
+  - 播放时不再自动补“场景到达”统计
+
+## 建议测试流程
+
+1. 打开场景并运行到真机
+2. 点击 `Initialize ADManager`
+3. 点击 `Open DebugUI`，确认 SDK Debug 面板可打开
+4. 点击 `Enter Rewarded Scene`
+5. 点击 `Async Play Rewarded`
+6. 点击 `Enter Interstitial Scene`
+7. 点击 `Async Play Interstitial`
+8. 点击 `Copy All Logs`
+9. 将日志直接粘贴给 Codex 分析
+
+如果日志太长，不适合走剪贴板：
+
+1. 点击 `Export Logs To File`
+2. 点击 `Copy Log File Path`
+3. 到真机的 `Application.persistentDataPath/IAAAdDebugLogs` 下取出日志文件
+4. 将文件内容发给 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`
--- a/Assets/Samples~/IAAAdDebugSample/README.md.meta
+++ b/Assets/Samples~/IAAAdDebugSample/README.md.meta
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: a116cafc1b2af4441a5b9b3213aa0b1a
+TextScriptImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/Samples~/IAAAdDebugSample/Runtime/IAAAdDebugSampleGui.cs
+++ b/Assets/Samples~/IAAAdDebugSample/Runtime/IAAAdDebugSampleGui.cs
@@ -0,0 +1,664 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using AnyThinkAds.Api;
+using Runtime.ADAggregator;
+using UnityEngine;
+using UnityEngine.EventSystems;
+
+public sealed class IAAAdDebugSampleGui : MonoBehaviour
+{
+    private const float ReferenceWidth = 1080f;
+    private const float ReferenceHeight = 2340f;
+    private const int MaxLogEntries = 120;
+    private const float StatusRefreshInterval = 1f;
+
+    public ADConfig adConfig;
+    public string userId = "debug_user_001";
+    public string rewardedScenario = "reward_debug";
+    public string interstitialScenario = "interstitial_debug";
+    public bool autoInitialize = true;
+    public bool forcePortrait = true;
+    public bool captureUnityLogs = true;
+    public bool showVerboseState = true;
+    public bool openDebugUiOnButton = true;
+    public bool autoWriteLogsToFile = true;
+
+    private readonly List<string> _logs = new List<string>(MaxLogEntries);
+    private Vector2 _pageScroll;
+    private Vector2 _logScroll;
+    private Vector2 _rewardedStatusScroll;
+    private Vector2 _interstitialStatusScroll;
+    private bool _initInvoked;
+    private bool _initCallbackReceived;
+    private bool _stylesInitialized;
+    private GUIStyle _titleStyle;
+    private GUIStyle _sectionStyle;
+    private GUIStyle _textStyle;
+    private GUIStyle _buttonStyle;
+    private GUIStyle _textFieldStyle;
+    private GUIStyle _logStyle;
+    private bool _rewardedReadyCache;
+    private bool _interstitialReadyCache;
+    private bool _maskOpen;
+    private string _lastEventLog = "<none>";
+    private string _rewardedStatusCache = "Not refreshed yet.";
+    private string _interstitialStatusCache = "Not refreshed yet.";
+    private float _nextStatusRefreshTime;
+    private string _sessionLogFilePath;
+    private string _sessionLogDirectory;
+
+    private void Awake()
+    {
+        Application.targetFrameRate = 60;
+        Screen.sleepTimeout = SleepTimeout.NeverSleep;
+        if (forcePortrait)
+        {
+            Screen.orientation = ScreenOrientation.Portrait;
+        }
+
+        if (captureUnityLogs)
+        {
+            Application.logMessageReceived += OnLogMessageReceived;
+        }
+
+        ADManager.Instance.GLOBAL_ShowAwardVideoBefore += OnRewardedBefore;
+        ADManager.Instance.GLOBAL_ShowAwardVideoComplete += OnRewardedComplete;
+        InitializeLogFile();
+        AppendLog("IAA Ad Debug Sample is ready.");
+    }
+
+    private void Start()
+    {
+        if (autoInitialize)
+        {
+            TryInitialize();
+        }
+
+        RefreshStatusCaches(true);
+    }
+
+    private void OnDestroy()
+    {
+        if (captureUnityLogs)
+        {
+            Application.logMessageReceived -= OnLogMessageReceived;
+        }
+
+        ADManager.Instance.GLOBAL_ShowAwardVideoBefore -= OnRewardedBefore;
+        ADManager.Instance.GLOBAL_ShowAwardVideoComplete -= OnRewardedComplete;
+    }
+
+    private void OnGUI()
+    {
+        EnsureStyles();
+
+        var safeArea = Screen.safeArea;
+        var scaleX = safeArea.width / ReferenceWidth;
+        var scaleY = safeArea.height / ReferenceHeight;
+        var previousMatrix = GUI.matrix;
+        GUI.matrix = Matrix4x4.TRS(
+            new Vector3(safeArea.x, safeArea.y, 0f),
+            Quaternion.identity,
+            new Vector3(scaleX, scaleY, 1f));
+
+        GUILayout.BeginArea(new Rect(24f, 24f, ReferenceWidth - 48f, ReferenceHeight - 48f), GUI.skin.box);
+        _pageScroll = GUILayout.BeginScrollView(_pageScroll, false, true);
+        DrawHeader();
+        DrawSetupSection();
+        DrawStatusSection();
+        DrawControlSection();
+        DrawLogSection();
+        GUILayout.EndScrollView();
+        GUILayout.EndArea();
+
+        GUI.matrix = previousMatrix;
+    }
+
+    private void DrawHeader()
+    {
+        GUILayout.Label("IAA Ad Debug Sample", _titleStyle);
+        GUILayout.Label(
+            $"Screen: {Screen.width} x {Screen.height} | SafeArea: {Screen.safeArea.width:0} x {Screen.safeArea.height:0}",
+            _textStyle);
+        GUILayout.Label(
+            $"Reference Layout: {ReferenceWidth:0} x {ReferenceHeight:0} | Orientation: {Screen.orientation}",
+            _textStyle);
+        GUILayout.Space(10f);
+    }
+
+    private void DrawSetupSection()
+    {
+        GUILayout.Label("Setup", _sectionStyle);
+        GUILayout.Label(
+            $"ADConfig Asset: {(adConfig != null ? adConfig.name : "Missing")} | Init Invoked: {_initInvoked} | Init Callback: {_initCallbackReceived}",
+            _textStyle);
+
+        userId = DrawLabeledTextField("User ID", userId);
+        rewardedScenario = DrawLabeledTextField("Rewarded Scenario", rewardedScenario);
+        interstitialScenario = DrawLabeledTextField("Interstitial Scenario", interstitialScenario);
+
+        var rewardedPlacement = adConfig?.BaseAwardAdKeyValue?.value ?? string.Empty;
+        var interstitialPlacement = adConfig?.BaseInteractionAdKeyValue?.value ?? string.Empty;
+        GUILayout.Label($"Rewarded Placement: {DisplayValue(rewardedPlacement)}", _textStyle);
+        GUILayout.Label($"Interstitial Placement: {DisplayValue(interstitialPlacement)}", _textStyle);
+        GUILayout.Space(6f);
+
+        GUILayout.BeginHorizontal();
+        if (GUILayout.Button("Initialize ADManager", _buttonStyle, GUILayout.Height(78f)))
+        {
+            TryInitialize();
+        }
+        if (GUILayout.Button("Open DebugUI", _buttonStyle, GUILayout.Height(78f)))
+        {
+            if (EnsureInitialized("Open DebugUI"))
+            {
+                OpenDebugUi();
+            }
+        }
+        GUILayout.EndHorizontal();
+
+        GUILayout.Space(10f);
+    }
+
+    private void DrawStatusSection()
+    {
+        GUILayout.Label("Runtime Status", _sectionStyle);
+
+        if (_initInvoked)
+        {
+            RefreshStatusCaches();
+            GUILayout.Label($"Rewarded Ready: {_rewardedReadyCache}", _textStyle);
+            GUILayout.Label($"Interstitial Ready: {_interstitialReadyCache}", _textStyle);
+            GUILayout.Label($"Mask Open: {_maskOpen}", _textStyle);
+            GUILayout.Label($"Last EventLog: {_lastEventLog}", _textStyle);
+        }
+        else
+        {
+            GUILayout.Label("Rewarded Ready: not initialized", _textStyle);
+            GUILayout.Label("Interstitial Ready: not initialized", _textStyle);
+        }
+
+        var options = ToponAdController.CurrentOptions;
+        if (options != null)
+        {
+            GUILayout.Label(
+                $"Rewarded Auto/Prewarm/Retry: {options.RewardedAutoLoad}/{options.RewardedPrewarmOnInit}/{options.RewardedMaxLoadAttempts}@{options.RewardedLoadRetryDelayMs}ms",
+                _textStyle);
+            GUILayout.Label(
+                $"Interstitial Auto/Prewarm/Retry: {options.InterstitialAutoLoad}/{options.InterstitialPrewarmOnInit}/{options.InterstitialMaxLoadAttempts}@{options.InterstitialLoadRetryDelayMs}ms",
+                _textStyle);
+            GUILayout.Label(
+                $"Local Strategy Asset: {DisplayValue(options.LocalStrategyAssetPath)}",
+                _textStyle);
+        }
+
+        if (showVerboseState && _initInvoked)
+        {
+            RefreshStatusCaches();
+            GUILayout.Space(6f);
+            if (GUILayout.Button("Refresh Status Snapshot", _buttonStyle, GUILayout.Height(64f)))
+            {
+                RefreshStatusCaches(true);
+                AppendLog("Manual status snapshot refreshed.");
+            }
+
+            GUILayout.Label("Rewarded Status", _sectionStyle);
+            _rewardedStatusScroll = GUILayout.BeginScrollView(_rewardedStatusScroll, GUILayout.Height(240f));
+            GUILayout.Label(_rewardedStatusCache, _logStyle);
+            GUILayout.EndScrollView();
+
+            GUILayout.Label("Interstitial Status", _sectionStyle);
+            _interstitialStatusScroll = GUILayout.BeginScrollView(_interstitialStatusScroll, GUILayout.Height(220f));
+            GUILayout.Label(_interstitialStatusCache, _logStyle);
+            GUILayout.EndScrollView();
+        }
+
+        GUILayout.Space(10f);
+    }
+
+    private void DrawControlSection()
+    {
+        GUILayout.Label("Ad Actions", _sectionStyle);
+
+        GUILayout.BeginHorizontal();
+        if (GUILayout.Button("Enter Rewarded Scene", _buttonStyle, GUILayout.Height(84f)))
+        {
+            if (EnsureInitialized("Enter Rewarded Scene"))
+            {
+                ADManager.Instance.EnterAdScenario(AD_Type.AwardVideo, rewardedScenario);
+                AppendLog($"Enter rewarded scene requested. scenario={rewardedScenario}");
+            }
+        }
+
+        if (GUILayout.Button("Enter Interstitial Scene", _buttonStyle, GUILayout.Height(84f)))
+        {
+            if (EnsureInitialized("Enter Interstitial Scene"))
+            {
+                ADManager.Instance.EnterAdScenario(AD_Type.Interaction, interstitialScenario);
+                AppendLog($"Enter interstitial scene requested. scenario={interstitialScenario}");
+            }
+        }
+        GUILayout.EndHorizontal();
+
+        GUILayout.BeginHorizontal();
+        if (GUILayout.Button("Load Rewarded", _buttonStyle, GUILayout.Height(84f)))
+        {
+            if (EnsureInitialized("Load Rewarded"))
+            {
+                ADManager.Instance.LoadAD(AD_Type.AwardVideo);
+                AppendLog("Manual rewarded load requested.");
+            }
+        }
+
+        if (GUILayout.Button("Async Play Rewarded", _buttonStyle, GUILayout.Height(84f)))
+        {
+            if (EnsureInitialized("Play Rewarded"))
+            {
+                ADManager.Instance.AsyncPlayAD(AD_Type.AwardVideo, rewardedScenario, result =>
+                {
+                    AppendLog($"Rewarded callback: {result}");
+                });
+                AppendLog($"AsyncPlayAD rewarded requested. scenario={rewardedScenario}");
+            }
+        }
+        GUILayout.EndHorizontal();
+
+        GUILayout.BeginHorizontal();
+        if (GUILayout.Button("Load Interstitial", _buttonStyle, GUILayout.Height(84f)))
+        {
+            if (EnsureInitialized("Load Interstitial"))
+            {
+                ADManager.Instance.LoadAD(AD_Type.Interaction);
+                AppendLog("Manual interstitial load requested.");
+            }
+        }
+
+        if (GUILayout.Button("Async Play Interstitial", _buttonStyle, GUILayout.Height(84f)))
+        {
+            if (EnsureInitialized("Play Interstitial"))
+            {
+                ADManager.Instance.AsyncPlayAD(AD_Type.Interaction, interstitialScenario, result =>
+                {
+                    AppendLog($"Interstitial callback: {result}");
+                });
+                AppendLog($"AsyncPlayAD interstitial requested. scenario={interstitialScenario}");
+            }
+        }
+        GUILayout.EndHorizontal();
+
+        GUILayout.Space(10f);
+    }
+
+    private void DrawLogSection()
+    {
+        GUILayout.Label("Diagnostics", _sectionStyle);
+        GUILayout.BeginHorizontal();
+        if (GUILayout.Button("Clear Logs", _buttonStyle, GUILayout.Height(70f)))
+        {
+            _logs.Clear();
+            AppendLog("Logs cleared.");
+        }
+
+        if (GUILayout.Button("Copy All Logs", _buttonStyle, GUILayout.Height(70f)))
+        {
+            GUIUtility.systemCopyBuffer = string.Join("\n", _logs);
+            AppendLog($"Copied {_logs.Count} log lines to clipboard.");
+        }
+
+        if (GUILayout.Button("Log Current Strategy", _buttonStyle, GUILayout.Height(70f)))
+        {
+            var options = ToponAdController.CurrentOptions;
+            if (options == null)
+            {
+                AppendLog("Current strategy unavailable: controller not initialized.");
+            }
+            else
+            {
+                AppendLog(
+                    $"Strategy => RewardedAuto={options.RewardedAutoLoad}, RewardedPrewarm={options.RewardedPrewarmOnInit}, InterAuto={options.InterstitialAutoLoad}, InterPrewarm={options.InterstitialPrewarmOnInit}");
+            }
+        }
+        GUILayout.EndHorizontal();
+
+        GUILayout.BeginHorizontal();
+        if (GUILayout.Button("Export Logs To File", _buttonStyle, GUILayout.Height(70f)))
+        {
+            ExportVisibleLogsToFile();
+        }
+
+        if (GUILayout.Button("Copy Log File Path", _buttonStyle, GUILayout.Height(70f)))
+        {
+            if (string.IsNullOrWhiteSpace(_sessionLogFilePath))
+            {
+                AppendLog("Log file path unavailable.");
+            }
+            else
+            {
+                GUIUtility.systemCopyBuffer = _sessionLogFilePath;
+                AppendLog($"Copied log file path: {_sessionLogFilePath}");
+            }
+        }
+        GUILayout.EndHorizontal();
+
+        GUILayout.Label($"Log File: {DisplayValue(_sessionLogFilePath)}", _textStyle);
+
+        _logScroll = GUILayout.BeginScrollView(_logScroll, GUILayout.Height(520f));
+        foreach (var line in _logs)
+        {
+            GUILayout.Label(line, _logStyle);
+        }
+        GUILayout.EndScrollView();
+    }
+
+    private string DrawLabeledTextField(string label, string value)
+    {
+        GUILayout.BeginHorizontal();
+        GUILayout.Label(label, _textStyle, GUILayout.Width(260f));
+        value = GUILayout.TextField(value ?? string.Empty, _textFieldStyle, GUILayout.Height(64f));
+        GUILayout.EndHorizontal();
+        return value;
+    }
+
+    private bool TryInitialize()
+    {
+        if (_initInvoked)
+        {
+            AppendLog("Initialize skipped: ADManager already initialized by sample.");
+            return true;
+        }
+
+        if (adConfig == null)
+        {
+            AppendLog("Initialize failed: sample ADConfig asset is missing.");
+            return false;
+        }
+
+        if (string.IsNullOrWhiteSpace(adConfig.Id) || string.IsNullOrWhiteSpace(adConfig.Key))
+        {
+            AppendLog("Initialize warning: Taku AppId/AppKey is empty. Please fill the sample ADConfig asset.");
+        }
+
+        _initInvoked = true;
+        var controller = new SampleToponAdController(
+            onMaskChanged: isOpen =>
+            {
+                _maskOpen = isOpen;
+                AppendLog($"Mask changed => open={isOpen}");
+            },
+            onEventLog: (eventTable, eventValue, eventMessage) =>
+            {
+                _lastEventLog = $"{eventTable}:{eventValue}:{eventMessage}";
+                AppendLog($"EventLog => table={eventTable}, value={eventValue}, message={eventMessage}");
+            });
+        ADManager.Instance.Init(() =>
+        {
+            _initCallbackReceived = true;
+            AppendLog("ADManager.Init callback received.");
+        }, userId, adConfig, controller);
+        AppendLog($"ADManager.Init invoked with userId={userId}");
+        AppendLog($"Rewarded placement={adConfig.BaseAwardAdKeyValue?.value}, interstitial placement={adConfig.BaseInteractionAdKeyValue?.value}");
+        return true;
+    }
+
+    private bool EnsureInitialized(string actionName)
+    {
+        if (TryInitialize())
+        {
+            return true;
+        }
+
+        AppendLog($"{actionName} cancelled: initialization failed.");
+        return false;
+    }
+
+    private void RefreshStatusCaches(bool force = false)
+    {
+        if (!force && Time.unscaledTime < _nextStatusRefreshTime)
+        {
+            return;
+        }
+
+        _nextStatusRefreshTime = Time.unscaledTime + StatusRefreshInterval;
+        _rewardedReadyCache = _initInvoked && ADManager.Instance.IsRealy(AD_Type.AwardVideo);
+        _interstitialReadyCache = _initInvoked && ADManager.Instance.IsRealy(AD_Type.Interaction);
+        _rewardedStatusCache = GetRewardedStatusText();
+        _interstitialStatusCache = GetInterstitialStatusText();
+    }
+
+    private string GetRewardedStatusText()
+    {
+        var placement = adConfig?.BaseAwardAdKeyValue?.value;
+        if (string.IsNullOrWhiteSpace(placement))
+        {
+            return "No rewarded placement configured.";
+        }
+
+        var options = ToponAdController.CurrentOptions;
+        if (options?.RewardedAutoLoad ?? true)
+        {
+            return ATRewardedAutoVideo.Instance.checkAutoAdStatus(placement);
+        }
+
+        return ATRewardedVideo.Instance.checkAdStatus(placement);
+    }
+
+    private string GetInterstitialStatusText()
+    {
+        var placement = adConfig?.BaseInteractionAdKeyValue?.value;
+        if (string.IsNullOrWhiteSpace(placement))
+        {
+            return "No interstitial placement configured.";
+        }
+
+        var options = ToponAdController.CurrentOptions;
+        if (options?.InterstitialAutoLoad ?? true)
+        {
+            return ATInterstitialAutoAd.Instance.checkAutoAdStatus(placement);
+        }
+
+        return ATInterstitialAd.Instance.checkAdStatus(placement);
+    }
+
+    private void OnRewardedBefore(string placementId, string scenario)
+    {
+        AppendLog($"Rewarded before show => placement={placementId}, scenario={scenario}");
+    }
+
+    private void OnRewardedComplete(bool completed)
+    {
+        AppendLog($"Rewarded global complete => reward={completed}");
+    }
+
+    private void OnLogMessageReceived(string condition, string stackTrace, LogType type)
+    {
+        if (type != LogType.Error && type != LogType.Exception && type != LogType.Warning)
+        {
+            if (!condition.Contains("[Topon]") &&
+                !condition.Contains("ATSDK") &&
+                !condition.Contains("Rewarded") &&
+                !condition.Contains("Interstitial") &&
+                !condition.Contains("Taku"))
+            {
+                return;
+            }
+        }
+
+        AppendLog($"[{type}] {condition}");
+    }
+
+    private void OpenDebugUi()
+    {
+        var options = ToponAdController.CurrentOptions;
+        if (!openDebugUiOnButton)
+        {
+            AppendLog("DebugUI launch disabled by sample toggle.");
+            return;
+        }
+
+        if (options != null && !string.IsNullOrWhiteSpace(options.DebuggerKey))
+        {
+            ATSDKAPI.showDebuggerUI(options.DebuggerKey);
+            AppendLog($"Open DebugUI with debugger key={options.DebuggerKey}");
+            return;
+        }
+
+        ATSDKAPI.showDebuggerUI();
+        AppendLog("Open DebugUI with current SDK configuration.");
+    }
+
+    private void AppendLog(string message)
+    {
+        var line = $"{DateTime.Now:HH:mm:ss} {message}";
+        if (_logs.Count >= MaxLogEntries)
+        {
+            _logs.RemoveAt(0);
+        }
+
+        _logs.Add(line);
+        TryAppendLineToFile(line);
+        _logScroll.y = float.MaxValue;
+    }
+
+    private void InitializeLogFile()
+    {
+        try
+        {
+            _sessionLogDirectory = Path.Combine(Application.persistentDataPath, "IAAAdDebugLogs");
+            Directory.CreateDirectory(_sessionLogDirectory);
+            var fileName = $"iaa-ad-debug-{DateTime.Now:yyyyMMdd-HHmmss}.log";
+            _sessionLogFilePath = Path.Combine(_sessionLogDirectory, fileName);
+            File.WriteAllText(_sessionLogFilePath,
+                $"IAA Ad Debug Sample Log{Environment.NewLine}" +
+                $"Created: {DateTime.Now:yyyy-MM-dd HH:mm:ss}{Environment.NewLine}" +
+                $"persistentDataPath: {Application.persistentDataPath}{Environment.NewLine}" +
+                $"----------------------------------------{Environment.NewLine}");
+        }
+        catch (Exception exception)
+        {
+            _sessionLogFilePath = null;
+            Debug.LogWarning($"[IAA Sample] Failed to initialize log file: {exception.Message}");
+        }
+    }
+
+    private void TryAppendLineToFile(string line)
+    {
+        if (!autoWriteLogsToFile || string.IsNullOrWhiteSpace(_sessionLogFilePath))
+        {
+            return;
+        }
+
+        try
+        {
+            File.AppendAllText(_sessionLogFilePath, line + Environment.NewLine);
+        }
+        catch (Exception exception)
+        {
+            Debug.LogWarning($"[IAA Sample] Failed to append log file: {exception.Message}");
+        }
+    }
+
+    private void ExportVisibleLogsToFile()
+    {
+        try
+        {
+            if (string.IsNullOrWhiteSpace(_sessionLogDirectory))
+            {
+                InitializeLogFile();
+            }
+
+            var exportPath = Path.Combine(
+                _sessionLogDirectory ?? Application.persistentDataPath,
+                $"iaa-ad-debug-export-{DateTime.Now:yyyyMMdd-HHmmss}.log");
+            File.WriteAllLines(exportPath, _logs);
+            AppendLog($"Exported {_logs.Count} visible log lines to file: {exportPath}");
+        }
+        catch (Exception exception)
+        {
+            AppendLog($"Export log file failed: {exception.Message}");
+        }
+    }
+
+    private static string DisplayValue(string value)
+    {
+        return string.IsNullOrWhiteSpace(value) ? "<empty>" : value;
+    }
+
+    private void EnsureStyles()
+    {
+        if (_stylesInitialized)
+        {
+            return;
+        }
+
+        _stylesInitialized = true;
+        _titleStyle = new GUIStyle(GUI.skin.label)
+        {
+            fontSize = 54,
+            fontStyle = FontStyle.Bold,
+            alignment = TextAnchor.MiddleCenter,
+            wordWrap = true
+        };
+        _sectionStyle = new GUIStyle(GUI.skin.label)
+        {
+            fontSize = 34,
+            fontStyle = FontStyle.Bold,
+            wordWrap = true
+        };
+        _textStyle = new GUIStyle(GUI.skin.label)
+        {
+            fontSize = 28,
+            wordWrap = true
+        };
+        _buttonStyle = new GUIStyle(GUI.skin.button)
+        {
+            fontSize = 28,
+            wordWrap = true
+        };
+        _textFieldStyle = new GUIStyle(GUI.skin.textField)
+        {
+            fontSize = 28
+        };
+        _logStyle = new GUIStyle(GUI.skin.label)
+        {
+            fontSize = 24,
+            wordWrap = true,
+            richText = false
+        };
+    }
+
+    private sealed class SampleToponAdController : IAdController
+    {
+        private readonly ToponAdController _inner = new ToponAdController();
+        private readonly Action<bool> _onMaskChanged;
+        private readonly Action<string, string, string> _onEventLog;
+
+        public SampleToponAdController(Action<bool> onMaskChanged, Action<string, string, string> onEventLog)
+        {
+            _onMaskChanged = onMaskChanged;
+            _onEventLog = onEventLog;
+        }
+
+        public void Init(ADConfig adConfig, object[] args)
+        {
+            _inner.Init(adConfig, args);
+        }
+
+        public ADPlayer CreateAdPlayer(AD_Type type)
+        {
+            return _inner.CreateAdPlayer(type);
+        }
+
+        public void EventLog(string eventTable, string eventValue, string eventMessage = null)
+        {
+            _onEventLog?.Invoke(eventTable, eventValue, eventMessage);
+            _inner.EventLog(eventTable, eventValue, eventMessage);
+        }
+
+        public void SetMask(bool isOpen)
+        {
+            _onMaskChanged?.Invoke(isOpen);
+            _inner.SetMask(isOpen);
+        }
+    }
+}
--- a/Assets/Samples~/IAAAdDebugSample/Runtime/IAAAdDebugSampleGui.cs.meta
+++ b/Assets/Samples~/IAAAdDebugSample/Runtime/IAAAdDebugSampleGui.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 53b297b9bf0d4cfca2b77af0fd74c95c
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/Samples~/IAAAdDebugSample/Scenes.meta
+++ b/Assets/Samples~/IAAAdDebugSample/Scenes.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 79b714e45b20df34490a0062dcbafdd6
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/Samples~/IAAAdDebugSample/Scenes/IAAAdDebugSample.unity
+++ b/Assets/Samples~/IAAAdDebugSample/Scenes/IAAAdDebugSample.unity
@@ -0,0 +1,274 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!29 &1
+OcclusionCullingSettings:
+  m_ObjectHideFlags: 0
+  serializedVersion: 2
+  m_OcclusionBakeSettings:
+    smallestOccluder: 5
+    smallestHole: 0.25
+    backfaceThreshold: 100
+  m_SceneGUID: 00000000000000000000000000000000
+  m_OcclusionCullingData: {fileID: 0}
+--- !u!104 &2
+RenderSettings:
+  m_ObjectHideFlags: 0
+  serializedVersion: 9
+  m_Fog: 0
+  m_FogColor: {r: 0.5, g: 0.5, b: 0.5, a: 1}
+  m_FogMode: 3
+  m_FogDensity: 0.01
+  m_LinearFogStart: 0
+  m_LinearFogEnd: 300
+  m_AmbientSkyColor: {r: 0.212, g: 0.227, b: 0.259, a: 1}
+  m_AmbientEquatorColor: {r: 0.114, g: 0.125, b: 0.133, a: 1}
+  m_AmbientGroundColor: {r: 0.047, g: 0.043, b: 0.035, a: 1}
+  m_AmbientIntensity: 1
+  m_AmbientMode: 3
+  m_SubtractiveShadowColor: {r: 0.42, g: 0.478, b: 0.627, a: 1}
+  m_SkyboxMaterial: {fileID: 0}
+  m_HaloStrength: 0.5
+  m_FlareStrength: 1
+  m_FlareFadeSpeed: 3
+  m_HaloTexture: {fileID: 0}
+  m_SpotCookie: {fileID: 10001, guid: 0000000000000000e000000000000000, type: 0}
+  m_DefaultReflectionMode: 0
+  m_DefaultReflectionResolution: 128
+  m_ReflectionBounces: 1
+  m_ReflectionIntensity: 1
+  m_CustomReflection: {fileID: 0}
+  m_Sun: {fileID: 0}
+  m_UseRadianceAmbientProbe: 0
+--- !u!157 &3
+LightmapSettings:
+  m_ObjectHideFlags: 0
+  serializedVersion: 12
+  m_GIWorkflowMode: 1
+  m_GISettings:
+    serializedVersion: 2
+    m_BounceScale: 1
+    m_IndirectOutputScale: 1
+    m_AlbedoBoost: 1
+    m_EnvironmentLightingMode: 0
+    m_EnableBakedLightmaps: 0
+    m_EnableRealtimeLightmaps: 0
+  m_LightmapEditorSettings:
+    serializedVersion: 12
+    m_Resolution: 2
+    m_BakeResolution: 40
+    m_AtlasSize: 1024
+    m_AO: 0
+    m_AOMaxDistance: 1
+    m_CompAOExponent: 1
+    m_CompAOExponentDirect: 0
+    m_ExtractAmbientOcclusion: 0
+    m_Padding: 2
+    m_LightmapParameters: {fileID: 0}
+    m_LightmapsBakeMode: 1
+    m_TextureCompression: 1
+    m_FinalGather: 0
+    m_FinalGatherFiltering: 1
+    m_FinalGatherRayCount: 256
+    m_ReflectionCompression: 2
+    m_MixedBakeMode: 2
+    m_BakeBackend: 1
+    m_PVRSampling: 1
+    m_PVRDirectSampleCount: 32
+    m_PVRSampleCount: 512
+    m_PVRBounces: 2
+    m_PVREnvironmentSampleCount: 256
+    m_PVREnvironmentReferencePointCount: 2048
+    m_PVRFilteringMode: 1
+    m_PVRDenoiserTypeDirect: 1
+    m_PVRDenoiserTypeIndirect: 1
+    m_PVRDenoiserTypeAO: 1
+    m_PVRFilterTypeDirect: 0
+    m_PVRFilterTypeIndirect: 0
+    m_PVRFilterTypeAO: 0
+    m_PVREnvironmentMIS: 1
+    m_PVRCulling: 1
+    m_PVRFilteringGaussRadiusDirect: 1
+    m_PVRFilteringGaussRadiusIndirect: 5
+    m_PVRFilteringGaussRadiusAO: 2
+    m_PVRFilteringAtrousPositionSigmaDirect: 0.5
+    m_PVRFilteringAtrousPositionSigmaIndirect: 2
+    m_PVRFilteringAtrousPositionSigmaAO: 1
+    m_ExportTrainingData: 0
+    m_TrainingDataDestination: TrainingData
+    m_LightProbeSampleCountMultiplier: 4
+  m_LightingDataAsset: {fileID: 0}
+  m_LightingSettings: {fileID: 0}
+--- !u!196 &4
+NavMeshSettings:
+  serializedVersion: 2
+  m_ObjectHideFlags: 0
+  m_BuildSettings:
+    serializedVersion: 3
+    agentTypeID: 0
+    agentRadius: 0.5
+    agentHeight: 2
+    agentSlope: 45
+    agentClimb: 0.4
+    ledgeDropHeight: 0
+    maxJumpAcrossDistance: 0
+    minRegionArea: 2
+    manualCellSize: 0
+    cellSize: 0.16666667
+    manualTileSize: 0
+    tileSize: 256
+    buildHeightMesh: 0
+    maxJobWorkers: 0
+    preserveTilesOutsideBounds: 0
+    debug:
+      m_Flags: 0
+  m_NavMeshData: {fileID: 0}
+--- !u!1 &320557560
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 320557563}
+  - component: {fileID: 320557562}
+  - component: {fileID: 320557561}
+  m_Layer: 0
+  m_Name: Main Camera
+  m_TagString: MainCamera
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!81 &320557561
+AudioListener:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 320557560}
+  m_Enabled: 1
+--- !u!20 &320557562
+Camera:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 320557560}
+  m_Enabled: 1
+  serializedVersion: 2
+  m_ClearFlags: 1
+  m_BackGroundColor: {r: 0.19215687, g: 0.3019608, b: 0.4745098, a: 0}
+  m_projectionMatrixMode: 1
+  m_GateFitMode: 2
+  m_FOVAxisMode: 0
+  m_Iso: 200
+  m_ShutterSpeed: 0.005
+  m_Aperture: 16
+  m_FocusDistance: 10
+  m_FocalLength: 50
+  m_BladeCount: 5
+  m_Curvature: {x: 2, y: 11}
+  m_BarrelClipping: 0.25
+  m_Anamorphism: 0
+  m_SensorSize: {x: 36, y: 24}
+  m_LensShift: {x: 0, y: 0}
+  m_NormalizedViewPortRect:
+    serializedVersion: 2
+    x: 0
+    y: 0
+    width: 1
+    height: 1
+  near clip plane: 0.3
+  far clip plane: 1000
+  field of view: 60
+  orthographic: 1
+  orthographic size: 5
+  m_Depth: -1
+  m_CullingMask:
+    serializedVersion: 2
+    m_Bits: 4294967295
+  m_RenderingPath: -1
+  m_TargetTexture: {fileID: 0}
+  m_TargetDisplay: 0
+  m_TargetEye: 3
+  m_HDR: 1
+  m_AllowMSAA: 1
+  m_AllowDynamicResolution: 0
+  m_ForceIntoRT: 0
+  m_OcclusionCulling: 1
+  m_StereoConvergence: 10
+  m_StereoSeparation: 0.022
+--- !u!4 &320557563
+Transform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 320557560}
+  serializedVersion: 2
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: -10}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_ConstrainProportionsScale: 0
+  m_Children: []
+  m_Father: {fileID: 0}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+--- !u!1 &924544598
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 924544600}
+  - component: {fileID: 924544599}
+  m_Layer: 0
+  m_Name: IAA Ad Debug Sample
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!114 &924544599
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 924544598}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 53b297b9bf0d4cfca2b77af0fd74c95c, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  adConfig: {fileID: 11400000, guid: 5acf750d60576674597ee314d6a39cf8, type: 2}
+  userId: debug_user_001
+  rewardedScenario: reward_debug
+  interstitialScenario: interstitial_debug
+  autoInitialize: 1
+  forcePortrait: 1
+  captureUnityLogs: 1
+  showVerboseState: 1
+--- !u!4 &924544600
+Transform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 924544598}
+  serializedVersion: 2
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_ConstrainProportionsScale: 0
+  m_Children: []
+  m_Father: {fileID: 0}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+--- !u!1660057539 &9223372036854775807
+SceneRoots:
+  m_ObjectHideFlags: 0
+  m_Roots:
+  - {fileID: 320557563}
+  - {fileID: 924544600}
--- a/Assets/Samples~/IAAAdDebugSample/Scenes/IAAAdDebugSample.unity.meta
+++ b/Assets/Samples~/IAAAdDebugSample/Scenes/IAAAdDebugSample.unity.meta
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: f2af01c304b689445904b3b93d20ff83
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: