iOS 向けネイティブ広告インテグレーション

前提条件

ネイティブ広告の統合

1. ネイティブ広告オブジェクトの作成とロード
2. デリゲートの実装
3. ビューの設計とバインド
4. ネイティブ広告の表示
5. ネイティブ広告の破棄

1. LevelPlayNativeAdBuilder クラスを使用してネイティブの広告オブジェクトを作成します。このクラスでは、オブジェクトのカスタム設定が可能です。ネイティブ広告のロードメカニズムを 1 か所で管理するために、別のクラスを作成することをお勧めします。

   LevelPlayNativeAd *levelPlayNativeAd = [[[[LevelPlayNativeAdBuilder new] withViewController:self] withPlacementName:YOUR_配置_NAME] // 配置に置き換えるか、空にしておきますwithDelegate:self]	// We implement the delegate in step 2.build;

   let levelPlayNativeAd:LevelPlayNativeAd = LevelPlayNativeAdBuilder()            .withViewController(self)            .withPlacementName(YOUR_配置_NAME) // 配置に置き換えるか、空白のままにします。            .withDelegate(self)            .build()

   ロード処理には時間がかかる場合があるため、ユーザーに表示する直前にネイティブ広告を作成してください。短いスパンで連続して要求することは推奨されません。可用性が変更される可能性が低いためです。
2. 広告オブジェクトを構築したら、ネイティブ広告をロードし、NativeAdView タイプの新しいビューを作成します。デリゲートのdidLoadコールバックを通じて広告がロードされると通知されます**。

   [levelPlayNativeAd loadAd];NativeAdView *levelPlayNativeAdView = [[NativeAdView alloc] init];

   levelPlayNativeAd.load()let levelPlayNativeAdView = NativeAdView()

   ネイティブ広告とそれに対応するビューへの参照を維持することを推奨します。これらの参照は didLoad コールバックがトリガーされた後にビューに読み込むために使用されます。

   @プロパティ（非アトミック、強） LevelPlayNativeAd *nativeAd;@プロパティ （非アトミック、強力） NativeAdView *nativeAdView; //ステップ 3 で NativeAdView を定義します

   private var nativeAd:LevelPlayNativeAd!private var nativeAdView:NativeAdView! //ステップ 3 で NativeAdView を定義します

   これらの参照は、広告がロードされビューが初期化された後も維持してください。

      _nativeAd = levelPlayNativeAd;   _nativeAdView = levelPlayNativeAdView;

     nativeAd = levelPlayNativeAd      nativeAdView = levelPlayNativeAdView

ステップ 2. デリゲートの実装

// LevelPlayNativeAdDelegate/** ネイティブ広告が正常にロードされた後に呼び出されます。 @param nativeAd Level ネイティブ広告の再生。 @param adInfo 広告の情報。 */-(void)didLoad:(LevelPlayNativeAd *)nativeAd    withAdInfo:(ISAdInfo *)adInfo{}/** ネイティブが広告のロードを試行したが失敗した後に呼び出されます。 @param nativeAd Level ネイティブ広告の再生。 @param error エラーの理由 */-(void)didFailToLoad:(LevelPlayNativeAd *)nativeAd           withError:(NSError *)error;{}/** ネイティブアドインプレッションが記録された後に呼び出されます。 @param nativeAd Level ネイティブ広告の再生。 @param adInfo 広告の情報。 */-(void)didRecordImpression:(LevelPlayNativeAd *)nativeAd                withAdInfo:(ISAdInfo *)adInfo{}/** ネイティブ広告がクリックされた後に呼び出されます。 @param nativeAd Level ネイティブ広告の再生。 @param adInfo 広告の情報。 */-(void)didClick:(LevelPlayNativeAd *)nativeAd     withAdInfo:(ISAdInfo *)adInfo;{}

// LevelPlayNativeAdDelegate/** ネイティブ広告が正常にロードされた後に呼び出されます。 @param nativeAd Level ネイティブ広告の再生。 @param adInfo 広告の情報。 */ func didLoad(_ nativeAd:LevelPlayNativeAd、adInfo あり：ISAdInfo) {}/** ネイティブが広告のロードを試行したが失敗した後に呼び出されます。 @param nativeAd Level ネイティブ広告の再生。 @param error エラーの理由 */    func didFail(_ nativeAd:LevelPlayNativeAd、withError エラー:Error) {} /** ネイティブアドインプレッションが記録された後に呼び出されます。 @param nativeAd Level ネイティブ広告の再生。 @param adInfo 広告の情報。 */   func didRecordImpression(_ nativeAd:LevelPlayNativeAd、adInfo あり：ISAdInfo) {}   /** ネイティブ広告がクリックされた後に呼び出されます。 @param nativeAd Level ネイティブ広告の再生。 @param adInfo 広告の情報。 */ func didClick(_ nativeAd:LevelPlayNativeAd、adInfo あり：ISAdInfo) {}

ステップ 3. ネイティブ広告ビューの設計とバインド

1. 以下のビュー (.xib) ファイルをダウンロードしてプロジェクトにインポートし、プロジェクトのターゲットに追加します。ファイルには、ネイティブの広告アセットを保持するビューが含まれています。インターフェースビルダーを使用して、アプリケーションのデザインに応じてコンポーネントをカスタマイズします。.xib ファイルの変更中は、事前に定義されたコンセントからコンポーネントを切断しないでください。デザインには以下のコンポーネントが含まれます。
   • ビュー 1: adAppIcon (UIImageView)
   • ビュー 2: adTitleView (UILabel)
   • ビュー 3: adAdvertiserView (UILabel)
   • ビュー 4: adBodyView (UILabel)
   • ビュー 5: adMediaView (カスタムクラス LevelPlayMediaView を持つ UIView) 
   • ビュー 6: adCallToActionView (UIButton)
2. UIView を継承してビューを表すカスタムクラスを作成します

   #import <IronSource/IronSource.h>@interface NativeAdView :UIView@プロパティ（非アトミック、高強度） ISNativeAdView *nativeAdView;- (void)populateWithContent:(nonnull LevelPlayNativeAd *)nativeAd;@end@implementation NativeAdView- (instancetype)init {    UINib *nib = [UINib nibWithNibName:@"ISNativeAdView" bundle:[NSBundle mainBundle]];        NSArray *nibContents = [nib instantiateWithOwner:nil options:nil];    self.nativeAdView = (NativeAdView *)[nibContents firstObject];    self.translatesAutoresizingMaskIntoConstraints = NO;    self.nativeAdView.translatesAutoresizingMaskIntoConstraints = NO;        // adding your own ad badge, privacy icon, or delete button here  // ...    return self;}// This function will be useful when the didLoad call back arrives- (void)populateWithContent:(nonnull LevelPlayNativeAd *)nativeAd {    // Assigning views contents to the nativeAdView    if (nativeAd.icon.image) {        self.nativeAdView.adAppIcon.image = nativeAd.icon.image;    } else {        [self.nativeAdView.adAppIcon removeFromSuperview];    }    if (nativeAd.title) {        self.nativeAdView.adTitleView.text = nativeAd.title;    }    if (nativeAd.advertiser) {        self.nativeAdView.adAdvertiserView.text = nativeAd.advertiser;    }    if (nativeAd.body) {        self.nativeAdView.adBodyView.text = nativeAd.body;    }    if (nativeAd.callToAction) {        [self.nativeAdView.adCallToActionView setTitle:nativeAd.callToAction forState:UIControlStateNormal];    // To ensure proper processing of touch events by the SDK, user interaction should be disabled        self.nativeAdView.adCallToActionView.userInteractionEnabled = NO;    }    // call function to register native ad    [self.nativeAdView registerNativeAdViews:nativeAd];}@end

   import UIKitimport IronSourceclass NativeAdView:UIView {    private var nativeAdView:ISNativeAdView!        override init(frame:CGRect) {        super.init(frame: frame)        let nib = UINib(nibName:"ISNativeAdView", bundle: .main)                let nibContents = nib.instantiate(withOwner: nil, options: nil)        self.nativeAdView = nibContents.first as?ISNativeAdView ??ISNativeAdView()                self.translatesAutoresizingMaskIntoConstraints = false        self.nativeAdView?.translatesAutoresizingMaskIntoConstraints = false                // adding your own ad badge, privacy icon, or delete button here        // ...        addSubview(nativeAdView)    }        必要な init?(コーダー:NSCoder) {        super.init(coder: coder)    }    // This function will be useful when the didLoad call back arrives    func populateWithContent(nativeAd:LevelPlayNativeAd) {        // Assigning views contents to the nativeAdView        if let iconImage = nativeAd.icon?.image {            nativeAdView.adAppIcon?.image = iconImage        } else {            nativeAdView.adAppIcon?.removeFromSuperview()        }        nativeAdView.adTitleView?.text = nativeAd.title        nativeAdView.adAdvertiserView?.text = nativeAd.advertiser        nativeAdView.adBodyView?.text = nativeAd.body        nativeAdView.adCallToActionView?.setTitle(nativeAd.callToAction, for: .normal)        nativeAdView.adCallToActionView?.isUserInteractionEnabled = false        // call function to register native ad        nativeAdView.registerNativeAdViews(nativeAd)    }}

MediaView

広告透明度の向上

ステップ 4. ネイティブ広告の表示

@プロパティ （weak、nonatomic） IBOutlet UIView *nativeAdContainer;

@IBOutlet weak var nativeAdContainer:UIView!

-(void)didLoad:(LevelPlayNativeAd *)nativeAd    withAdInfo:(ISAdInfo *)adInfo{        // Populate view        [_nativeAdView populateWithContent:nativeAd];            // Nest the native ad view in the container view        [_nativeAdContainer addSubview:_nativeAdView];            // Set the constraints between the container and native ad view        _nativeAdView.translatesAutoresizingMaskIntoConstraints = NO;        [NSLayoutConstraint activateConstraints:@[            [_nativeAdView.topAnchor constraintEqualToAnchor:_nativeAdContainer.topAnchor],            [_nativeAdView.leadingAnchor constraintEqualToAnchor:_nativeAdContainer.leadingAnchor],            [_nativeAdView.trailingAnchor constraintEqualToAnchor:_nativeAdContainer.trailingAnchor],            [_nativeAdView.bottomAnchor constraintEqualToAnchor:_nativeAdContainer.bottomAnchor]        ]];}

func didLoad(_ nativeAd:LevelPlayNativeAd、adInfo あり：ISAdInfo) {        // Populate view        nativeAdView.populateWithContent(nativeAd: nativeAd)                // Nest the native ad view in the container view        nativeAdContainer.addSubview(nativeAdView)                // Set the constraints between the container and native ad view        nativeAdView.translatesAutoresizingMaskIntoConstraints = false        NSLayoutConstraint.activate([            nativeAdView.topAnchor.constraint(equalTo: nativeAdContainer.topAnchor),            nativeAdView.leadingAnchor.constraint(equalTo: nativeAdContainer.leadingAnchor),            nativeAdView.trailingAnchor.constraint(equalTo: nativeAdContainer.trailingAnchor),            nativeAdView.bottomAnchor.constraint(equalTo: nativeAdContainer.bottomAnchor)        ])    }

ステップ 5.ネイティブ広告の破棄

[_nativeAd destroyAd];[_nativeAdView removeFromSuperview];

nativeAd.destroy()nativeAdView.removeFromSuperview()