Menyiapkan akses langsung untuk Ad Exchange

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

Prasyarat

Mengonfigurasi aplikasi untuk mengakses Ad Exchange

Tambahkan ID aplikasi Ad Manager Anda (dapat dilihat di UI Ad Manager) 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 untuk menambahkan tag <meta-data> seperti yang ditunjukkan di atas akan mengakibatkan error dengan pesan:

Missing application ID.

Selanjutnya, Anda dapat melakukan inisialisasi Google Mobile Ads SDK dan memilih format iklan yang akan ditampilkan. Bagian selanjutnya dalam panduan ini menerapkan format banner untuk menggambarkan cara memuat iklan dari Ad Exchange. 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 depan di akhir, di aplikasi Anda sebagai pengganti ID unit iklan.

Misalnya, untuk memuat iklan banner dengan menempatkan AdManagerAdView dalam tata letak untuk Activity sebagai berikut:

# main_activity.xml
...
  <com.google.android.gms.ads.admanager.AdManagerAdView
      xmlns:ads="http://schemas.android.com/apk/res-auto"
      android:id="@+id/adManagerAdView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerHorizontal="true"
      android:layout_alignParentBottom="true"
      ads:adSize="BANNER"
      ads:adUnitId="ca-mb-app-pub-5629679302779023/">
  </com.google.android.gms.ads.admanager.AdManagerAdView>

Perhatikan bahwa kegagalan untuk menambahkan garis miring depan di akhir kode properti web Ad Exchange seperti yang ditunjukkan di atas akan menyebabkan error permintaan iklan dengan pesan:

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

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

Atau, Anda dapat membuat AdManagerAdView secara terprogram:

JavaKotlin
AdManagerAdView adView = new AdManagerAdView(this);

adView.setAdSizes(AdSize.BANNER);
adView.setAdUnitId("ca-mb-app-pub-5629679302779023/");

// TODO: Add adView to your view hierarchy.

val adView = AdManagerAdView(this)

adView.adSizes = AdSize.BANNER
adView.adUnitId = "ca-mb-app-pub-5629679302779023/"

// TODO: Add adView to your view hierarchy.

Setelah AdManagerAdView diterapkan, Anda dapat memanggil metode loadAd() di class AdManagerAdView dan menyesuaikan perilaku iklan menggunakan peristiwa iklan.

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:

(Khusus penayang dari Eropa yang disetujui) Menambahkan harga minimum

Anda dapat mengirimkan permintaan untuk fitur "Harga minimum".

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

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

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();

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

val request = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class::java, extras)
    .build();