【官方】小程序 U-MiniProgram FAQ TOP10

*更新于2021-09-01*

本帖精选了小程序集成过程遇到的高频问题Top10 Q& A，欢迎大家阅读与提问~

友情Tips：
① Ctrl + F 页内搜索
② 可以在本帖下方留言你的其它疑问、或新发布提问
③ 收藏本帖，常来看看 ☆



Q1：小程序成功上报自定义事件，埋点验证也没有问题，为什么看不到属性值？
A1：

• 自定义事件的事件ID、属性名称的上报都是实时的，但属性值是T+1，今日上报后需明天才能查看。
• 之所以埋点验证可以看到属性值是因为埋点验证中的所有内容都是实时的。

Q2：自定义事件的属性值不准，或是Console中看到上报了属性值，第二天仍然没有属性值，应该如何排查？
A2：
可以从以下几点进行排查：

• 属性值会在第一次上报时决定属性值是数值型&字符型，数值型需要在事件趋势中编辑指标后查看，字符型则是在属性明细中直接筛选属性名称进行查看，如果第一次上报了数值型，后续只允许上报数值型，如果第一次上报了字符型，后续只允许上报字符型，后续上报的类型与第一次上报类型不符合，会被抛弃。
• 查看事件管理中的事件ID下是否有最近上报的属性名称的展示，查看Console中的数据发送成功日志下是否有上报的事件ID、属性名称、属性值。
• 在集成SDK的代码中添加enableVerify: true配置项，在启动参数中增加_ttn参数，通过友盟后台埋点验证进行验证。

Q3：小游戏SDK都支持哪些游戏引擎呢？
A3：

• 快游戏SDK当前支持引擎：Cocos 2.x 、LayaBox、Egret（注：Cocos 3.x暂不支持）。
• 除快游戏SDK外，其他平台SDK暂时都需要先导出工程到对应的平台，再按照文档进行集成。
• 后续可关注官网最新消息，如有更新会及时进行同步。

Q4：小程序或小游戏数据不准，应该如何排查？
A4：
看下Console有没有报错信息，根据对应平台的集成文档检查获取ID是否存在问题，此处以微信举例：

• 确认useOpenid和autoGetOpenid是否设置为true，友盟后台是否配置了微信APPID及AppSecret，如果是手动获取Openid，需要检查，获取Openid时是否是静默获取，有没有触发用户授权等操作。
• 获取ID经检查没有问题，需要确认下微信后台是否配置了https://umini.shujupie.com的域名白名单。
• 点击退出小程序按钮，看Console中有没有数据上报，清除浏览器缓存，重新编译运行并检查network下是否有getuut、wxm_logs等请求。

Q5：已经设置了uploadUserInfo:true，为什么还有用户没有昵称和头像呢？
A5：

• 1. 检查SDK是否是微信小程序，如果是微信小程序则需要检查SDK版本是否低于2.6.6，低于2.6.6的话，需要升级SDK到2.6.6及以上版本，升级完成后通过setUserInfo(userinfo)，上报用户信息。
• 2. 可能请求获取用户昵称及头像时，用户没有授权，导致无法获取。
  

Q6：为什么没有填写appKey会影响到小程序自定义分享功能？
A6：

• 如果因为没有填写appKey影响到小程序自定义分享功能，请升级到最新版SDK可以解决此问题。
• 如果是开发环境建议通过开发版appKey和生产版appKey进行开发环境和生产环境的数据区分，不建议在任何情况下不填写appKey。

Q7：自定义事件有哪些注意事项，保留字段有哪些？
A7：

• 1. params为object类型时，属性值仅支持字符串和数值两种类型;
• 2. 请在App.onLaunch之后调用事件。
• 3. 参数eventId和事件标签都不能为null，也不能为空字符串"", 参数eventId长度不能超过128个字符，参数label长度不能超过256个字符。
• 4. 以下保留字段，不能作为event id 及key的名称：id、ts、du、token、device_name、device_model 、device_brand、country、city、channel、province、appkey、app_version、access、launch、pre_app_version、terminate、no_first_pay、is_newpayer、first_pay_at、first_pay_level、first_pay_source、first_pay_user_level、first_pay_version、page、path、openid、unionid、scene

Q8：服务商如何集成小程序？
A8：

• 服务商模板小程序，通过后端API接口生成appKey，将生成的appKey通过json返回给前端
• 具体API接口参考如下文档：https://developer.umeng.com/docs/147615/detail/162443

Q9：小程序相关功能限制有哪些？
A9：

• 每个账号最多可创建300个小程序
• 每个应用分别支持400个活动和渠道，500个自定义事件
• 每个事件可配置100个参数和最多1000个参数值（事件不能删除，只可以暂停计算，被暂停的事件不占用500的份额）
• 每个小程序下最多可创建5个漏斗，每个漏斗最多可设置5个步骤，新创建的漏斗将在第二天产出转化数据

Q10：后台已经收到数据，但是应用信息的当前友盟+SDK集成版本处显示 ‘还未集成SDK’，如图片显示

A10：集成状态是T+1的，需要第二天才能查看。

本帖长期、持续更新！建议大家收藏保存！如果对你有帮助，右下角赞👍🏻一下哦~ 如需发布新提问，下方留言回复告诉我们！