iOS offerwall SDK'sı. Swift, SwiftUI ve Objective-C.
Moonetix offerwall'unu tek bir Swift paketiyle iPhone ve iPad uygulamanızda açın. Yalnızca UIKit ve WebKit kullanır, üçüncü taraf bağımlılığı yoktur ve bir privacy manifest ile gelir.
- 13+iOS ve iPadOS
- 2.0.1Güncel sürüm
- 0Üçüncü taraf bağımlılık
import MoonetixOfferwall
Moonetix.configure(appId: "YOUR_APP_ID")
// When the user taps Earn
Moonetix.open(token: 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.
-
SDK'yı kurun
Paketi Xcode'da File, Add Package Dependencies ile ekleyin veya CocoaPods kullanın. xcframework'ü indirip elle de gömebilirsiniz. Xcode 16 veya daha yenisiyle derleyin.
Package.swiftdependencies: [ .package(url: "https://moonetix.com/ios/moonetix-ios.git", from: "2.0.1"), ], targets: [ .target(name: "MyApp", dependencies: [ .product(name: "MoonetixOfferwall", package: "moonetix-ios"), ]), ]Podfilepod 'MoonetixOfferwall', :podspec => 'https://moonetix.com/ios/2.0.1/MoonetixOfferwall.podspec' -
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']);session.js// POST /api/moonetix/session: a fresh token for the signed-in user app.post('/api/moonetix/session', requireLogin, async (req, res) => { const r = await fetch('https://api.moonetix.com/v1/session', { method: 'POST', headers: { Authorization: `Bearer ${process.env.MOONETIX_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ user_id: String(req.user.id) }), signal: AbortSignal.timeout(10000), }); const data = await r.json().catch(() => ({})); if (r.status === 201 && data.token) { return res.json({ token: data.token }); } const status = r.status === 403 ? 403 : 503; res.status(status).json({ error: 'offerwall_unavailable' }); });session.py# POST /api/moonetix/session: a fresh token for the signed-in user @app.post("/api/moonetix/session") @login_required def moonetix_session(): key = os.environ["MOONETIX_API_KEY"] r = requests.post( "https://api.moonetix.com/v1/session", data={"user_id": str(current_user.id)}, headers={"Authorization": f"Bearer {key}"}, timeout=10, ) data = r.json() if r.status_code == 201 and data.get("token"): return {"token": data["token"]} status = 403 if r.status_code == 403 else 503 return {"error": "offerwall_unavailable"}, status -
Offerwall'u açın
Panelinizdeki App ID ile bir kez yapılandırın, ardından offerwall'u yeni bir token ile açın. View controller verilmezse SDK, uygulamanızın en üstteki ekranından açılır; böylece SwiftUI'dan da çalışır.
EarnViewController.swiftMoonetix.configure(appId: "YOUR_APP_ID") Moonetix.onClosed = { [weak self] in self?.refreshBalance() } Moonetix.onError = { error in print(error.code.name, error.message) } Moonetix.open(token: token, from: self)EarnButton.swiftButton("Earn coins") { Task { let token = try await api.fetchMoonetixToken() Moonetix.open(token: token) } }EarnViewController.m@import MoonetixOfferwall; [Moonetix configureWithAppId:@"YOUR_APP_ID"]; [Moonetix openWithToken:token from:self options:nil]; -
Ö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.
Panel, Postback sekmesihttps://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}postback.php<?php $tx = $_GET['tx'] ?? ''; $userId = $_GET['user'] ?? ''; $reward = $_GET['reward'] ?? ''; $status = $_GET['status'] ?? ''; $secret = getenv('MOONETIX_POSTBACK_SECRET'); $expected = hash_hmac('sha256', "$tx:$userId:$reward:$status", $secret); if (!hash_equals($expected, $_GET['hash'] ?? '')) { http_response_code(403); exit; } if ($status === '1') { credit_once($userId, $tx, $reward); // once per transaction ID } elseif ($status === '2') { reverse_if_credited($userId, $tx, $reward); } http_response_code(200);postback.jsconst crypto = require('crypto'); app.get('/postback', (req, res) => { const { tx, user, reward, status, hash } = req.query; const secret = process.env.MOONETIX_POSTBACK_SECRET; const expected = crypto.createHmac('sha256', secret) .update(`${tx}:${user}:${reward}:${status}`) .digest('hex'); const valid = typeof hash === 'string' && hash.length === expected.length && crypto.timingSafeEqual(Buffer.from(hash), Buffer.from(expected)); if (!valid) return res.sendStatus(403); if (status === '1') creditOnce(user, tx, reward); // once per transaction ID if (status === '2') reverseIfCredited(user, tx, reward); res.sendStatus(200); });postback.pyimport hmac, hashlib, os from flask import request, abort @app.get("/postback") def postback(): a = request.args parts = [a.get(k, "") for k in ("tx", "user", "reward", "status")] msg = ":".join(parts) secret = os.environ["MOONETIX_POSTBACK_SECRET"].encode() expected = hmac.new(secret, msg.encode(), hashlib.sha256).hexdigest() if not hmac.compare_digest(expected, a.get("hash", "")): abort(403) if a.get("status") == "1": credit_once(a["user"], a["tx"], a["reward"]) # once per transaction ID elif a.get("status") == "2": reverse_if_credited(a["user"], a["tx"], a["reward"]) return "", 200
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
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
App Store'a 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
Kapat düğmesi uygulamanıza döner, sol kenardan kaydırma offerwall içinde geri gider ve arka plandan dönüldüğünde kullanıcının kaldığı yerden devam eder.
- Varsayılan olarak erişilebilir
Açık ve koyu mod, büyük yazı boyutları ve VoiceOver kutudan çıktığı gibi çalışır.
- Privacy manifest dahil
SDK privacy manifest'iyle gelir, cihaz parmak izi kullanmaz ve reklam kimliğini kullanmaz.
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.
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.
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.
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.
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
Yayına hazır. İlerlemeniz bu tarayıcıda kaydedilir.
Sık görülen hatalar, hızla çözülür.
iOS SDK'yı entegre ederken karşılaşabileceğiniz durumlar, nedenleri ve çözümleri.
INVALID_APP_IDinit'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_TOKENUygulama 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_USEDToken 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_INITIALIZEDopen, init'ten önce çağrıldı.
ÇözümUygulamanız başlarken Moonetix.configure'u çağırın.
UNKNOWNOfferwall zaten açık ya da açılacağı ekranda bir view controller yoktu.
ÇözümAynı anda yalnızca bir offerwall açın ve open(token:from:) ile görünür bir view controller iletin.
Delegate is never calledMoonetix.delegate zayıf bir referanstır, bu yüzden nesne zaten serbest bırakılmıştı.
ÇözümDelegate'inize güçlü bir referans tutun veya closure'ları kullanın.
403 from /v1/sessionapp_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 detectedCihaz, 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 404Script'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 timeoutScript'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 302URL'niz yönlendirme yapıyor, örneğin http'den https'e.
ÇözümSon URL'yi kullanın. Postback'ler yönlendirmeleri takip etmez.
Eşleşme yok. Tam listeyi belgelerde görün veya bize ulaşın.
Bir bakışta
- Minimum sürüm
- iOS 13, iPhone ve iPad, Xcode 16 veya daha yenisiyle derlenmiş
- Diller
- Swift, SwiftUI ve Objective-C
- Kurulum
- Swift Package Manager, CocoaPods veya bir xcframework
- Bağımlılıklar
- Yalnızca UIKit ve WebKit
- Gizlilik
- Privacy manifest dahil, reklam kimliği yok
- Fiyat
- Onaylı yayıncılar için ücretsiz
Diğer entegrasyonlar
- Web sitesiBir link, bir iframe veya yüzen bir Earn düğmesi. SDK gerekmez.
- Offers APITeklifleri JSON olarak alın ve kendi tasarımınızda gösterin.
- Android SDKKotlin ve Java uygulamaları için native bir offerwall ekranı.
- Unity SDKC# ile Android ve iOS oyunları için ödüllü teklifler.
- Flutter SDKAndroid ve iOS için tek bir Dart eklentisi.
- React Native SDKReact Native ve Expo uygulamaları için, TypeScript tipleriyle.
- Tüm entegrasyonlarOnları yan yana karşılaştırın.
iOS soruları
Geliştiricilerin iOS SDK'yı eklemeden önce sordukları.
Bir yerde mi takıldınız? Bize ulaşın
Moonetix SDK hangi iOS sürümlerini destekliyor?
iPhone ve iPad'de iOS 13 veya daha yenisi, Xcode 16 veya daha yenisiyle derlenmiş. SDK yalnızca UIKit ve WebKit kullanır, üçüncü taraf bağımlılığı yoktur.
SwiftUI ile kullanabilir miyim?
Evet. Moonetix.open(token:)'ı view controller olmadan çağırın; SDK uygulamanızın en üstteki ekranından açılır, bu da SwiftUI düğmelerinden çalışır.
Nasıl kurarım?
https://moonetix.com/ios/moonetix-ios.git adresinden Swift Package Manager ile, podspec'imizden CocoaPods ile ya da xcframework'ü elle gömerek.
App Store gizlilik ayrıntılarında neyi beyan etmeliyim?
User ID, Device ID, Coarse Location ve Product Interaction; hepsi kullanıcıya bağlı, izleme için kullanılmaz, App Functionality amacıyla. SDK'nın privacy manifest'i aynı verileri listeler.
Offerwall, App Store inceleme kurallarını ihlal ediyor mu?
Apple'ın kullanıcıları ödüllendiren uygulamalar için kuralları vardır. Academy'de, bir iOS uygulamasında bu kurallara uygun şekilde offerwall çalıştırmaya dair bir rehber var; ödüllerinizi nasıl ifade edeceğiniz de dahil.
Kullanıcılar nasıl ödüllendirilir?
Sunucunuz her ödül için imzalı bir postback alır ve kullanıcıya yükleme yapar. Asla uygulama olaylarından yükleme yapmayın, çünkü cihazda taklit edilebilirler.
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.