Unity offerwall SDK'sı. Oyuncular oyun içi para biriminizi kazanır.

Oyuncuların teklifleri tamamlayarak oyun içi para biriminizi kazanmasını sağlayın; oyununuzda banner reklam olmadan. Tek bir Unity paketi Android ve iOS'u kapsar ve her ödül oyun sunucunuza imzalı bir postback olarak ulaşır.

  • 2022.3+Unity LTS veya Unity 6
  • 2.0.1Güncel sürüm
  • 2Platform, tek paket
Unity SDKSürüm 2.0.1
EarnButton.cs
using MoonetixOfferwall;
 
void Awake()
{
    Moonetix.Init("YOUR_APP_ID");
}
 
public void ShowOfferwall(string token)
{
    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. Paketi kurun

    Moonetix scoped registry'sini ve paketi Packages/manifest.json dosyasına ekleyin ya da registry'yi Project Settings'te ekleyip Moonetix Offerwall'u Package Manager'dan kurun. Android ve iOS SDK'ları onunla birlikte gelir.

    Packages/manifest.json
    {
      "scopedRegistries": [
        {
          "name": "Moonetix",
          "url": "https://moonetix.com/upm",
          "scopes": ["com.moonetix"]
        }
      ],
      "dependencies": {
        "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 yeni bir token ile Open'ı çağırın. Tüm olaylar Unity ana iş parçacığında gelir, böylece arayüzünüzü doğrudan güncelleyebilirsiniz. Paket ayrıca bir Offerwall demo örneği içerir.

    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. Ö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
Elmas kazan12,450 Elmas
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 Elmas
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.

Paketin sizin için hallettikleri

  • Android ve iOS derlemeleri

    Android'de Gradle projenize Maven deposunu, SDK'yı ve R8 kuralını ekler. iOS'ta iOS SDK'sını Xcode'da bağlar ve gömer.

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

    Google Play'e veya App Store'a yönlendiren teklifler mağaza uygulamasında açılır; böylece kurulumlar doğru şekilde izlenir.

  • Oyununuzun içinde anahtar yok

    Oyununuz yalnızca App ID'yi tutar. Session'lar sunucunuzdan gelir ve bir kez çalışır.

  • Ana iş parçacığında olaylar

    OnOpened, OnClosed ve OnError Unity ana iş parçacığında tetiklenir, arayüzünüz için hazırdır.

  • Oyun içi para biriminiz

    Ödüller, sizin kurunuz ve kullanıcı payınızla, kendi para biriminizde gösterilir ve hesaba yazılır.

  • Reklam kimliği yok

    SDK reklam kimliğini kullanmaz ve oyuncuları 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.

Unity 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 ilk sahnenizin Awake metodunda çağırın.

  • Unsupported

    Oyun Unity Editor'da, masaüstünde veya WebGL'de çalışıyor.

    ÇözümAndroid veya iOS için derleyin ve düğmeyi göstermeden önce Moonetix.IsSupported değerini kontrol edin.

  • iOS build stops on the iOS version

    Player Settings'teki Target minimum iOS Version 13.0'ın altında.

    Çözüm13.0 veya üstüne 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.

Unity soruları

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

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

Hangi Unity sürümleri destekleniyor?

Unity 2022.3 LTS veya Unity 6 (6000.0) ya da daha yenisi. iOS'ta Player Settings'te minimum iOS sürümünü 13.0 veya üstüne ayarlayın.

Android ve iOS derlemelerinde çalışıyor mu?

Evet. Tek paket ikisini de kapsar. Unity, Android SDK'yı Gradle projesine ve iOS SDK'yı Xcode projesine kendisi ekler; dışa aktarılan projeler ve özel Gradle şablonları dahil.

Moonetix Unity paketini nasıl kurarım?

Moonetix scoped registry'sini ve com.moonetix.offerwall'u Packages/manifest.json dosyasına ekleyin ya da Package Manager'daki My Registries bölümünden kurun. Bir tarball'dan da kurabilirsiniz.

Offerwall pay-to-win midir?

Hayır. Oyuncular, oynayarak kazanacakları aynı para birimini reklamverenlerin uygulamalarını ve oyunlarını deneyerek kazanır. Bu, ödeme yapmayan oyunculara oyununuzda banner reklam olmadan ilerleme yolu sunar.

Oyunculara ödülü nasıl güvenle yüklerim?

Ödülleri istemci olaylarından değil, her zaman oyun sunucunuzda imzalı postback'ten yükleyin, çünkü oyuncular olayları taklit edebilir. OnClosed tetiklendiğinde oyuncunun bakiyesini sunucunuzdan yükleyin.

Unity Editor'da test edebilir miyim?

Akışınızı test edebilirsiniz. Editor'da, masaüstünde ve WebGL'de Open, App ID'yi ve token'ı kontrol eder ve ardından Unsupported bildirir; Moonetix.IsSupported false olur. Offerwall'un kendisini görmek için Android veya iOS için derleyin ve bir telefonda ya da iOS Simulator'da test edin.

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