Mengintegrasikan DT Exchange dengan Mediasi

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

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk DT Exchange memiliki kemampuan berikut:

Persyaratan

• Android API level 19 atau yang lebih tinggi

• Google Mobile Ads SDK terbaru

• Selesaikan mediasi Panduan memulai

Langkah 1: Siapkan DT Exchange

Menambahkan aplikasi dan penempatan iklan baru

Daftar atau login ke Konsol DT Exchange.

Klik tombol Add App untuk menambahkan aplikasi Anda.

Pilih Android di bagian Platform, isi bagian formulir lainnya, lalu klik Add Placements.

Masukkan nama untuk penempatan baru di kolom berlabel Name your Placement, lalu pilih Placement Type yang Anda inginkan dari daftar dropdown. Terakhir, klik Save Placement.

ID Aplikasi dan ID Penempatan

Buka bilah navigasi kiri dengan mengarahkan mouse ke atasnya. Lalu klik Apps dari menu kiri.

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

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

ID Penayang, Kunci Konsumen, dan Rahasia Konsumen

Klik nama pengguna Anda dari menu sebelah kiri, lalu pilih Profil Pengguna.

Catat Publisher ID, Consumer Key, dan Consumer Secret karena diperlukan pada langkah berikutnya.

Langkah 2: Konfigurasikan setelan mediasi untuk AdMob unit iklan Anda

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

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

Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.

Masukkan format dan platform iklan Anda, lalu klik Lanjutkan.

Beri nama grup mediasi Anda dan pilih lokasi yang akan ditargetkan. Selanjutnya, tetapkan status grup mediasi ke Enabled, lalu klik Add Ad Units.

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

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

Menambahkan DT Exchange sebagai sumber iklan

Di kartu Waterfall di bagian Sumber Iklan, pilih Tambahkan Sumber Iklan. Kemudian, pilih DT Exchange.

Aktifkan tombol Optimize. Kemudian, masukkan Publisher ID, Consumer Key, dan Consumer Secret yang diperoleh di bagian sebelumnya.

Tinjau dan centang kotak Authorization guna menyiapkan pengoptimalan sumber iklan untuk DT Exchange. Masukkan nilai eCPM untuk DT Exchange dan klik Lanjutkan.

Jika sudah memiliki pemetaan untuk DT Exchange, Anda cukup memilihnya. Jika tidak, klik Tambahkan pemetaan.

Selanjutnya, masukkan Nama pemetaan, ID Aplikasi, dan ID Penempatan yang diperoleh di bagian sebelumnya. Kemudian, klik Done.

Langkah 3: Impor DT Exchange SDK dan adaptor

Integrasi Android Studio (direkomendasikan)

Tambahkan dependensi implementasi berikut dengan adaptor dan DT Exchange SDK versi terbaru di file build.gradle level aplikasi:

repositories {
    google()
    mavenCentral()
}

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

Integrasi manual

• Download versi terbaru DT Exchange SDK for 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 DT Exchange di Repositori Maven Google. Pilih versi terbaru, download file .aar adaptor DT Exchange, dan tambahkan ke project Anda.

Langkah 4: Kode tambahan diperlukan

Tidak ada kode tambahan yang diperlukan untuk integrasi DT Exchange.

Langkah opsional

Izin Uni Eropa dan GDPR

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 dalam rantai mediasi Anda yang dapat mengumpulkan, menerima, atau menggunakan data pribadi dan memberikan informasi tentang penggunaan setiap jaringan. Saat ini, Google tidak dapat otomatis meneruskan pilihan izin pengguna ke jaringan tersebut.

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.

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

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

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

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

Buka Halaman Referensi GDPR DT Exchange dan panduan penerapan GDPR untuk mengetahui detail selengkapnya dan nilai yang mungkin disediakan dalam metode tersebut.

Tambahkan DT Exchange ke daftar partner iklan GDPR

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

CCPA

Hukum privasi negara bagian Amerika Serikat mewajibkan memberi pengguna hak 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 terlihat jelas di halaman beranda pihak "penjual". Panduan kepatuhan hukum privasi negara bagian Amerika Serikat menawarkan kemampuan untuk mengaktifkan pemrosesan data yang dibatasi untuk penayangan iklan Google, tetapi Google tidak dapat menerapkan setelan ini ke setiap jaringan iklan dalam rantai mediasi Anda. Oleh karena itu, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi Anda yang dapat berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

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.

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

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

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

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

