Flutter offerwall eklentisi. Tek Dart API'si, Android ve iOS.

Moonetix offerwall'unu tek bir eklentiyle Flutter uygulamanıza ekleyin. Native Android ve iOS SDK'larını beraberinde getirir, bu yüzden Gradle veya Xcode'da ayarlanacak başka bir şey yoktur.

  • 3.27+Flutter
  • 2.0.1Güncel sürüm
  • 2Platform, tek eklenti
Flutter SDKSürüm 2.0.1
main.dart
import 'package:moonetix_offerwall/moonetix_offerwall.dart';
 
Moonetix.init('YOUR_APP_ID');
 
// When the user taps Earn
await Moonetix.open(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. Eklentiyi kurun

    Eklentiyi Moonetix paket deposundan ekleyin ve flutter pub get çalıştırın. Android'de Maven deposunu, SDK'yı ve R8 kurallarını getirir. iOS'ta CocoaPods ve Swift Package Manager için iOS SDK'sını getirir.

    pubspec.yaml
    dependencies:
      moonetix_offerwall:
        hosted: https://moonetix.com/pub
        version: ^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 yeni bir token ile open'ı çağırın. open'ı çağırmadan önce Moonetix.events'i dinleyin ve kullanıcı offerwall'u kapattığında bakiyeyi yenileyin.

    main.dart
    void main() {
      WidgetsFlutterBinding.ensureInitialized();
      Moonetix.init('YOUR_APP_ID');
      runApp(const MyApp());
    }
     
    Moonetix.events.listen((MoonetixEvent event) {
      switch (event) {
        case MoonetixOpened():
          break;
        case MoonetixClosed():
          refreshBalance();
        case MoonetixErrorEvent(:final MoonetixError error):
          debugPrint('${error.code.name}: ${error.message}');
      }
    });
     
    await Moonetix.open(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.

Eklentinin sizin için hallettikleri

  • Native SDK'lar dahil

    Eklenti Android ve iOS SDK'larını beraberinde getirir. Elle eklenecek Gradle deposu veya Xcode adımı yoktur.

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

    Mağaza teklifleri Google Play'de veya App Store'da, 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 sunucunuzdan gelir ve bir kez çalışır.

  • Tipli olaylar

    MoonetixOpened, MoonetixClosed ve MoonetixErrorEvent içeren bir broadcast stream ya da callback tercih ederseniz bir listener.

  • Sizin tasarımınız

    Ekran, panelinizin Tasarım sekmesindeki başlığı ve renkleri kullanır.

  • Reklam kimliği yok

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

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

  • invalidAppId

    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.

  • invalidToken

    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.

  • tokenExpiredOrUsed

    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.

  • notInitialized

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

    ÇözümMoonetix.init'i main() içinde çağırın.

  • unsupported

    Uygulama web'de veya masaüstünde çalışıyor ya da eklentinin native kısmı henüz derlemede değil.

    ÇözümAndroid veya iOS'ta çalıştırın, uygulamayı durdurup yeniden derleyin. Hot reload native kod eklemez.

  • No events arrive

    Uygulama open'ı çağırdıktan sonra dinlemeye başladı.

    Çözümopen'ı çağırmadan önce, canlı kalan bir nesneden Moonetix.events'i dinleyin.

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

Flutter soruları

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

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

Eklenti hangi Flutter sürümlerini destekliyor?

Flutter 3.27 veya daha yenisi. iOS'ta Xcode 16 veya daha yenisiyle derleyin.

Eklenti pub.dev'de mi?

Moonetix paket deposunda barındırılır. hosted: https://moonetix.com/pub ile pubspec.yaml dosyasına ekleyin ve herhangi bir paketi eklediğiniz gibi flutter pub get çalıştırın.

Gradle veya Xcode ayarlarını değiştirmem gerekiyor mu?

Genellikle hayır. Eklenti Android ve iOS SDK'larını beraberinde getirir. Yalnızca android/settings.gradle dosyanız proje depolarını engelliyorsa, Moonetix Maven deposunu oraya ekleyin.

Kullanıcının offerwall'u kapattığını nasıl anlarım?

open'ı çağırmadan önce bir broadcast stream olan Moonetix.events'i dinleyin. MoonetixClosed, kullanıcının bakiyesini sunucunuzdan yüklemek için iyi bir andır.

Ödüller nasıl yüklenir?

Sunucunuzdaki imzalı postback'ten, her işlem ID'si için bir kez. Uygulamadaki olaylar yalnızca kullanıcı arayüzünüz içindir.

Mağaza gizlilik formlarında neyi beyan etmeliyim?

User ID, Device ID, Coarse Location ve Product Interaction; kullanıcıya bağlı, izleme için kullanılmaz. Belgeler, aynı veri türlerinin Google Play'deki adlarını listeler.

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