Offerwall untuk situs web apa pun. Link, iframe, atau tombol.
Pasang offerwall Moonetix di situs web apa pun, dari WordPress hingga aplikasi kustom, dengan link bertanda tangan, iframe, atau tombol mengambang. Pengguna Anda mendapatkan mata uang Anda, dan setiap hadiah sampai ke server Anda sebagai postback bertanda tangan.
- 3Cara menampilkannya
- 0SDK yang perlu diinstal
- HTTPSSitus apa pun, stack apa pun
<iframe title="Offerwall"
src="https://wall.moonetix.com/APP_ID?user_id=USER_ID&hash=HASH"
style="border:0;width:100%;height:100vh"></iframe>Mulai live dalam tiga langkah.
Salin kode, ganti placeholder dengan nilai dari dasbor Anda di Offerwall, offerwall Anda, Integrasi, lalu uji sebelum Anda meluncurkannya.
-
Buat link bertanda tangan di server Anda
Setiap link membawa ID pengguna Anda yang sedang login dan hash HMAC-SHA256 yang dibuat dengan link hash salt Anda. Hash ini mencegah siapa pun mengubah user ID untuk membuka offerwall sebagai orang lain, jadi buatlah di server Anda dan jangan pernah menaruh salt di halaman.
offerwall.php<?php // Build the link on your server, for the signed-in user $hash = hash_hmac('sha256', $userId, $linkHashSalt); $url = 'https://wall.moonetix.com/' . $appId . '?user_id=' . rawurlencode($userId) . '&hash=' . $hash;offerwall.js// Build the link on your server, for the signed-in user const crypto = require('crypto'); const hash = crypto.createHmac('sha256', linkHashSalt) .update(String(userId)) .digest('hex'); const url = `https://wall.moonetix.com/${appId}` + `?user_id=${encodeURIComponent(userId)}&hash=${hash}`;offerwall.py# Build the link on your server, for the signed-in user import hmac, hashlib from urllib.parse import quote uid = str(user_id) hash = hmac.new(link_hash_salt.encode(), uid.encode(), hashlib.sha256).hexdigest() url = f"https://wall.moonetix.com/{app_id}?user_id={quote(uid)}&hash={hash}" -
Tampilkan dengan cara yang sesuai dengan situs Anda
Buka link dari menu Anda, sematkan di halamannya sendiri, atau tambahkan tombol mengambang ke setiap halaman. Anda dapat menggunakan lebih dari satu sekaligus: semuanya berbagi hadiah dan postback yang sama.
earn.html<iframe title="Offerwall" src="https://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}" style="border:0;width:100%;height:100vh"></iframe>layout.html<script src="https://wall.moonetix.com/embed.js" async data-button-url="https://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}" data-button-text="Earn rewards" data-button-color="#004ABB" data-button-position="right"></script>menu.html<a href="https://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}" data-moonetix-open>Earn rewards</a> <script src="https://wall.moonetix.com/embed.js" async></script>Linkhttps://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}&sub1=homepage -
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
Langsung di halaman Anda
Tombol mengambang membuka offerwall dalam pop-up, sehingga pengguna tidak pernah meninggalkan halaman yang sedang mereka buka.
Semua yang dikerjakan offerwall untuk Anda
- Halaman offerwall penuh
Tab Earn dan My offers, pencarian, kategori, dan pengurutan, dengan penawaran yang sesuai dengan negara dan perangkat setiap pengguna.
- Mata uang Anda
Setiap hadiah ditampilkan dengan nama dan ikon mata uang Anda sendiri, dihitung dengan nilai konversi dan bagian pengguna Anda.
- Merek Anda
Warna, radius sudut, padding, ukuran font, dan ikon mata uang diatur di dasbor Anda, tanpa kode.
- Link bertanda tangan
Opsi "Keamanan tautan" aktif secara default, sehingga tidak ada yang bisa membuka offerwall Anda sebagai salah satu pengguna Anda.
- Sub ID
Tambahkan hingga lima nilai Anda sendiri, seperti halaman atau kampanye, dan dapatkan kembali nilai tersebut di setiap postback dan laporan.
- Dukungan pengguna
Pengguna memantau penawaran mereka di My offers dan dapat melaporkan hadiah yang tidak masuk langsung dari penawaran tersebut.
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.
Periksa link
Tempel link yang dibuat situs Anda, atau ketik user ID untuk melihat link persis yang seharusnya dibuat server Anda. Keduanya harus identik.
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 offerwall ke situs web, penyebabnya, dan solusinya.
Link not validHash tidak cocok dengan user ID di link.
SolusiTanda tangani user ID yang persis sama dengan link hash salt, bukan postback secret key, dalam format hex huruf kecil.
Missing user IDUser ID kosong atau berisi karakter yang tidak kami terima.
SolusiGunakan 1 hingga 100 karakter dari A-Z a-z 0-9 . _ @ : + - dan lakukan URL-encode.
Blank iframe or pop-upHalaman tidak berada di situs web yang Anda daftarkan untuk aplikasi tersebut, atau tidak menggunakan https.
SolusiSematkan di halaman https pada domain tersebut atau subdomainnya. Untuk situs lain, tambahkan aplikasi baru.
No floating buttondata-button-url tidak ada atau bukan link offerwall.
SolusiGunakan link bertanda tangan lengkap yang diawali https://wall.moonetix.com/.
VPN or Proxy detectedAnda melakukan pengujian melalui VPN, proxy, atau jaringan cloud.
SolusiUji dari koneksi rumah atau seluler biasa.
Fewer offers than expectedAnda menyembunyikan beberapa penawaran, atau lebih sedikit penawaran yang tersedia di negara atau perangkat tersebut.
SolusiBuka "Penawaran" di dasbor Anda, atur "Status" ke "Tersembunyi", lalu klik "Tampilkan" untuk memunculkan kembali sebuah penawaran.
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
- Berfungsi di
- Situs web https apa pun: WordPress, Next.js, Laravel, HTML biasa, dan lainnya
- Cara menampilkannya
- Link, iframe, tombol mengambang, atau tombol Anda sendiri
- Aturan embed
- Frame dan pop-up dimuat di situs web yang Anda daftarkan beserta subdomainnya
- Ukuran skrip
- Satu skrip kecil, hanya untuk tombol dan pop-up
- Hadiah
- Postback server-to-server bertanda tangan, dicoba ulang hingga 5 kali
- Harga
- Gratis untuk publisher yang disetujui
Mulai dari kode yang berfungsi
- Next.jsHalaman Earn Next.js dengan link offerwall bertanda tangan server dan route postback yang terverifikasi.
- LaravelAplikasi Laravel dengan halaman Earn dan route postback yang mengkreditkan setiap penawaran tepat satu kali.
- DjangoAplikasi Django dengan halaman Earn dan view postback yang mengkreditkan setiap penawaran tepat satu kali.
- Situs hadiahSitus hadiah kecil dengan akun, saldo, halaman Earn, postback terverifikasi, dan permintaan penukaran yang Anda setujui.
Integrasi lainnya
- Offers APIDapatkan penawaran dalam format JSON dan tampilkan dengan desain Anda sendiri.
- Android SDKLayar offerwall native untuk aplikasi Kotlin dan Java.
- iOS SDKOfferwall native untuk Swift, SwiftUI, dan Objective-C.
- 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 situs web
Pertanyaan developer sebelum menambahkan integrasi situs web.
Mengalami kendala? Hubungi kami
Apakah saya perlu menginstal sesuatu untuk menambahkan offerwall ke situs web saya?
Tidak. Offerwall berjalan di Moonetix. Anda menambahkan link bertanda tangan ke situs Anda, menyematkannya dengan iframe, atau memuat satu skrip kecil untuk tombol mengambang. Server Anda hanya membuat link dan menerima postback.
Apakah ini berfungsi dengan WordPress?
Ya. Buat link bertanda tangan di plugin kecil atau di tema Anda dengan contoh PHP, lalu sematkan di halaman Earn atau tambahkan tombol mengambang. Academy memiliki panduan WordPress langkah demi langkah.
Mengapa link memerlukan hash?
Hash adalah HMAC-SHA256 dari user ID, yang dibuat dengan link hash salt Anda. Hash ini membuktikan bahwa server Anda yang membuat link untuk pengguna tersebut, sehingga tidak ada yang bisa mengubah user ID di address bar dan mendapatkan penghasilan sebagai orang lain.
Mengapa offerwall tidak dimuat di iframe saya?
Demi keamanan, frame dan pop-up hanya dimuat di halaman https dari situs web yang Anda daftarkan untuk aplikasi tersebut beserta subdomainnya. Membuka link langsung di tab, jendela baru, atau WebView seluler dapat dilakukan di mana saja.
Bagaimana pengguna saya mendapatkan hadiah mereka?
Moonetix mengirimkan postback bertanda tangan ke server Anda untuk setiap hadiah. Server Anda memeriksa hash dan mengkreditkan pengguna dalam mata uang Anda. Pembatalan di kemudian hari dikirim dengan ID transaksi yang sama, sehingga Anda dapat menarik kembali hadiahnya.
Apakah saya bisa memilih penawaran yang ditampilkan?
Ya. Di halaman "Penawaran" pada dasbor Anda, Anda dapat menyembunyikan penawaran apa pun, dan penawaran itu hilang dari offerwall, offerwall yang disematkan, tombol mengambang, dan Offers API aplikasi tersebut.
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.