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

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

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

広告の設置 ¶

Viewの作成 ¶

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

広告の取得 ¶

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

objective-c

#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

swift

import UIKit
import AdstirAds;

class ViewController: UIViewController, AdstirNativeAdDelegate, AdstirNativeVideoViewDelegate {

    var nativead: AdstirNativeAd?
    var nativeadResponse: AdstirNativeAdResponse?
    var adstirNativeVideoView: AdstirNativeVideoView?

    @IBOutlet var titleLabel: UILabel!
    @IBOutlet var textLabel: UILabel!
    @IBOutlet var sponsoredLabel: UILabel!
    @IBOutlet var imageView: UIImageView!
    @IBOutlet var iconView: UIImageView!
    @IBOutlet var ctaButton: UIButton!
    @IBOutlet var optoutButton: UIButton!
    @IBOutlet var videoView: UIView!

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        // インスタンス生成
        self.nativead = AdstirNativeAd()
        self.nativead?.media = "メディアID"
        self.nativead?.spot = 枠No

        // ガイドラインで規定されているスポンサー表記を実装した通りに設定してください
        self.nativead?.sponsoredText = "スポンサー表記"

        // 広告枠登録時に設定した広告要素が配信されます
        // 広告レスポンスを受け取るDelegateを設定します
        self.nativead?.delegate = self
        // ネイティブ動画のViewを作成します
        self.adstirNativeVideoView = AdstirNativeVideoView()
        self.adstirNativeVideoView?.frame = self.videoView.frame
        self.videoView.addSubview(self.adstirNativeVideoView!)

        // ネイティブ広告を読み込みます
        self.nativead?.getAd()
    }

    // MARK: AdstirNativeAdDelegateの実装
    func adstirNativeAdDidReceive(_ nativeAd: AdstirNativeAd, response: AdstirNativeAdResponse) {
        // 広告レスポンスが正常に取得できた時に行う処理を実装します
        // AdstirNativeAdDelegateのメソッドはすべてバックグラウンドスレッドで動作します
        self.nativeadResponse = response
        DispatchQueue.main.async {
            // タイトルを設定します。
            self.titleLabel.text = response.title;
            // 説明文を設定します
            self.textLabel.text = response.descriptionText;
            // 広告であることを表示します
            self.sponsoredLabel.text = nativeAd.sponsoredText;
            // CTAボタンにCTAテキストを設定します
            self.ctaButton.setTitle(response.cta, for: .normal)
            // アイコン画像をImageViewに設置します
            response.bindSmallImage(to: self.iconView)
            // バナー画像をImageViewに設置します
            response.bindImage(to: self.imageView)
            // オプトアウトボタンにオプトアウト画像を設定できます。
            response.bindOptoutImage(to: self.optoutButton)

            // ネイティブ動画のdelegatを設定します
            self.adstirNativeVideoView?.delegate = self;
            // ネイティブ動画広告をviewに読み込みます
            self.adstirNativeVideoView?.load(response.adstirNativeVideoAd)
        }

        // 広告を表示するときにimpressionを呼び出します
        response.impression()
    }

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

    // MARK: AdstirNativeVideoViewDelegateの実装
    /** 動画の読み込み成功時に呼び出されます */
    func adstirNativeVideoDidLoad(_ nativeVideoView: AdstirNativeVideoView) {
    }

    /** 動画の再生準備に失敗した際に呼び出されます */
    func adstirNativeVideo(_ nativeVideoView: AdstirNativeVideoView, didFailToLoadWithError error: Error) {
    }

    /** 動画再生開始時に呼び出されます */
    func adstirNativeVideoDidStart(_ nativeVideoView: AdstirNativeVideoView) {
    }

    /** 動画停止時に呼び出されます */
    func adstirNativeVideoDidStop(_ nativeVideoView: AdstirNativeVideoView) {
    }

    /** 動画再生完了時に呼び出されます */
    func adstirNativeVideoDidFinishPlayback(_ nativeVideoView: AdstirNativeVideoView) {
    }

    /** 動画の再生に失敗した際に呼び出されます */
    func adstirNativeVideo(_ nativeVideoView: AdstirNativeVideoView, didFailToPlaybackWithError error: Error) {
    }

    // MARK: ボタンの実装
    @IBAction func adClick(sender:AnyObject) {
        // 広告がクリックされたときはclickを呼び出します
        self.nativeadResponse?.click()
    }

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

ライブラリ詳細 ¶

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

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

広告の設置¶

Viewの作成¶

広告の取得¶

ライブラリ詳細¶

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

広告の設置 ¶

Viewの作成 ¶

広告の取得 ¶

ライブラリ詳細 ¶