vivo广告平台广告渠道来源

一、分包参数说明

1、内容说明

• 本文档将介绍vivo 营销平台的广告渠道来源参数归因方案基本原理、 渠道来源参数接入流程和接入注意事项等相关内容。

2、术语

3、使用场景

• 统计 应用内 转化数据用于广告渠道效果分析基于归因方案，可统计广告渠道带来的应用 内各项转化数据，如新增注册、登录、总付费流水、新增付费用户、成单 等 应用内用户行为 ，用于分析广告渠道的效果。

二、对接说明

1、渠道来源参数方案原理说明

1.1 渠道来源参数写入说明  

说明：

1. 1.vivo广告系统会在APP下载安装的时候，将广告渠道来源相关信息，如：广告ID，经过加密后写入APP的注释区中；

2. 2.经过验证，写入注释区的渠道来源参数，不会影响应用校验安装和正常启动；

3. 3.渠道来源参数的写入，不需要APP开发者参与。

1.2 渠道来源参数实现原理说明

渠道来源参数方案通过参数连接广告前向与后向的用户行为以达到数据归因的结果，实现原理图如下所示，其中，参数是指广告的渠道来源参数；后项行为是指用户行为路径中激活、登录、注册、付费等应用内的行为。  

说明：

1.渠道来源参数方案仅适用于下载安装类APP的广告；

2.在广告投放时，vivo广告系统自动生成渠道来源参数，无需广告主参与；

3.当APP被下载且安装时，vivo广告系统将渠道来源参数自动写入到APP的注释区，无需广告主参与，原理如 渠道来源参数写入说明 介绍；

4.当安装了该APP的用户产生激活、注册等后向行为时，广告主需集成vivo侧提供的渠道来源参数读取工具进行读取，从而获得含有加密后的渠道来源参数信息的后向行为数据；

5.广告主获得后向行为数据后，通过vivo广告系统提供的渠道来源参数接口解析出广告信息(广告ID)。

6.解析出后向数据中渠道来源参数对应的广告信息，关联通过vivo广告系统提供接口获取的展示、点击等前向数据，进行广告行为数据归因，可形成展示、点击、下载、激活、注册等漏斗链路分析。

2、渠道来源参数接入流程介绍

2.1、联系vivo商务建立对接沟通

双方确认对接意愿后，可联系vivo商务建立沟通，完成接入工作。

2.2、对接渠道来源参数读取&解析工具

确认接入后，广告主需进行渠道来源参数的读取工具和解析接口的相关开发工作，集成读取工具，是为了获取写入到apk的加密渠道来源参数，对接解析接口，是为了让广告主获取到加密的渠道来源参数后解析出广告信息，识别广告渠道来源，读取和解析为两个独立步骤。

1）广告平台会提供渠道来源参数读取工具，广告主需利用工具读取渠道来源参数，开发成本非常低；

2）集成读取参数工具分两种场景：

• 对于游戏类，需按照游戏联运的vivoSDK接入文档中“获取安装来源信息接口接入步骤”集成，开发者可参考《vivo联运SDK接入指导》；

• 对于应用类，需依赖vivo侧提供的读取工具jar包集成，集成后通过代码String channel = ChannelReader.readChannel(getApplicationContext())可以读取加密的渠道来源参数，其中channel即为参数值；jar包获取可联系vivo商务。

3）读取到加密的渠道来源参数后，广告主需对接vivo广告系统的渠道来源参数解析接口获取解密后的广告信息，解析接口请求地址：https://marketing-api.vivo.com.cn/openapi/v1/channelInfo/query ，接口接入请参考地址：https://open-ad.vivo.com.cn/doc/index?id=384 。

4）接入解析接口前，需先对接vivo营销平台MAPI，授权认证后方可进一步对接解析接口，授权认证及系统返回码如下：

• 授权认证，请参考Oauth2.0授权：a、授权流程(https://open-ad.vivo.com.cn/doc/index?id=388)；b、授权流程说明(https://open-ad.vivo.com.cn/doc/index?id=390)；c、token管理(https://open-ad.vivo.com.cn/doc/index?id=395)。

• API请求，请参考快速入门-发起请求(https://open-ad.vivo.com.cn/doc/index?id=166)。

• API应答，请参考快速入门-接收应答(https://open-ad.vivo.com.cn/doc/index?id=167)。

• 接入vivo平台接口后，接收应答可通过系统返回码识别当前请求状态结果。

2.3、广告主自测

广告主完成读取&解析工具的接入后，在正式投放前，可通过vivo广告系统提供的渠道来源参数测试工具进行测试验证，需注意，测试工具写入的渠道来源参数只适用于广告主接入渠道来源参数时测试使用，并无其他意义。

1）广告主APK集成读取工具后，需将该apk上传至vivo测试工具写入测试的渠道来源参数，用于读取参数测试，测试工具用户操作文档可联系vivo商务获取。

2）广告主上传测试工具的APK写入参数成功后，广告主可自行下载、安装，测试APK集成的读取工具是否正常，若读取的值为一串加密的字符串，则为渠道来源参数，读取成功，否则，读取失败。

3）读取到加密的渠道来源参数，需通过调用渠道来源参数解析接口进一步解析，获取来源的广告信息(广告ID)；

2.4、重新上传APK并提交审核

广告主自测正常后，可联系vivo商务，进行正常的广告投放流程对接和审核，上传到vivo平台的APK包体需已集成渠道来源参数读取工具，且不要把测试使用后已写入渠道来源参数的APK上传至vivo平台，否则会造成数据错误。

2.5、启动广告投放

广告主完成vivo广告投放流程对接并审核通过后，即可进行vivo平台的广告投放。

2.6、广告数据归因统计

接入渠道来源参数功能，正式投放广告，当产生用户行为时，集成的读取工具将会读取APP注释区的渠道来源参数，随行为数据一起上报，然后通过解析接口获得后向行为数据的广告ID，进行广告数据归因统计。

1）广告主利用“渠道来源参数解析接口”可获取到用户激活、注册和付费等后向行为数据的广告信息，结合vivo平台提供的广告前向行为数据进行链路前后行为归因统计，形成从广告曝光、点击、下载、激活、注册等完整的数据分析漏斗，流程示意图如下。

2）vivo广告平台提供了两种获取广告前向行为数据方式：

• 通过请求vivoMAPI接口获取展示、点击、消耗和广告id等数据；

• 对于已接点击监测功能的APP，可使用点击监测下发的展示、点击数据。

流程示意图：

• 

• 
  

• 广告主根据MAPI或点击监测接口返回的广告数据和渠道来源参数解析接口返回的数据，通过广告ID进行统计；

• 广告主需要明确，通过渠道来源参数解析接口同步给vivo广告平台的参数，在广告主侧代表的是什么指标，比如： a. 将激活用户的渠道来源参数同步给广告平台，则表示广告平台返回的为该广告下激活数据对应的广告ID；b. 将有付费行为的用户的渠道来源参数同步给vivo广告平台，则表示广告平台返回的数据为该广告ID下付费人数对应的广告ID。

总结：广告主确认接入渠道来源参数时，APK需先接入参数读取和解析工具，进行读取、和解析测试，测试正常后，可进行广告的正常投放，投放前，需向vivo平台上传集成读取工具的apk，投放后可读取参数并通过解析接口解析加密的渠道来源参数获取广告信息进行归因统计。

更多vivo广告推广的方式详情官网咨询！