Android offerwall SDK'sı. Birkaç satır Kotlin ile native.

Moonetix offerwall'unu Android uygulamanızda native bir ekran olarak açın. Tek bir Gradle bağımlılığı kurun, sunucunuzda bir session oluşturun ve open'ı çağırın. Kotlin, Java ve Jetpack Compose'dan çalışır.

  • 5.0+Android, API 21
  • 2.0.1Güncel sürüm
  • 0Ek izin
Android SDKSürüm 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)

Dört adımda yayına geçin.

Kodu kopyalayın, yer tutucuları panelinizde Offerwall'lar, offerwall'unuz, Entegrasyon altındaki değerlerle değiştirin ve yayına geçmeden önce test edin.

  1. SDK'yı kurun

    Moonetix Maven deposunu ve tek bir bağımlılığı ekleyin. SDK, internet iznini ve kendi ekranını manifest'inize kendisi ekler, kendi R8 ve ProGuard kurallarını da getirir.

    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. Sunucunuza bir token endpoint'i ekleyin

    Uygulamanız API anahtarını asla tutmaz. Bir kullanıcı Earn'e dokunduğunda uygulamanız sunucunuzdan bir session ister, sunucunuz da Moonetix'ten oturum açmış o kullanıcı için tek kullanımlık bir token ister. Bir token bir kez ve 10 dakika boyunca çalışır.

    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. Offerwall'u açın

    init'i panelinizdeki App ID ile bir kez çağırın, ardından offerwall'u sunucunuzdan gelen token ile açın. Hatalar asla exception fırlatmaz, olay olarak gelir. onClosed, kullanıcının bakiyesini yenilemek için iyi bir andır.

    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. Ödülleri postback ile yükleyin

    Her ödül sunucunuza imzalı bir postback olarak ulaşır. Hash'i kontrol edin, ödülü her işlem ID'si için bir kez ekleyin ve sonraki bir postback onu iptal ederse geri alın. Başarısız postback'ler 5 kereye kadar yeniden denenir.

    Postback makroları ve yeniden denemeler

    Panel, Postback sekmesi
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
9:41
Coin kazan12,450 Coin
KazanınMy offers
  • Travel Town15. seviyeye ulaşın+1,500
  • WPS OfficeKurun ve açın+2,000
  • Bus Escape20. seviyeye ulaşın+450
  • CapCutSign up in the app+800
Ödül yüklendiTravel Town · +1,500 Coin
Native ekran
Postback 200 OK

Kullanıcılarınızın gördüğü

Uygulamanızın üzerinde, sizin başlığınız, renkleriniz ve para biriminizle açılan native bir ekran; her ödül bir postback ile onaylanır.

SDK'nın sizin için hallettikleri

  • Teklifler doğru yerde açılır

    Google Play'e yönlendiren teklifler mağaza uygulamasında, diğer siteler tarayıcıda açılır; böylece kurulumlar doğru şekilde izlenir.

  • Uygulamanızın içinde anahtar yok

    Uygulamanız yalnızca App ID'yi tutar. Session'lar sunucunuzda oluşturulur ve bir kez çalışır, bu yüzden kimse offerwall'u başka bir kullanıcı olarak açamaz.

  • Kilitli bir ekran

    İçinde yalnızca offerwall sayfaları yüklenir; uygulamanıza JavaScript köprüsü yoktur.

  • Native gezinme

    Geri düğmesi offerwall içinde geri gider; ekran döndürme veya düşük bellek nedeniyle yeniden başlatma kullanıcıyı kaldığı yerde tutar.

  • Sizin tasarımınız, ek kod yok

    Ekran, panelinizin Tasarım sekmesindeki başlığı ve renkleri kullanır; değişiklikleri birkaç dakika içinde alır.

  • Reklam kimliği yok

    SDK reklam kimliğini kullanmaz ve kullanıcıları uygulamalar arasında izlemez.

Test edin, sonra yayına alın.

Gerçek kullanıcılar offerwall'unuzu görmeden önce kontrol etmeniz gereken her şey, panelinizdeki yerleşik araçlarla.

  1. Test kullanıcısı olarak aç

    Entegrasyon sekmesindeki Entegrasyon durumu bölümünde offerwall'unuzu owner-test kullanıcısı olarak açın. Test ziyaretleri kullanıcı olarak sayılmaz.

  2. Gerçek bir cihazda çalıştırın

    Android veya iOS için derleyin ve offerwall'u her seferinde yeni bir token ile Earn düğmenizden açın.

  3. Test postback'i gönder

    Kullanıcıyı, durumu ve ödemeyi seçin; sunucunuzun tam olarak ne yanıt verdiğini yanıt kodu ve süresiyle görün. Test işlem ID'leri test_ ile başlar.

  4. Normal bir bağlantıdan test edin

    VPN'ler, proxy'ler, Tor ve bulut ağları engellenir; bu yüzden tekliflerin yayında olduğu bir ülkede, ev Wi-Fi'ında veya mobil veriyle test edin.

Yayın kontrol listesi

0 / 11 hazır

Sık görülen hatalar, hızla çözülür.

