Mengintegrasikan DT Exchange dengan Mediasi

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari DT Exchange menggunakan mediasi yang mencakup integrasi waterfall. Artikel ini membahas cara menambahkan DT Exchange ke konfigurasi mediasi unit iklan dan cara mengintegrasikan SDK dan adaptor DT Exchange ke dalam Android aplikasi.

Integrasi dan format iklan yang didukung

Adaptor AdMob mediasi untuk DT Exchange memiliki kemampuan berikut:

Integrasi
Bidding
Air terjun
Format
Banner
Interstisial
Diberikan sebagai reward
Native

Persyaratan

  • Android API level 19 atau yang lebih tinggi
  • Google Mobile Ads SDK terbaru

Langkah 1: Siapkan DT Exchange

Menambahkan aplikasi dan penempatan iklan baru

Daftar atau login ke DT Exchange Console.

Klik tombol Tambahkan Aplikasi untuk menambahkan aplikasi Anda.

Kelola Aplikasi

Pilih Android di bagian Platform, isi formulir lainnya, lalu klik Tambahkan Penempatan.

Masukkan nama untuk penempatan baru dalam kolom yang berlabel Beri nama Penempatan Anda, lalu pilih Jenis Penempatan yang diinginkan dari daftar dropdown. Terakhir, klik Save Placement.

Penyiapan

ID Aplikasi dan ID Penempatan

Buka menu navigasi sebelah kiri dengan mengarahkan mouse ke atasnya. Kemudian, klik Apps dari menu kiri.

Menu

Di halaman Pengelolaan Aplikasi, catat ID Aplikasi di samping aplikasi Anda.

ID Aplikasi

Pilih aplikasi, buka tab Penempatan, lalu klik ikon salin di samping Nama Penempatan. Catat ID Penempatan.

ID Penempatan

ID Penayang, Kunci Konsumen, dan Rahasia Konsumen

Klik nama pengguna dari menu kiri, lalu pilih User Profile.

Menu Profil Pengguna

Catat ID Penayang, Kunci Konsumen, dan Rahasia Konsumen karena ini diperlukan di langkah berikutnya.

Profil Pengguna

Langkah 2: Konfigurasikan setelan mediasi untuk AdMob unit iklan

Anda perlu menambahkan DT Exchange ke konfigurasi mediasi untuk unit iklan Anda.

Pertama, login ke akun AdMob. Selanjutnya, buka tab Mediasi. Jika Anda sudah memiliki grup mediasi yang ingin diubah, klik nama grup mediasi tersebut untuk mengeditnya dan langsung lanjutkan ke Menambahkan DT Exchange sebagai sumber iklan.

Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.

Tab mediasi AdMob

Masukkan format dan platform iklan Anda, lalu klik Lanjutkan.

Beri nama grup mediasi Anda, lalu pilih lokasi yang akan ditargetkan. Berikutnya, tetapkan status grup mediasi ke Diaktifkan, lalu klik Tambahkan Unit Iklan.

Kaitkan grup mediasi ini dengan satu atau beberapa unit iklan AdMob yang ada. Kemudian, klik Selesai.

Sekarang Anda akan melihat kartu unit iklan yang terisi dengan unit iklan yang dipilih.

Menambahkan DT Exchange sebagai sumber iklan

Di kartu Waterfall, pilih Add Ad Source.

Pilih DT Exchange dan Anda akan diarahkan ke Tambahkan sumber iklan: DT Exchange

Sumber iklan

Aktifkan tombol Optimalkan. Kemudian, masukkan ID Penayang, Kunci Pelanggan, dan Rahasia Konsumen yang diperoleh di bagian sebelumnya.

Tinjau dan centang kotak Otorisasi untuk menyiapkan pengoptimalan sumber iklan untuk DT Exchange. Masukkan nilai eCPM untuk DT Exchange, lalu klik Lanjutkan.

Sumber iklan

Masukkan ID Aplikasi dan ID Penempatan yang diperoleh di bagian sebelumnya, lalu klik Selesai.

Iklan reward

Di setelan untuk unit iklan reward, berikan nilai untuk jumlah reward dan jenis reward. Untuk memberikan reward yang sama kepada pengguna, apa pun jaringan iklan yang ditayangkan, pilih kotak Terapkan untuk semua jaringan di Grup mediasi.

Diberikan sebagai reward

Jika Anda tidak menerapkan setelan ini, adaptor DT Exchange akan meneruskan kembali reward yang ditentukan di dasbor DT Exchange saat membuat penempatan.

Untuk informasi selengkapnya tentang cara menetapkan nilai reward untuk unit iklan AdMob, lihat Membuat unit iklan.

Langkah 3: Impor adaptor dan SDK DT Exchange

Tambahkan dependensi penerapan berikut dengan versi terbaru DT Exchange SDK dan adaptor dalam file build.gradle tingkat aplikasi:

repositories {
    google()
    mavenCentral()
}

// ...
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.google.android.gms:play-services-ads:21.3.0'
    implementation 'com.google.ads.mediation:fyber:8.2.0.0'
}
// ...

