腾讯优量汇 Android SDK 接入文档

概述

说明

本文档旨在帮助 Android 应用开发者在程序中快速植入腾讯优量汇开发者平台提供的广告。作为应用开发者，您只需要进行简单配置，就可以在您的应用中显示定制的广告。关于 SDK 的具体使用方法，请仔细阅读下面的文档。

背景

开发环境

操作系统：支持 Linux/Mac/Windows 系统，具体依赖开发者选择的 IDE
开发工具：支持 Android studio、Eclipse、Intellij
部署目标：接入优量汇流量的应用
支持设备：运行了 Android 4.0 以及以上系统的 Android 设备

接入方式：下载 aar 或 gradle。如使用 gradle，版本号需大于等于 4.370.1240，请参考下方：

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

术语介绍

APPID：媒体 ID，是您在腾讯优量汇开发者平台创建媒体时获得的 ID，这个 ID 是我们在广告网络中识别您应用的唯一 ID。
POSID：广告位 ID，是您在腾讯优量汇开发者平台为您的媒体所创建的某种类型（Banner、开屏、插屏、自渲染、平台模板、平台模板2.0）的广告位置的 ID。

权限申请

部分广告样式的接入需要权限，您可以联系腾讯优量汇运营进行了解和权限申请。在腾讯优量汇开发者平台新建广告位时您只能看到您有相应权限的广告位类型。

广告位创建流程

在您的媒体通过审核后，可以在腾讯优量汇开发者平台选择“新建广告位”。

步骤说明：

1.在新建广告位之前，确保您已经下载最新版SDK并阅读完说明文档，了解如何在您的媒体中使用广告位 ID
2.选择需要嵌入广告的媒体名称。注意此处只可选择已通过审核的媒体
3.广告位名称用于区分媒体内设置的各个广告位，方便您在后台进行统一管理和查看数据报表；目前支持接入的广告类型包含：开屏广告、动态信息流广告、横幅广告、贴片广告、插屏广告、激励视频广告和 Banner 广告；接入方式包含SDK原生渲染、平台模板2.0、平台模板、自渲染、H5接入等
4.点击完成按钮以后即获得对应该广告位的 ID 号
5.成功得到广告位ID以后，您可以在应用代码内使用该ID进行广告联调测试（见“接入代码”部分）
6.通过测试后去掉测试代码部分（TestAd），即可发布带有优量汇广告位的 Android 应用

支持广告类型及对应接入方式及简介

优量汇支持以下几种广告类型，您可以根据开发需要选择合适的广告：

广告类型	接入方式	简介	适用场景	备注
开屏广告	开屏广告	开屏广告以App启动作为曝光时机，提供5s的可感知广告展示。用户可以点击广告跳转到目标页面；或者点击右上角的“跳过”按钮，跳转到app内容首页。开屏V+广告是一个5s-30s的视频广告，在5s开屏呈现的过程中，用户点击右上角的“进入首页”或5s曝光结束后，视频均将收缩到APP内右下角的小视窗继续播放。	APP启动时	包含开屏与开屏V+ 两种
动态信息流/横幅/贴片广告	平台模板渲染自渲染	本广告类型下提供了多种的广告模板样式及自渲染方式，在新建广告位时支持只出图文广告或只出视频广告，也支持图文和视频广告混出。为保证广告位填充率，建议尽量选择图文和视频广告混出。如样式满足您的诉求，您可直接使用展示。	APP信息流中、任何您希望展示广告的地方、APP中视频内容的框内插入
激励广告	原生渲染 H5渲染	指将短视频融入到app场景当中，成为app“任务”之一，用户观看短视频广告后可以得到一些应用内奖励。模板激励视频相比于原生激励视频会基于优量汇平台模板针对用户提供转化效果更好的播放样式，以提升流量收益。	常见于游戏内的广告样式，多出现在游戏的复活、登录等位置，或者网服类app的一些增值服务场景。建议开发者在分析媒体属性和功能的基础上，判断是否嵌入。
插屏广告	插屏广告	插屏半屏是移动广告的一种常见形式，在应用流程中弹出，当应用展示插页式广告时，用户可以选择点按广告，访问其目标网址，也可以将其关闭，返回应用。插屏全屏视频广告：是移动广告的一种常见形式，在应用自然流畅结束时，全屏弹出播放，当应用展示插页式广告时，用户可以选择点按广告，访问其目标网址，也可以将其关闭，返回应用。	在应用执行流程的自然停顿点，适合投放这类广告
Banner广告	平台模板渲染	Banner广告(横幅广告)位于app顶部、中部、底部任意一处，横向贯穿整个app页面；当用户与app互动时，Banner广告会停留在屏幕上，并可在一段时间后自动刷新。	常见的展现场景为：文章页末尾，详情页面底部，信息流顶部等。