跳转到主要内容
PRODUCT DOCUMENTS

快速找到所需文档,高效完成接入与排障

浏览产品文档与友盟 Skill,展开目录并阅读正文。

常见问题

一、产品功能与基础概念

Q1:广告平台的数据是如何怎么同步到友盟的?

在广告平台配置友盟监测链接后,媒体会将点击、支持的曝光数据发送给友盟,再与App上报的激活、转化数据匹配。

Q2:营销归因如何判断用户是买量用户还是自然量?

通过配置监测链接,结合设备信息(OAID/IMEI/CAID等)进行匹配。归因成功的即为买量用户,未匹配到广告点击的自然归为自然量。

Q3:新版营销归因与旧版 APPtrack 有什么区别?

新版归因模型底层全部重构,增加了更多归因因子,如安卓商店下载来源、CAID等,整体准确率更高。此外还支持深度事件转化追踪,可追踪收入(IAA、IAP)、成本、ROAS等,方便做更精准的预算分配决策。

Q4:营销归因支持哪些媒体渠道?

目前已支持巨量引擎、百度搜索、百度信息流、小红书、华为、网易有道智选等20+主流渠道。

Q5:一个产品一个渠道只需要一个监测链接吗?多个账户是否共用同一个?

是的,同一个产品在同一渠道下只需要一个监测链接,多个广告账户可以共用同一个监测链接。

Q6:子账号能使用营销归因、查看归因数据吗?

可以。操作入口:投放媒体管理,通过“控制台-管理-投放媒体管理-授权他人”,可让对方创建推广链接、配置投放媒体,无需重复购买,用量计入您的额度。

image.png

查看归因数据新增授权账号:https://mobile.umeng.com/platform/users/authorised_users/author_create

Q7:营销归因的计费方式有哪些?

有两种计费方式:一是按全渠道点击次数收费,二是按DAU收费。具体价格可参考营销归因定价


二、SDK 集成与技术对接

Q1:整体接入流程是什么?

  1. 开通权益:确认营销归因服务已开通

  2. 配置应用与渠道:业务或投放人员负责配置OneLink或媒体监测链接,以及对应的应用和渠道信息。

  3. 完成SDK与事件接入:开发人员负责SDK升级、唤端和事件上报。

  4. 配置投放并联调:投放人员将链接配置到广告平台,业务、投放和开发共同完成端到端验证,确认归因结果正常后再正式投放。

Q2:Android SDK 接入文档在哪里?

营销归因接入文档参考:https://developer.umeng.com/docs/119267/detail/3041099

ASA接入文档参考:https://devs.umeng.com/docs/119267/detail/3041957

Q3:SDK 是否支持在扩展程序中使用?

开通归因服务的账号下的应用,事件会实时上报。如果是键盘记录等扩展程序场景,建议通过App上报方式接入。

Q4:鸿蒙系统如何集成友盟SDK?需要注意什么?

鸿蒙SDK集成时需特别注意OAID的获取:

  • 需要在隐私同意和OAID授权后才能初始化SDK

  • 首次启动时需确保能获取到OAID,否则会影响归因

  • 鸿蒙权限 ohos.permission.APP_TRACKING_CONSENT 需要配置

  • 要求最低版本:@umeng/common@1.2.0+

Q5:归因成功后客户端如何获取归因结果回调?

友盟SDK提供归因结果回调接口,可通过 UMConfigure.setOnAttributionListener 方法获取,仅支持拉新归因。但注意:onAttributionFail 口径较粗,自然流量用户也会走fail,不能以此判断归因成功率。

Q6:我已经在使用其他厂商的同类产品,如何迁移?

友盟支持历史数据快速迁移,不影响正常投放,详见:U-App移动统计和广告归因迁移操作手册

Q7:会采集和使用哪些数据?数据安全、隐私和合规如何保障?

归因会使用推广链接及活动参数、可用的设备或来源信息,以及客户选择上报的注册、交易、退款和广告收入等事件数据。

数据安全与隐私合规资料:友盟隐私协议、友盟+数据安全与个人信息保护声明、友盟+数据安全白皮书


三、数据回传

Q1:如何将归因明细数据回传给我们服务端?

需要客户提供一个回调接口(callback URL),友盟侧开通后可推送归因明细数据,包括归因后的转化事件等。需提供回调地址和配置 secret_key。

Q2:事件回传支持哪些类型的事件?

支持归因后的转化事件回传,即在归因匹配成功后的设备、在转化窗口期内发生的指定事件会回传。普通事件(非归因事件)不会通过此接口回传。

Q3:自定义事件如何配置回传?最多可以配置多少?

需要提供事件名称列表给友盟侧进行配置。巨量引擎和小红书等渠道支持在友盟后台添加关键行为事件。

Q4:事件上报时间为多少?事件上报有延迟怎么办?

启用营销归因的应用,事件上报时间应在3秒以内。如果出现延迟,可能是上报时机的策略没有下发成功,需联系友盟技术支持排查。

Q5:归因数据能否回传给媒体渠道(如百度、巨量等)?

可以。友盟会将归因结果回传给对应媒体渠道,但需要在友盟后台配置渠道的回传参数(如华为渠道需配置 API 客户端凭证)。

Q6:服务端能否主动拉取数据?OpenAPI 如何开通?

