Android iOS Unity JS API Media API 常见问题

SDK 嵌入

导入示例工程

如果您是初次使用优量汇 SDK,我们建议您利用Demo工程来了解优量汇SDK的使用规范。目前支持两种导入方式:

嵌入广告SDK

步骤1:添加 SDK 到工程中

方式一:通过 gradle

implementation 'com.qq.e.union:union:+' // 普通版本
implementation 'com.qq.e.union:tbs:+' // X5 内核版本

方式二:通过 aar

步骤2: 权限申请

优量汇 SDK 建议您在AndroidManifest.xml添加以下权限声明,若您的targetSDKVersion >= 23您还需要在运行时进行动态权限申请(可参考示例工程)

<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />    <!-- 可选,如果需要精确定位的话请加上此权限 -->

注意:SDK不强制校验上述权限(即:无上述权限sdk也可正常工作),但建议您申请上述权限。针对单媒体的用户,允许获取权限的,投放定向广告;不允许获取权限的用户,投放通投广告。媒体可以选择是否把上述权限提供给优量汇,并承担相应广告填充和eCPM单价下降损失的结果。

步骤3: 文件兼容

如果您打包 App 时的 targetSdkVersion >= 24
为了让 SDK 能够正常下载、安装 App 类广告,必须按照下面的步骤做兼容性处理。

AndroidManifest.xml 中的 Application 标签中添加 provider 标签

<provider
    android:name="com.qq.e.comm.GDTFileProvider"
    android:authorities="${applicationId}.gdt.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
     android:name="android.support.FILE_PROVIDER_PATHS"
     android:resource="@xml/gdt_file_path" />
</provider>

需要注意的是 provider 的 authorities 值为 ${applicationId}.gdt.fileprovider,对于每一个开发者而言,这个值都是不同的,${applicationId} 在代码中和 Context.getPackageName() 值相等,是应用的唯一 id。

例如 Demo 示例工程中的 applicationId 为 "com.qq.e.union.demo"。

步骤4: 接入检查

此步骤用于您进行接入的自我检查,检查优量汇 SDK AAR文件中的配置和资源是否正确应用到您的项目中

proguard配置位于优量汇 SDK AAR文件中"/proguard.txt",您可以通过check混淆后的您的mapping文件来判断这些配置是否生效。
比如,您可以check包名com.qq.e下类的public和protected成员是否被keep来验证优量汇 SDK AAR文件中的proguard配置被正确应用。

步骤5:初始化SDK

请在您的的 Application 类的 onCreate() 回调中调用如下方法初始化 SDK。

注意:如果需要在多个进程拉取广告,每个进程都需要初始化 SDK。

GDTADManager.getInstance().initWith(applicationContext, "您在腾讯联盟开发者平台的APPID");

步骤6: 参数设置(可选)

注意:如需设置参数,请先设置参数,然后再使用SDK的其他功能

方法名 方法介绍
setChannel(int channel) 设置渠道号,渠道号信息主要用来协助平台提升流量变现效果及您的收益,请如实填写,渠道和渠道号的映射关系见下面《渠道号与渠道的对应关系》

《渠道号与渠道的对应关系》

渠道号 渠道
1 百度
2 头条
3 广点通
4 搜狗
5 其他网盟
6 oppo
7 vivo
8 华为
9 应用宝
10 小米
11 金立
12 百度手机助手
13 魅族
14 AppStore
999 其他

Copyright © 1998 - 2020 Tencent Inc. All Rights Reserved.
腾讯公司 版权所有 | 加入优量汇