完成串接準備

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

將 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;
建立 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 種串流外的影音廣告介面，分別為：
  InScrollView
  InTableView
  
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;
建立 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;
建立 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:@[]];
完成廣告初始化後，您可以實作以下函數監聽廣告狀態：
- (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(@"影片離開全屏");
Sample Code
如果您想看到完整的串接實例，請參考我們的 Sample Code
其它廣告形式
如果您想了解其它廣告形式的串接，請參考以下內容：