SDK offerwall Unity. Pemain mendapatkan mata uang dalam game Anda.

Biarkan pemain mendapatkan mata uang dalam game Anda dengan menyelesaikan penawaran, tanpa iklan banner di game Anda. Satu paket Unity mencakup Android dan iOS, dan setiap hadiah sampai ke server game Anda sebagai postback bertanda tangan.

  • 2022.3+Unity LTS atau Unity 6
  • 2.0.1Versi saat ini
  • 2Platform, satu paket
Unity SDKVersi 2.0.1
EarnButton.cs
using MoonetixOfferwall;
 
void Awake()
{
    Moonetix.Init("YOUR_APP_ID");
}
 
public void ShowOfferwall(string token)
{
    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 scoped registry Moonetix dan paketnya ke Packages/manifest.json, atau tambahkan registry di Project Settings lalu instal Moonetix Offerwall dari Package Manager. SDK Android dan iOS sudah termasuk.

    Packages/manifest.json
    {
      "scopedRegistries": [
        {
          "name": "Moonetix",
          "url": "https://moonetix.com/upm",
          "scopes": ["com.moonetix"]
        }
      ],
      "dependencies": {
        "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 Open dengan token baru. Semua event diterima di main thread Unity, sehingga Anda dapat langsung memperbarui UI. Paket ini juga menyertakan sampel Offerwall demo.

    EarnButton.cs
    using MoonetixOfferwall;
    using UnityEngine;
     
    public class EarnButton : MonoBehaviour
    {
        void Awake() => Moonetix.Init("YOUR_APP_ID");
     
        void OnEnable()
        {
            Moonetix.OnClosed += RefreshBalance;
            Moonetix.OnError += HandleError;
        }
     
        void OnDisable()
        {
            Moonetix.OnClosed -= RefreshBalance;
            Moonetix.OnError -= HandleError;
        }
     
        public void ShowOfferwall(string token) => Moonetix.Open(token);
     
        void HandleError(MoonetixError error)
        {
            Debug.LogWarning(error.CodeName + ": " + error.Message);
        }
     
        void RefreshBalance() { }
    }
  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 gems12,450 Gems
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 Gems
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

  • Build Android dan iOS

    Di Android, paket ini menambahkan repositori Maven, SDK, dan aturan R8 ke proyek Gradle Anda. Di iOS, paket ini menautkan dan menyematkan iOS SDK di Xcode.

  • Penawaran dibuka di tempat yang tepat

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

  • Tanpa key di dalam game Anda

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

  • Event di main thread

    OnOpened, OnClosed, dan OnError dipicu di main thread Unity, siap untuk UI Anda.

  • Mata uang dalam game Anda

    Hadiah ditampilkan dan dikreditkan dalam mata uang Anda sendiri, dengan nilai tukar dan bagian pengguna Anda.

  • Tanpa advertising ID

    SDK tidak menggunakan advertising identifier dan tidak melacak pemain 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 Unity SDK, penyebabnya, dan solusinya.

  • InvalidAppId

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

  • InvalidToken

    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.

  • TokenExpiredOrUsed

    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.

  • NotInitialized

    open dipanggil sebelum init.

    SolusiPanggil Moonetix.Init di Awake pada scene pertama Anda.

  • Unsupported

    Game berjalan di Unity Editor, di desktop, atau di WebGL.

    SolusiBuild untuk Android atau iOS, dan periksa Moonetix.IsSupported sebelum Anda menampilkan tombol.

  • iOS build stops on the iOS version

    Target minimum iOS Version di Player Settings di bawah 13.0.

    SolusiAtur ke 13.0 atau lebih tinggi.

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

Pertanyaan developer sebelum menambahkan Unity SDK.

Mengalami kendala? Hubungi kami

Versi Unity mana saja yang didukung?

Unity 2022.3 LTS, atau Unity 6 (6000.0) atau yang lebih baru. Di iOS, atur versi iOS minimum ke 13.0 atau lebih tinggi di Player Settings.

Apakah ini berfungsi untuk build Android dan iOS?

Ya. Satu paket mencakup keduanya. Unity menambahkan Android SDK ke proyek Gradle dan iOS SDK ke proyek Xcode secara otomatis, termasuk proyek yang diekspor dan template Gradle kustom.

Bagaimana cara menginstal paket Moonetix Unity?

Tambahkan scoped registry Moonetix dan com.moonetix.offerwall ke Packages/manifest.json, atau instal dari My Registries di Package Manager. Anda juga dapat menginstalnya dari tarball.

Apakah offerwall bersifat pay-to-win?

Tidak. Pemain mendapatkan mata uang yang sama seperti yang mereka peroleh dengan bermain, dengan mencoba aplikasi dan game dari pengiklan. Ini memberi pemain yang tidak membayar cara untuk maju tanpa iklan banner di game Anda.

Bagaimana cara mengkreditkan pemain dengan aman?

Kreditkan hadiah di server game Anda dari postback bertanda tangan, jangan pernah dari event di klien, karena pemain dapat memalsukannya. Saat OnClosed terpicu, muat saldo pemain dari server Anda.

Apakah saya bisa mengujinya di Unity Editor?

Anda dapat menguji alur Anda. Di Editor, di desktop, dan di WebGL, Open memeriksa App ID dan token lalu melaporkan Unsupported, dan Moonetix.IsSupported bernilai false. Untuk melihat offerwall itu sendiri, build untuk Android atau iOS dan uji di ponsel atau iOS Simulator.

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