尊敬的开发者朋友,欢迎您使用极光广告SDK。通过本文档,您可以在几分钟之内轻松完成广告的集成过程。
操作系统: iOS 9.0 及以上版本
运行设备:iPhone (iPad上可能部分广告正常展示,但是存在填充很低或者平台不支持等问题,建议不要在iPad上展示广告,穿山甲等平台开屏广告iPad端展示异常)
ADJgSDK Objective-C Demo地址
[ADJgSDK Objective-C Demo]
ADJgSDK Swift Demo地址
[ADJgSDK Swift Demo]
Name | 版本号 |
---|---|
ADJgSDK | 3.7.1.02032 |
jgads | 1.3.5.2.02031 |
tianmu | 2.0.1.2.02031 |
baidu | 5.11.02031 |
gdt | 4.14.10.12221 |
ksad | 3.3.38.1.02031 |
mintegral | 7.2.9.02032 |
toutiao | 5.0.0.5.02201 |
jiguang | 5.0.6.02031 |
推荐使用pod命令
// 挑选在托管的平台导入项目,请不要导入全部,如果不清楚需要哪些平台可以咨询我们
pod 'ADJgSDK','~> 3.7.1.02032' # 主SDK 必选
pod 'ADJgSDK/ADJgSDKPlatforms/tianmu' # 天目 必选
pod 'ADJgSDK/ADJgSDKPlatforms/jgads' # 极光Ads
pod 'ADJgSDK/ADJgSDKPlatforms/gdt' # 优量汇(广点通)
pod 'ADJgSDK/ADJgSDKPlatforms/bu' # 穿山甲(头条)
pod 'ADJgSDK/ADJgSDKPlatforms/ks' # 快手
pod 'ADJgSDK/ADJgSDKPlatforms/baidu' # 百度
pod 'ADJgSDK/ADJgSDKPlatforms/mtg' # 汇量
pod 'ADJgSDK/ADJgSDKPlatforms/jiguang' # 极光联盟
pod 'ADJgSDK/ADJgSDKPlatforms/xxxx'
默认集成了一个固定版本的三方SDK,如果因为项目中也使用了相同的三方广告SDK而发生冲突,可通过以下方法尝试避免或解决;
通过 Pod 我们的 xxx-without 依赖,该方式没有绑定三方广告SDK,开发者可自行集成三方广告SDK,但是需要注意,我们的AdapterSdk是基于三方广告SDK某个版本开发的,如果自行集成三方广告SDK,需要承担三方广告SDK版本不一致可能引起的兼容性和其他不可预知问题;
# 例如:
pod 'ADJgSDK/ADJgSDKPlatforms/gdt-without' # 优量汇(广点通)
点击进入SDK下载地址下载各SDK拖入到工程中
手动方式导入,需要添加如下依赖库:
AdSupport.framework
CoreLocation.framework
QuartzCore.framework
SystemConfiguration.framework
CoreTelephony.framework
libz.tbd
libc++.tbd
libresolv.9.tbd
WebKit.framework (Optional)
libxml2.tbd
Security.framework
StoreKit.framework
AVFoundation.framework
CoreMedia.framework
头条还需要添加依赖库:
Accelerate.framework
AudioToolbox.framework
CoreGraphics.framework
CoreImage.framework
CoreMotion.framework
CoreText.framework
ImageIO.framework
JavaScriptCore.framework
MapKit.framework
MediaPlayer.framework
MobileCoreServices.framework
UIKit.framework
libbz2.tbd
libiconv.tbd
libsqlite3.tbd
libc++abi.tbd
打开项目的 app target,查看 Build Settings 中的 Linking-Other Linker Flags 选项,确保含有 -ObjC 一值, 若没有则添加。
在项目的 app target 中,查看 Build Settings 中的 Build options - Enable Bitcode 选项, 设置为NO。
info.plist 添加支持 Http访问字段
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
NSLocationWhenInUseUsageDescription
NSLocationAlwaysAndWhenInUseUsageDeion
<key>LSApplicationQueriesSchemes</key>
<array>
<!-- 电商及生活 -->
<string>com.suning.SuningEBuy</string> <!-- 苏宁 -->
<string>openapp.jdmobile</string> <!-- 京东 -->
<string>openjd</string> <!-- 京东 -->
<string>jdmobile</string> <!-- 京东 -->
<string>vmall</string>
<string>vipshop</string> <!-- 维品汇 -->
<string>suning</string> <!-- 苏宁 -->
<string>yohobuy</string> <!-- 有货 -->
<string>kaola</string> <!-- 网易考拉 -->
<string>yanxuan</string> <!-- 网易严选 -->
<string>wbmain</string> <!-- 58同城 -->
<string>dianping</string> <!-- 大众点评 -->
<string>imeituan</string> <!-- 美团 -->
<string>beibeiapp</string> <!-- 贝贝 -->
<string>taobao</string> <!-- 淘宝 -->
<string>tmall</string> <!-- 天猫 -->
<string>wireless1688</string> <!-- 阿里巴巴1688 -->
<string>tbopen</string> <!-- 淘宝 -->
<string>taobaolite</string> <!-- 淘特 -->
<string>taobaoliveshare</string> <!-- 淘宝直播 -->
<string>koubei</string> <!-- 口碑 -->
<string>eleme</string> <!-- 饿了么 -->
<string>alipays</string> <!-- 支付宝 -->
<string>kfcapplinkurl</string> <!-- KFC -->
<string>pddopen</string> <!-- 拼多多 -->
<string>pinduoduo</string> <!-- 拼多多 -->
<string>mogujie</string> <!-- 蘑菇街 -->
<string>lianjiabeike</string> <!-- 链家贝壳 -->
<string>lianjia</string> <!-- 链家 -->
<string>openanjuke</string> <!-- 安居客 -->
<string>zhuanzhuan</string> <!-- 转转 -->
<string>farfetchCN</string> <!-- 发发奇全球时尚购物 -->
<!-- 社交社区 -->
<string>weibo</string> <!-- 微博 -->
<string>xhsdiscover</string> <!-- 小红书 -->
<string>uclink</string> <!-- uc浏览器 -->
<string>momochat</string> <!-- 陌陌 -->
<string>blued</string> <!-- Blued -->
<string>zhihu</string> <!-- 知乎 -->
<string>baiduboxapp</string> <!-- 手机百度 -->
<string>yidui</string> <!-- 伊对 -->
<!-- 资讯及阅读 -->
<string>sinanews</string> <!-- 新浪新闻 -->
<string>snssdk141</string> <!-- 今日头条 -->
<string>newsapp</string> <!-- 网易新闻 -->
<string>igetApp</string> <!-- 得到 -->
<string>kuaikan</string> <!-- 快看漫画 -->
<!-- 短视频及音乐 -->
<string>youku</string> <!-- 优酷 -->
<string>snssdk1128</string> <!-- 抖音 -->
<string>gifshow</string> <!-- 快手 -->
<string>snssdk1112</string> <!-- 火山 -->
<string>miguvideo</string> <!-- 咪咕视频 -->
<string>iqiyi</string> <!-- 爱奇艺 -->
<string>bilibili</string> <!-- B站 -->
<string>tenvideo</string> <!-- 腾讯视频 -->
<string>baiduhaokan</string> <!-- 百度好看 -->
<string>yykiwi</string> <!-- 虎牙直播 -->
<string>qqmusic</string> <!-- qq音乐 -->
<string>orpheus</string> <!-- 网易云音乐 -->
<string>kugouURL</string> <!-- 酷狗 -->
<string>qmkege</string> <!-- 全民K歌 -->
<string>changba</string> <!-- 唱吧 -->
<string>iting</string> <!-- 喜马拉雅 -->
<!-- 出行 -->
<string>ctrip</string> <!-- 携程 -->
<string>QunarAlipay</string> <!-- 去哪儿旅行 -->
<string>diditaxi</string> <!-- 滴滴出行 -->
<string>didicommon</string> <!-- 滴滴出行 -->
<string>taobaotravel</string> <!-- 飞猪 -->
<string>OneTravel</string> <!-- 海南航空 -->
<string>kfhxztravel</string> <!-- 花小猪 -->
<!-- 医美 -->
<string>gengmei</string> <!-- 更美 -->
<string>app.soyoung</string> <!-- 新氧医美 -->
</array>
由于iOS14中对于权限和隐私内容有一定程度的修改,而且和广告业务关系较大,请按照如下步骤适配,如果未适配。不会导致运行异常或者崩溃等情况,但是会一定程度上影响广告收入。敬请知悉。
从 iOS 14 开始,在应用程序调用 App Tracking Transparency 向用户提跟踪授权请求之前,IDFA 将不可用。
更新 Info.plist,添加 NSUserTrackingUsageDescription 字段和自定义文案描述。
弹窗小字文案建议:
获取标记权限向您提供更优质、安全的个性化服务及内容,未经同意我们不会用于其他目的;开启后,您也可以前往系统“设置-隐私 ”中随时关闭。
获取IDFA标记权限向您提供更优质、安全的个性化服务及内容;开启后,您也可以前往系统“设置-隐私 ”中随时关闭。
<key>NSUserTrackingUsageDescription</key>
<string>获取标记权限向您提供更优质、安全的个性化服务及内容,未经同意我们不会用于其他目的;开启后,您也可以前往系统“设置-隐私 ”中随时关闭</string>
#import <AppTrackingTransparency/AppTrackingTransparency.h>
#import <AdSupport/AdSupport.h>
...
- (void)requestIDFA {
[ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
// 无需对授权状态进行处理
}];
}
// 建议启动App用户同意协议后就获取权限或者请求广告前获取
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 针对iOS15中不弹窗被拒解决方案,方案1:经测试可能无效
//dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(1.0 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
// 用户同意协议后获取
//[self requestIDFA];
//});
}
// 方案2:根据官方文档调整权限申请时机
// 根据官方开发文档选择在此方法中进行权限申请
- (void)applicationDidBecomeActive:(UIApplication *)application {
// 用户同意协议后获取
[self requestIDFA];
}
// 建议方案1与2一起使用,可正常通过审核。
SKAdNetwork 是接收iOS端营销推广活动归因数据的一种方法。
<key>SKAdNetworkItems</key>
<array>
// 穿山甲广告(ADJgBU)
<dict>
<key>SKAdNetworkIdentifier</key>
<string>238da6jt44.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>22mmun2rn5.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>x2jnk7ly8j.skadnetwork</string>
</dict>
// 优量汇广告(ADJgGDT)
<dict>
<key>SKAdNetworkIdentifier</key>
<string>f7s53z58qe.skadnetwork</string>
</dict>
// 汇量广告(ADJgMTG)
<dict>
<key>SKAdNetworkIdentifier</key>
<string>KBD757YWX3.skadnetwork</string>
</dict>
// 汇量广告 合作伙伴(ADJgMTG)
<dict>
<key>SKAdNetworkIdentifier</key>
<string>wg4vff78zm.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>737z793b9f.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>ydx93a7ass.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>prcb7njmu6.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>7UG5ZH24HU.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>44jx6755aq.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>2U9PT9HC89.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>W9Q455WK68.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>YCLNXRL5PM.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>TL55SBB4FM.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>8s468mfl3y.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>GLQZH8VGBY.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>c6k4g5qg8m.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>mlmmfzh3r3.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>4PFYVQ9L8R.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>av6w8kgt66.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>6xzpu9s2p8.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>hs6bdukanm.skadnetwork</string>
</dict>
</array>
申请的appid必须与您的包名一一对应
// ADJgSDK初始化
[ADJgSDK initWithAppId:@"3283986" completionBlock:^(NSError * _Nonnull error) {
if (error) {
NSLog(@"SDK 初始化失败:%@", error.localizedDescription);
}
}];
用户日志输出等级
添加头文件
#import <ADJgKit/ADJgKitLogging.h>
// 设置日志输出等级
[ADJgSDK setLogLevel:ADJgKitLogLevelDebug];
获取ADJgSDK版本号
//获取SDK版本号
NSString *sdkVersion = [ADJgSDK getSDKVersion];
ADJg的个性化开关可统一控制第三方广告SDK的个性化开关接口,目前支持天目、穿山甲、优量汇、百度、快手、汇量;
// 是否开启个性化广告;默认YES,建议初始化SDK之前设置
ADJgSDK.enablePersonalAd = NO;
开屏广告会在您的应用开启时加载展示,拥有固定展示时间,展示完毕后自动关闭并进入您的应用主界面。
开屏广告建议在闪屏页进行展示,开屏广告的宽度和高度取决于容器的宽高,都是会撑满广告容器;开屏广告的高度必须大于等于屏幕高度(手机屏幕完整高度,包括状态栏之类)的75%,否则可能会影响收益计费。
推荐在 AppDelegate
的 didFinishLaunchingWithOptions
方法的 return YES
之前调用开屏。
OC请求开屏代码示例:
[开屏代码示例]
Swift请求开屏代码示例:
[开屏代码示例]
ADJgSDKSplashAd: 开屏广告的加载类
属性 | 类型 | 说明 |
---|---|---|
delegate | id<ADJgSDKSplashAdDelegate> | 委托对象 |
controller | UIViewController | [必选]开发者需传入用来弹出目标页的ViewController,一般为当前ViewController |
posId | NSString | 广告位id |
scenesId | NSString | 场景id(可选) |
backgroundColor | UIColor | 开屏的默认背景色,或者启动页,为nil则代表透明 |
userId | NSString | 用户id (用户在App内的userID,用于激励视频服务器验证,如无需服务器验证可不传) |
extra | NSString | 其他信息 (服务器端验证回调中包含的可选自定义奖励字符串,可选) |
tolerateTimeout | NSInteger | 开屏请求总超时时间 |
skipView | UIView | 跳过按钮的类型,可以通过此接口替换开屏广告的跳过按钮样式 |
needBottomSkipButton | BOOL | 是否使用右下角跳过按钮,默认为右上角(仅针对穿山甲<头条>平台生效) |
zoomOutViewDelegate | id<ADJgSDKSplashAdZoomOutViewDelegate> | zoomOutView代理回调(如果需要支持广点通v+视频开屏广告,需要实现此协议,其他情况暂时不需要实现) |
splashZoomOutView | UIView<ADJgSDKSplashAdZoomOutViewProtocol> | 当广告命中开屏视频V+时,会存在 |
接口 | 说明 |
---|---|
setBottomSplashWithJgPosid: platformListId: platform: appId: appKey: platformPosid: renderType: | 设置保底开屏 (可选) |
loadAndShowInWindow: | 加载并展示开屏广告 |
loadAndShowInWindow: withBottomView: | 加载并展示开屏广告;底部logo视图, 高度不能超过屏幕的25%,可传nil |
loadAdInWindow: | 加载开屏广告 |
loadAdInWindow: withBottomView: | 加载开屏广告;底部logo视图, 高度不能超过屏幕的25%,可传nil |
showAdInWindow: | 展示开屏广告 |
ADJgSDKSplashAdDelegate:开屏代理方法
回调函数 | 回调说明 |
---|---|
adjg_splashAdSuccessToLoadAd: | 开屏加载成功 |
adjg_splashAdSuccessToPresentScreen: | 开屏展示成功 |
adjg_splashAdFailToPresentScreen: | 开屏展示失败 |
adjg_splashAdEffective: | 开屏曝光 |
adjg_splashAdClicked: | 开屏点击 |
adjg_splashAdClosed: | 开屏关闭 |
adjg_splashAdCloseLandingPage: | 开屏关闭落地页 |
adjg_splashAdDidRewardEffective: info: | 开屏达到激励条件 (开启服务器验证后请使用服务端验证判断是否达到条件,无需使用本回调做激励达成判断) |
ADJgSDKSplashAdZoomOutViewDelegate:开屏代理方法
回调函数 | 回调说明 |
---|---|
adjg_splashZoomOutViewDidClick:splashZoomOutView: | ZoomOutView 点击 |
adjg_splashZoomOutViewAdDidClose:splashZoomOutView: | ZoomOutView 关闭 |
adjg_splashZoomOutViewAdVideoFinished:splashZoomOutView: | ZoomOutView 播放完成 |
adjg_splashZoomOutViewAdDidPresentFullScreenModal:splashZoomOutView: | ZoomOutView 进入视频详情页 |
adjg_splashZoomOutViewAdDidDismissFullScreenModal:splashZoomOutView: | ZoomOutView 退出视频详情页 |
特殊说明
/**
开屏请求总超时时间:所有平台轮询的请求等待总时长(不包括图片渲染时间),单位秒,推荐设置为4s,最小值为3s
开屏各平台分配逻辑:(目前只有开屏需要分配时间,并且理论上分配给到各平台的超时时间不会完全耗尽)
1、3<=tolerateTimeout<=4:轮询首位平台的超时时间为(tolerateTimeout-1)s,次位为2s,如果后续还有平台统一为1s;
2、tolerateTimeout>=5:轮询首位平台的超时时间为(tolerateTimeout-2)s,次位为3s,如果后续还有平台统一为2s;
*/
Swift请求开屏广告代码示例:[开屏代码示例]
OC请求开屏广告代码示例:
#import <ADJgSDK/ADJgSDKSplashAd.h>
#import <ADJgKit/ADJgKit.h>
/*
* 推荐在AppDelegate中的最后加载开屏广告
* 其他的接入方式会有需要特殊注意的方式,遇到过的相关问题在SDK相关问题的文档中有提到
* 不建议在开屏展示过程中做控制器的切换(如:开屏广告关闭回调时切换当前window的根控制器或者present另外一个控制器)
*/
- (void)loadSplashAd{
// 1、初始化开屏广告实例对象
self.splashAd = [[ADJgSDKSplashAd alloc]init];
self.splashAd.delegate = self;
self.splashAd.controller = _window.rootViewController;
// 2、设置开屏的广告位id
self.splashAd.posId = @"88d136b3d8c8da294e";
// 3、设置是否使用右下角跳过按钮,默认为右上角(仅针对穿山甲<头条>平台生效)
self.splashAd.needBottomSkipButton = YES;
/**
开屏请求总超时时间:所有平台轮询的请求等待总时长(不包括图片渲染时间),单位秒,推荐设置为4s,最小值为3s
开屏各平台分配逻辑:(目前只有开屏需要分配时间,并且理论上分配给到各平台的超时时间不会完全耗尽)
1、3<=tolerateTimeout<=4:轮询首位平台的超时时间为(tolerateTimeout-1)s,次位为2s,如果后续还有平台统一为1s;
2、tolerateTimeout>=5:轮询首位平台的超时时间为(tolerateTimeout-2)s,次位为3s,如果后续还有平台统一为2s;
*/
self.splashAd.tolerateTimeout = 4;
// 4、设置默认启动图(一般设置启动图的平铺颜色为背景颜色,使得视觉效果更加平滑)
self.splashAd.backgroundColor = [UIColor adjg_getColorWithImage:[UIImage imageNamed:@"750x1334.png"] withNewSize:[UIScreen mainScreen].bounds.size];
// 5、开屏广告机型适配
CGFloat bottomViewHeight;
if (kADJGCurveScreen) { // 刘海屏
bottomViewHeight = [UIScreen mainScreen].bounds.size.height * 0.15;
} else {
bottomViewHeight = [UIScreen mainScreen].bounds.size.height - [UIScreen mainScreen].bounds.size.width * (960 / 640.0);
}
// 6、底部视图设置,非必选项
UIView *bottomView = [[UIView alloc] init];
bottomView.backgroundColor = [UIColor whiteColor];
bottomView.frame = CGRectMake(0, 0, [UIScreen mainScreen].bounds.size.width, bottomViewHeight);
UIImageView *logoImageView = [[UIImageView alloc]initWithImage:[UIImage imageNamed:@"ADJg_Logo.png"]];
logoImageView.frame = CGRectMake(([UIScreen mainScreen].bounds.size.width-135)/2, (bottomViewHeight-46)/2, 135, 46);
[bottomView addSubview:logoImageView];
// 7、加载开屏广告
[self.splashAd loadAndShowInWindow:_window withBottomView:bottomView];
}
// 9、代理回调
#pragma mark - ADJgSDKSplashAdDelegate
/**
开屏展现成功
@param splashAd 广告实例
*/
- (void)adjg_splashAdSuccessToPresentScreen:(ADJgSDKSplashAd *)splashAd{
}
/**
开屏展现失败
@param splashAd 广告实例
@param error 具体错误信息
*/
- (void)adjg_splashAdFailToPresentScreen:(ADJgSDKSplashAd *)splashAd failToPresentScreen:(ADJgAdapterErrorDefine *)error{
_splashAd = nil;
}
/**
开屏广告点击
@param splashAd 广告实例
*/
- (void)adjg_splashAdClicked:(ADJgSDKSplashAd *)splashAd{
}
/**
开屏被关闭
@param splashAd 广告实例
*/
- (void)adjg_splashAdClosed:(ADJgSDKSplashAd *)splashAd{
_splashAd = nil;
}
/**
开屏展示
@param splashAd 广告实例
*/
- (void)adjg_splashAdEffective:(ADJgSDKSplashAd *)splashAd{
}
Banner广告(横幅广告)位于app顶部、中部、底部任意一处,横向贯穿整个app页面;当用户与app互动时,Banner广告会停留在屏幕上,并可在一段时间后自动刷新。
OC请求横幅代码示例:
[横幅代码示例]
Swift请求横幅代码示例:
[横幅代码示例]
ADJgSDKBannerAdView: 横幅广告的加载类
属性 | 类型 | 说明 |
---|---|---|
delegate | id<ADJgSDKBannerAdViewDelegate> | 委托对象 |
controller | UIViewController | [必选]开发者需传入用来弹出目标页的ViewController,一般为当前ViewController |
posId | NSString | 广告位id |
scenesId | NSString | 场景id(可选) |
refershTime | NSInteger | banner刷新时间间隔,30-120s之间;默认不刷新 |
tolerateTimeout | NSInteger | 请求超时时间,默认为4s,需要设置3s及以上 |
接口 | 说明 |
---|---|
loadAndShow | 加载并展示广告 |
ADJgSDKBannerAdViewDelegate:横幅代理方法
回调函数 | 回调说明 |
---|---|
adjg_bannerViewDidReceived: | 横幅广告加载成功 |
adjg_bannerViewFailToReceived:errorModel: | 横幅广告加载失败 |
adjg_bannerViewDidPresent: | 横幅广告展示 |
adjg_bannerViewExposure: | 横幅广告曝光 |
adjg_bannerViewClicked: | 横幅广告点击 |
adjg_bannerViewClose: | 横幅广告关闭 |
adjg_bannerAdCloseLandingPage: | 横幅广告关闭落地页 |
Swift请求横幅代码示例:[横幅代码示例]
OC请求横幅广告请求示例:
#import <ADJgSDK/ADJgSDKBannerAdView.h>
- (void)loadBannerWithRate:(CGFloat)rate posId:(NSString *)posId {
[self.bannerView removeFromSuperview];
self.bannerView.delegate = nil;
self.bannerView = nil;
// 1、初始化banner视图,并给定frame值,rate取值根据banner的尺寸
self.bannerView = [[ADJgSDKBannerAdView alloc] initWithFrame:CGRectMake(0, 250, kADJGScreenWidth, kADJGScreenWidth / rate)];
self.bannerView.delegate = self;
// 2、设置控制器,用来弹出落地页,重要
self.bannerView.controller = self;
// 3、设置广告位id,重要 测试可使用posId: 8caaf541ebc0f0b87e
self.bannerView.posId = posId;
self.bannerView.refershTime = 30;
// 4、可先展示再请求
[self.view addSubview:self.bannerView];
self.bannerView.backgroundColor = [UIColor redColor];
// 5、加载并展示
[self.bannerView loadAndShow];
}
// 5、代理回调
#pragma mark - ADJgSDKBannerAdViewDelegate
/**
广告获取成功
@param bannerView banner实例
*/
- (void)adjg_bannerViewDidReceived:(ADJgSDKBannerAdView *)bannerView{
}
/**
广告拉取失败
@param bannerView banner实例
@param errorModel 错误描述
*/
- (void)adjg_bannerViewFailToReceived:(ADJgSDKBannerAdView *)bannerView errorModel:(ADJgAdapterErrorDefine *)errorModel{
NSLog(@"adjg_bannerViewFailToReceived:%@, %@",errorModel.errorDescription, errorModel.errorDetailDict);
[_bannerView removeFromSuperview];
_bannerView = nil;
}
/**
广告点击
@param bannerView 广告实例
*/
- (void)adjg_bannerViewClicked:(ADJgSDKBannerAdView *)bannerView{
}
/**
广告关闭
@param bannerView 广告实例
*/
- (void)adjg_bannerViewClose:(ADJgSDKBannerAdView *)bannerView{
_bannerView = nil;
}
/**
广告展示
@param bannerView 广告实例
*/
- (void)adjg_bannerViewExposure:(ADJgSDKBannerAdView *)bannerView{
}
信息流广告,具备自渲染和模板两种广告样式:自渲染是SDK将返回广告标题、描述、Icon、图片、多媒体视图等信息,开发者可通过自行拼装渲染成喜欢的样式;模板样式则是返回拼装好的广告视图,开发者只需将视图添加到相应容器即可,模板样式的容器高度建议是自适应。请务必确保自渲染类型广告渲染时包含广告创意素材(至少包含一张图片)、平台logo、广告标识、关闭按钮;模板广告不得被遮挡。 注意,信息流广告点击关闭时,开发者需要在- (void)adjg_nativeAdClose:回调中将广告视图隐藏或移除,避免如穿山甲渠道点击关闭后视图依旧存在问题
OC请求信息流广告代码示例:
[信息流广告代码示例]
Swift请求信息流广告代码示例:
[信息流广告代码示例]
ADJgSDKNativeAd: 信息流广告的加载类
属性 | 类型 | 说明 |
---|---|---|
delegate | id<ADJgSDKNativeAdDelegate> | 委托对象 |
controller | UIViewController | [必选]开发者需传入用来弹出目标页的ViewController,一般为当前ViewController |
posId | NSString | 广告位id |
scenesId | NSString | 场景id |
tolerateTimeout | NSTimeInterval | 请求超时时间,默认为4s,需要设置3s及以上 |
muted | BOOL | 是否静音播放视频 默认YES |
detailPageVideoMuted | BOOL | 是否静音播放详情页视频 默认YES,仅支持优量汇平台 |
autoPlay | BOOL | 信息流自动播放,默认WiFi自动播放 开启后WiFi/4G自动播放 |
status | ADJgSDKNativeAdStatus | 开发者可通过状态值来判断当前广告对象是否正在加载广告 |
insets | UIEdgeInsets | 模板信息流内边距 默认(16,16,12,16)(部分平台支持,其余需后台设置) |
接口 | 说明 |
---|---|
load: | 加载广告,建议区间 1~5, 超过可能无法拉取到 |
ADJgSDKNativeAdDelegate:信息流代理方法
回调函数 | 回调说明 |
---|---|
adjg_nativeAdSucessToLoad:adViewArray: | 信息流广告加载成功 |
adjg_nativeAdFailToLoad:errorModel | 信息流广告加载失败 |
adjg_nativeAdViewRenderOrRegistSuccess: | 信息流广告渲染成功 |
adjg_nativeAdViewRenderOrRegistFail: | 信息流广告渲染失败 |
adjg_nativeAdExposure:adView: | 信息流广告曝光 |
adjg_nativeAdClicked:adView: | 信息流广告点击 |
adjg_nativeAdClose:adView: | 信息流广告关闭 |
adjg_nativeAdCloseLandingPage:adView: | 信息流广告关闭落地页 |
adjg_nativeAd:adView:playerStatusChanged: | 视频类型信息流广告player 播放状态更新回调 |
Swift请求信息流广告代码示例:[信息流广告代码示例]
OC请求信息流广告请求示例:
#import <ADJgSDK/ADJgSDKNativeAd.h>
if(!_nativeAd) {
// 1、信息流广告初始化
_nativeAd = [[ADJgSDKNativeAd alloc] initWithAdSize:CGSizeMake(self.tableView.frame.size.width, 10)];
// 2、传入posId,重要 测试可使用posId:0ee1184a15a310284e
_nativeAd.posId = self.posId;
_nativeAd.delegate = self;
_nativeAd.controller = self;
}
// 3、加载信息流广告
[_nativeAd load:1];
// 4、代理回调
#pragma mark - ADJgSDKNativeAdDelegate
- (void)adjg_nativeAdSucessToLoad:(ADJgSDKNativeAd *)nativeAd
adViewArray:(NSArray<__kindof UIView<ADJgAdapterNativeAdViewDelegate> *> *)adViewArray {
for (UIView<ADJgAdapterNativeAdViewDelegate> *adView in adViewArray) {
// 4、判断信息流广告是否为自渲染类型
if(adView.renderType == ADJgAdapterRenderTypeNative) {
// 4.1、如果是自渲染类型则可样式自定义
[self setUpUnifiedNativeAdView:adView];
}
// 5、注册,自渲染:注册点击事件,模板:render,重要
[adView adjg_registViews:@[adView]];
}
[self.tableView.mj_header endRefreshing];
[self.tableView.mj_footer endRefreshing];
}
// 渲染成功回调
- (void)adjg_nativeAdViewRenderOrRegistSuccess:(UIView<ADJgAdapterNativeAdViewDelegate> *)adView {
// 6、注册或渲染成功,此时高度正常,可以展示
dispatch_async(dispatch_get_main_queue(), ^{
for (int i = 0; i < 6; i ++) {
[self.items addObject:[NSNull null]];
}
[self.items addObject:adView];
[self.tableView reloadData];
});
}
- (void)adjg_nativeAdClose:(ADJgSDKNativeAd *)nativeAd
adView:(__kindof UIView<ADJgAdapterNativeAdViewDelegate> *)adView {
for (id item in _items) {
if(item == adView) {
dispatch_async(dispatch_get_main_queue(), ^{
[adView adjg_unRegistView];
[self.items removeObject:adView];
[self.tableView reloadData];
});
}
}
}
将短视频融入到APP场景当中,用户观看短视频广告后可以给予一些应用内奖励。常出现在游戏的复活、任务等位置,或者网服类APP的一些增值服务场景。
OC请求激励视频代码示例:
[激励视频广告代码示例]
Swift请求激励视频代码示例:
[激励视频广告代码示例]
ADJgSDKRewardvodAd: 激励视频广告的加载类
属性 | 类型 | 说明 |
---|---|---|
delegate | id<ADJgSDKRewardvodAdDelegate> | 委托对象 |
controller | UIViewController | 开发者需传入用来弹出目标页的ViewController,一般为当前ViewController |
posId | NSString | 广告位id |
scenesId | NSString | 场景id |
userId | NSString | 用户id (用户在App内的userID,用于激励视频服务器验证,如无需服务器验证可不传) |
rewardName | NSString | 奖励名称 (用于激励视频服务器验证参数,可选) |
rewardAmount | NSString | 奖励数量 (用于激励视频服务器验证参数,可选) |
extraInfo | NSString | 其他信息 (服务器端验证回调中包含的可选自定义奖励字符串,可选) |
tolerateTimeout | NSInteger | 请求超时时间,默认为4s,需要设置3s及以上 |
isMuted | BOOL | 是否静音,默认静音(部分平台支持:优量汇,汇量,快手 |
接口 | 说明 |
---|---|
loadRewardvodAd | 加载激励视频广告 |
showRewardvodAd | 展示激励视频广告 |
rewardvodAdIsValid | 激励视频广告物料是否有效 |
rewardvodAdIsReady | 激励视频广告是否准备好 |
rewardvodAdCanServerVerrify | 激励视频广告是否支持服务端验证 |
ADJgSDKRewardvodAdDelegate:激励视频代理方法
回调函数 | 回调说明 |
---|---|
adjg_rewardvodAdLoadSuccess: | 激励视频广告加载成功 |
adjg_rewardvodAdFailToLoad:errorModel: | 激励视频广告加载失败 |
adjg_rewardvodAdReadyToPlay: | 激励视频广告准备好播放 |
adjg_rewardvodAdPlaying:errorModel: | 激励视频广告播放时错误回调 |
adjg_rewardvodAdVideoLoadSuccess: | 视频数据下载成功回调,已经下载过的视频会直接回调 |
adjg_rewardvodAdWillVisible: | 激励视频广告播放页即将展示 |
adjg_rewardvodAdDidVisible: | 激励视频广告曝光 |
adjg_rewardvodAdDidRewardEffective: | 激励视频广告达到激励条件 |
adjg_rewardvodAdServerDidSucceed: | 激励视频服务验证成功(需等待服务器返回结果后判断是否激励生效) |
adjg_rewardvodAdServerDidSucceed:info: | 激励视频服务验证成功(需等待服务器返回结果后判断是否激励生效),并携带服务验证三方返回的相关参数 |
adjg_rewardvodAdServerDidFailed:errorModel: | 激励视频服服务验证失败 |
adjg_rewardvodAdDidPlayFinish: | 激励视频广告播放完成 |
adjg_rewardvodAdDidClick: | 激励视频广告点击 |
adjg_rewardvodAdDidClose: | 激励视频广告关闭 |
adjg_rewardvodAdCloseLandingPage: | 激励视频广告关闭落地页 |
Swift请求激励视频代码示例:[激励视频广告代码示例]
OC请求激励视频代码示例:
#import <ADJgSDK/ADJgSDKRewardvodAd.h>
- (void)loadRewardvodAd{
// 1、初始化激励视频广告
self.rewardvodAd = [[ADJgSDKRewardvodAd alloc]init];
self.rewardvodAd.delegate = self;
self.rewardvodAd.tolerateTimeout = 5;
self.rewardvodAd.controller = self;
self.rewardvodAd.posId = @"a2b2644e75983ae44d";
// 以下参数如不需服务端验证可不传
self.rewardvodAd.userId = @"xxx";
self.rewardvodAd.extraInfo = @"这是一个激励视频生效验证";
self.rewardvodAd.rewardName = @"看视频得金币";
self.rewardvodAd.rewardAmount = [NSNumber numberWithInt:2];
// 2、加载激励视频广告
[self.rewardvodAd loadRewardvodAd];
}
/**
激励视频广告准备好被播放
@param rewardvodAd 广告实例
*/
- (void)adjg_rewardvodAdReadyToPlay:(ADJgSDKRewardvodAd *)rewardvodAd{
// 3、推荐在准备好被播放回调中展示激励视频广告
if ([self.rewardvodAd rewardvodAdIsReady]) {
[self.rewardvodAd showRewardvodAd];
}
}
/**
视频播放页关闭回调
@param rewardvodAd 广告实例
*/
- (void)adjg_rewardvodAdDidClose:(ADJgSDKRewardvodAd *)rewardvodAd{
// 4、广告内存回收
_rewardvodAd = nil;
}
/**
视频广告请求失败回调
@param rewardvodAd 广告实例
@param errorModel 具体错误信息
*/
- (void)adjg_rewardvodAdFailToLoad:(ADJgSDKRewardvodAd *)rewardvodAd errorModel:(ADJgAdapterErrorDefine *)errorModel{
// 4、广告内存回收
_rewardvodAd = nil;
}
/**
视频广告发送服务端验证成功回调
@param rewardvodAd 广告实例
*/
- (void)adjg_rewardvodAdServerDidSucceed:(ADJgSDKRewardvodAd *)rewardvodAd {
}
/**
视频广告发送服务端验证请求失败回调
@param rewardvodAd 广告实例
@param errorModel 具体错误信息
*/
- (void)adjg_rewardvodAdServerDidFailed:(ADJgSDKRewardvodAd *)rewardvodAd errorModel:(ADJgAdapterErrorDefine *)errorModel {
}
插屏广告是移动广告的一种常见形式,在应用流程中弹出,当应用展示插屏广告时,用户可以选择点击广告,访问其目标网址,也可以将其关闭并返回应用。在应用执行流程的自然停顿点,适合投放这类广告。
注意:穿山甲插屏广告禁止App启动即请求,建议在首页控制器viewDidLoad方法中2~3s后请求展示,否则会有明显数据影响,将会存在约50%数据异常。
OC请求插屏广告代码示例:
[插屏广告代码示例]
Swift请求插屏广告代码示例:
[插屏广告代码示例]
ADJgSDKIntertitialAd: 插屏广告的加载类
属性 | 类型 | 说明 |
---|---|---|
delegate | id<ADJgSDKIntertitialAdDelegate> | 委托对象 |
controller | UIViewController | 开发者需传入用来弹出目标页的ViewController,一般为当前ViewController |
posId | NSString | 广告位id |
scenesId | NSString | 场景id |
tolerateTimeout | NSTimeInterval | 请求超时时间,默认为4s,需要设置3s及以上 |
isMuted | BOOL | 是否静音,默认静音(部分平台支持:优量汇,汇量,快手) |
detailPageVideoMuted | BOOL | 是否静音,默认静音(部分平台支持:优量汇) |
adSize | CGSize | 广告尺寸,需与平台所申请广告位比例一致,否则会导致素材压缩(仅支持部分平台) |
接口 | 说明 |
---|---|
loadAdData | 加载插屏广告 |
show | 展示插屏广告 |
ADJgSDKIntertitialAdDelegate:插屏代理方法
回调函数 | 回调说明 |
---|---|
adjg_interstitialAdSuccedToLoad: | 插屏广告加载成功 |
adjg_interstitialAdFailedToLoad:error: | 插屏广告加载失败 |
adjg_interstitialAdDidPresent: | 插屏广告展示成功 |
adjg_interstitialAdFailedToPresent:error: | 插屏广告展示失败 |
adjg_interstitialAdExposure: | 插屏广告曝光 |
adjg_interstitialAdDidClick: | 插屏广告点击 |
adjg_interstitialAdDidClose: | 插屏广告关闭 |
adjg_interstitialAdCloseLandingPage: | 插屏广告关闭落地页 |
Swift请求插屏代码示例:[插屏广告代码示例]
OC请求插屏代码示例:
#import <ADJgSDK/ADJgSDKIntertitialAd.h>
- (void)loadInterstitialAd{
// 1、初始化插屏广告
self.intertitialAd = [ADJgSDKIntertitialAd new];
self.intertitialAd.controller = self;
self.intertitialAd.posId = @"75dc0e44ed48bc2a62";
self.intertitialAd.delegate = self;
self.intertitialAd.tolerateTimeout = 4;
// 2、加载插屏广告
[self.intertitialAd loadAdData];
}
#pragma mark - ADJgSDKIntertitialAdDelegate
/**
ADJgSDKIntertitialAd请求成功回调
@param interstitialAd 插屏广告实例对象
*/
- (void)adjg_interstitialAdSuccedToLoad:(ADJgSDKIntertitialAd *)interstitialAd{
// 3、展示插屏广告
[self.intertitialAd show];
}
/**
ADJgSDKIntertitialAd请求失败回调
@param interstitialAd 插屏广告实例对象
@param error 失败原因
*/
- (void)adjg_interstitialAdFailedToLoad:(ADJgSDKIntertitialAd *)interstitialAd error:(ADJgAdapterErrorDefine *)error{
// 4、内存回收
_intertitialAd = nil;
}
/**
ADJgSDKIntertitialAd关闭回调
@param interstitialAd 插屏广告实例对象
*/
- (void)adjg_interstitialAdDidClose:(ADJgSDKIntertitialAd *)interstitialAd{
// 4、内存回收
_intertitialAd = nil;
}
极光联盟渠道特有广告样式(非极光Ads)对接地址
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。