# 放置类埋点模板_v1

## 事件数据

| 事件名 | 显示名 | 说明 | 标签 | 平台 | 属性 |
| --- | --- | --- | --- | --- | --- |
| register | 注册日志 | 注册完成后 |  |  |  |
| create_role | 创建角色 | 创角完成后 |  |  |  |
| login | 登录日志 | 登录完成后 |  |  | first_login |
| logout | 登出日志 | 用户登出时 |  |  | online_time |
| levelup | 升级日志 | 用户升级后（连升多级需多次调用） |  |  | new_level |
| vip_levelup | 贵族等级提升 | 贵族等级提升后（连升多级需多次调用） |  |  | new_vip_level |
| guide_complete | 完成新手引导 | 完成新手引导每一步时记录 |  |  | guide_step, guide_name |
| order_init | 发起订单 | 用户发起充值订单 |  |  | order_id, pay_amount, pay_reason, is_first_pay |
| order_finish | 订单完成 | 订单完成 |  |  | order_id, pay_amount, pay_reason, is_first_pay, pay_method |
| enter_chapter | 挑战章节 | 挑战副本或关卡 |  |  | chapter_id, chapter_name, hero_list |
| chapter_completed | 章节通过 | 通过副本或关卡 |  |  | chapter_id, chapter_name, hero_list |
| chapter_fail | 章节失败 | 副本或关卡挑战失败 |  |  | chapter_id, chapter_name, hero_list |
| enter_dungeon | 挑战护国战争关卡 | 结束一关挑战时记录 |  |  | dungeon_id, dungeon_name, hero_list, fight_result |
| mopup_dungeon | 扫荡护国战争 | 扫荡完成时 |  |  | main_dungeon_name, dungeon_id, dungeon_name |
| enter_daily | 参与日常副本 | 结束一局日常副本挑战时记录 |  |  | daily_type, daily_level, fight_result |
| mopup_daily | 扫荡日常副本 | 扫荡日常副本时记录 |  |  | daily_type, daily_level |
| all_mopup_daily | 一键扫荡日常副本 | 完成一键扫荡时记录 |  |  |  |
| enter_pvp | 参与竞技场 | 一局竞技场结束时记录 |  |  | enemy_id, enemy_fight, enemy_cup, enemy_rank, hero_list, fight_result, cup_change, rank_change, after_rank |
| enter_ancient_city | 将领对决 | 古城探宝对决结束时 |  |  | city_floor, hero_id, hero_name, hero_fight, enemy_id, enemy_name, enemy_fight, enemy_type, fight_result |
| enter_cave | 诡异洞穴 | 探索诡异洞穴时记录 |  |  | hero_id, hero_name, fight_result |
| city_store | 古城商店购物 | 购买古城商店物品时记录 |  |  | store_type, item_id, item_name, item_price, cost_type |
| all_mopup_city | 一键扫荡古城 |  |  |  |  |
| enter_exercise | 参与沙场演兵 | 完成一局沙场演兵时记录 |  |  | dungeon_id, game_result |
| enter_battle | 参与全军切磋 | 完成一局全军切磋时记录 |  |  | battle_chapter, battle_dungeon, fight_result, get_star |
| star_store | 星数商店 | 购买星数商店时记录 |  |  | item_id, item_name, item_price, cost_type |
| crusade | 征讨国贼 | 征讨国贼后记录 |  |  | fight_result, damage, buy_encourage |
| resource_change | 资源变动 | 资源发生变化时记录 |  |  | resource_id, resource_name, change_type, change_num, change_before, change_after, change_reason |
| item_change | 道具变动 | 道具数量发生变化时记录 |  |  | change_type, item_id, item_name, item_quality, item_num, change_reason |
| chip_change | 碎片变动 | 碎片数量发生变化时记录 |  |  | chip_id, chip_name, chip_level, change_type, change_num, change_before, change_after, change_reason |
| buy_item | 购买道具 | 购买道具时触发 |  |  | store_type, item_id, item_name, item_price, cost_type |
| general_up | 将领升级 | 将领升级后记录 |  |  | general_id, general_name, rarity, new_level, new_fight, up_type |
| general_starup | 将领升星 | 将领升星后记录 |  |  | general_id, general_name, rarity, new_star, new_fight |
| general_breach | 将领突破 | 将领突破后记录 |  |  | general_id, general_name, rarity, new_breach_fight |
| general_control | 将领统御 | 统御升级时记录 |  |  | control_level |
| seven_task | 七天任务 | 点击领取时记录 |  |  | day_num |
| task_completed | 完成任务 | 点击领取时记录 |  |  | task_type, task_name |
| recruit | 招募 | 完成将领招募时记录 |  |  | recruit_type, order_type, cost_ordernum, hero_list |
| get_hangup | 领取挂机收益 | 点击领取时记录 |  |  | hangup_time |
| fast_hangup | 快速挂机 | 完成快速挂机时记录 |  |  |  |
| online_reward | 在线奖励 | 领取在线奖励时记录 |  |  | reward_name |
| barracks | 兵营放置 | 在兵营内放置将领时记录 |  |  | hero_type, hero_id, hero_name |
| unlock_general | 激活将领 | 激活将领时记录 |  |  | hero_id, hero_name |
| up_general | 升级将领 | 在图鉴中升级将领时记录 |  |  | hero_id, hero_name |
| unlock_class | 解锁讲武堂 | 解锁讲武堂位置时记录 |  |  |  |
| put_student | 放入学员 | 放入学员时记录 |  |  | hero_id, hero_name |
| reback_student | 复原学员 | 放入学员时记录 |  |  | hero_id, hero_name |
| join_guild | 加入军团 | 加入他人军团时触发 |  |  | guild_level, guild_id, guild_name, guild_position |
| leave_guild | 离开军团 | 退出军团时触发 |  |  | guild_level, guild_id, guild_name, guild_position |
| create_guild | 创建军团 | 自己创建军团时触发 |  |  | guild_level, guild_id, guild_name, task_name, hero_list |
| get_task_reward | 任务领取 | 领取情报任务奖励时记录 |  |  | task_name, hero_list |
| buy_passcheck | 购买通行证 | 购买通行证后记录 |  |  | passcheck_type |
| get_passreward | 领取援助号奖励 | 领取援助号奖励时记录 |  |  | reward_type |
| gambling | 援助号抽奖 | 援助号内抽奖时记录 |  |  | extract_type |
| help_exchange | 援助号兑换 | 兑换物品时记录 |  |  | item_name |
| get_sprint | 领取冲刺奖励 | 领取冲刺奖励时记录 |  |  | day_num, reward_type, reward_name |
| get_world_reward | 领取世界福利 | 领取世界福利时记录 |  |  | box_type |
| sign | 签到 | 每投掷一次上传一次事件 |  |  |  |
| get_level_box | 领取等级礼包 | 领取等级礼包时记录 |  |  | box_name |
| get_order | 领取战令 | 领取战令时记录 |  |  | order_type, reward_type, reward_name |
| all_recharge | 开服累冲 | 领取累冲奖励时记录 |  |  | reward_name |
| send_gift | 赏赐佳人 | 赏赐佳人礼物时记录 |  |  | beauty_id, beauty_name |
| patronize_beauty | 宠幸佳人 | 宠幸佳人是记录 |  |  | beauty_id, beauty_name |
| beauty_starup | 佳人升星 | 佳人升星后记录 |  |  | beauty_id, beauty_name, new_star |
| beauty_rankup | 佳人进阶 | 佳人进阶后记录 |  |  | beauty_id, beauty_name, new_rank |
| get_title | 获得称号 | 佳人获得称号时记录 |  |  | beauty_id, beauty_name, title |
| unlock_fighter | 战机解锁 | 战机解锁后记录 |  |  | fighter_general |
| ammunition_starup | 弹药升星 | 弹药升星后记录 |  |  | fighter_general, ammunition_id, ammunition_name, new_star |
| strengthen_fighter | 战机强化 | 战机强化后记录 |  |  | fighter_general, new_level |
| fighter_change | 战机换代 | 完成战机换代时记录 |  |  | fighter_general |
| play_turntable | 转动转盘 | 完成一次转盘寻宝时记录 |  |  | turntable_type, reward_name |
| billboard_reward | 获得冲榜奖励 | 获得全服冲榜奖励时记录 |  |  | reward_date, reward_name |
| intercept_beauty | 拦截佳人 | 完成拦截战斗时记录 |  |  | escort_player, intercept_result |
| up_car | 提升花车 | 提升花车时记录 |  |  |  |
| start_escort | 开始护送 | 玩家开始护送时记录 |  |  |  |
| get_email_reward | 领取邮件奖励 | 完成邮件奖励领取时记录 |  |  | reward_name |
| add_friends | 添加好友 | 添加好友成功时记录 |  |  |  |
| decompose | 分解 | 分解装备时记录 |  |  | item_list, get_resource, get_num |
| reborn | 重生 | 将领重生时记录 |  |  | hero_id, hero_name |
| rank_list | 排行榜事件 | 每日上传排行榜快照 |  |  | rank |

