ネイティブ動画広告の導入

メディアのコンテンツにマッチしたレイアウトで動画広告も掲載できるネイティブ広告です。 動画広告が案件切れの場合はAdstirNativeVideoViewにバナー画像が表示されます。

こちらの変更履歴をご覧になってから導入を開始してください。

ネイティブ動画をご利用される場合は営業担当にご相談ください。

adstir SDK v2.14.3 より、iOS 9未満の端末には動画の配信がされず、代わりにバナー画像が表示されます。

必要条件

XCode 9.0以上 iOS 8.1以上

初期設定

初期設定をご覧ください。

広告の設置

Viewの作成

Viewの作成に関しては、ご自由に実装して頂いて構いません。
実装方法に制限はありません。Layout XML・Javaコード以外の実装方法でも問題ありません。
ただし、作成したViewは、ネイティブ広告ガイドラインに従っている必要があります。　　

広告の取得

viewDidLoad等で広告のリクエストおよびレスポンスの処理を設定します。
このコードは実装の全体をつかむためのサンプルですので、この通りに実装しても動作しません。
実際に広告を実装する際は、ライブラリ詳細の項目をよく確認して必要なパラメータの設定及び処理を記述する必要があります。
各メソッドの詳細はAPIリファレンスをご覧ください。

#import "FooViewController.h"
@import AdstirAds;

@interface FooViewController () <AdstirNativeAdDelegate, AdstirNativeVideoViewDelegate>
@property (strong, nonatomic) AdstirNativeAd* nativead;
@property (strong, nonatomic) AdstirNativeAdResponse* nativeadResponse;
@property (strong, nonatomic) AdstirNativeVideoView* adstirNativeVideoView;

@property (weak, nonatomic) IBOutlet UILabel *titleLabel;
@property (weak, nonatomic) IBOutlet UILabel *textLabel;
@property (weak, nonatomic) IBOutlet UILabel *sponsoredLabel;
@property (weak, nonatomic) IBOutlet UIImageView *imageView;
@property (weak, nonatomic) IBOutlet UIImageView *iconView;
@property (weak, nonatomic) IBOutlet UIButton *ctaButton;
@property (weak, nonatomic) IBOutlet UIButton *optoutButton;

@property (weak, nonatomic) IBOutlet UIView *nativeView;
@end

@implementation FooViewController
- (void)viewDidLoad {
    [super viewDidLoad];
    // インスタンス生成
    self.nativead = [[[AdstirNativeAd alloc] init] autorelease];
    self.nativead.media = @"メディアID";
    self.nativead.spot = 枠No;
    // ガイドラインで規定されているスポンサー表記を実装した通りに設定してください
    self.nativead.sponsoredText = @"スポンサー表記";
    // 広告に必要な要素を要求するパラメーターは、設定する必要がなくなりました。広告枠登録時に設定した内容で配信されます
    // 広告レスポンスを受け取るDelegateを設定します
    self.nativead.delegate = self;

    // ネイティブ動画のViewを作成します
    self.adstirNativeVideoView = [[AdstirNativeVideoView alloc] init];
    self.adstirNativeVideoView.frame = self.nativeView.frame;
    [self.nativeView addSubview: self.adstirNativeVideoView];

    [self.nativead getAd];
}

/* AdstirNativeAdDelegateを実装 ここから */
- (void)adstirNativeAdDidReceiveAd:(AdstirNativeAd*)ad response:(AdstirNativeAdResponse*)response{
    // 広告レスポンスが正常に取得できた時に行う処理を実装します
    // AdstirNativeAdDelegateのメソッドはすべてバックグラウンドスレッドで動作します
    self.nativeadResponse = response;
    dispatch_sync(dispatch_get_main_queue(), ^(void){
        // タイトルを設定します。
        self.titleLabel.text = response.title;
        // 説明文を設定します
        self.textLabel.text = response.descriptionText;
        // 広告であることを表示します
        self.sponsoredLabel.text = ad.sponsoredText;
        // CTAボタンにCTAテキストを設定します
        [self.ctaButton setTitle:response.cta forState:UIControlStateNormal];
        // アイコン画像をImageViewに設置します
        [response bindSmallImageToImageView:self.iconView];
        // バナー画像をImageViewに設置します
        [response bindImageToImageView:self.imageView];
        // オプトアウトボタンにオプトアウト画像を設定できます。
        [response bindOptoutImageToButton:self.optoutButton];

        // ネイティブ動画広告をviewに読み込みます。
        [self.adstirNativeVideoView loadAd:response.adstirNativeVideoAd];
    });
    // 広告を表示するときにimpressionを呼び出します
    [response impression];
}

- (void)adstirNativeAdDidFailToReceiveAd:(AdstirNativeAd*)ad{
    // 広告レスポンスが正常に取得できなかった時に行う処理を実装します
    // AdstirNativeAdDelegateのメソッドはすべてバックグラウンドスレッドで動作します

}
/* AdstirNativeAdDelegateを実装 ここまで */

/* AdstirNativeVideoViewDelegateを実装 ここから */
/**
 動画の読み込み成功時に呼び出されます
 */
- (void)adstirNativeVideoDidLoad:(AdstirNativeVideoView * __asadnonnull)nativeVideoView
{
    NSLog(@"%s", __PRETTY_FUNCTION__);
}

/**
 動画の再生準備に失敗した際に呼び出されます
 */
- (void)adstirNativeVideo:(AdstirNativeVideoView * __asadnonnull)nativeVideoView didFailToLoadWithError:(NSError * __asadnonnull)error
{
    NSLog(@"%s", __PRETTY_FUNCTION__);
}

/**
 動画再生開始時に呼び出されます
 */
- (void)adstirNativeVideoDidStart:(AdstirNativeVideoView * __asadnonnull)nativeVideoView
{
    NSLog(@"%s", __PRETTY_FUNCTION__);
}

/**
 動画停止時に呼び出されます
 */
- (void)adstirNativeVideoDidStop:(AdstirNativeVideoView * __asadnonnull)nativeVideoView
{
    NSLog(@"%s", __PRETTY_FUNCTION__);
}

/**
 動画再生完了時に呼び出されます
 */
- (void)adstirNativeVideoDidFinishPlayback:(AdstirNativeVideoView * __asadnonnull)nativeVideoView
{
    NSLog(@"%s", __PRETTY_FUNCTION__);
}

/**
 動画の再生に失敗した際に呼び出されます
 */
- (void)adstirNativeVideo:(AdstirNativeVideoView * __asadnonnull)nativeVideoView didFailToPlaybackWithError:(NSError * __asadnonnull)error
{
    NSLog(@"%s", __PRETTY_FUNCTION__);
}
/* AdstirNativeVideoViewDelegateを実装 ここまで */

- (IBAction)adClick:(id)sender {
    // 広告がクリックされたときはclickを呼び出します
    [self.nativeadResponse click];
}

- (IBAction)optoutClick:(id)sender {
    // オプトアウトボタンがクリクされた時はclickOptoutを呼び出します
    [self.nativeadResponse clickOptout];
}

- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
}

- (void)dealloc {
    // デリゲートを解放します。
    self.nativead.delegate = nil;
    self.nativead = nil;
    self.nativeadResponse = nil;

    [self.adstirNativeVideoView removeFromSuperview];
    self.adstirNativeVideoView.delegate = nil;
    self.adstirNativeVideoView = nil;
}
@end

ライブラリ詳細

APIリファレンスをご覧ください。