自归因

0000000000011111111.20240722162609.19858587277397342636934562644248.jpg

1 选择归因方案

当前支持智能分包、监测链接和华为分析三种归因方式，三种方式对比如下，根据需要选择一种即可

华为三种归因方式优缺点.png

1.1 智能分包

📌

需要客户端开发，调用应用市场提供的渠道号查询接口获取归因信息，并将客户端获取的归因信息上报到您的服务端。

需要广告主获取设备标识ID，在服务端将渠道号和设备标识ID进行关联完成归因。

受老版应用市场影响，可支持设备覆盖率超过95%。

1.1.1 读取智能分包参数开发

1

构造Uri对象：uriString为content://com.huawei.appmarket.commondata/item/5。

2

调用ContentResolver.query接口，第1个参数传入Uri对象，第4个参数传入应用包名。

3

解析ContentResolver.query接口返回的“Cursor”字段值。

可能获取到的归因信息种类请参考FAQ

4

取出INDEX_TRACKID对应的归因结果json字符串后可以反序列化为HashMap<String, String>

请参见示例代码。

建议您不要在客户端处理归因字符串，将归因字符串上报服务端，在服务端进行解析处理。

5

完成客户端新版本开发后，打包新版本应用进行调测，详情请参考功能调试。

1.1.2 功能调试

您已申请开通智能分包功能。

准备包含归因查询代码的测试版本包。

1

创建智能分包，并设置智能分包渠道号，详情请参考新建智能分包。

2

创建搜索任务，创建任务时应注意以下几点：

在“投放控制 > 每日预算”设置中，设置任务预算不少于500。

在“通用投放”设置中，关闭“通用投放开关”。

在“场景投放”设置中，新增并设置子任务“定向字词”为冷门关键词（如APP名称+123），出价尽量高，“字词匹配方式”选择“广泛匹配”。

在“归因监测”设置中，选择刚刚创建的渠道号，与任务进行绑定。

3

创建完成并审核通过后，搜索关键词，找到广告位（需与运营进行确认），并下载应用。

4

查看报表数据是否统计到了本次下载，来确保本次下载是否为推广量。
具体请参见查询任务数据报表。

5

覆盖安装测试包。 adb install -r <测试包所在路径>.apk

6

启动应用后调用归因查询代码将数据传到服务端解析处理。

1.2 监测链接

📌

需要广告主服务端开发监测链接功能。通过监测链接，获取用户是通过哪一个广告任务，在何时看到、何时点击、何时下载安装了您的应用。

广告主只需填写好链接，信息由应用市场发送给广告主的服务端，广告主直接统计数据即可。

应用市场版本在10.5.3之后的才具备采集OAID的功能，可支持设备覆盖率超过80%。

1.2.1监测链接开发

参数中的特殊字符和汉字会进行URLEncode

在配置监测链接后，华为服务器在给广告主的请求中会将定义链接中的宏参数替换为实际的宏参数值。

1

监测链接格式

2

说明

3

监测链接所支持的宏参数如下表所示。

1.2.2 监测链接测试

通过链路测试，可以对监测链接、数据回传进行联调测试。

1

登录华为应用市场付费推广平台，点击右上角“管理中心”，进入“管理中心”页面。

2

点击“工具”页签，在“调试工具”中选择“监测链接调试”，进入“监测链接调试”页面。
0000000000011111111.20240614162442.63871201503289325233191808294567.png

0000000000011111111.20240614162442.63871201503289325233191808294567.png

3

按格式要求，填写一个或多个监测链接后，点击“新建测试记录”。

0000000000011111111.20240614162442.17926529534741568096277978012171.png

4

进入“新建测试”页面，设置“测试应用”、“数据源”、“测试组数”和“OAID”，完成后，点击“启动”。

0000000000011111111.20240614162442.59682986391449272817349379891544.png

5

测试记录保留最近30日的数据，可以查看测试的启动时间、结束时间、测试组数、测试成功率。
点击“详情”，可以下载本次测试的详细记录，详细信息包括“测试启动时间”、“测试结束时间”、“测试链接”、“响应详情”、“测试结果”。

0000000000011111111.20240614162442.27666114789703283391577845182788.png

0000000000011111111.20240614162442.76919380892267671660210033646641.png

1.3 华为分析

📌

无需客户端开发、集成华为分析SDK，即可实现“应用激活、注册、次日留存、授权”等事件的自动回传，有效节约归因监测的时间和技术成本。

除上述转化事件外，您也可以将需要监测的其他核心事件打点上报至华为分析，在华为分析后台操作配置事件回传即可。

华为分析转化事件回传与SDK接入流程进行了集成整合，避免配置遗漏，不易出错，且提升了回传的稳定性。

2 客户端上报转化数据

由客户端向服务端上报用户侧产生的转化行为，服务端收到后，将转化行为数据与归因方案产生的数据进行归因，再回传给媒体侧。

3 回传用户行为数据

3.1 回传准备

❗

数据源、API客户端都需要使用开发者账号登录创建，否则会影响数据回传。

广告主可以通过调用回传用户行为数据接口回传转化数据，回传前，需要完成以下准备工作：
创建数据源：用于存储广告主回传的转化数据。
创建API客户端：广告主调用API前，需申请AppGallery Connect平台的API调用授权凭据。

3.1.1 创建数据源

1

登录华为应用市场付费推广平台，点击右上角“管理中心”，进入“管理中心”页面。

2

点击“工具”页签，选择“资产管理 > 数据资产”，进入“数据资产”页面。

0000000000011111111.20240614162445.09465709143252157420293953305328.png

3

点击“新建数据源”，配置相关任务设置项。

在创建数据源时，请务必将授权投放操作账户查看选项修改为是，以便后续查看。

0000000000011111111.20240614162445.03187605164279054598573112342295-1.png

4

点击“提交”按钮完成数据源创建。

若需要修改配置信息，请在数据源“操作”中点击“详情”后，点击“修改基础信息”进行修改。

0000000000011111111.20240614162445.31622601800541272994997269648678.png

0000000000011111111.20240614162445.64158455806744933988784462885737.png

3.1.2 创建API客户端

1

登录AppGallery Connect网站，选择“用户与访问”。

2

选择左侧导航栏的“API密钥 > Connect API”，点击“创建”。

3

在“名称”列输入自定义的客户端名称，“项目”保持默认值“N/A”，“角色”选择“管理员”，点击“确认”。

❗

“项目”或“角色”选择错误会导致接口调用失败。

0000000000011111111.20240614162445.41500942457930000036287937654716.png

4

客户端创建成功后在API客户端列表中记录“客户端ID”和“密钥”的值，提供给开发人员用于回传转化数据。

0000000000011111111.20240614162445.63176193819640361144145867619181.png

3.2 开发步骤

1

获取Token

获取Token接口 | ⏩快速调试

2

回传用户行为数据

回传用户行为数据接口 | ⏩快速调试

4 查看归因数据

创建oCPD任务后，您可以在归因报表中查看您的归因转化报表数据。

1

登录华为应用市场付费推广平台，点击右上角“管理中心”，进入“管理中心”页面。

2

点击“工具”页签，在“资产管理”中选择“数据资产”，进入“数据资产”页面。

3

在数据源“操作”中点击“详情”。

4

在“归因报表”中可以显示所有已选择归因目标的任务，包括CPD和oCPD任务以及任务的曝光、下载、出价、深度转化成本、注册、激活等数据。
报表支持筛选时间周期、任务类型、计费类型、转化目标。

修改于 2024-11-11 10:33:04