Integrasi manual

  • Download versi terbaru DT Exchange SDK untuk Android dan tambahkan file berikut ke project Anda:
    • ia-mraid-kit-release-x.y.z.aar
    • ia-sdk-core-release-x.y.z.aar
    • ia-video-kit-release-x.y.z.aar
  • Buka artefak adaptor Exchange Exchange di Repositori Maven Google. Pilih versi terbaru, download file .aar adaptor DT Exchange, lalu tambahkan ke project Anda.

Langkah opsional

Berdasarkan Kebijakan Izin Pengguna Uni Eropa Google, Anda harus memastikan bahwa pengungkapan tertentu diberikan kepada, dan izin yang diperoleh dari, pengguna di Wilayah Ekonomi Eropa (EEA) terkait penggunaan ID perangkat dan data pribadi. Kebijakan ini mencerminkan persyaratan dalam ePrivacy Directive dan General Data Protection Regulation (GDPR) Uni Eropa. Saat meminta izin, Anda harus mengidentifikasi setiap jaringan iklan di rantai mediasi Anda yang dapat mengumpulkan, menerima, atau menggunakan data pribadi dan memberikan informasi tentang penggunaan setiap jaringan. Saat ini Google tidak dapat meneruskan pilihan izin pengguna ke jaringan tersebut secara otomatis.

DT Exchange berisi API yang memungkinkan Anda meneruskan izin pengguna ke SDK mereka. Kode contoh berikut menunjukkan cara meneruskan informasi izin ke DT Exchange SDK secara manual. Jika Anda memilih untuk meneruskan informasi izin ke DT Exchange SDK secara manual, sebaiknya kode ini dipanggil sebelum meminta iklan melalui Google Mobile Ads SDK.

Java

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");

Kotlin

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")

Buka Halaman Resource GDPR DT Exchange dan panduan penerapan GDPR untuk mengetahui detail selengkapnya dan nilai yang dapat diberikan dalam metode ini.

Menambahkan DT Exchange ke daftar partner iklan GDPR

Ikuti langkah-langkah di Setelan GDPR untuk menambahkan DT Exchange ke daftar partner iklan GDPR di UI UI.

CCPA

California Consumer Privacy Act (CCPA) harus memberikan hak kepada penduduk negara bagian California untuk memilih tidak ikut "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan hukum), dengan pilihan tidak ikut yang disediakan melalui link "Jangan Jual Informasi Pribadi Saya" yang menonjol di halaman beranda pihak "penjual". Panduan Penyiapan CCPA menawarkan kemampuan mengaktifkan pemrosesan data yang dibatasi untuk penayangan iklan Google, tetapi Google tidak dapat menerapkan setelan ini ke setiap jaringan iklan di rantai mediasi Anda. Oleh karena itu, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi yang dapat berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan dengan CCPA.

DT Exchange berisi API yang memungkinkan Anda meneruskan izin pengguna ke SDK mereka. Kode contoh berikut menunjukkan cara meneruskan informasi izin ke DT Exchange SDK secara manual. Jika Anda memilih untuk meneruskan informasi izin ke DT Exchange SDK secara manual, sebaiknya kode ini dipanggil sebelum meminta iklan melalui Google Mobile Ads SDK.

Java

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

Kotlin

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

Buka Halaman Resource CCPA DT Exchange dan Panduan penerapan CCPA untuk mengetahui detail selengkapnya dan nilai yang mungkin diberikan dalam metode.

Parameter khusus jaringan

Adaptor DT Exchange mendukung parameter tambahan untuk meneruskan usia pengguna ke SDK DT Exchange.

Berikut adalah contoh kode tentang cara menetapkan parameter ini:

Java

Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);

AdRequest request = new AdRequest.Builder()
       .addNetworkExtrasBundle(FyberMediationAdapter.class, extras)
       .build();

Kotlin

var extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)

var adrequest = AdRequest.Builder()
       .addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
       .build()

Kode error

Jika adaptor gagal menerima iklan dari DT Exchange, Anda dapat memeriksa error yang mendasari dari respons iklan menggunakan ResponseInfo.getAdapterResponses() di bawah kelas berikut:

com.google.ads.mediation.fyber.FyberMediationAdapter

Berikut adalah kode dan pesan pendamping yang ditampilkan oleh adaptor DT Exchange saat iklan gagal dimuat:

Kode error Alasan
101 Parameter server DT Exchange yang dikonfigurasi di AdMob UI tidak ada/tidak valid.
103 Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung DT Exchange.
105 DT Exchange SDK memuat iklan, tetapi menampilkan pengontrol yang tidak diharapkan.
106 Iklan tidak siap ditampilkan.
200-399 DT Exchange SDK menampilkan error. Lihat kode untuk detail selengkapnya.
0-10 DT Exchange SDK menampilkan error. Lihat dokumentasi untuk mengetahui detail selengkapnya.
101 Parameter server DT Exchange yang dikonfigurasi di AdMob UI tidak ada/tidak valid.
102 Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung DT Exchange.
103 Gagal menampilkan iklan karena objek iklan sudah digunakan.
104 Gagal menampilkan iklan DT Exchange karena iklan belum siap.
105 DT Exchange SDK menampilkan error inisialisasi.

