Menyiapkan akses langsung untuk Ad Exchange

Pilih platform: Android Baru dipilih Android iOS

Google Mobile Ads SDK mendukung monetisasi aplikasi Anda dengan properti Ad Exchange. Panduan ini menunjukkan cara mengonfigurasi aplikasi Anda untuk semua format iklan yang didukung oleh Ad Exchange.

Prasyarat

Mengonfigurasi aplikasi Anda untuk mengakses Ad Exchange

Tambahkan ID aplikasi Ad Manager Anda (dapat dilihat di Ad Manager UI) ke file AndroidManifest.xml aplikasi melalui tag <meta-data> dengan android:name="com.google.android.gms.ads.APPLICATION_ID". Untuk android:value, masukkan ID aplikasi Ad Manager Anda sendiri, dalam tanda petik.

<manifest>
    <application>
        <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

Perhatikan juga bahwa kegagalan menambahkan tag <meta-data> seperti yang ditunjukkan di atas akan menyebabkan error dengan pesan:

Missing application ID.

Selanjutnya, Anda dapat melakukan inisialisasi Google Mobile Ads SDK dan memilih format iklan untuk ditampilkan. Bagian selanjutnya dari panduan ini menerapkan format banner untuk mengilustrasikan cara memuat iklan dari Ad Exchange. Langkah-langkah yang sama dapat diterapkan ke format iklan apa pun yang didukung oleh Google Mobile Ads SDK.

Memuat iklan dari Ad Exchange

Anda dapat menggunakan kode properti web Ad Exchange dengan garis miring di akhir, sebagai pengganti ID unit iklan. Misalnya, ca-mb-app-pub-5629679302779023/.

Contoh berikut menambahkan kode properti web Ad Exchange ke permintaan iklan banner:

Kotlin 

val adRequest = BannerAdRequest.Builder("ca-mb-app-pub-5629679302779023/", AdSize.BANNER).build()

BannerAd.load(
  adRequest,
  object : AdLoadCallback<BannerAd> {
    override fun onAdLoaded(ad: BannerAd) {
      bannerAd = ad
      activity?.runOnUiThread {
        binding.bannerViewContainer.addView(ad.getView(requireActivity()))
      }
    }
  }
)

Java 

BannerAdRequest adRequest = new BannerAdRequest.Builder("ca-mb-app-pub-5629679302779023/",
    AdSize.BANNER).build();

BannerAd.load(
    adRequest,
    new AdLoadCallback<BannerAd>() {
      @Override
      public void onAdLoaded(@NonNull BannerAd ad) {
        bannerAd = ad;
        runOnUiThread(
            () -> binding.bannerViewContainer.addView(ad.getView(MainActivity.this)));
      }
    });

Perhatikan bahwa kegagalan menambahkan garis miring di akhir ke kode properti web Ad Exchange akan menyebabkan error permintaan iklan dengan pesan:

Invalid Request. Cannot determine request type. Is your ad unit id correct?

Anda juga dapat mengonversi kode properti web Ad Exchange menjadi unit iklan. Setelah itu, gunakan UI Ad Manager untuk membuat Tag Ad Exchange dan salin ke aplikasi Anda. Tag yang dibuat harus memiliki kode properti web Ad Exchange, diikuti dengan ID unit iklan turunan tanpa garis miring di akhir, misalnya: ca-mb-app-pub-5629679302779023/banner.

Selesai! Aplikasi Anda kini siap memuat dan menampilkan iklan banner dari Ad Exchange.

Selain itu, Anda dapat menggunakan properti web Ad Exchange untuk memuat dan menampilkan format iklan lain dari Ad Exchange dengan mengikuti panduan masing-masing:

(Hanya untuk penayang dari Eropa yang disetujui) Menambahkan harga minimum

Anda dapat mengirimkan permintaan untuk fitur "Harga minimum".

Setelah disetujui, Anda dapat menyertakan harga minimum publik atau harga minimum pribadi dalam permintaan iklan menggunakan parameter pubf dan pvtf. Dalam contoh kode berikut, ganti "123" dengan harga minimum dalam mikro dan mata uang default jaringan Anda. Contoh cara mikro diterapkan: jika mata uang default Anda adalah USD, memasukkan "6000000" setara dengan $6,00.

Kotlin

val extras = Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

val request = AdRequest.Builder("ca-mb-app-pub-5629679302779023/")
    .setGoogleExtrasBundle(extras)
    .build();

Java 

Bundle extras = new Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

AdRequest request = new AdRequest.Builder("ca-mb-app-pub-5629679302779023/")
    .setGoogleExtrasBundle(extras)
    .build();