SDK offerwall React Native. Siap untuk Expo, termasuk TypeScript.

Buka offerwall Moonetix sebagai layar native dari React Native atau Expo. Paket ini membawa SDK Android dan iOS, berfungsi dengan New Architecture, dan menyertakan tipe TypeScript sendiri.

  • 0.77+React Native
  • 53+Expo SDK
  • TSTermasuk tipe
React Native SDKVersi 2.0.1
EarnScreen.tsx
import { Moonetix } from '@moonetix/react-native-offerwall';
 
Moonetix.init('YOUR_APP_ID');
 
// When the user taps Earn
Moonetix.open(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 paket

    Tambahkan registry Moonetix untuk scope @moonetix, lalu instal paket dan build ulang aplikasi Anda. Untuk Expo, tambahkan config plugin dan gunakan development build, karena Expo Go tidak dapat memuat kode native.

    Terminal
    # .npmrc, next to package.json
    @moonetix:registry=https://moonetix.com/npm/
     
    npm install @moonetix/react-native-offerwall
    cd ios && pod install
  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 open dengan token baru. addListener mengembalikan subscription, jadi hapus subscription tersebut saat layar Anda ditutup.

    EarnScreen.tsx
    import { Moonetix } from '@moonetix/react-native-offerwall';
     
    Moonetix.init('YOUR_APP_ID');
     
    useEffect(() => {
      const closed = Moonetix.addListener('closed', refreshBalance);
      const failed = Moonetix.addListener('error', (error) => {
        console.warn(`${error.code}: ${error.message}`);
      });
      return () => {
        closed.remove();
        failed.remove();
      };
    }, []);
     
    async function openOfferwall() {
      const url = 'https://your-server.example/api/moonetix/session';
      const res = await fetch(url, { method: 'POST' });
      const { token } = await res.json();
      Moonetix.open(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 paket untuk Anda

  • SDK native sudah termasuk

    Android Gradle dan iOS CocoaPods sudah dikonfigurasi untuk Anda. Jalankan pod install dan build ulang.

  • Expo config plugin

    Tambahkan satu baris ke app.json, lalu jalankan prebuild atau mulai EAS Build.

  • Tipe TypeScript

    init, open, event, dan kode error yang bertipe, dengan nama yang sama seperti yang digunakan SDK native.

  • Penawaran dibuka di tempat yang tepat

    Penawaran aplikasi store dibuka di Google Play atau App Store, sehingga instalasi terlacak dengan benar.

  • Tanpa key di bundle Anda

    Bundle JavaScript Anda hanya menyimpan App ID. Sesi berasal dari server Anda dan hanya berlaku satu kali.

  • 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 React Native 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 satu kali saat aplikasi Anda dimulai.

  • UNSUPPORTED on a phone

    Bagian native tidak ada di build, misalnya di Expo Go atau sebelum build ulang.

    SolusiBuild ulang aplikasi atau gunakan Expo development build. Reload Metro tidak menambahkan kode native.

  • Gradle cannot find com.moonetix

    settings.gradle Anda tidak mengizinkan proyek menambahkan repositori.

    SolusiTambahkan repositori Maven Moonetix ke settings.gradle.

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

Pertanyaan seputar React Native

Pertanyaan developer sebelum menambahkan React Native SDK.

Mengalami kendala? Hubungi kami

Versi React Native dan Expo mana saja yang didukung?

React Native 0.77 atau yang lebih baru, atau Expo SDK 53 atau yang lebih baru. Paket ini berfungsi dengan New Architecture dan, di React Native 0.77 hingga 0.81, juga dengan arsitektur lama.

Apakah ini berfungsi di Expo Go?

Tidak. Expo Go tidak dapat memuat kode native, sehingga Moonetix.isSupported bernilai false di sana. Tambahkan config plugin dan uji dengan development build atau EAS Build.

Apakah paketnya tersedia di registry npm publik?

Paket ini ada di registry npm Moonetix. Tambahkan @moonetix:registry=https://moonetix.com/npm/ ke .npmrc Anda, atau entri npmScopes untuk Yarn 2 dan yang lebih baru, lalu instal seperti biasa.

Apakah tipe TypeScript sudah termasuk?

Ya. Tipe untuk init, open, event, dan kode error sudah disertakan dalam paket.

Bagaimana cara memberi hadiah kepada pengguna?

Server Anda menerima postback bertanda tangan untuk setiap hadiah dan mengkreditkan pengguna satu kali per ID transaksi. Event aplikasi dapat dipalsukan di perangkat, jadi gunakan hanya untuk memperbarui UI Anda.

Di mana API key saya disimpan?

Hanya di server Anda. Aplikasi Anda menyimpan App ID, dan server Anda membuat session token sekali pakai untuk pengguna yang sedang login.

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