跳转到主要内容
开发者中心
PRODUCT DOCUMENTS

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

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

营销归因接入相关问题

背景

该文档旨在说明如何快速使用营销归因产品，让您快速上手。其中营销归因部分指标需要广告主回传，其中包括注册转化、收入转化和成本。本期我们支持了四个U-App预置埋点事件，开发者可自行通过U-App自定义事件上传接口进行上报。若接入过程中遇到问题请联系友盟商务

操作流程总览（五步）

  • 【必选】开通「营销归因」付费权益。阿里云市场下单用户需手动激活订单，可参考付费产品购买激活教程。

  • 【必选，测试阶段OneLink和监测链接可二选一】在 U-App 后台配置 OneLink、管理媒体渠道（查看合作渠道）、创建监测链接（已支持华为鲸鸿/OPPO营销/VIVO商店/磁力智投/巨量引擎/小红书/百度搜索/阿里汇川等）

  • 【可选】技术集成最新统计分析 SDK 并上报指定事件

  • 【必选】OneLink配置至投放平台并正式投放

  • 【必选】登录 U-App 查看归因结果

注：接入后，建议联调后再正式投放，以避免数据回传失败影响投放效果，或造成不必要的用量损失。

1.创建OneLink链接-管理员操作

产品访问入口：https://mobile.umeng.com/platform/config/onelink

OneLink基于Deeplink技术实现跨应用跳转，在App推广场景下点击推广链接可直达目标页面，提升转化与用户体验，现已支持IOS和Android应用使用Onelink

应用场景：自有流量渠道（比如邮件）、广告（比如巨量引擎/应用商店）用户拉新、促活场景下，通过落地页的内容种草可提升业务转化率。

1.1 推广信息配置

1.1.1 Android应用配置

请至少配置一个平台。若您的 App 无 Android 版本，以下可留空。

配置项

填写内容

场景

推广页面（Scheme URL）

您 App 注册的 Scheme 链

接，如 umeng://deeplink_test

用户手机已安装 App 时，通

过此链接打开 App 并跳转到

指定页面

兜底页配置

选择一种兜底方式（三选

一，见下方详细说明）

当 App 唤起失败时（如用户

未安装 App），引导用户去

哪里

选择推广应用

选择您 App 的应用包名

image

兜底页配置 —— 三种类型详解：

类型

需要填写

中转页行为

应用商店

勾选您 App 已上架的商店

（华为/小米/荣

耀/OPPO/vivo/三星）

App 唤起失败后，自动识别

用户手机品牌，跳转到对应

品牌的应用商店下载页。

小程序

填写微信小程序跳转链接

App 唤起失败后，弹窗提示

「尚未安装 App，前往微信

小程序查看」，用户确认后

跳转小程序

H5（推荐官网）

填写 H5 网页地址

（http/https）

App 唤起失败后，直接跳转

到您填写的 H5 页面（如官

网、活动页）

1.1.2 iOS 应用配置

请至少配置一个平台。若您的 App 无 iOS版本，以下可留空。

配置项

填写内容

场景

推广页面（Universal Link

或 Scheme URL）

Universal Link（推荐）或

Scheme URL

Universal Link：用户点击

后直接打开 App，体验较

好，推荐使用。

Scheme URL：通过跳转协

议唤起 App，可能会有系统

确认弹窗

兜底页配置

选择一种兜底方式（三选

一，同 Android）

当 App 唤起失败时，引导用

户去哪里。类型和行为同

Android 配置

选择推广应用

手动填写您 App 的应用信息

填写后可自动生成 App

Store 下载链接

image

1.1.3 默认兜底页 URL

配置项

填写内容

作用

默认兜底页 URL

必须是 http/https 开头的网

址

最终保底地址。当前面所有

唤起方式都失败时，用户会

被跳转到此页面，确保不会

停留在空白页。必填

1.2选择投放媒体

image

1.3 OneLink 链接生成后，复制链接配置到对应投放平台/自有渠道中

image

image

复制生成的OneLink链接，并配置到投放平台中。当C端用户点击广告时，OneLink会判断状

态并实现跳转、同时记录下点击行为

image

1.4 测试验证-扫描二维码进入中转页

image

1.5 落地页配置

应用场景：当原始链接因失效、受平台访问限制（如微信、浏览器内打开受限）等原因无法直达页面时，OneLink将自动启用此备用落地页，每个应用支持配置一个。

image

2、创建监测链接-管理员操作

2.1 配置监测链接

image

选择应用、媒体投放平台后生成监测链接

image

生成一条新的监测链接

image

2.2 媒体平台开通

媒体平台的状态默认关闭，请找到要投放的媒体平台，通过配置打开渠道

image

image

2.3 登录投放平台，将复制的监测链接填入（需要技术部分参与）

2.3.1 示例：进入「百度营销」中，在转化追踪处配置友盟生成的监测链接

