SDK offerwall iOS. Swift, SwiftUI, dan Objective-C.
Buka offerwall Moonetix di aplikasi iPhone dan iPad Anda dengan satu paket Swift. Paket ini hanya menggunakan UIKit dan WebKit, tanpa dependensi pihak ketiga, dan dilengkapi privacy manifest.
- 13+iOS dan iPadOS
- 2.0.1Versi saat ini
- 0Dependensi pihak ketiga
import MoonetixOfferwall
Moonetix.configure(appId: "YOUR_APP_ID")
// When the user taps Earn
Moonetix.open(token: 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.
-
Instal SDK
Tambahkan paket di Xcode melalui File, Add Package Dependencies, atau gunakan CocoaPods. Anda juga dapat mengunduh xcframework dan menyematkannya secara manual. Build dengan Xcode 16 atau yang lebih baru.
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' -
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']);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 -
Buka offerwall
Lakukan configure satu kali dengan App ID dari dasbor Anda, lalu buka offerwall dengan token baru. Tanpa view controller, SDK menampilkannya dari layar teratas aplikasi Anda, sehingga juga berfungsi dari SwiftUI.
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]; -
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.
Dasbor, tab Postbackhttps://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 TownCapai level 15+1,500
WPS OfficeInstal dan buka+2,000
Bus EscapeCapai level 20+450
CapCutSign up in the app+800
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 SDK untuk Anda
- Penawaran dibuka di tempat yang tepat
Penawaran yang mengarah ke App Store dibuka di aplikasi store, dan situs lain dibuka di browser, sehingga instalasi terlacak dengan benar.
- Tanpa key di dalam aplikasi Anda
Aplikasi Anda hanya menyimpan App ID. Sesi dibuat di server Anda dan hanya berlaku satu kali, sehingga tidak ada yang bisa membuka offerwall sebagai pengguna lain.
- Layar yang terkunci
Hanya halaman offerwall yang dimuat di dalamnya, tanpa jembatan JavaScript ke aplikasi Anda.
- Navigasi native
Tombol tutup kembali ke aplikasi Anda, menggeser dari tepi kiri bergerak mundur di dalam offerwall, dan offerwall melanjutkan dari posisi terakhir pengguna setelah berada di latar belakang.
- Aksesibel secara default
Mode terang dan gelap, ukuran teks yang lebih besar, dan VoiceOver langsung berfungsi.
- Termasuk privacy manifest
SDK dilengkapi privacy manifest, tidak menggunakan device fingerprinting, dan tidak menggunakan advertising identifier.
Uji dulu, lalu luncurkan.
Semua yang perlu Anda periksa sebelum pengguna sungguhan melihat offerwall Anda, dengan alat yang sudah tersedia di dasbor Anda.
Buka sebagai pengguna uji
Di "Status integrasi" pada tab "Integrasi", buka offerwall Anda sebagai pengguna owner-test. Kunjungan uji tidak dihitung sebagai pengguna.
Jalankan di perangkat sungguhan
Build untuk Android atau iOS dan buka offerwall dari tombol Earn Anda dengan token baru setiap kali.
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_.
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
Siap diluncurkan. Progres Anda disimpan di browser ini.
Error umum, cepat teratasi.
Hal yang mungkin Anda temui saat mengintegrasikan iOS SDK, penyebabnya, dan solusinya.
INVALID_APP_IDNilai 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_TOKENAplikasi 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_USEDToken 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_INITIALIZEDopen dipanggil sebelum init.
SolusiPanggil Moonetix.configure saat aplikasi Anda dimulai.
UNKNOWNOfferwall sudah terbuka, atau tidak ada view controller di layar yang dapat digunakan untuk menampilkannya.
SolusiBuka satu per satu, dan berikan view controller yang terlihat dengan open(token:from:).
Delegate is never calledMoonetix.delegate adalah weak reference, sehingga objeknya sudah dilepaskan.
SolusiSimpan strong reference ke delegate Anda, atau gunakan closure.
403 from /v1/sessionapp_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 detectedPerangkat 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 404Skrip Anda menolak postback, atau URL-nya salah.
SolusiBuka URL dari log di browser dan periksa kode hash Anda.
Postback log shows a timeoutSkrip 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 302URL Anda melakukan redirect, misalnya dari http ke https.
SolusiGunakan URL akhir. Postback tidak mengikuti redirect.
Tidak ditemukan. Lihat daftar lengkap di dokumentasi atau hubungi kami.
Sekilas pandang
- Versi minimum
- iOS 13, iPhone dan iPad, di-build dengan Xcode 16 atau yang lebih baru
- Bahasa
- Swift, SwiftUI, dan Objective-C
- Instal
- Swift Package Manager, CocoaPods, atau xcframework
- Dependensi
- Hanya UIKit dan WebKit
- Privasi
- Termasuk privacy manifest, tanpa advertising identifier
- Harga
- Gratis untuk publisher yang disetujui
Mulai dari kode yang berfungsi
Integrasi lainnya
- Situs webLink, iframe, atau tombol Earn mengambang. Tanpa SDK.
- Offers APIDapatkan penawaran dalam format JSON dan tampilkan dengan desain Anda sendiri.
- Android SDKLayar offerwall native untuk aplikasi Kotlin dan Java.
- Unity SDKPenawaran berhadiah untuk game Android dan iOS, dari C#.
- Flutter SDKSatu plugin Dart untuk Android dan iOS.
- React Native SDKUntuk aplikasi React Native dan Expo, dengan tipe TypeScript.
- Semua integrasiBandingkan secara berdampingan.
Pertanyaan seputar iOS
Pertanyaan developer sebelum menambahkan iOS SDK.
Mengalami kendala? Hubungi kami
Versi iOS mana saja yang didukung Moonetix SDK?
iOS 13 atau yang lebih baru di iPhone dan iPad, di-build dengan Xcode 16 atau yang lebih baru. SDK hanya menggunakan UIKit dan WebKit dan tidak memiliki dependensi pihak ketiga.
Apakah saya bisa menggunakannya dengan SwiftUI?
Ya. Panggil Moonetix.open(token:) tanpa view controller dan SDK akan menampilkannya dari layar teratas aplikasi Anda, yang berfungsi dari tombol SwiftUI.
Bagaimana cara menginstalnya?
Dengan Swift Package Manager dari https://moonetix.com/ios/moonetix-ios.git, dengan CocoaPods dari podspec kami, atau dengan menyematkan xcframework secara manual.
Apa yang perlu saya deklarasikan di detail privasi App Store?
User ID, Device ID, Coarse Location, dan Product Interaction, semuanya terhubung dengan pengguna, tidak digunakan untuk pelacakan, untuk App Functionality. Privacy manifest SDK mencantumkan data yang sama.
Apakah offerwall melanggar aturan review App Store?
Apple memiliki aturan untuk aplikasi yang memberi hadiah kepada pengguna. Academy memiliki panduan menjalankan offerwall di aplikasi iOS sesuai aturan tersebut, termasuk cara merumuskan hadiah Anda.
Bagaimana pengguna mendapatkan hadiah?
Server Anda menerima postback bertanda tangan untuk setiap hadiah dan mengkreditkan pengguna. Jangan pernah mengkreditkan dari event aplikasi, karena event dapat dipalsukan di perangkat.
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.