## 公共事件属性

| 属性名 | 显示名 | 类型 | 说明 |
| --- | --- | --- | --- |
| device_id | 设备id | 字符串 | 设备相关id（数数sdk有一套自己采集设备关联id的逻辑，因此如果希望记录项目指定的设备id，建议以自定义属性进行记录） |
| server_id | 区服id | 字符串 | 如服务器ID完全由短数字组成，也可设为数值型 |
| channel | 渠道 | 字符串 | 如taptap、appstore等 |
| level | 等级 | 数值 | 玩家事件发生时的等级 |
| vip_level | 贵族等级 | 数值 | 玩家发生事件时的vip等级 |
| fight | 战力 | 数值 | 玩家发生事件时的战力情况 |

## 用户数据

| 属性名 | 显示名 | 类型 | 更新方式 | 说明 | 标签 |
| --- | --- | --- | --- | --- | --- |
| role_id | 角色ID | 字符串 | user_set | 创建角色时记录 |  |
| role_name | 角色名称 | 字符串 | user_set | 创建角色时记录 |  |
| account_id | 账户ID | 字符串 | user_set | 创建角色时记录该角色上一级账号ID |  |
| device_id | 设备ID | 字符串 | user_set | 创建角色时记录 |  |
| channel | 渠道 | 字符串 | user_set | 在游戏启动时设置，上传用户的渠道信息，如app store、应用宝等 |  |
| server | 服务器ID | 字符串 | user_set | 用户创建角色时上传所属服务器ID |  |
| register_time | 注册时间 | 时间 | user_set | 创建角色时记录 |  |
| current_level | 当前等级 | 数值 | user_set | 升级时覆盖 |  |
| current_viplevel | 当前VIP等级 | 数值 | user_set | 升级时覆盖 |  |
| total_revenue | 累计付费 | 数值 | user_set | 每次付费完成时累加 |  |
| total_login | 累计登录 | 数值 | user_set | 每次登录时累加 |  |
| first_game_start_time | 首次游戏启动时间 | 时间 | user_set | 每次启动时设置，上传启动时间 |  |
| last_login_time | 末次登录时间 | 时间 | user_set | 每次登出时设置 |  |
| last_gold | 末次金币 | 数值 | user_set | 每次登出时设置 |  |
| last_sliver | 末次银币 | 数值 | user_set | 每次登出时设置 |  |
| last_soldier | 末次士兵 | 数值 | user_set | 每次登出时设置 |  |
| current_dungeon | 当前副本 | 数值 | user_set | 每次登出时设置 |  |
| current_fight | 当前战力 | 数值 | user_set | 每次登出时设置 |  |
