Menambahkan Banner dan Iklan Persegi Sedang ke Aplikasi iOS

Audience Network memungkinkan Anda memonetisasi aplikasi iOS Anda dengan iklan Facebook. Panduan ini menjelaskan cara membuat aplikasi iOS yang menampilkan iklan banner dan persegi sedang.

Jika Anda tertarik dengan jenis unit iklan lain, lihat daftar jenis yang tersedia.

Langkah-langkah Iklan Banner dan Persegi Sedang

Mari kita terapkan penempatan iklan banner berikut ini.

Langkah 1: Muat dan Tampilkan Tampilan Iklan

Langkah 2: Verifikasi Pencatatan Impresi dan Klik

Langkah 3: Cara Melakukan Debug Saat Iklan Tidak Ditampilkan

Langkah 4: Uji Integrasi Iklan

Langkah 1: Muat dan Tampilkan Tampilan Iklan

1. Setelah Anda membuat proyek baru dari panduan Memulai iOS, buka Main.storyboard. Tambahkan elemen UIView ke elemen Tampilan utama dan beri nama adContainer.
   
2. Sekarang, di file header Pengontrol Tampilan Anda (atau file Swift, jika Anda adalah pengguna Swift), impor FBAudienceNetwork, nyatakan kesesuaian dengan protokol FBAdViewDelegate, dan tambahkan variabel instance untuk unit iklan
   SwiftObjective-C

   import UIKit
   import FBAudienceNetwork
   
   class ViewController: UIViewController, FBAdViewDelegate {
   
     @IBOutlet private var adContainer: UIView!
   
     private var adView: FBAdView?
   }

   #import <UIKit/UIKit.h>
   @import FBAudienceNetwork;
   
   @interface ViewController : UIViewController <FBAdViewDelegate>
   
   @property (nonatomic, weak) IBOutlet UIView *adContainer;
   @property (nonatomic, strong) FBAdView *adView;
   
   @end


3. Tambahkan kode di bawah ini ke viewDidLoad; Buatlah instance baru dari FBAdView dan tambahkan ke tampilan. FBAdView adalah subkelas dari UIView. Anda dapat menambahkannya ke hierarki tampilan Anda seperti tampilan lainnya.
   SwiftObjective-C

   override func viewDidLoad() {
     super.viewDidLoad()
   
     // Instantiate an AdView object.
     // NOTE: the placement ID will eventually identify this as your app, you can ignore while you
     // are testing and replace it later when you have signed up.
     // While you are using this temporary code you will only get test ads and if you release
     // your code like this to the App Store your users will not receive ads (you will get a 'No Fill' error).
     let adView = FBAdView(placementID: "YOUR_PLACEMENT_ID", adSize: kFBAdSizeHeight50Banner, rootViewController: self)
     adView.frame = CGRect(x: 0, y: 0, width: 320, height: 250)
     adView.delegate = self
     adView.loadAd()
     self.adView = adView
   }

   - (void)viewDidLoad
   {
     [super viewDidLoad];
     // Instantiate an AdView object. 
     // NOTE: the placement ID will eventually identify this as your App, you can ignore it for
     // now, while you are testing and replace it later when you have signed up.
     // While you are using this temporary code you will only get test ads and if you release
     // your code like this to the App Store your users will not receive ads (you will get a no fill error).
     self.adView = [[FBAdView alloc] initWithPlacementID:@"YOUR_PLACEMENT_ID" adSize:kFBAdSizeHeight50Banner rootViewController:self];
     self.adView.frame = CGRectMake(0, 0, 320, 250);
     self.adView.delegate = self;
     [self.adView loadAd];
   }
   Untuk menambahkan iklan Persegi Sedang, Anda hanya perlu menyediakan kFBAdSizeHeight250Rectangle di parameter adSize ke FBAdView.
   
   Audience Network mendukung tiga ukuran iklan untuk digunakan di FBAdView Anda. Lebar unit fleksibel dengan minimum 320 px, dan hanya tinggi yang ditentukan.
   
   

   Format Iklan	Referensi AdSize	Ukuran	Rekomendasi
   Persegi Sedang	kFBAdSizeHeight 250Rectangle	300 x 250	Format ini sangat direkomendasikan karena memberikan kinerja yang lebih baik, kualitas yang lebih tinggi, dan CPU yang lebih efisien
   Banner Standar	kFBAdSizeHeight 50Banner	320 x 50	Format ini cocok untuk ponsel, tetapi tidak direkomendasikan karena kinerja dan kualitas yang buruk
   Banner Besar	kFBAdSizeHeight 90Banner	320 x 90	Format ini cocok untuk tablet dan perangkat yang lebih besar, tetapi tidak direkomendasikan karena kinerja dan kualitas yang buruk

4. Ganti YOUR_PLACEMENT_ID dengan string id penempatan Anda sendiri. Jika Anda tidak memiliki id penempatan atau tidak tahu cara mendapatkannya, baca halaman Panduan Memulai. Pilih target build Anda menjadi perangkat dan jalankan kode di atas, Anda akan melihat tampilan seperti ini:
   
   
   
   

Langkah 2: Verifikasi Pencatatan Impresi dan Klik

Secara opsional, Anda dapat menambahkan fungsi berikut untuk menangani kasus-kasus ketika iklan ditutup atau ketika pengguna mengkliknya:

func adViewDidClick(_ adView: FBAdView) {
  print("Ad was clicked.")
}

func adViewDidFinishHandlingClick(_ adView: FBAdView) {
  print("Ad did finish click handling.")
}

func adViewWillLogImpression(_ adView: FBAdView) {
  print("Ad impression is being captured.")
}

- (void)adViewDidClick:(FBAdView *)adView
{
  NSLog(@"Ad was clicked.");
}

- (void)adViewDidFinishHandlingClick:(FBAdView *)adView
{
  NSLog(@"Ad did finish click handling.");
}

- (void)adViewWillLogImpression:(FBAdView *)adView
{
  NSLog(@"Ad impression is being captured.");
}

Langkah 3: Cara Melakukan Debug Saat Iklan Tidak Ditampilkan

Tambahkan dan terapkan dua fungsi delegasi berikut ini di Pengontrol Tampilan Anda untuk menangani kegagalan pemuatan iklan:

func adView(_ adView: FBAdView, didFailWithError error: Error) {
  print("Ad failed to load with error: \(error.localizedDescription)")
}

func adViewDidLoad(_ adView: FBAdView) {
  print("Ad was loaded and ready to be displayed")
  showAd()
}

private func showAd() {
  guard let adView = adView, adView.isAdValid else {
    return
  }
  adContainer.addSubview(adView)
}

- (void)adView:(FBAdView *)adView didFailWithError:(NSError *)error
{
  NSLog(@"Ad failed to load with error: %@", error);
}

- (void)adViewDidLoad:(FBAdView *)adView
{
  NSLog(@"Ad was loaded and ready to be displayed");
  [self showAd];
}

- (void)showAd
{
  if (self.adView && self.adView.isAdValid) {
    [self.adContainer addSubview:self.adView];
  }
}