SDK offerwall Android. Native, dengan beberapa baris Kotlin.

Buka offerwall Moonetix sebagai layar native di aplikasi Android Anda. Instal satu dependensi Gradle, buat sesi di server Anda, lalu panggil open. Berfungsi dari Kotlin, Java, dan Jetpack Compose.

  • 5.0+Android, API 21
  • 2.0.1Versi saat ini
  • 0Izin tambahan
Android SDKVersi 2.0.1
EarnActivity.kt
// Once, in your Application class
Moonetix.init(applicationContext, "YOUR_APP_ID")
 
// When the user taps Earn
Moonetix.open(activity, token)

Mulai live dalam empat langkah.

Salin kode, ganti placeholder dengan nilai dari dasbor Anda di Offerwall, offerwall Anda, Integrasi, lalu uji sebelum Anda meluncurkannya.

  1. Instal SDK

    Tambahkan repositori Maven Moonetix dan satu dependensi. SDK menambahkan izin internet dan layarnya ke manifest Anda secara otomatis, serta membawa aturan R8 dan ProGuard sendiri.

    settings.gradle.kts
    dependencyResolutionManagement {
        repositories {
            google()
            mavenCentral()
            maven { url = uri("https://moonetix.com/maven") }
        }
    }
     
    // app/build.gradle.kts
    dependencies {
        implementation("com.moonetix:offerwall:2.0.1")
    }
  2. Tambahkan endpoint token ke server Anda

    Aplikasi Anda tidak pernah menyimpan API key. Saat pengguna mengetuk Earn, aplikasi Anda meminta sesi ke server Anda, dan server Anda meminta token sekali pakai ke Moonetix untuk pengguna yang sedang login tersebut. Token hanya berlaku satu kali, selama 10 menit.

    session.php
    <?php
    // POST /api/moonetix/session: a fresh token for the signed-in user
    $user = current_user();
    if (!$user) {
        http_response_code(401);
        exit;
    }
     
    $key = getenv('MOONETIX_API_KEY');
    $ch  = curl_init('https://api.moonetix.com/v1/session');
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query(['user_id' => (string)$user->id]),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 10,
        CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $key],
    ]);
    $data = json_decode((string)curl_exec($ch), true);
    $code = (int)curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
     
    header('Content-Type: application/json');
    if ($code === 201 && !empty($data['token'])) {
        echo json_encode(['token' => $data['token']]);
        exit;
    }
    http_response_code($code === 403 ? 403 : 503);
    echo json_encode(['error' => 'offerwall_unavailable']);
  3. Buka offerwall

    Panggil init satu kali dengan App ID dari dasbor Anda, lalu buka offerwall dengan token dari server Anda. Error tidak pernah dilempar sebagai exception: error diterima sebagai event, dan onClosed adalah saat yang tepat untuk memperbarui saldo pengguna.

    EarnActivity.kt
    Moonetix.init(applicationContext, "YOUR_APP_ID")
     
    Moonetix.setListener(object : MoonetixListener {
        override fun onClosed() {
            refreshBalance()
        }
        override fun onError(error: MoonetixError) {
            Log.w("Earn", "${error.code}: ${error.message}")
        }
    })
     
    lifecycleScope.launch {
        val token = fetchMoonetixToken(authToken)
        Moonetix.open(this@EarnActivity, token)
    }
  4. Kreditkan hadiah dengan postback

    Setiap hadiah sampai ke server Anda sebagai postback bertanda tangan. Periksa hash, tambahkan hadiah satu kali per ID transaksi, dan tarik kembali jika postback berikutnya membatalkannya. Postback yang gagal dicoba ulang hingga 5 kali.

    Makro postback dan percobaan ulang

    Dasbor, tab Postback
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
9:41
Earn coins12,450 Koin
EarnMy offers
  • Travel TownCapai level 15+1,500
  • WPS OfficeInstal dan buka+2,000
  • Bus EscapeCapai level 20+450
  • CapCutSign up in the app+800