Log Perubahan Adaptor Mediasi Fyber

Versi 8.2.0.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 8.2.0.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 21.1.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 21.1.0.
  • Fyber SDK versi 8.2.0.

Versi 8.1.5.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 8.1.5.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 21.0.0.
  • Fyber SDK versi 8.1.5.

Versi 8.1.4.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 8.1.4.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 21.0.0.
  • Fyber SDK versi 8.1.4.

Versi 8.1.3.1

  • Mengupdate compileSdkVersion dan targetSdkVersion ke API 31.
  • Mengupdate versi minimum Google Mobile Ads SDK minimum ke 21.0.0.
  • Mengupdate API level Android minimum yang diperlukan ke versi 19.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 21.0.0.
  • Fyber SDK versi 8.1.3.

Versi 8.1.3.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 8.1.3.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke versi 20.6.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 20.6.0.
  • Fyber SDK versi 8.1.3.

Versi 8.1.2.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 8.1.2.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 20.5.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 20.5.0.
  • Fyber SDK versi 8.1.2.

Versi 8.1.0.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 8.1.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 20.4.0.
  • Fyber SDK versi 8.1.0.

Versi 7.8.4.1

  • Memperbaiki masalah ketika adaptor tidak dapat melakukan inisialisasi jika ada duplikat atau lebih dari satu ID aplikasi unik dari konfigurasi mediasi.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke versi 20.4.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 20.4.0.
  • Fyber SDK versi 7.8.4.

Versi 7.8.4.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.8.4.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 20.3.0.
  • Memperbaiki masalah iklan Display reward, yang tidak memanggil onVideoComplete().
  • Fyber kini memerlukan konteks Aktivitas untuk menampilkan iklan.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 20.3.0.
  • Fyber SDK versi 7.8.4.

Versi 7.8.3.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.8.3.
  • Menambahkan kode dan pesan error adaptor terstandardisasi.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke versi 20.1.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 20.1.0.
  • Fyber SDK versi 7.8.3.

Versi 7.8.2.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.8.2.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke versi 20.0.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 20.0.0.
  • Fyber SDK versi 7.8.2.

Versi 7.8.1.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.8.1.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 19.7.0.
  • Fyber SDK versi 7.8.1.

Versi 7.8.0.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.8.0.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke versi 19.7.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 19.7.0.
  • Fyber SDK versi 7.8.0.

Versi 7.7.4.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.7.4.
  • Memperbaiki masalah ketika onUserEarnedReward() diteruskan dua kali untuk iklan reward.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 19.5.0.
  • Fyber SDK versi 7.7.4.

Versi 7.7.3.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.7.3.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 19.5.0.
  • Fyber SDK versi 7.7.3.

Versi 7.7.2.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.7.2.
  • Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 19.5.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 19.5.0.
  • Fyber SDK versi 7.7.2.

Versi 7.7.1.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.7.1.
  • Versi minimum Google Mobile Ads SDK minimum telah diupdate ke 19.4.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 19.4.0.
  • Fyber SDK versi 7.7.1.

Versi 7.7.0.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.7.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 19.3.0.
  • Fyber SDK versi 7.7.0.

Versi 7.6.1.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.6.1.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 19.3.0.
  • Fyber SDK versi 7.6.1.

Versi 7.6.0.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.6.0.
  • Memperbarui adaptor untuk mendukung permintaan banner adaptif inline.
  • Versi minimum Google Mobile Ads SDK minimum telah diupdate ke 19.3.0.
  • Memperbaiki bug saat metode onAdOpened()/onAdClosed() tidak dipanggil untuk iklan banner.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 19.3.0.
  • Fyber SDK versi 7.6.0.

Versi 7.5.4.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.5.4.
  • Versi minimum Google Mobile Ads SDK minimum telah diupdate ke 19.1.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 19.1.0.
  • Fyber SDK versi 7.5.4.

Versi 7.5.3.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.5.3.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 19.0.1.
  • Fyber SDK versi 7.5.3.

Versi 7.5.2.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.5.2.
  • Versi minimum Google Mobile Ads SDK minimum telah diupdate ke 19.0.1.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 19.0.1.
  • Fyber SDK versi 7.5.2.

Versi 7.5.0.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.5.0.
  • Memperbaiki error NullPointerException selama pemuatan iklan Fyber.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 18.3.0.
  • Fyber SDK versi 7.5.0.

Versi 7.4.1.0

  • Kompatibilitas terverifikasi dengan Fyber SDK 7.4.1.
  • Versi Google Mobile Ads SDK minimum yang diperlukan telah diupdate ke versi 18.3.0.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 18.3.0.
  • Fyber SDK versi 7.4.1.

Versi 7.3.4.0

  • Rilis awal!
  • Mendukung iklan Banner, Interstisial, dan Reward.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 18.2.0.
  • Fyber SDK versi 7.3.4.