IOS_ADMaxSDK接入說明文檔 V1.0.4
1.導入SDK
步驟1: 將 ADMaxSDK.framework 添加到工程
5212835F-DC2F-49DA-ADCA-2E9AF549D5E1.png
步驟2:添加項目配置
- 在Other Linker Flags加入 -ObjC 和 -fobjc-arc 骑素，注意不要寫為-Objc
1231214142323423.png
- -ObjC屬于鏈接庫必備參數(shù)噩凹，如果不加此項嚼松，會導致庫文件無法被正確鏈接针贬，SDK無法正常運行
步驟3:加入依賴系統(tǒng)庫
- 選中項目Target -> General -> Linked Frameworks and Libraries列表中進行添加
1231681638716619164.png
- 加入以下系統(tǒng)庫：
1. libsqlite3.tbd
2. CoreGraphics.framework
3. SystemConfiguration.framework
4. CoreTelephony.framework
5. libc++.tbd
6. libz.tbd
7. libiconv.tbd
8. Security.framework
2.初始化設置
1. 導入SDK頭文件
#import <ADMaxSDK/ADMaxSDK.h>
2. 初始化SDK
- 準備 SDK 的AppID 和 Secret
- 每一種廣告對應一個appId （例如：setSplashAppId -> 開屏廣告ID）
- 注意：如果廣告ID沒有對應钩蚊，就拿不到廣告（以下廣告ID只提供測試）
AdMAXInit.png
- 代碼如下：
//初始化 ADMaxSDK
[[ADMaxManager defaultManager] setSplashAppId:@"320100" BannerAppId:@"320101" NativeAppId:@"320102" appSecret:@"ABCDEFGHIGKLMN"];
//檢測配置日志
[[ADMaxManager defaultManager] setDebugLogOpen:YES];
//設定展示廣告的容器 默認：AdMaxWebType
[[ADMaxManager defaultManager] setNewWebType:AdMaxWebType];
3. 使用方法
- SDK：提供以下兩種廣告實現(xiàn)方式（廣告1 and 廣告2）可根據(jù)自身開發(fā)需求自行選擇蝗蛙，詳細使用方法請參考 ADMaxSDKDome
1. 使用方法
- 快速集成無需初始化對象 如下：
//開屏廣告
[[ADMaxManager defaultManager] loadSplashAddWindow:[UIApplication sharedApplication].keyWindow withBottomView:nil Duration:10];
//Native
[[ADMaxManager defaultManager] requestNativeAds:^(NSArray *nativeArr) {
} failed:^(PeAdFailReason error) {
}];
//Banner
[[ADMaxManager defaultManager] bannerStart];
注：Native廣告只返回廣告數(shù)據(jù)赤惊，用戶可自定義廣告展示樣式
在使用 Native 的時候注意參考 ADMaxDome
PeAdNativeObject.png
展示例子：
54B3AF0E-C16C-49AA-B0DE-675D1D339AF6.png
注意使用
@property (nonatomic, strong) PeAdNativeObject* object;
[[ADMaxManager defaultManager] requestNativeAds:^(NSArray *nativeArr) {
_object = [nativeArr objectAtIndex:0];
if(_object){
NSLog(@"原生廣告請求成功 %@",_object.title);
_nativeView.alpha = 1;
[_nativeView setObject:_object];
}
} failed:^(PeAdFailReason error) {
}];
2. 使用方法
測試 SDK的APPID
publisherId = @"320100"（ * 如果在application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions 里填過appId衫仑，在項目中使用時可選擇不填 SDK的APPID
例：
_adSplash.publisherId = @"SDK的APPID";
_native.publisherId = @"SDK的APPID";
_adBanner.publisherId = @"SDK的APPID";
）
793CD251-FDB9-4923-99DB-A71471B04426.png
- 初始化對象 代碼如下：
-(PeAdNative *)native{
if (!_native) {
_native = [[PeAdNative alloc]init];
_native.delegate = self;
_native.publisherId = @"SDK的APPID";
_native.controller = self;//當前使用的控制器
}
return _native;
}
-(PeAdSplash *)adSplash{
if (!_adSplash) {
_adSplash = [[PeAdSplash alloc]init];
_adSplash.delegate = self;
_adSplash.publisherId = @"SDK的APPID";
}
return _adSplash;
}
-(PeAdBanner *)adBanner{
if (!_adBanner) {
_adBanner = [[PeAdBanner alloc]init];
_adBanner.delegate = self;
_adBanner.publisherId = @"SDK的APPID";
_adBanner.controller = self;//當前使用的控制器
}
return _adBanner;
}
- 注意添加代理
用到哪個功能梨与，注意添加相應的代理。
- 例：
PeAdNativeDelegate
PeAdSplashDelegate
PeAdBannerDelegate
- 以上準備OK文狱，即可引入相應的功能代理方法
90B7424B-9455-4669-8FDC-8F9CAB98C8BF.png
- 進入代理
707B5724-49B6-41AB-BC14-FBC614A8373C.png
- 代理實現(xiàn)
例：
#pragma mark - NativeDelegate
/**
* 廣告請求成功
*/
- (void)nativeObjectsSuccessLoad:(NSArray*)nativeAds{
// __kWeakSelf__;
_object = [nativeAds objectAtIndex:0];
if(_object){
NSLog(@"原生廣告請求成功 %@",_object.title);
_nativeLable.text = [NSString stringWithFormat:@"原生廣告 title: %@",_object.title];
}
}
/**
* 廣告請求失敗
*/
- (void)nativeFailLoad:(PeAdFailReason) reason{
NSLog(@"原生廣告請求失敗 error%d",reason);
}
/**
* 廣告點擊
*/
- (void)nativeClicked:(PeAdNativeView*)nativeView{
NSLog(@"nativeClicked");
}
/**
* 廣告詳情頁關閉
*/
-(void)didDismissLandingPage:(PeAdNativeView *)nativeView{
NSLog(@"didDismissLandingPage");
}
注：代理的詳細功能粥鞋，以
SDK中的.h文件注釋為主
- 廣告請求 如下：
//Native requestNativeAds:請求的廣告?zhèn)€數(shù)
[self.native requestNativeAds];
//Banner
[self.adBanner start];
//開屏廣告 —— 半屏 withBottomView：底部自定義View
[self.adSplash loadAdAndShowInWindow:[UIApplication sharedApplication].keyWindow withBottomView:self.adSplashBottomView];
//開屏廣告 —— 全屏
[self.adSplash loadAdAndShowInWindow:[UIApplication sharedApplication].keyWindow];
更新內容
1.增加了落地廣告展示茴肥，分別有 AdMaxWeb 琉苇，Safari荚板，用戶自定義 customUrl
注：用戶自定義
通過以下的兩個方法 返回 customUrl：廣告點擊后跳轉的url-(void)setClickAdPassValueCustomViewUrl:(void (^)(NSString * url))customUrl;
-(void)setNewWebType:(ADMaxClickWebType)clickWebType ClickAdPassValueUrl:(void (^)(NSString * url))customUrl;
typedef enum{
AdMaxWebType = 0,//!<AdMaxWeb
SafariType = 1,//!<Safari
UserWebType = 2,//!<自定義
} ADMaxClickWebType;
使用方法如下：
-
SDK點擊后志笼，展示方式設置的公開方法
FADAF82F-28B5-4EE8-8A35-A3870F9D31E2.png SDK點擊后拦宣，展示方式初始化以及方法使用
92D8CF64-2A7C-4B83-9A2E-59D589E3CD4C.png
