Android iOS Unity JS API Media API 常见问题

腾讯优量汇 iOS SDK 接入文档

Version: 4.13.11

概述

说明

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

背景

开发环境

确保您的开发及部署环境符合以下标准:

注册开户

开发者需在腾讯优量汇开发者平台上进行注册,在平台审核通过后,开发者就成为了腾讯优量汇的正式会员。

术语介绍

权限申请

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

说明:针对单媒体的用户,允许获取idfa和定位权限的,投放定向广告;不允许获取权限的用户,投放通投广告,媒体可以选择是否把idfa和定位数据提供给优量汇,并承担相应广告填充和eCPM单价下降损失的结果。

SDK 初始化

SDK 拉取广告之前,必须要进行初始化操作,传入在腾讯优量汇开发者平台注册得到的 APPID。方法如下:

#import "GDTSDKConfig.h"

+ (BOOL)registerAppId:(NSString *)appId;

GPS信息获取开关

在已获得GPS权限的前提下,媒体可以选择是否在广告中获取用户的GPS信息,以便获取定向广告。方法如下:

#import "GDTSDKConfig.h"

[GDTSDKConfig enableGPS:YES]; // 获取用户的GPS信息,默认值为NO

禁用IDFA信息

此接口默认值是NO,即同意优量汇SDK获取IDFA信息。
允许流量方设置此接口值为YES,即禁止优量汇SDK获取IDFA信息。方法如下:

#import "GDTSDKConfig.h"

[GDTSDKConfig forbiddenIDFA:YES]; // 禁止优量汇SDK获取IDFA信息,默认值为NO

设置渠道号

渠道号信息主要用来协助平台提升流量变现效果及您的收益,请如实填写,若渠道号无法满足您的诉求请联系平台负责运营。

渠道号映射关系为:

方法如下:

#import "GDTSDKConfig.h"

+ (void)setChannel:(NSInteger)channel;
[GDTSDKConfig setChannel:3];

音频设置

在播放音频时是否使用SDK内部对AVAudioSession设置的category及options,默认使用,若不使用,SDK内部不做任何处理,由调用方在播放视频时自行设置;

SDK设置的category为AVAudioSessionCategoryAmbient,options为AVAudioSessionCategoryOptionDuckOthers

#import "GDTSDKConfig.h"

+ (void)enableDefaultAudioSessionSetting:(BOOL)enabled;

广告位创建流程

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

步骤说明:

支持广告类型

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

广告类型 接入方式 简介 适用场景 版本备注
开屏广告 SDK原生渲染 开屏广告以App启动作为曝光时机,提供5s的可感知广告展示。用户可以点击广告跳转到目标页面;或者点击右上角的“跳过”按钮,跳转到app内容首页。

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