23 KiB
23 KiB
KBMaiPoint 埋点事件表（统一口径：iOS / Android / 后端）
统一约定（全端一致）
1）事件类型（event_type）
- 页面曝光：
page_exposure - 点击事件：
click
iOS 侧可映射为：
KBMaiPointGenericReportTypePage / KBMaiPointGenericReportTypeClick
2）事件名称（event_name）
- 统一使用
lower_snake_case，不绑定任何端的类名/资源名 - 页面曝光统一前缀：
enter_ - 点击事件统一前缀：
click_
3）事件参数（value / params）
- 所有事件都固定带：
token（NSString，有就传真实值；没有就传空字符串""） - 建议额外固定带：
page_id（页面/区域统一ID） - 点击类事件建议固定带：
element_id（控件/入口统一ID） - 列表/集合类点击建议带：
index（NSInteger）与业务id（如theme_id/product_id）
参数示例（最小）：
{ "token": "", "page_id": "shop", "element_id": "search_btn" }
A. 主工程（keyBoard）
A1）页面曝光（触发：VC 的 viewDidAppear）
| 注释 | 事件类型 | 事件名称 | page_id | iOS 对应页面 | Android 对应页面 | 触发时机 | 事件参数（示例） |
|---|---|---|---|---|---|---|---|
| 进入首页 | page_exposure | enter_home_main | home_main | HomeMainVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"home_main" } |
| 进入首页Tab容器 | page_exposure | enter_home | home | HomeVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"home" } |
| 进入热门页 | page_exposure | enter_home_hot | home_hot | HomeHotVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"home_hot" } |
| 进入排行榜页 | page_exposure | enter_home_rank | home_rank | HomeRankVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"home_rank" } |
| 进入排行榜内容页 | page_exposure | enter_home_rank_content | home_rank_content | HomeRankContentVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"home_rank_content" } |
| 进入首页底部弹层 | page_exposure | enter_home_sheet | home_sheet | HomeSheetVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"home_sheet" } |
| 进入社区页 | page_exposure | enter_community | community | KBCommunityVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"community" } |
| 进入搜索页 | page_exposure | enter_search | search | KBSearchVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"search" } |
| 进入搜索结果页 | page_exposure | enter_search_result | search_result | KBSearchResultVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"search_result" } |
| 进入商店页 | page_exposure | enter_shop | shop | KBShopVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"shop" } |
| 进入商店分类列表页 | page_exposure | enter_shop_item_list | shop_item_list | KBShopItemVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"shop_item_list" } |
| 进入皮肤详情页 | page_exposure | enter_skin_detail | skin_detail | KBSkinDetailVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"skin_detail", "theme_id":"" } |
| 进入我的页 | page_exposure | enter_my | my | MyVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"my" } |
| 进入我的皮肤页 | page_exposure | enter_my_skin | my_skin | MySkinVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"my_skin" } |
| 进入我的键盘配置页 | page_exposure | enter_my_keyboard | my_keyboard | KBMyKeyBoardVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"my_keyboard" } |
| 进入个人信息页 | page_exposure | enter_person_info | person_info | KBPersonInfoVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"person_info" } |
| 进入反馈页 | page_exposure | enter_feedback | feedback | KBFeedBackVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"feedback" } |
| 进入公告页 | page_exposure | enter_notice | notice | KBNoticeVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"notice" } |
| 进入消费记录页 | page_exposure | enter_consumption_record | consumption_record | KBConsumptionRecordVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"consumption_record" } |
| 进入VIP购买页 | page_exposure | enter_vip_pay | vip_pay | KBVipPay | Android 自定义 | viewDidAppear | { "token":"", "page_id":"vip_pay" } |
| 进入积分充值页 | page_exposure | enter_points_recharge | points_recharge | KBJfPay | Android 自定义 | viewDidAppear | { "token":"", "page_id":"points_recharge" } |
| 进入登录页 | page_exposure | enter_login | login | KBLoginVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"login" } |
| 进入邮箱登录页 | page_exposure | enter_login_email | login_email | KBEmailLoginVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"login_email" } |
| 进入邮箱注册页 | page_exposure | enter_register_email | register_email | KBEmailRegistVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"register_email" } |
| 进入注册验证码页 | page_exposure | enter_register_verify_email | register_verify_email | KBRegistVerEmailVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"register_verify_email" } |
| 进入忘记密码页 | page_exposure | enter_forgot_password_email | forgot_password_email | KBForgetPwdVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"forgot_password_email" } |
| 进入忘记密码验证码页 | page_exposure | enter_forgot_password_verify | forgot_password_verify | KBForgetVerPwdVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"forgot_password_verify" } |
| 进入忘记密码新密码页 | page_exposure | enter_forgot_password_newpwd | forgot_password_newpwd | KBForgetPwdNewPwdVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"forgot_password_newpwd" } |
| 进入键盘权限引导页（App内） | page_exposure | enter_keyboard_permission_guide | keyboard_permission_guide | KBPermissionViewController | Android 自定义 | viewDidAppear | { "token":"", "page_id":"keyboard_permission_guide" } |
| 进入首次引导页 | page_exposure | enter_guide | guide | KBGuideVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"guide" } |
| 进入性别选择页 | page_exposure | enter_sex_select | sex_select | KBSexSelVC | Android 自定义 | viewDidAppear | { "token":"", "page_id":"sex_select" } |
| 进入WebView页 | page_exposure | enter_webview | webview | KBWebViewViewController | Android 自定义 | viewDidAppear | { "token":"", "page_id":"webview", "url":"" } |
测试/工具页（建议仅 DEBUG 或按需接入）：
KBTestVC / KBLangTestVC / KBSkinCenterVC / ViewController / LoginViewController / KBLoginSheetViewController。
A2）点击事件（按钮/列表/入口）
| 注释 | 事件类型 | 事件名称 | page_id | element_id | iOS 对应控件/方法 | Android 对应控件 | 触发时机 | 事件参数（示例） |
|---|---|---|---|---|---|---|---|---|
| 首页点击“购买会员” | click | click_home_buy_vip_btn | home_main | buy_vip_btn | HomeHeadView onTapBuyAction |
Android 自定义 | touchUpInside | { "token":"", "page_id":"home_main", "element_id":"buy_vip_btn" } |
| 首页点击“权限悬浮按钮” | click | click_home_permission_float_btn | home_main | permission_float_btn | HomeMainVC keyPermissButton.clickDragViewBlock |
Android 自定义 | 点击悬浮按钮 | { "token":"", "page_id":"home_main", "element_id":"permission_float_btn" } |
| 权限引导页点击“去设置” | click | click_permission_open_settings_btn | keyboard_permission_guide | open_settings_btn | KBPermissionViewController openSettings |
Android 自定义 | touchUpInside | { "token":"", "page_id":"keyboard_permission_guide", "element_id":"open_settings_btn" } |
| 权限引导页点击“关闭” | click | click_permission_close_btn | keyboard_permission_guide | close_btn | KBPermissionViewController closeButtonAction |
Android 自定义 | touchUpInside | { "token":"", "page_id":"keyboard_permission_guide", "element_id":"close_btn" } |
| 商店页点击“搜索” | click | click_shop_search_btn | shop | search_btn | KBShopVC searchBtnAction |
Android 自定义 | touchUpInside | { "token":"", "page_id":"shop", "element_id":"search_btn" } |
| 商店页点击“我的皮肤” | click | click_shop_my_skin_btn | shop | my_skin_btn | KBShopVC skinBtnAction |
Android 自定义 | touchUpInside | { "token":"", "page_id":"shop", "element_id":"my_skin_btn" } |
| 商店列表点击皮肤卡片 | click | click_shop_theme_card | shop_item_list | theme_card | KBShopItemVC didSelectItemAtIndexPath |
Android 自定义 | didSelect | { "token":"", "page_id":"shop_item_list", "element_id":"theme_card", "theme_id":"", "index":0 } |
| 皮肤详情点击“下载/购买” | click | click_skin_download_btn | skin_detail | download_btn | KBSkinDetailVC handleDownloadAction |
Android 自定义 | touchUpInside | { "token":"", "page_id":"skin_detail", "element_id":"download_btn", "theme_id":"", "purchased":0 } |
| 皮肤详情点击“推荐皮肤” | click | click_skin_recommend_card | skin_detail | recommend_card | KBSkinDetailVC didSelectItemAtIndexPath |
Android 自定义 | didSelect | { "token":"", "page_id":"skin_detail", "element_id":"recommend_card", "from_theme_id":"", "to_theme_id":"", "index":0 } |
| 搜索栏点击搜索 | click | click_search_submit | search | search_submit | KBSearchBarView onSearch |
Android 自定义 | 点击搜索 | { "token":"", "page_id":"search", "element_id":"search_submit", "keyword_len":0 } |
| 搜索页点击历史词条 | click | click_search_history_item | search | history_item | KBSearchVC didSelectItemAtIndexPath |
Android 自定义 | didSelect | { "token":"", "page_id":"search", "element_id":"history_item", "index":0 } |
| 搜索页点击“展开更多历史” | click | click_search_history_more | search | history_more | KBSearchVC didSelectItemAtIndexPath |
Android 自定义 | didSelect | { "token":"", "page_id":"search", "element_id":"history_more" } |
| 搜索页点击“清空历史” | click | click_search_clear_history | search | clear_history | KBSearchVC clearHistory（header trash） |
Android 自定义 | 点击垃圾桶 | { "token":"", "page_id":"search", "element_id":"clear_history" } |
| 搜索页点击推荐皮肤 | click | click_search_recommend_theme | search | recommend_theme_card | KBSearchVC didSelectItemAtIndexPath |
Android 自定义 | didSelect | { "token":"", "page_id":"search", "element_id":"recommend_theme_card", "theme_id":"", "index":0 } |
| 搜索结果页点击皮肤 | click | click_search_result_theme | search_result | result_theme_card | KBSearchResultVC didSelectItemAtIndexPath |
Android 自定义 | didSelect | { "token":"", "page_id":"search_result", "element_id":"result_theme_card", "theme_id":"", "index":0 } |
| 我的页点击菜单项 | click | click_my_menu_item | my | menu_item | MyVC didSelectRowAtIndexPath |
Android 自定义 | didSelect | { "token":"", "page_id":"my", "element_id":"menu_item", "item_id":"", "item_title":"" } |
| 我的页点击“邀请”成功复制 | click | click_my_invite_copy | my | invite_copy | MyVC（邀请分支） | Android 自定义 | 复制时机 | { "token":"", "page_id":"my", "element_id":"invite_copy" } |
| 反馈页点击提交 | click | click_feedback_commit_btn | feedback | commit_btn | KBFeedBackVC onTapCommit |
Android 自定义 | touchUpInside | { "token":"", "page_id":"feedback", "element_id":"commit_btn", "content_len":0 } |
| 个人信息点击更换头像 | click | click_person_avatar_edit | person_info | avatar_edit | KBPersonInfoVC onTapAvatarEdit |
Android 自定义 | tapGesture | { "token":"", "page_id":"person_info", "element_id":"avatar_edit" } |
| 个人信息点击退出登录 | click | click_person_logout_btn | person_info | logout_btn | KBPersonInfoVC onTapLogout |
Android 自定义 | touchUpInside | { "token":"", "page_id":"person_info", "element_id":"logout_btn" } |
| 我的键盘页点击保存 | click | click_my_keyboard_save_btn | my_keyboard | save_btn | KBMyKeyBoardVC onSave |
Android 自定义 | touchUpInside | { "token":"", "page_id":"my_keyboard", "element_id":"save_btn" } |
| 我的皮肤页点击编辑/取消 | click | click_my_skin_toggle_edit | my_skin | toggle_edit | MySkinVC onToggleEdit |
Android 自定义 | touchUpInside | { "token":"", "page_id":"my_skin", "element_id":"toggle_edit", "editing":0 } |
| 我的皮肤页点击删除 | click | click_my_skin_delete_btn | my_skin | delete_btn | MySkinVC onDelete |
Android 自定义 | touchUpInside | { "token":"", "page_id":"my_skin", "element_id":"delete_btn", "selected_count":0 } |
| 我的皮肤页点击皮肤（进入详情） | click | click_my_skin_theme_card | my_skin | theme_card | MySkinVC didSelectItemAtIndexPath |
Android 自定义 | didSelect | { "token":"", "page_id":"my_skin", "element_id":"theme_card", "theme_id":"", "index":0 } |
| 登录页点击 Apple 登录 | click | click_login_apple_btn | login | apple_btn | KBLoginVC onTapAppleLogin |
Android 自定义 | touchUpInside | { "token":"", "page_id":"login", "element_id":"apple_btn" } |
| 登录页点击邮箱登录 | click | click_login_email_btn | login | email_btn | KBLoginVC onTapEmailLogin |
Android 自定义 | touchUpInside | { "token":"", "page_id":"login", "element_id":"email_btn" } |
| 登录页点击注册 | click | click_login_signup_btn | login | signup_btn | KBLoginVC onTapSignUp |
Android 自定义 | touchUpInside | { "token":"", "page_id":"login", "element_id":"signup_btn" } |
| 登录页点击忘记密码 | click | click_login_forgot_btn | login | forgot_btn | KBLoginVC onTapForgotPassword |
Android 自定义 | touchUpInside | { "token":"", "page_id":"login", "element_id":"forgot_btn" } |
| 邮箱登录页点击提交 | click | click_login_email_submit_btn | login_email | submit_btn | KBEmailLoginVC onTapSubmit |
Android 自定义 | touchUpInside | { "token":"", "page_id":"login_email", "element_id":"submit_btn" } |
| 邮箱注册页点击提交 | click | click_register_email_submit_btn | register_email | submit_btn | KBEmailRegistVC onTapSubmit |
Android 自定义 | touchUpInside | { "token":"", "page_id":"register_email", "element_id":"submit_btn" } |
| 注册验证码页点击确认 | click | click_register_verify_confirm_btn | register_verify_email | confirm_btn | KBRegistVerEmailVC onTapConfirm |
Android 自定义 | touchUpInside | { "token":"", "page_id":"register_verify_email", "element_id":"confirm_btn" } |
| 忘记密码（邮箱）点击下一步 | click | click_forgot_email_next_btn | forgot_password_email | next_btn | KBForgetPwdVC onTapNext |
Android 自定义 | touchUpInside | { "token":"", "page_id":"forgot_password_email", "element_id":"next_btn" } |
| 忘记密码（验证码）点击下一步 | click | click_forgot_verify_next_btn | forgot_password_verify | next_btn | KBForgetVerPwdVC onTapNext |
Android 自定义 | touchUpInside | { "token":"", "page_id":"forgot_password_verify", "element_id":"next_btn" } |
| 忘记密码（新密码）点击下一步 | click | click_forgot_newpwd_next_btn | forgot_password_newpwd | next_btn | KBForgetPwdNewPwdVC onTapNext |
Android 自定义 | touchUpInside | { "token":"", "page_id":"forgot_password_newpwd", "element_id":"next_btn" } |
| VIP页选择套餐 | click | click_vip_select_plan | vip_pay | plan_item | KBVipPay didSelectItemAtIndexPath |
Android 自定义 | didSelect | { "token":"", "page_id":"vip_pay", "element_id":"plan_item", "product_id":"", "index":0 } |
| VIP页点击支付 | click | click_vip_pay_btn | vip_pay | pay_btn | KBVipPay onTapPayButton |
Android 自定义 | touchUpInside | { "token":"", "page_id":"vip_pay", "element_id":"pay_btn", "product_id":"" } |
| VIP页点击恢复购买 | click | click_vip_restore_btn | vip_pay | restore_btn | KBVipPay onTapRestoreButton |
Android 自定义 | touchUpInside | { "token":"", "page_id":"vip_pay", "element_id":"restore_btn" } |
| VIP页点击关闭 | click | click_vip_close_btn | vip_pay | close_btn | KBVipPay onTapClose |
Android 自定义 | touchUpInside | { "token":"", "page_id":"vip_pay", "element_id":"close_btn" } |
| 积分充值页选择商品 | click | click_points_select_product | points_recharge | product_item | KBJfPay didSelectItemAtIndexPath |
Android 自定义 | didSelect | { "token":"", "page_id":"points_recharge", "element_id":"product_item", "product_id":"", "index":0 } |
| 积分充值页点击充值 | click | click_points_pay_btn | points_recharge | pay_btn | KBJfPay onTapPayButton |
Android 自定义 | touchUpInside | { "token":"", "page_id":"points_recharge", "element_id":"pay_btn", "product_id":"" } |
| 引导页点击复制示例1 | click | click_guide_copy_example_1 | guide | copy_example_1 | KBGuideTopCell kb_onTapQ1 |
Android 自定义 | touchUpInside | { "token":"", "page_id":"guide", "element_id":"copy_example_1" } |
| 引导页点击复制示例2 | click | click_guide_copy_example_2 | guide | copy_example_2 | KBGuideTopCell kb_onTapQ2 |
Android 自定义 | touchUpInside | { "token":"", "page_id":"guide", "element_id":"copy_example_2" } |
B. 键盘扩展（CustomKeyboard）
B1）页面曝光（触发：显示/切换时机）
| 注释 | 事件类型 | 事件名称 | page_id | iOS 对应页面/视图 | Android 对应页面 | 触发时机 | 事件参数（示例） |
|---|---|---|---|---|---|---|---|
| 键盘首次显示 | page_exposure | enter_keyboard | keyboard | KeyboardViewController | Android 自定义 | viewDidAppear | { "token":"", "page_id":"keyboard" } |
| 打开功能面板 | page_exposure | enter_keyboard_function_panel | keyboard_function_panel | KBFunctionView | Android 自定义 | showFunctionPanel:YES | { "token":"", "page_id":"keyboard_function_panel" } |
| 关闭功能面板（回到主键盘） | page_exposure | enter_keyboard_main_panel | keyboard_main_panel | KBKeyBoardMainView | Android 自定义 | showFunctionPanel:NO | { "token":"", "page_id":"keyboard_main_panel" } |
| 打开设置页 | page_exposure | enter_keyboard_settings | keyboard_settings | KBSettingView | Android 自定义 | showSettingView:YES | { "token":"", "page_id":"keyboard_settings" } |
| 打开订阅/充值面板 | page_exposure | enter_keyboard_subscription_panel | keyboard_subscription_panel | KBKeyboardSubscriptionView | Android 自定义 | showSubscriptionPanel | { "token":"", "page_id":"keyboard_subscription_panel" } |
B2）点击事件（键盘工具栏 / 功能面板 / 订阅面板）
| 注释 | 事件类型 | 事件名称 | page_id | element_id | iOS 对应控件/方法 | Android 对应控件 | 触发时机 | 事件参数（示例） |
|---|---|---|---|---|---|---|---|---|
| 点击键盘顶部工具栏（index=0 打开功能面板） | click | click_keyboard_toolbar_action | keyboard_main_panel | toolbar_action | KBKeyBoardMainViewDelegate didTapToolActionAtIndex: |
Android 自定义 | 点击工具栏 | { "token":"", "page_id":"keyboard_main_panel", "element_id":"toolbar_action", "index":0 } |
| 点击键盘设置按钮 | click | click_keyboard_settings_btn | keyboard_main_panel | settings_btn | keyBoardMainViewDidTapSettings: |
Android 自定义 | 点击设置 | { "token":"", "page_id":"keyboard_main_panel", "element_id":"settings_btn" } |
| 点击设置页返回 | click | click_keyboard_settings_back_btn | keyboard_settings | back_btn | KeyboardViewController onTapSettingsBack |
Android 自定义 | touchUpInside | { "token":"", "page_id":"keyboard_settings", "element_id":"back_btn" } |
| 点击撤销删除 | click | click_keyboard_undo_btn | keyboard_main_panel | undo_btn | keyBoardMainViewDidTapUndo: |
Android 自定义 | 点击撤销 | { "token":"", "page_id":"keyboard_main_panel", "element_id":"undo_btn" } |
| 点击表情面板搜索 | click | click_keyboard_emoji_search_btn | keyboard_main_panel | emoji_search_btn | keyBoardMainViewDidTapEmojiSearch: |
Android 自定义 | 点击搜索 | { "token":"", "page_id":"keyboard_main_panel", "element_id":"emoji_search_btn" } |
| 点击联想词条 | click | click_keyboard_suggestion_item | keyboard_main_panel | suggestion_item | didSelectSuggestion: |
Android 自定义 | 点击候选 | { "token":"", "page_id":"keyboard_main_panel", "element_id":"suggestion_item", "index":0 } |
| 功能面板点击“粘贴” | click | click_keyboard_function_paste_btn | keyboard_function_panel | paste_btn | KBFunctionView onTapPaste |
Android 自定义 | touchUpInside | { "token":"", "page_id":"keyboard_function_panel", "element_id":"paste_btn" } |
| 功能面板点击“删除” | click | click_keyboard_function_delete_btn | keyboard_function_panel | delete_btn | KBFunctionView onTapDelete |
Android 自定义 | touchUpInside | { "token":"", "page_id":"keyboard_function_panel", "element_id":"delete_btn" } |
| 功能面板点击“清空” | click | click_keyboard_function_clear_btn | keyboard_function_panel | clear_btn | KBFunctionView onTapClear |
Android 自定义 | touchUpInside | { "token":"", "page_id":"keyboard_function_panel", "element_id":"clear_btn" } |
| 功能面板点击“发送” | click | click_keyboard_function_send_btn | keyboard_function_panel | send_btn | KBFunctionView onTapSend |
Android 自定义 | touchUpInside | { "token":"", "page_id":"keyboard_function_panel", "element_id":"send_btn" } |
| 功能面板点击“人设/标签”条目 | click | click_keyboard_function_tag_item | keyboard_function_panel | renshe_item | KBFunctionTagListView didSelectItemAtIndexPath |
Android 自定义 | didSelect | { "token":"", "page_id":"keyboard_function_panel", "element_id":"renshe_item", "index":0, "id":456, "name":"" } |
| 功能面板右侧点击“登录/充值”入口（未登录走登录） | click | click_keyboard_function_right_action | keyboard_function_panel | right_action | KeyboardViewController didRightTapToolActionAtIndex: |
Android 自定义 | 点击右侧入口 | { "token":"", "page_id":"keyboard_function_panel", "element_id":"right_action", "action":"login_or_recharge" } |
| 订阅面板点击关闭 | click | click_keyboard_subscription_close_btn | keyboard_subscription_panel | close_btn | subscriptionViewDidTapClose: |
Android 自定义 | 点击关闭 | { "token":"", "page_id":"keyboard_subscription_panel", "element_id":"close_btn" } |
| 订阅面板点击购买某商品 | click | click_keyboard_subscription_product_btn | keyboard_subscription_panel | product_btn | didTapPurchaseForProduct: |
Android 自定义 | 点击购买 | { "token":"", "page_id":"keyboard_subscription_panel", "element_id":"product_btn", "product_id":"", "index":0 } |