记录事件¶

概述¶

本指南将向您展示如何在您的游戏中记录事件。

事件可以提供关于游戏中正在发生的事情的见解，例如用户操作、系统事件或错误。

SohaGame SDK会自动记录一些事件，但某些事件需要您手动集成。

开始之前¶

您需要将 SohaGame SDK 集成到您的 iOS 游戏中。

需要集成的事件列表¶

必要事件¶

1. create_character：在成功创建角色并进入游戏时记录此事件（必要）

[SohaKit logCreateCharacterWithName:role_name
                    roleID:role_id
                    roleLevel:role_level
                    serverID:server_id];

注意： create_character 事件在角色成功创建时只会触发一次。

2. set_role：在选择角色或角色升级后记录此事件（必要）

[SohaKit mapUserGame:role_name
                    roleID:role_id 
                    roleLevel:role_level 
                    serverID:server_id];

请务必传递完整信息：AreaId(serverID)、RoleID、RoleName、RoleLevel

3. CDN 下载事件追踪 在应用启动并开始 CDN 资源准备流程时（包括 CDN 下载，或在无需下载时进行资源解压），触发一次 SohaCDNDownloadStartEvent。当 CDN 下载或资源解压成功完成且所有资源已准备就绪时，触发 SohaCDNDownloadCompleteEvent。这两个事件仅需在应用启动阶段上报一次，无需在用户登录后或进入游戏时再次上报。

// 立即记录开始事件，并在 CDN 下载完成后记录完成事件。
[SohaKit logCustomEvent:SohaCDNDownloadStartEvent];

// 模拟实际的 CDN 下载过程。
[SohaKit logCustomEvent:SohaCDNDownloadCompleteEvent];

可选事件¶

自定义事件

[SohaKit logCustomEvent:@"<your_event_name>"];