U-App 统计相关数据可通过 OpenAPI 拉取,参考文档:https://developer.umeng.com/open-api/ns/com.umeng.uapp/apply。但OpenAPI 目前不含归因数据,如需拉取归因数据请联系友盟技术支持。


四、测试与调试

Q1:有没有Demo可以看?如何申请试用?试用期多久?

营销归因DEMO:营销概览

试用申请:可联系友盟工作人员申请7天试用,试用期间可完成开通和测试。

Q2:需要我做什么配置或授权吗?

需完成链接配置和SDK接入:接入教程

媒体权限和成本接入方式由友盟与渠道确认。部分渠道需客户进行账号授权或补充配置信息,:

  • 需要媒体账号授权的渠道:苹果 ASA、 巨量引擎、磁力智投、腾讯广告、VIVO 营销;

  • 需要客户配置必备信息的渠道:华为商店、华为惊鸿、小米营销、百度信息流、快看后羿智投

Q3:如何调试回调接口?

可通过以下方式调试:

  1. 使用OneLink制造几次归因结果

  2. 用广告媒体平台的联调功能生成广告点击和归因数据

  3. 用测试设备真实点击广告、下载安装启动走一遍完整流程

Q4:测试数据能否清除?

目前数据没有区分测试数据和正式数据的标识,无法单独清除。建议使用测试设备进行测试,卸载重装后也能归因,会出现在"再启动"指标中。

Q5:华为渠道如何进行联调测试?

  1. 在友盟后台配置华为渠道参数(API客户端凭证)

  2. 使用华为联调功能触发模拟点击

  3. 先卸载App,再触发点击,然后安装App并启动

  4. 确认友盟侧归因成功,并检查回传结果


五、购买与付费

Q1:营销归因如何付费?有哪些支付方式?

两种支付方式:

  1. 微信/支付宝支付:在友盟控制台后台扫码支付,自动激活

    1. image.png

  2. 阿里云支付:在阿里云市场下单购买,需手动激活

    1. 下单链接:阿里云下单链接

    2. 激活链接: https://account.umeng.com/activate 选择阿里云订单激活,输入阿里云账号ID(右上角头像下的一串纯数字),激活产品选择U-AppPro,确认友盟账号信息后提交。

Q2:有什么优惠活动?

老用户(如APPtrack历史用户)可申请九折优惠,具体情况可联系友盟商务代表。

Q3:续费如何操作?

续费流程与新购相同。

Q4:点击量资源包用完后会怎样?有缓冲机制吗?

有缓冲机制。用量耗尽后归因链路和数据采集不受影响,一切正常运行,但后台数据展示和配置不可用。建议正常投放的同时安排续费,不会造成数据丢失或服务中断。


六、数据排查与异常处理

Q1:有点击数但没有激活,如何排查?

  1. 确认SDK是否正确集成,特别是OAID等设备标识的获取

  2. 检查监测链接配置是否正确

  3. 确认媒体渠道的回传配置是否完成

  4. 使用联调功能进行端到端测试

  5. 检查友盟后台日志,确认是否有设备日志上报

Q2:广告渠道收不到回传怎么办?

  1. 确认渠道的配置是否正确(akey等参数)

  2. 检查友盟侧归因是否成功

  3. 查看友盟后台回传日志,确认是否有异常

  4. 确认渠道侧接口是否正常接收

  5. 自然流量用户不会匹配到广告点击,是正常现象

Q3:有效触点数量比媒体后台的曝光量还多,怎么回事?

可能的原因:

  1. 友盟侧的监测链接收到了多渠道的数据(如iOS和Android合计)

  2. 新接入的渠道(如网易有道智选)可能有异常下发

  3. 建议导出分渠道数据逐一排查,必要时暂停异常渠道投放

Q4:点击广告后被引导到应用市场下载,还能被归因到吗?

可以。即使被引导到应用市场下载,友盟的归因机制仍然可以匹配到广告点击并进行归因。


七、渠道配置

Q1:如何新增回传关键行为事件?

操作入口:投放媒体管理

在友盟后台“管理-投放媒体管理-选择需要配置平台-新增回传事件”,可以为每个渠道添加关键行为事件。巨量引擎和小红书等渠道支持在友盟侧添加事件类型,然后在媒体平台选择相应的事件进行联调。

image.pngimage.png

Q2:归因的时间范围是多长?可以自己设置吗?

默认归因窗口期为7天;同时支持自定义归因窗口期,操作入口:投放媒体管理,在友盟后台“管理-投放媒体管理-选择需要配置平台-归因窗口配置”

Q3:一个媒体配置只能配置一个回传事件吗?能否支持多产品多事件配置?

目前友盟支持在AppKey级别单独配置回传事件。不同产品对应不同的友盟AppKey,可以在各自的AppKey下单独配置回传事件,从而支持多产品多事件的差异化配置。

Q4:新渠道接入需要多久?需要什么条件?

新渠道接入大约需要1天左右,前提是客户能提供该渠道的后台账号供友盟进行调试对接。接入后客户可以自行联调测试。


八、其他常见问题

Q1:首次安装并启动人数是否有重复?是否存在回流或误归因?

友盟的归因模型会区分首次安装(new install)和再启动(recall install),不会重复计算。回流用户会归入再启动指标,首次安装指标仅统计全新设备。

Q2:能否导出分日分广告账户的点击量数据?

可以联系友盟技术支持导出分渠道、分日的数据明细,用于排查和核对。