Android SDK'yı entegre ederken karşılaşabileceğiniz durumlar, nedenleri ve çözümleri.

  • INVALID_APP_ID

    init'e iletilen değer App ID değil. Buraya API anahtarını iletmek en sık yapılan hatadır.

    Çözüm24 karakterlik App ID'yi Entegrasyon sekmesinden yeniden kopyalayın.

  • INVALID_TOKEN

    Uygulama token dışında bir şey ya da başka bir uygulamanın API anahtarıyla oluşturulmuş bir token iletti.

    ÇözümYalnızca sst_ ile başlayan token alanını iletin ve aynı uygulamanın App ID'sini ve API anahtarını kullanın.

  • TOKEN_EXPIRED_OR_USED

    Token 10 dakikadan eski veya zaten kullanılmış, örneğin önceki bir dokunuştan saklanmış.

    ÇözümHer açılış için, kullanıcı Earn'e dokunduğu anda yeni bir token oluşturun.

  • NOT_INITIALIZED

    open, init'ten önce çağrıldı.

    ÇözümMoonetix.init'i Application.onCreate içinde çağırın.

  • UNKNOWN

    Android System WebView eksik veya kapalı ya da ilettiğiniz Activity zaten kapanıyordu.

    ÇözümKullanıcıdan Android System WebView'ı güncellemesini isteyin ve ekranda olan bir Activity iletin.

  • onClosed never arrives

    Listener onStop içinde temizlendi ya da artık olmayan bir ekrana aitti.

    ÇözümonCreate içinde ayarlayıp onDestroy içinde temizleyin veya Application'ınızda bir kez ayarlayın.

  • 403 from /v1/session

    app_not_live, uygulamanın duraklatıldığı veya hesabınızın aktif olmadığı anlamına gelir. user_blocked, bu kullanıcıyı engellediğimiz anlamına gelir.

    ÇözümOfferwall'u göstermeyin. app_not_live için bildirimlerinizi kontrol edin.

  • VPN or Proxy detected

    Cihaz, tekliflerin izlenemediği bir VPN, proxy veya bulut ağında.

    ÇözümNormal bir ev veya mobil internet bağlantısında, tekliflerin yayında olduğu bir ülkede test edin.

  • Postback log shows 403 or 404

    Script'iniz postback'i reddetti veya URL yanlış.

    ÇözümLog'daki URL'yi bir tarayıcıda açın ve hash kodunuzu kontrol edin.

  • Postback log shows a timeout

    Script'inizin yanıt vermesi 6 saniyeden uzun sürüyor.

    ÇözümÖnce 200 ile yanıt verin, yavaş işleri arka planda çalıştırın.

  • Postback log shows 301 or 302

    URL'niz yönlendirme yapıyor, örneğin http'den https'e.

    ÇözümSon URL'yi kullanın. Postback'ler yönlendirmeleri takip etmez.

Bir bakışta

Minimum sürüm
Android 5.0 (API 21), Android System WebView veya Chrome ile
Diller
Kotlin, Java ve Jetpack Compose
Paket
moonetix.com/maven adresinden com.moonetix:offerwall:2.0.1
Bağımlılıklar
Yalnızca Kotlin standart kütüphanesi
İzinler
Yalnızca internet, SDK tarafından eklenir
Fiyat
Onaylı yayıncılar için ücretsiz

Diğer entegrasyonlar

Android soruları

Geliştiricilerin Android SDK'yı eklemeden önce sordukları.

Bir yerde mi takıldınız? Bize ulaşın

Moonetix SDK hangi Android sürümlerini destekliyor?

Cihazda Android System WebView veya Chrome bulunan Android 5.0 (API 21) ya da üstü. Tek bağımlılık Kotlin standart kütüphanesidir, bu yüzden Kotlin ve Java uygulamalarında çalışır.

ProGuard veya R8 kuralları eklemem gerekiyor mu?

Hayır. SDK kendi R8 ve ProGuard kurallarını getirir; internet iznini ve offerwall ekranını manifest'inize kendisi ekler.

API anahtarım uygulamaya mı konur?

Hayır. Uygulamanız yalnızca App ID'yi tutar. Sunucunuz API anahtarıyla bir session oluşturur ve uygulamaya bir token iletir. Bir token yalnızca bir kez ve 10 dakika boyunca çalışır, bu yüzden uygulamanızdaki hiçbir şey başka bir kullanıcının offerwall'unu açamaz.

SDK reklam kimliğini kullanıyor mu?

Hayır. Reklam kimliğini kullanmaz, internet erişimi dışında izin istemez ve kullanıcıları uygulamalar arasında izlemez. Belgeler, Google Play Data safety formunda neleri beyan etmeniz gerektiğini listeler.

Uygulamamda kullanıcıları nasıl ödüllendiririm?

Ödülleri uygulamadaki olaylardan değil, her zaman sunucunuzdaki imzalı postback'ten yükleyin, çünkü olaylar cihazda taklit edilebilir. Kullanıcı offerwall'u kapattığında yeni bakiyesini sunucunuzdan yükleyin.

Offerwall ekranı uygulamama uyabilir mi?

Evet. Panelinizin Tasarım sekmesindeki başlığı ve renkleri kullanır. MoonetixOptions ile kendi başlığınızı, araç çubuğu renginizi de iletebilir veya işareti gizleyebilirsiniz.

Trafiğinizi kazanca dönüştürün.

Ücretsiz bir yayıncı hesabı oluşturun ve kullanıcılarınızın web sitenizde, uygulamanızda, oyununuzda veya topluluğunuzda tamamladığı her tekliften kazanın.

Dünya çapında hedefleme
Diğer
Giriş yapın