iOS SDK 预置事件和属性

根据常用的使用场景，以及帮助开发者快速集成 SDK，极光分析 SDK 预先定义了一部分基础的事件和属性，无需开发者自行埋点，SDK 会自动采集并上报。
预置事件和预置属性都会以“jg_”开头，便于您和自定义事件、属性进行区分。

预置事件

所有预置事件均包括基础的预置属性，详见预置事件属性。

“-”代表该事件仅有基础的预置属性。

事件显示名称	事件名称	事件属性	属性显示名称	数据类型	属性值含义或示例 & 样例格式	事件触发时机
应用启动	jg_app_launch	-				App 应用启动时上报
应用首次激活	jg_app_active	-				应用安装后首次打开才会触发，第二次打开不会再触发
应用切换至后台	jg_app_hide	-				应用从前台激活状态切换至后台
应用切换至前台	jg_app_show	-				应用从后台切换至前台激活状态
退出应用	jg_app_end	-				退出应用或应用进入后台时触发
用户新注册	jg_app_cuid	jg_utm_source	广告系列来源	string	依赖开发者设置公共属性，否则无数据	新用户注册成功时触发，后台同时触发设置用户属性：首次访问时间、first_utm 系列
		jg_utm_medium	广告系列媒介	string	依赖开发者设置公共属性，否则无数据
		jg_utm_term	广告系列字词	string	依赖开发者设置公共属性，否则无数据
		jg_utm_content	广告系列内容	string	依赖开发者设置公共属性，否则无数据
		jg_utm_campaign	广告系列名称	string	依赖开发者设置公共属性，否则无数据
点击通知栏消息	jg_message_click	jg_msg_id	推送 ID	string	通知栏消息的 msgid	用户点击通知栏消息时触发
		jg_task_id	任务 ID	string	运营计划产生的发送任务 ID
		jg_plan_id	运营计划 ID	string	运营计划 ID
		jg_msg_title	消息标题	string	通知栏消息的标题
		jg_msg_content	消息内容	string	通知栏消息的文案
		jg_msg_type	消息类型	string	消息类型
		jg_msg_url	跳转页面	string	Android 平台的目标打开地址
送达通知栏消息	jg_push_received	jg_msg_id	推送 ID	string	通知栏消息的 msgid	通知栏消息被送达至终端时触发
		jg_task_id	任务 ID	string	运营计划产生的发送任务 ID
		jg_plan_id	运营计划 ID	string	运营计划 ID
		jg_msg_title	消息标题	string	通知栏消息的标题
		jg_msg_content	消息内容	string	通知栏消息的文案
		jg_msg_type	消息类型	string	消息类型
		jg_msg_url	跳转页面	string	Android 平台的目标打开地址
开启通知权限	jg_notification_state_on	jg_date_time	通知关闭 / 开启时间	string	通知开启或关闭的最近发生时间 <br />	开启应用通知权限时触发
关闭通知权限	jg_notification_state_off	jg_date_time	通知关闭 / 开启时间	string	通知开启或关闭的最近发生时间	用户关闭应用通知权限时触发
App 浏览页面	jg_app_viewscreen	-				打开一个 Activity / ViewController 页面时触发、依赖全埋点、IOS暂不支持
App 页面元素点击	jg_app_click	-				点击控件时触发、依赖全埋点、IOS暂不支持

预置事件属性

显示名称	属性名称	数据类型	备注
数据来源类型	jg_data_source	string	Android、IOS、WebJS、微信小程序、微信公众号、HTTP API
app_key	jg_app_key	string	android、iOS、web、小程序等在平台 - 数据源注册的 appkey
应用名称	jg_app_name	string	android、iOS 由 SDK 自行处理、webjs/ 小程序 / 公众号由后台处理（08.22 日更新）
数据源 ID	jg_data_source_id	number	android、iOS、web、小程序等在平台 - 数据源注册的数据源 ID
应用渠道	jg_channel_source	string	360、应用宝、豌豆荚，华为商城。
是否首次启动	jg_launch_first	bool	安装应用后，第一次启动
是否首日访问	jg_is_first_day	bool	事件是否在首日触发（首次启动当天至 24 点之前均为首日）
平台类型	jg_platform_type	string	APP 端、网页端、小程序端、微信公众号
应用版本	jg_app_version	string	app、小程序应用版本号
极光分析 SDK 版本	jg_operate_sdk_ver	string	极光分析 SDK 版本号
设备 ID	jg_device_id	string	Android 端主要取 Android ID ，iOS 端先尝试获取 IDFA
移动运营商	jg_carrier	string	中国电信、中国移动、中国联通
是否使用 wifi	jg_wifi	bool	是否使用 wifi 联网
WiFI 名	jg_ssid	string
网络类型	jg_network_type	string	wifi、2g、3g、4g、5g
IP 地址	jg_ip	string	需要后台服务端获取
国家	jg_country	string	根据 IP 地址解析出城国家
城市	jg_city	string	根据 IP 地址解析出城市
省份	jg_province	string	根据 IP 地址解析出省份
GPS 纬度	jg_latitude	number	微信公众号 Latitude
GPS 经度	jg_longitude	number	微信公众号 Longitude
设备品牌	jg_brand	string	huawei、xiaomi、vivo、oppo、apple
设备厂商	jg_manufacturer	string	huawei、xiaomi、vivo、oppo、apple
设备型号	jg_devices_model	string	移动终端设备的生产型号
设备时区	jg_time_zone	string	设备终端系统的当前时区
系统语言	jg_os_language	string	设备终端系统的当前语言
操作系统	jg_os	string	ios、android、harmony、Windows、Linux
系统版本	jg_os_version	string	android 7、 ios 14.5
屏幕高度	jg_screen_height	number
屏幕宽度	jg_screen_width	number
屏幕尺寸	jg_screen_size	string
会话时长	jg_event_duration	number	基于设备位于前台的时长求和统计，单位为秒, 在 app_launch 里无该属性或值为 0