概要

Vpon Out-stream 影音廣告提供串流外的影音廣告服務，透過將影音廣告嵌入應用程式內容之間，以原生方式呈現廣告，同時預設為靜音播放，基於使用者體驗的考量，不影響使用者的閱讀狀態。

完成串接準備

在開始串接廣告之前，請確認您已經完成以下準備：

將 Vpon SDK 導入您的 Xcode 專案中，若您尚未完成，請先參考串接說明完成相關設定
聯繫 Vpon PDMKT Team 完成帳號設定，並取得您的 License Key

開始撰寫 Out-stream 影音廣告

請參考以下說明，在應用程式中在自定義的位置上建立 Out-stream 影音廣告：

Import VpadnSDKAdKit
在應用程式的 ViewController 中宣告 VpadnInReadAd
建立 VpadnInReadAd 物件，並指定 License Key
拉取廣告
展示廣告
實作 Delegate Protocol

請參考以下範例，完成 Out-stream 影音廣告設定：

Import VpadnSDKAdKit 並宣告 VpadnInReadAd

@import VpadnSDKAdKit;

@interface VponSdkVastCustomAdViewController () <VpadnInReadAdDelegate>

@property (nonatomic, weak) IBOutlet UIView *videoLoadedView;

// 宣告 VpadnInReadAd
@property (nonatomic, strong) VpadnInReadAd *VpadnInReadAd;

@end

建立 VpadnInReadAd 物件後指定 License Key，再拉取廣告

- (void) requestVpadnInReadAd {
    // 請將 License Key 換成 Vpon PDMKT Team 提供您的 License Key
    _VpadnInReadAd = [[VpadnInReadAd alloc] initWithPlacementId:@"License Key" delegate:self];

    // 拉取廣告
    [_VpadnInReadAd loadAdWithTestIdentifiers:@[]];
}

展示廣告

您可以實作 Delegate Protocol，透過 videoView() 取得廣告後，將廣告加到您想呈現廣告的位置上：

#pragma mark - VpadnInReadAd Delegate

- (void) VpadnInReadAdDidLoad:(VpadnInReadAd *)ad {
    UIView *videoView = [ad videoView];
    [_videoLoadedView addSubview:videoView];
    
    videoView.translatesAutoresizingMaskIntoConstraints = NO;
    
    [_videoLoadedView addConstraints:[NSLayoutConstraint constraintsWithVisualFormat:@"V:|-0-[videoView]-0-|" options:0 metrics:nil views:@{@"videoView":videoView}]];
    [_videoLoadedView addConstraints:[NSLayoutConstraint constraintsWithVisualFormat:@"H:|-0-[videoView]-0-|" options:0 metrics:nil views:@{@"videoView":videoView}]];
}

Interface for Out-stream 影音廣告

此外，Vpon Out-stream 影音串流廣告提供 3 種串流外的影音廣告介面，分別為：

請依您的需求選擇放置 Out-stream 影音廣告的介面。

在 InScrollView 中展示 Out-stream 影音廣告

在應用程式中的 ScrollView 建立 Out-stream 影音廣告需要執行以下步驟：

Import VpadnSDKAdKit
在應用程式的 ViewController 中宣告 VpadnInReadAd
建立 VpadnInReadAd 物件，並指定 License Key
拉取廣告
實作 Delegate Protocol

請參考以下範例，完成 Out-stream 影音廣告設定：

Import VpadnSDKAdKit 並宣告 VpadnInReadAd

@import VpadnSDKAdKit;

@interface VponSdkVastInScrollViewController () <VpadnInReadAdDelegate>

// 宣告要呈現廣告的 View
@property (nonatomic, weak) IBOutlet UIView *inScrollLoadedView;

// 宣告用來調整廣告起始高度的 Constraint
@property (nonatomic, weak) IBOutlet NSLayoutConstraint *inScrollHeightConstraint;

// 宣告要放置廣告的 ScrollView
@property (nonatomic, weak) IBOutlet UIScrollView *inScrollView;

// 宣告 VpadnInReadAd
@property (nonatomic, strong) VpadnInReadAd *VpadnInReadAd;

@end

建立 VpadnInReadAd 物件後指定 License Key，再拉取廣告

