1 前置条件
完成 腾讯广告一方数据合作 - 通用规范 文档阅读。
2 行为类型
为满足当前应用场景的数据应用要求，需按要求在action_type（如为自定义行为还需填写custom_action）中上报以下行为类型。
| 行为英文名（action_type） | 行为中文名 | 是否必填 | 是否要求行为参数（action_param） | 是否关联商品（product_inform） |
|---|
| ACTIVATE_APP | 激活应用 | 建议 | 是 | |
| PURCHASE | 购买 | 建议 | 是 | |
| REGISTER | 注册 | 建议 | | |
| RESERVATION_CHECK | 用户意向表单 | 建议 | | |
| CREATE_ROLE | （游戏）创建角色 | 建议 | | |
| CUSTOM | 对应custom_action：ACTIVE_USER | 建议 | 是 | |
| CUSTOM | 对应custom_action：UNINSTALL | 建议 | 是 | |
3 行为参数
对于有行为参数要求的行为类型，需按照下述要求在action_param字段中上报对应参数。
ACTIVATE_APP（激活应用）
| 参数名称 | 参数类型 | 参数描述 | 是否必填 | 示例值 |
|---|
| package_name | string | 游戏包名 | 是 | com.lilithgames.rok.ios.offical |
| game_name | string | 游戏中文名称 | 是 | 万国觉醒 |
| source_appid | string | 数据来源游戏对应的appid(多个appid用英文逗号分隔) | 是 | 1519945981,1111199677 |
| apply_appid | string | 期望数据应用到的游戏对应的appid(多个appid用英文逗号分隔) | 是 | 1519945981,1111199677 |
| data_update_frequency | integer | 激活应用更新频率，非实时回传必填，不填默认实时回传。单位：天，枚举范围:[1,30]。例如：1-每天更新，7-每周更新。 | 建议 | 1 |
| os | string | 推广目标的操作系统，枚举值：IOS/ANDROID/SGAME，对应：苹果/安卓/小游戏 | 是 | IOS |
| device_type | string | 设备号格式，枚举值：HASH_IMEI/HASH_OAID/HASH_IDFA/CAID/WECHAT_OPENID/MD5_SHA256_IMEI/MD5_SHA256_IDFA/GDT_OPENID/HASH_PHONE/SHA256_PHONE/HASH_ANDROID_ID/MD5_SHA256_OAID/WECHAT_UNIONID/WECHAT_APP_ID | 是 | HASH_OAID |
| ip | string | 实时获取到的设备IP，用户行为中user_id为空时，可上报IP/UA | 建议 | 11.11.11.11 |
| user_agent | string | 实时获取到的设备User Agent，用户行为中user_id为空时，可上报IP/UA | 建议 | Mozilla/5.0 xxxx |
PURCHASE（购买）
| 参数名称 | 参数类型 | 参数描述 | 是否必填 | 示例值 |
|---|
| value | int | 付费金额，单位分，100表示1元 | 是 | 600 |
| package_name | string | 游戏包名 | 是 | com.lilithgames.rok.ios.offical |
| game_name | string | 游戏中文名称 | 是 | 万国觉醒 |
| source_appid | string | 数据来源游戏对应的appid(多个appid用英文逗号分隔) | 是 | 1519945981,1111199677 |
| apply_appid | string | 期望数据应用到的游戏对应的appid(多个appid用英文逗号分隔) | 是 | 1519945981,1111199677 |
| data_update_frequency | int | 购买行为更新频率，非实时回传必填，不填默认实时回传。单位：天，枚举范围:[1,30]。例如：1-每天更新，7-每周更新。 | 建议 | 1 |
| os | string | 推广目标的操作系统，枚举值：IOS/ANDROID/SGAME，对应：苹果/安卓/小游戏 | 是 | IOS |
| device_type | string | 设备号格式，枚举值：HASH_IMEI/HASH_OAID/HASH_IDFA/CAID/WECHAT_OPENID/MD5_SHA256_IMEI/MD5_SHA256_IDFA/GDT_OPENID/HASH_PHONE/SHA256_PHONE/HASH_ANDROID_ID/MD5_SHA256_OAID/WECHAT_UNIONID/WECHAT_APP_ID | 是 | HASH_OAID |
| ip | string | 实时获取到的设备IP，用户行为中user_id为空时，可上报IP/UA | 建议 | 11.11.11.11 |
| user_agent | string | 实时获取到的设备User Agent，用户行为中user_id为空时，可上报IP/UA | 建议 | Mozilla/5.0 xxxx |
CUSTOM（ACTIVE_USER）
| 参数名称 | 参数类型 | 参数描述 | 是否必填 | 示例值 |
|---|
| package_name | string | 游戏包名 | 是 | com.lilithgames.rok.ios.offical |
| game_name | string | 游戏中文名称 | 是 | 万国觉醒 |
| source_appid | string | 数据来源游戏对应的appid(多个appid用英文逗号分隔) | 是 | 1519945981,1111199677 |
| apply_appid | string | 期望数据应用到的游戏对应的appid(多个appid用英文逗号分隔) | 是 | 1519945981,1111199677 |
| start_time | int | 活跃开始时间，10位时间戳，unixtimestamp，实时回传必填 | 建议 | 1665728628 |
| end_time | int | 活跃结束时间，10位时间戳，unixtimestamp，实时回传必填 | 建议 | 1665728728 |
| active_duration | int | 活跃总时长，非实时回传必填，单位：秒，100代表上报时间周期内活跃10次，总活跃时长为100秒 | 建议 | 100 |
| active_time | int | 活跃总次数，非实时回传必填，单位：次，10 | 建议 | 10 |
| data_update_frequency | int | 用户活跃更新频率，非实时回传必填，不填默认实时回传。单位：天，枚举范围:[1,30]。每天更新填1，每周更新填7 | 建议 | 1 |
| os | string | 推广目标的操作系统，枚举值：IOS/ANDROID/SGAME，对应：苹果/安卓/小游戏 | 是 | IOS |
| device_type | string | 设备号格式，枚举值：HASH_IMEI/HASH_OAID/HASH_IDFA/CAID/WECHAT_OPENID/MD5_SHA256_IMEI/MD5_SHA256_IDFA/GDT_OPENID/HASH_PHONE/SHA256_PHONE/HASH_ANDROID_ID/MD5_SHA256_OAID/WECHAT_UNIONID/WECHAT_APP_ID | 是 | HASH_OAID |
CUSTOM（UNINSTALL）
| 参数名称 | 参数类型 | 参数描述 | 是否必填 | 示例值 |
|---|
| package_name | string | 游戏包名 | 是 | com.lilithgames.rok.ios.offical |
| game_name | string | 游戏中文名称 | 是 | 万国觉醒 |
| source_appid | string | 数据来源游戏对应的appid(多个appid用英文逗号分隔) | 是 | 1519945981,1111199677 |
| apply_appid | string | 期望数据应用到的游戏对应的appid(多个appid用英文逗号分隔) | 是 | 1519945981,1111199677 |
| data_update_frequency | int | 用户卸载更新频率，非实时回传必填，不填默认实时回传。单位：天，枚举范围:[1,30]。例如：1-每天更新，7-每周更新。 | 建议 | 1 |
| os | string | 推广目标的操作系统，枚举值：IOS/ANDROID/SGAME，对应：苹果/安卓/小游戏 | 是 | IOS |
| device_type | string | 设备号格式，枚举值：HASH_IMEI/HASH_OAID/HASH_IDFA/CAID/WECHAT_OPENID/MD5_SHA256_IMEI/MD5_SHA256_IDFA/GDT_OPENID/HASH_PHONE/SHA256_PHONE/HASH_ANDROID_ID/MD5_SHA256_OAID/WECHAT_UNIONID/WECHAT_APP_ID | 是 | HASH_OAID |
| ip | string | 实时获取到的设备IP，用户行为中user_id为空时，可上报IP/UA | 建议 | 11.11.11.11 |
| user_agent | string | 实时获取到的设备User Agent，用户行为中user_id为空时，可上报IP/UA | 建议 | Mozilla/5.0 xxxx |