Hadiah dikreditkanTravel Town · +1,500 Koin
Layar native
Postback 200 OK

Apa yang dilihat pengguna Anda

Layar native di atas aplikasi Anda, dengan judul dan warna Anda, mata uang Anda, dan setiap hadiah dikonfirmasi oleh postback.

Apa yang ditangani SDK untuk Anda

  • Penawaran dibuka di tempat yang tepat

    Penawaran yang mengarah ke Google Play dibuka di aplikasi store, dan situs lain dibuka di browser, sehingga instalasi terlacak dengan benar.

  • Tanpa key di dalam aplikasi Anda

    Aplikasi Anda hanya menyimpan App ID. Sesi dibuat di server Anda dan hanya berlaku satu kali, sehingga tidak ada yang bisa membuka offerwall sebagai pengguna lain.

  • Layar yang terkunci

    Hanya halaman offerwall yang dimuat di dalamnya, tanpa jembatan JavaScript ke aplikasi Anda.

  • Navigasi native

    Tombol kembali membawa pengguna mundur di dalam offerwall, dan rotasi layar atau restart karena memori rendah tetap mempertahankan posisi pengguna.

  • Desain Anda, tanpa kode tambahan

    Layar menggunakan judul dan warna dari tab "Desain" di dasbor Anda, dan menerapkan perubahan dalam beberapa menit.

  • Tanpa advertising ID

    SDK tidak menggunakan advertising identifier dan tidak melacak pengguna di berbagai aplikasi.

Uji dulu, lalu luncurkan.

Semua yang perlu Anda periksa sebelum pengguna sungguhan melihat offerwall Anda, dengan alat yang sudah tersedia di dasbor Anda.

  1. Buka sebagai pengguna uji

    Di "Status integrasi" pada tab "Integrasi", buka offerwall Anda sebagai pengguna owner-test. Kunjungan uji tidak dihitung sebagai pengguna.

  2. Jalankan di perangkat sungguhan

    Build untuk Android atau iOS dan buka offerwall dari tombol Earn Anda dengan token baru setiap kali.

  3. Kirim postback uji

    Pilih pengguna, status, dan pembayaran, lalu lihat respons persis dari server Anda, lengkap dengan kode respons dan waktunya. ID transaksi uji diawali test_.

  4. Uji dari koneksi biasa

    VPN, proxy, Tor, dan jaringan cloud diblokir, jadi lakukan pengujian dengan Wi-Fi rumah atau data seluler, di negara tempat penawaran tersedia.

Daftar periksa peluncuran

0 dari 11 siap

Error umum, cepat teratasi.

Hal yang mungkin Anda temui saat mengintegrasikan Android SDK, penyebabnya, dan solusinya.

  • INVALID_APP_ID

    Nilai yang diteruskan ke init bukan App ID. Memasukkan API key di sini adalah kesalahan yang paling umum.

    SolusiSalin lagi App ID 24 karakter dari tab "Integrasi".

  • INVALID_TOKEN

    Aplikasi meneruskan sesuatu selain token, atau token yang dibuat dengan API key aplikasi lain.

    SolusiKirim hanya field token, yang diawali sst_, dan gunakan App ID serta API key dari aplikasi yang sama.

  • TOKEN_EXPIRED_OR_USED

    Token sudah berumur lebih dari 10 menit atau sudah digunakan, misalnya disimpan dari ketukan sebelumnya.

    SolusiBuat token baru setiap kali offerwall dibuka, tepat saat pengguna mengetuk Earn.

  • NOT_INITIALIZED

    open dipanggil sebelum init.

    SolusiPanggil Moonetix.init di Application.onCreate.

  • UNKNOWN

    Android System WebView tidak ada atau dinonaktifkan, atau Activity yang Anda berikan sudah dalam proses ditutup.

    SolusiMinta pengguna memperbarui Android System WebView, dan berikan Activity yang sedang tampil di layar.

  • onClosed never arrives

    Listener dihapus di onStop, atau listener tersebut milik layar yang sudah tidak ada.

    SolusiAtur di onCreate dan hapus di onDestroy, atau atur satu kali di Application Anda.

  • 403 from /v1/session

    app_not_live berarti aplikasi sedang dijeda atau akun Anda tidak aktif. user_blocked berarti kami memblokir pengguna ini.

    SolusiJangan tampilkan offerwall. Jika app_not_live, periksa notifikasi Anda.

  • VPN or Proxy detected

    Perangkat menggunakan VPN, proxy, atau jaringan cloud, sehingga penawaran tidak dapat dilacak.

    SolusiUji dengan koneksi rumah atau seluler biasa, di negara tempat penawaran tersedia.

  • Postback log shows 403 or 404

    Skrip Anda menolak postback, atau URL-nya salah.

    SolusiBuka URL dari log di browser dan periksa kode hash Anda.

  • Postback log shows a timeout

    Skrip Anda membutuhkan lebih dari 6 detik untuk merespons.

    SolusiBalas dengan 200 terlebih dahulu, lalu jalankan proses yang lambat di latar belakang.

  • Postback log shows 301 or 302

    URL Anda melakukan redirect, misalnya dari http ke https.

    SolusiGunakan URL akhir. Postback tidak mengikuti redirect.