- (void) requestVpadnInReadAd {
    // 請將 License Key 換成 Vpon PDMKT Team 提供您的 License Key
    _VpadnInReadAd = [[VpadnInReadAd alloc] initWithPlacementId:@"License Key" placeholder:_inScrollLoadedView heightConstraint:_inScrollHeightConstraint scrollView:_inScrollView delegate:self];
    
    // 拉取廣告
    [_VpadnInReadAd loadAdWithTestIdentifiers:@[]];
}

在 InTableView 中展示 Out-stream 影音廣告

在應用程式中的 TableView 建立 Out-stream 影音廣告需要執行以下步驟：

Import VpadnSDKAdKit
在應用程式的 ViewController 中宣告 VpadnInReadAd
建立 VpadnInReadAd 物件，並指定 License Key
拉取廣告
實作 Delegate Protocol

請參考以下範例，完成 Out-stream 影音廣告設定：

Import VpadnSDKAdKit 並宣告 VpadnInReadAd

@import VpadnSDKAdKit;

@interface VponSdkVastInTableViewController () <UITableViewDelegate, UITableViewDataSource, VpadnInReadAdDelegate>

// 宣告要放置廣告的 TableView
@property (nonatomic, weak) IBOutlet UITableView *tableView;

// 宣告 VpadnInReadAd
@property (nonatomic, strong) VpadnInReadAd *VpadnInReadAd;

@end

建立 VpadnInReadAd 物件後指定 License Key，再拉取廣告

- (void) requestVpadnInReadAd {
    // 請將 License Key 換成 Vpon PDMKT Team 提供您的 License Key
    // 修改 insertionIndexPath 參數來指定廣告嵌入的位置
    _VpadnInReadAd = [[VpadnInReadAd alloc] initWithPlacementId:@"License Key" insertionIndexPath:[NSIndexPath indexPathForRow:0 inSection:0] tableView:_tableView delegate:self];

    // 拉取廣告
    [_VpadnInReadAd loadAdWithTestIdentifiers:@[]];
}

實作 Delegate Protocol

完成廣告初始化後，您可以實作以下函數監聽廣告狀態：

- (void)vpadnInReadAd:(VpadnInReadAd *)ad didFailLoading:(NSError *)error {
	NSLog(@"廣告抓取失敗");	
}

- (void)vpadnInReadAdDidLoad:(VpadnInReadAd *)ad {
	NSLog(@"廣告抓取成功");
}

- (void)vpadnInReadAdDidStart:(VpadnInReadAd *)ad {
	NSLog(@"影片開始播放");
}

- (void)vpadnInReadAdDidStop:(VpadnInReadAd *)ad {
	NSLog(@"影片播放結束");
}

- (void)vpadnInReadAdDidMute:(VpadnInReadAd *)ad {
	NSLog(@"影片靜音");
}

- (void)vpadnInReadAdDidUnmute:(VpadnInReadAd *)ad {
	NSLog(@"影片取消靜音");
}

- (void)vpadnInReadAdWasClicked:(VpadnInReadAd *)ad {
	NSLog(@"廣告被點擊");
}

- (void)vpadnInReadAdDidTakeOverFullScreen:(VpadnInReadAd *)ad {
	NSLog(@"影片全屏");
}

- (void)vpadnInReadAdDidDismissFullscreen:(VpadnInReadAd *)ad {
	NSLog(@"影片離開全屏");
}

iOS - Out-stream 影音廣告

概要

完成串接準備

開始撰寫 Out-stream 影音廣告

Import VpadnSDKAdKit 並宣告 VpadnInReadAd

建立 VpadnInReadAd 物件後指定 License Key，再拉取廣告

展示廣告

Interface for Out-stream 影音廣告

在 InScrollView 中展示 Out-stream 影音廣告

Import VpadnSDKAdKit 並宣告 VpadnInReadAd

建立 VpadnInReadAd 物件後指定 License Key，再拉取廣告

在 InTableView 中展示 Out-stream 影音廣告

Import VpadnSDKAdKit 並宣告 VpadnInReadAd

建立 VpadnInReadAd 物件後指定 License Key，再拉取廣告

實作 Delegate Protocol

Tips

Sample Code

其它廣告形式