You need to enable JavaScript to run this app.
导航
数据接入&上报FAQ
最近更新时间:2025.03.13 18:04:54首次发布时间:2024.04.30 15:17:29
我的收藏
有用
有用
无用
无用

1. SDK接入

1.1 如何修改申请Appid时选择的应用类型?

不建议您进行修改,因为相关配置已经生成,您可以重新申请Appid。

1.2 不同平台的应用是否可以集成在同一个Appid下?

可以,建议您将业务相关的应用集成在同一个Appid下。

1.3 有没有服务端SDK相关文档?

有的,可查看服务端接入说明

1.4 UUID是否能设置为中文?

不支持,请勿将UUID上传为中文。UUID仅支持数字、字母及符号,如果上传为中文,会导致数据无法上报造成数据质量问题。

1.5 Android SDK 接入为什么会出现Didn't find class "com.android.id.impl.IdProviderImpl" 报错?

这个报错不会影响SDK的正常初始化。
错误的原因是当前版本的SDK提供了对华为、小米最新版本(AndroidQ)手机设备id获取能力,当在模拟器或低版本设备中运行时,控制台会打印这个错误信息,但不会影响SDK的正常初始化和使用。

1.6 UUID设置逻辑

UUID(User_Unique_ID)在用户未登录情况下可不设置,我们会用DID(Device ID)填充。用户登录之后可设置为您自己的UID,我们的统计口径会将登录前后的用户识别为同一用户。

注意

请不要将UUID设置为一个固定值,这样会将大量用户识别为同一用户,造成数据统计差异。

1.7 小程序接入SDK 为什么没有预置事件上报?

请将auto_report设置为ture。

1.8 SDK里面有read phone state的授权吗? 如果有的话,授权之后会拿到设备的什么信息?

有。授权后会拿到设备的deviceId、sim卡序列号、subscribeID等相关信息。但iOS没有权限申请,也不会采集sim卡序列号。

1.9 iOS如果使用swift语言,pod是否需要用户自己桥接?

是的,目前ios的SDK仅支持object-c,swift还未直接支持。

1.10 APP内嵌H5应该接哪个SDK?

如果需要APP内嵌H5的数据与APP数据相关联起来的话,请接入接移动端SDK;如不需要,则接入JS SDK

2. 数据上报

使用user profile api上报用户属性时报错:user xxx not exist

  • 报错场景:使用user profile api上报用户属性时报错,错误码为:{"code":4000,"message":"user 20********** not exist.","data":null}
  • 可能原因:您当前可能使用的是SaaS-非云原生环境,且当前上报用户属性的用户此前从未上报过任何事件相关数据,即,用户从未落库至DataFinder中(用户在DataFinder中无唯一标识ssid),此场景下如果未开启自动注册直接上报用户属性就会因用户不存在而报错。
  • 处理方式:
    • 方式1:您可以先使用当前用户上报一个事件,此时用户会在上报事件的同时生成一个用户ssid,将用户落库至DataFinder,后续再上报用户属性数据就不会再报错。
    • 方式2:如果您无法先上报事件数据,也可联系火山引擎技术支持人员,为您开启自动注册(auto_create_ssid),开启后,后续您即可在不入库的情况下直接上报用户属性。

3. 数据统计差异

3.1 如何验证上报数据的准确性?

  • 通过单个用户的用户细查,检查上报行为数据中的事件、属性与埋点是否设计一致;
  • 将活跃用户、事件触发次数等统计指标,与业务系统或其他系统进行比较,查看分析差异率。

3.2 火山引擎增长分析 数据与自有后台或第三方平台存在数据差异怎么排查?

  • 统计口径:建议您对比火山引擎增长分析与自有后台或第三方平台数据统计口径是否一致;
  • 埋点上报时机/逻辑:建议您确认火山引擎增长分析与自有后台或第三方平台数据埋点上报时机及埋点上报逻辑是否一致;
  • 如果依然存在疑问,请点击火山引擎增长分析页面右下角按钮,通过提交工单的方式将详细对比描述反馈给我们。