image

image

image

image

生成后请技术参与联调

image

3. 营销归因埋点上报（需要技术参与）

测试阶段，如不追踪后链路转化（比如会员注册、付费），第三步可跳过

跳过后，可以看到广告曝光-点击-下载并激活的归因

3.1 前置条件

3.1.1 升级 SDK 版本

iOS 应用将 iOS统计SDK 升级至 v7.5.11 版本

Android 应用将Android统计SDK 升级至v9.9.2 版本

3.1.2 iOS 调用方式

所有事件通过 [MobClick event:eventName attributes:params] 上报，事件名和参数 key

均定义在 UMCommonDeepLink.h中。

示例

NSDictionary *params = @{
    UMEventParamRegisterMethod: @"phone",
    UMEventParamRegisterTime: @(registerTimeMs)  //number 类型，毫秒时间戳
};
[MobClick event:UMEventUserRegister attributes:params];

3.1.3 Android 调用方式

所有事件通过 MobclickAgent.onEvent(this, eventName , params) 上报，事件名和参数

key 均定义在 DeepLinkPresetEvent中。

示例

Map<String, String> params = new HashMap<>();
params.put(DeepLinkPresetEvent.UMEventParamRegisterMethod, "phone");
// 传 Unix 毫秒时间戳，例如 1747705800000L
params.put(DeepLinkPresetEvent.UMEventParamRegisterTime, String.valueOf(System.currentTimeMillis()));
MobclickAgent.onEvent(this, DeepLinkPresetEvent.UMEventUserRegister, params);

3.2 埋点上报事件

以下是U-App预置埋点事件，可以通过common SDK预定义事件名称和属性名称埋点。确保

上报的事件名称和属性key正确，否则指标统计会有误差。

3.2.1 um_onUMengUserRegister 用户注册

触发时机：用户点击"注册"按钮并成功完成注册流程

属性标识符

属性名

属性类型

是否必填

属性备注

register_method

注册方式

String

是

取值：account /

phone_sms / email /

third_party_wechat /

third_party_qq /

third_party_apple

register_time

注册时间

number

是

Unix时间戳（毫秒）

invite_code

邀请码

String

否

裂变注册时传入，追踪

拉新来源

3.2.2 um_onUMengInAppConvert 应用内转化

触发时机：用户完成提交订单 或 完成付款行为

属性标识符

属性名

属性类型

属性备注

order_id

订单ID

String

唯一标识订单，用于去重及

订单追踪

transaction_type

交易类型

String

取值：

order（应用内下单）

purchase（应用内付款）

product_id

商品ID

number

商品唯一标识

product_type

商品类型

String

如：vip / course / tool

product_name

商品名称

String

商品名称，便于直观查看

product_price

商品价格

number

单位：分

time

交易时间

number

Unix时间戳（毫秒）

payment_method

支付方式

String

仅当 transaction_type =

"purchase" 时有效；取

值：alipay / wechat_pay /

apple_pay

is_first_purchase

是否首次付费

boolean

true：首次付费用户；

false：复购用户

discount_amount

优惠金额

number

单位：分

coupon_id

优惠券ID

String

使用优惠券时传入

currency

货币类型

String

默认CNY；如：CNY /

USD

3.2.3 um_onUMengOrderRefund 应用内退款

触发时机：用户完成退款操作时触发

属性标识符

属性名

属性类型

属性备注

order_id

订单ID

String

关联原交易事件的订单

ID

product_id

商品ID

number

商品唯一标识

product_type

商品类型

String

同交易事件

product_name

商品名称

String

商品名称，便于直观查

看

product_price

商品价格

number

原商品价格，单位：分

refund_amount

退款金额

number

实际退款金额，单位：

分

time

退款时间

number

Unix时间戳（毫秒）

currency

货币类型

String

默认CNY；如：CNY /

USD

3.2.4 um_onUMengAdRevenueEvent 广告收入

触发时机：广告成功展示 或 用户点击广告时触发

属性标识符

属性名

属性类型

是否必填

属性备注

ad_action_type

广告行为类型

String

是

取值：

show （广告展

示）

click（广告点

击）

ad_format

广告形式

String

取值：

float_window（浮

窗）/ splash（开

屏）/ interstitial

（插屏）/ feed

（信息流）/

rewarded_video

（激励视频）/

floating_ball（悬

浮球）

ad_position

广告位置

String

如：home_top /

home_bottom

price

广告收入金额

number

单位：分（如 2

分 表示 0.02 元）

ad_duration

广告时长

number

单位：秒，针对

激励视频类广告

填写

4. 登录U-App查看归因结果

入口：选择应用-统计-营销归因-营销概览/推广活动。如出现Demo标识，代表您的应用尚未

开通「营销归因」体验版，请联系友盟商务申请开通

image