vivo广告渠道来源参数设置需注意的问题

一、注意事项

1、游戏联运场景中渠道来源参数读取需要初始化

• 渠道来源参数的读取，需要在初始化操作之后调用，如果需要计算源文件的MD5，必须使用平台提供的读取方法。

• 另外，在源文件APK中，我们添加了IDValue块，如果您的APK中也添加了IDValue块，请不要和我们的重复，我们的IDValue为0x881155ff。

1）方法定义 public String getChannelInfo( Context context )  

2）参数说明

3）代码示例 String channelInfo = VivoUnionSDK .getChannelInfo(this)；

4）返回值 调用该接口能获取到的值有两类：

(1) 值为一串加密的字符串，为渠道来源参数，长度不固定，值不唯一，但长度上限为256 字节。表示该用户来源于广告渠道。

(2) 值为“NULL”。表示该用户来源不是来自vivo自有信息流、广告联盟和商店(不含内购游戏)渠道。

2、需要实时读渠道来源参数读取

必须实时读取渠道来源参数，不可使用缓存于服务端的渠道来源信息参数，否则可能会因为统计口径不一致造成数据gap。比如：做登录统计或数据埋点时调用读取工具获取渠道来源参数信息，做付费统计或数据埋点时需再次调用接口获取渠道来源参数信息。

3、渠道来源参数的长度上线为256字节

使用渠道来源参数的所有数据埋点上报和数据入库，数据存储的字段必须大于256 字节，否则可能因为数据存储失败而导致用户操作失败。比如：若实现逻辑为触发充值行为时会获取渠道来源参数信息进行数据关联存储，渠道来源信息的存储字段须大于256字节，否则会导致用户充值失败。

4、渠道来源参数为加密字符串

为了信息安全，渠道来源参数为加密字符串，读取到加密字符串后，需要通过平台提供的接口进行解析和回传：

1） 若为null，表示该用户来源不是来自vivo自有信息流、广告联盟和商店(不含内购游戏)渠道；

2） 若参数有值，但是平台解析后没有回传，同样表示该用户来源不是来自vivo自有信息流、广告联盟和商店(不含内购游戏)渠道；

3） 若参数有值并且平台解析后回传相应的广告ID，则表示来自vivo自有信息流、广告联盟或商店(不含内购游戏)渠道。

4） 若通过vivo开放平台上传的APK中带有渠道来源参数，会导致无法写入真实的渠道来源参数，因此，为了确保线上APP渠道来源参数的读写正常，在上传新包的时候，请注意不要把带有渠道来源参数的测试包上传到平台。

5）内购游戏在商店渠道不支持分包参数。

二、FAQ

1、广告主可以利用渠道来源归因接口做什么？

广告主可以利用渠道来源参数归因接口，获取到产生特定APP内行为的用户，来自哪个广告，再结合MAPI提供的广告行为数据，进行APP后向数据和广告数据的归因关联，形成完整的数据分析漏斗。以电商广告为例：广告主将在APP有购买行为的用户的渠道来源参数记录下来，通过接口获取到该用户的来源广告ID，然后通过广告ID进行归因，则能够在广告后台形成该广告ID的ROI模型。

2、渠道来源参数的数据颗粒度能到多细？

目前渠道来源参数支持广告ID回传，确保广告主能够通过广告ID，区分出完整的数据漏斗。

3、上线后没有广告来源数据怎么办？

优先自查，可以重点确认以下几点：

1） 确认广告量级是否足够大，若投放量小可能还未产生转化，可再持续观察；

2） 是否跟vivo 侧申请了广告归因方案的白名单，若未申请白名单则无法读取到渠道来源参数信息；

3） 广告是否投在该方案作用范围内的资源如信息流，若广告未在正确的资源上投放则无法读取到渠道来源参数信息；

4） 按照对接文档核查，确认是否取数逻辑有错误。若自查无法定位问题，请在沟通群向vivo 侧反馈相关问题，vivo 侧会安排相关人员配合排查。

4、第一次读取到渠道来源参数信息后是否可以缓存至服务端用于其他指标统计？

不能采用缓存机制。请跟平台的统计口径保持一致(仅适用游戏类)，实时读取来源信息，以减小数据gap

公司优势

开户流程

注意事项