EasyAds-iOS?是開(kāi)源聚合 SDK 廣告軟件。幫助 App 開(kāi)發(fā)者便捷接入國(guó)內(nèi)多家主流廣告 SDK。

EasyAds-iOS 快速指引

1. 支持的SDK平臺(tái)及廣告位

2. 快速接入

下面介紹EasyAds的快速接入方法，開(kāi)發(fā)中也可以參考Example下的示例工程，快速了解。

2.1 開(kāi)發(fā)環(huán)境準(zhǔn)備

• 開(kāi)發(fā)工具：推薦使用Xcode 12及以上版本
• 部署目標(biāo)：iOS 9.0及以上版本
• 開(kāi)發(fā)管理工具：CocoaPods，CocoaPods安裝方法及問(wèn)題參考

2.2 引入SDK

根據(jù)需要將相關(guān)的渠道SKAdNetwork ID添加到info.plist中，保證SKAdNetwork 的正確運(yùn)行。 示例如下：

SKAdNetworkItems
 
   
     SKAdNetworkIdentifier
     238da6jt44.skadnetwork
   
   
     SKAdNetworkIdentifier
     22mmun2rn5.skadnetwork
   
   
     SKAdNetworkIdentifier
     f7s53z58qe.skadnetwork
   
    
     SKAdNetworkIdentifier
     r3y5dwb26t.skadnetwork
   
 

2.3 SDK分發(fā)策略配置

配置SDK的分發(fā)策略，可方便的實(shí)現(xiàn)流量的切分操作，實(shí)現(xiàn)多SDK的混合執(zhí)行策略。

在EasyAds中，我們通過(guò)JSON文件的方式配置SDK的分發(fā)策略，開(kāi)發(fā)者可根據(jù)自身流量分發(fā)的需求，按照EasyAds中提供的JSON配置格式及方法設(shè)置流量分發(fā)策略。

以開(kāi)屏廣告對(duì)接穿山甲和優(yōu)量匯兩個(gè)SDK為例，配置選擇80%流量穿山甲->優(yōu)量匯的順序請(qǐng)求，20%流量?jī)?yōu)量匯->穿山甲的順序請(qǐng)求，配置如下所示。

其中，suppliers字段下配置媒體在穿山甲和優(yōu)量匯平臺(tái)申請(qǐng)的廣告代碼位信息，rules字段下配置流量分發(fā)策略及比例；

策略JSON的配置說(shuō)明詳細(xì)見(jiàn)：SDK策略配置JSON說(shuō)明

不同廣告位的JSON策略配置示例見(jiàn)：不同廣告位JSON配置示例

{
  "rules": [
    {
      "tag": "A",
      "sort": [
        1,
        2
      ],
      "percent": 80
    },
    {
      "tag": "B",
      "sort": [
        2,
        1
      ],
      "percent": 20
    }
  ],
  "suppliers": [
    {
      "tag": "csj",
      "adspotId": "穿山甲廣告位ID",
      "appId": "穿山甲應(yīng)用ID",
      "index": 1
    },
    {
      "tag": "ylh",
      "adspotId": "優(yōu)量匯廣告位ID",
      "appId": "優(yōu)量匯應(yīng)用ID",
      "index": 2
    }
  ]
}

注：?為了方便開(kāi)發(fā)者配置流量分發(fā)策略，我們也提供了在線可視化的便捷工具EasyTools，方便生成廣告位的策略配置JSON。

2.3 獲取廣告

以下步驟，為獲取廣告的必要步驟，適用于所有廣告位。 不同廣告位置的不同實(shí)現(xiàn)，可參考Example示例；

2.3.1 獲取執(zhí)行策略

從SDK策略配置的JSON文件獲取分發(fā)策略并轉(zhuǎn)換成NSDictionary，可參考Demo中的AdDataJsonManager文件

- (NSDictionary *)loadAdDataWithJsonName:(NSString *)jsonName {
    if (!jsonName) {
        return nil;
    }
    
    @try {
        NSString *path = [[NSBundle mainBundle] pathForResource:jsonName ofType:@"json"];
        NSData *data = [[NSData alloc] initWithContentsOfFile:path];
        
        return [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableContainers error:nil];

    } @catch (NSException *exception) {}
}

2.3.2 使用執(zhí)行策略初始化廣告對(duì)象

使用獲取的執(zhí)行策略初始化廣告對(duì)象EasyAdXXX，以開(kāi)屏為例

EasyAdSplash *splashAd = [[EasyAdSplash alloc] initWithJsonDic:self.dic viewController:self];

2.3.3 設(shè)置代理

splashAd.delegate = self

2.3.4 設(shè)置其他屬性(可選)

App根據(jù)自生需要設(shè)置以下參數(shù)

// 是否必須展示Logo 默認(rèn): NO 注意: 強(qiáng)制展示Logo可能會(huì)影響收益 !!!
splashAd.showLogoRequire = YES;
// App logo圖片
splashAd.logoImage = [UIImage imageNamed:@"app_logo"];
// 開(kāi)屏廣告未加載完成時(shí),所展示的背景圖(建議設(shè)置為啟動(dòng)頁(yè)圖片)
splashAd.delegate.backgroundImage = [UIImage imageNamed:@"LaunchImage_img"];
// 超時(shí)時(shí)間
splashAd.delegate.timeout = 5;

2.3.5 調(diào)用獲取廣告

方式一：請(qǐng)求并展示廣告。

[splashAd loadAndShowAd];

方式二：先發(fā)起請(qǐng)求廣告：

[splashAd loadAd];

待廣告成功拉取后，開(kāi)發(fā)者可根據(jù)業(yè)務(wù)需求在合適的時(shí)機(jī)，決定調(diào)用展示廣告方法。(注意：廣告會(huì)存在有效期，過(guò)久未調(diào)用展示，會(huì)導(dǎo)致廣告失效)

[splashAd  showAd];

2.3.4 各廣告位集成實(shí)現(xiàn)

• 開(kāi)屏廣告：EasyAdSplash

• 插屏廣告：EasyAdInterstitial

• 橫幅廣告：EasyAdBanner

• 原生模板、信息流廣告：EasyAdNativeExpress

• 激勵(lì)視頻廣告：EasyAdRewardVideo

• 全屏視頻廣告：EasyAdFullScreenVideo

3. SDK錯(cuò)誤碼 & 常見(jiàn)問(wèn)題

調(diào)試遇到問(wèn)題？歡迎查詢SDK錯(cuò)誤碼及常見(jiàn)問(wèn)題FAQ，幫助你快速解決對(duì)接中遇到的問(wèn)題。

SDK錯(cuò)誤碼

常見(jiàn)問(wèn)題