Opsi iklan native

Parameter terakhir yang disertakan dalam pembuatan GADAdLoader adalah array objek opsional. Bagian ini menjelaskan opsi tersebut.

Swift

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ ... ad type constants ... ]
               options:@[ ... ad loader options objects ... ]];

GWSNativeAdImageAdLoaderOptions

GADNativeAdImageAdLoaderOptions berisi properti yang terkait dengan gambar di iklan native. Aplikasi dapat mengontrol cara GADAdLoader menangani aset gambar dengan membuat objek GADNativeAdImageAdLoaderOptions, menyetel propertinya (disableImageLoading, preferredImageOrientation, dan shouldRequestMultipleImages), dan meneruskannya selama inisialisasi.

GADNativeAdImageAdLoaderOptions memiliki properti berikut:

disableImageLoading
Aset gambar untuk iklan native ditampilkan melalui instance GADNativeAdImage, yang berisi properti image dan imageURL. Jika disableImageLoading ditetapkan ke false, yang merupakan default (NO di Objective-C), SDK akan mengambil aset gambar secara otomatis dan mengisi properti image dan imageURL untuk Anda. Jika ditetapkan ke true (atau YES di Objective-C), SDK hanya akan mengisi imageURL, sehingga Anda dapat mendownload gambar sebenarnya sesuai kebijaksanaan. Gunakan properti mainImage GADMediaContent guna menetapkan gambar untuk tampilan media saat mendownload gambar secara manual.
preferredImageOrientation

Beberapa materi iklan memiliki beberapa gambar yang tersedia agar cocok dengan orientasi perangkat. Aplikasi dapat meminta gambar untuk orientasi tertentu dengan menetapkan properti ini ke salah satu konstanta orientasi:

  • GADNativeAdImageAdLoaderOptionsOrientationAny
  • GADNativeAdImageAdLoaderOptionsOrientationLandscape

  • GADNativeAdImageAdLoaderOptionsOrientationPortrait

    Jika Anda menggunakan preferredImageOrientation untuk menentukan preferensi orientasi gambar lanskap atau potret, SDK akan menempatkan gambar yang cocok dengan orientasi tersebut terlebih dahulu dalam array aset gambar dan menempatkan gambar yang tidak cocok setelahnya. Karena beberapa iklan hanya akan memiliki satu orientasi yang tersedia, penayang harus memastikan bahwa aplikasi mereka dapat menangani gambar lanskap dan potret.

    Jika metode ini tidak dipanggil, nilai default GADNativeAdImageAdLoaderOptionsOrientationAny akan digunakan.

shouldRequestMultipleImages

Beberapa aset gambar akan berisi serangkaian gambar, bukan hanya satu. Dengan menyetel nilai ini ke benar, aplikasi Anda menunjukkan bahwa ia siap untuk menampilkan semua gambar untuk aset yang memiliki lebih dari satu. Dengan menetapkannya ke false (default), aplikasi Anda akan menginstruksikan SDK untuk hanya menyediakan gambar pertama untuk setiap aset yang berisi seri.

Jika tidak ada objek GADAdLoaderOptions yang diteruskan saat melakukan inisialisasi GADAdLoader, nilai default untuk setiap opsi akan digunakan.

GWSNativeAdViewAdOptions

Objek GADNativeAdViewAdOptions digunakan untuk menunjukkan preferensi terkait cara tampilan iklan native mewakili iklan. Mereka memiliki satu properti: preferredAdChoicesPosition, yang dapat Anda gunakan untuk menentukan lokasi tempat ikon AdChoices harus ditempatkan. Ikon dapat muncul di sudut mana pun pada iklan dan secara default mengikuti GADAdChoicesPositionTopRightCorner. Nilai yang memungkinkan untuk properti ini adalah:

  • GADAdChoicesPositionTopRightCorner
  • GADAdChoicesPositionTopLeftCorner
  • GADAdChoicesPositionBottomRightCorner
  • GADAdChoicesPositionBottomLeftCorner

Berikut adalah contoh yang menunjukkan cara menempatkan ikon AdChoices di sudut kiri atas iklan:

Swift

let adViewOptions = GADNativeAdViewAdOptions()
adViewOptions.preferredAdChoicesPosition = .topLeftCorner
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective-C

GADNativeAdViewAdOptions *adViewOptions = [[GADNativeAdViewAdOptions alloc] init];
adViewOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ...  ]
               options:@[ ... ad loader options objects ... ]];

GWSVideoOptions

Objek GADVideoOptions digunakan untuk menunjukkan cara aset video native ditampilkan.

Boolean startMuted menunjukkan apakah aset video harus memulai pemutaran dalam keadaan dibisukan. Nilai defaultnya adalah true.

Swift

let videoOptions = GADVideoOptions()
// Ads start muted by default. Set to false to start video ads with sound.
videoOptions.startMuted = false
adLoader = GADAdLoader(
    adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [videoOptions])

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
// Ads start muted by default. Set to NO to start video ads with sound.
videoOptions.startMuted = NO;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ... ]
               options:@[videoOptions]];

GADMultipleAdsAdLoaderOptions

Objek GADMultipleAdsAdLoaderOptions memungkinkan penayang menginstruksikan loader iklan untuk memuat beberapa iklan dalam satu permintaan. Iklan yang dimuat dengan cara ini dijamin unik. GADMultipleAdsAdLoaderOptions memiliki satu properti, numberOfAds, yang mewakili jumlah iklan yang harus dicoba oleh loader iklan untuk menampilkan permintaan. Secara default, nilai ini adalah satu, dan dibatasi hingga maksimum lima (meskipun aplikasi meminta lebih banyak iklan, maksimal lima akan ditampilkan). Jumlah iklan sebenarnya yang ditampilkan tidak dijamin, tetapi antara nol dan numberOfAds.

GWSNativeAdMediaAdLoaderOptions

Untuk menggunakan fitur ini, sertakan class GADNativeAdMediaAdLoaderOptions dalam array opsi iklan native dalam inisialisasi GADAdLoader.

Objek GADNativeAdMediaAdLoaderOptions memungkinkan Anda memilih preferensi rasio lebar tinggi media. Opsi ini berlaku untuk gambar dan video. Class ini memiliki satu properti: mediaAspectRatio, yang dapat Anda gunakan untuk menentukan rasio lebar tinggi media yang didukung. Nilai yang memungkinkan untuk properti ini adalah:

Objective-CSwift
GADMediaAspectRatioAny .any
GADMediaAspectRatioLandscape .landscape
GADMediaAspectRatioPortrait .portrait
GADMediaAspectRatioSquare .square

Menetapkan mediaAspectRatio ke salah satu opsi ini hanya akan menampilkan iklan dengan media dengan rasio lebar tinggi yang ditentukan. Jika properti ini tidak ditetapkan secara eksplisit, nilai akan ditetapkan secara default ke GADMediaAspectRatioUnknown dan tidak ada batasan pada rasio lebar tinggi yang akan diterapkan.