Buka Halaman Referensi CCPA DT Exchange dan panduan penerapan CCPA untuk mengetahui detail selengkapnya dan nilai yang mungkin disediakan dalam metode.

Parameter spesifik per jaringan

Adaptor DT Exchange mendukung parameter permintaan tambahan yang dapat diteruskan ke adaptor sebagai Android Bundle. Adaptor mencari kunci berikut dalam paket:

Berikut adalah contoh kode tentang cara menetapkan parameter permintaan iklan ini:

Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);

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

var extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)

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 mendasarinya dari respons iklan menggunakan ResponseInfo.getAdapterResponses() di kelas berikut:

com.google.ads.mediation.fyber.FyberMediationAdapter

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

Log Perubahan Adaptor Mediasi Android DT Exchange

Versi Berikutnya

• Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 22.4.0.

Versi 8.2.4.0

• Kompatibilitas terverifikasi dengan DT Exchange SDK 8.2.4.

Dibangun dan diuji dengan:

• Google Mobile Ads SDK versi 22.3.0.
• DT Exchange SDK versi 8.2.4.

Versi 8.2.3.0

• Mengupdate adaptor untuk menggunakan class VersionInfo baru.
• Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 22.0.0.

Dibangun dan diuji dengan:

• Google Mobile Ads SDK versi 22.0.0.
• DT Exchange SDK versi 8.2.3.

Versi 8.2.2.1

• Menambahkan dukungan untuk meneruskan kunci muteVideo di tambahan mediasi untuk menonaktifkan iklan interstisial.

Dibangun dan diuji dengan:

• Google Mobile Ads SDK versi 21.5.0.
• DT Exchange SDK versi 8.2.2.

Versi 8.2.2.0

• Kompatibilitas terverifikasi dengan DT Exchange SDK 8.2.2.
• Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 21.5.0.

Dibangun dan diuji dengan:

• Google Mobile Ads SDK versi 21.5.0.
• DT Exchange SDK versi 8.2.2.

Versi 8.2.1.0

• Mengganti nama adaptor menjadi "DT Exchange".
• Kompatibilitas terverifikasi dengan DT Exchange SDK 8.2.1.
• Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 21.3.0.

Dibangun dan diuji dengan:

• Google Mobile Ads SDK versi 21.3.0.
• DT Exchange SDK versi 8.2.1.

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.

Dibangun 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.

Dibangun 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.

Dibangun 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 yang diperlukan ke 21.0.0.
• Mengupdate API level Android minimum yang diperlukan ke 19.

Dibangun 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 20.6.0.

Dibangun 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.

Dibangun 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.

Dibangun dan diuji dengan:

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

Versi 7.8.4.1

• Memperbaiki masalah saat adaptor tidak akan 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 20.4.0.

Dibangun 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, ketika onVideoComplete() tidak dipanggil.
• Fyber kini memerlukan konteks Aktivitas untuk menampilkan iklan.

Dibangun 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 standar.
• Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 20.1.0.

Dibangun 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 Google Mobile Ads SDK minimum yang diperlukan ke 20.0.0.

Dibangun 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.

Dibangun 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 Google Mobile Ads SDK minimum yang diperlukan ke 19.7.0.

Dibangun 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 yang menyebabkan onUserEarnedReward() diteruskan dua kali untuk iklan reward.

Dibangun 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.

Dibangun 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.

Dibangun 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.
• Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 19.4.0.

Dibangun 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.

Dibangun 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.

Dibangun 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.
• Mengupdate adaptor untuk mendukung permintaan banner adaptif inline.
• Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 19.3.0.
• Memperbaiki bug saat metode onAdOpened()/onAdClosed() tidak dipanggil untuk iklan banner.

Dibangun 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.
• Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 19.1.0.

Dibangun 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.

Dibangun 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.
• Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 19.0.1.

Dibangun 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.

Dibangun 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.
• Mengupdate versi minimum Google Mobile Ads SDK yang diperlukan ke 18.3.0.

Dibangun 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.

Dibangun dan diuji dengan:

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