Sekilas pandang

Versi minimum
Android 5.0 (API 21), dengan Android System WebView atau Chrome
Bahasa
Kotlin, Java, dan Jetpack Compose
Paket
com.moonetix:offerwall:2.0.1 dari moonetix.com/maven
Dependensi
Hanya Kotlin standard library
Izin
Hanya internet, ditambahkan oleh SDK
Harga
Gratis untuk publisher yang disetujui

Integrasi lainnya

Pertanyaan seputar Android

Pertanyaan developer sebelum menambahkan Android SDK.

Mengalami kendala? Hubungi kami

Versi Android mana saja yang didukung Moonetix SDK?

Android 5.0 (API 21) atau yang lebih baru, dengan Android System WebView atau Chrome di perangkat. Satu-satunya dependensi adalah Kotlin standard library, sehingga SDK ini dapat digunakan di aplikasi Kotlin maupun Java.

Apakah saya perlu menambahkan aturan ProGuard atau R8?

Tidak. SDK membawa aturan R8 dan ProGuard sendiri, dan menambahkan izin internet serta layar offerwall-nya ke manifest Anda secara otomatis.

Apakah API key saya dimasukkan ke dalam aplikasi?

Tidak. Aplikasi Anda hanya menyimpan App ID. Server Anda membuat sesi dengan API key dan meneruskan token ke aplikasi. Token hanya berlaku satu kali dan selama 10 menit, sehingga tidak ada apa pun di aplikasi Anda yang dapat membuka offerwall pengguna lain.

Apakah SDK menggunakan advertising ID?

Tidak. SDK ini tidak menggunakan advertising ID, tidak meminta izin apa pun selain akses internet, dan tidak melacak pengguna di berbagai aplikasi. Dokumentasi mencantumkan apa saja yang perlu dideklarasikan di formulir Data safety Google Play.

Bagaimana cara memberi hadiah kepada pengguna di aplikasi saya?

Kreditkan hadiah dari postback bertanda tangan di server Anda, jangan pernah dari event di aplikasi, karena event dapat dipalsukan di perangkat. Saat pengguna menutup offerwall, muat saldo baru mereka dari server Anda.

Apakah layar offerwall bisa disesuaikan dengan aplikasi saya?

Ya. Layar ini menggunakan judul dan warna dari tab "Desain" di dasbor Anda. Anda juga dapat meneruskan judul dan warna toolbar Anda sendiri, atau menyembunyikan tanda dengan MoonetixOptions.

Ubah trafik Anda menjadi penghasilan.

Buat akun publisher gratis dan dapatkan penghasilan dari setiap penawaran yang diselesaikan pengguna Anda di situs web, aplikasi, game, atau komunitas Anda.

Penargetan seluruh dunia
Lainnya
Masuk