Offerwall cho mọi trang web. Liên kết, iframe hoặc nút.
Đặt offerwall Moonetix trên mọi trang web, từ WordPress đến ứng dụng tùy chỉnh, bằng liên kết đã ký, iframe hoặc nút nổi. Người dùng của bạn kiếm đơn vị tiền tệ của bạn, và mọi phần thưởng tới máy chủ của bạn dưới dạng postback có chữ ký.
- 3Cách hiển thị
- 0SDK cần cài đặt
- HTTPSMọi trang web, mọi công nghệ
<iframe title="Offerwall"
src="https://wall.moonetix.com/APP_ID?user_id=USER_ID&hash=HASH"
style="border:0;width:100%;height:100vh"></iframe>Triển khai trong ba bước.
Sao chép mã, thay các giá trị giữ chỗ bằng giá trị từ bảng điều khiển của bạn trong "Offerwall", offerwall của bạn, "Tích hợp", và thử nghiệm trước khi ra mắt.
-
Tạo liên kết đã ký trên máy chủ của bạn
Mỗi liên kết mang ID của người dùng đã đăng nhập và một mã hash HMAC-SHA256 được tạo bằng link hash salt của bạn. Mã hash ngăn bất kỳ ai đổi ID người dùng để mở offerwall dưới danh nghĩa người khác, vì vậy hãy tạo nó trên máy chủ và không bao giờ đặt salt trong trang.
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}" -
Hiển thị theo cách phù hợp với trang web của bạn
Mở liên kết từ menu, nhúng vào một trang riêng, hoặc thêm nút nổi vào mọi trang. Bạn có thể dùng nhiều cách cùng lúc: tất cả đều dùng chung phần thưởng và postback.
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>Liên kếthttps://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}&sub1=homepage -
Cộng thưởng bằng postback
Mọi phần thưởng tới máy chủ của bạn dưới dạng postback có chữ ký. Hãy kiểm tra mã hash, cộng thưởng một lần cho mỗi ID giao dịch, và lấy lại nếu một postback sau đó thu hồi nó. Postback thất bại được gửi lại tối đa 5 lần.
Bảng điều khiển, tab "Postback"https://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 TownĐạt cấp 15+1,500
WPS OfficeCài đặt và mở+2,000
Bus EscapeĐạt cấp 20+450
CapCutSign up in the app+800
Ngay trên trang của bạn
Nút nổi mở offerwall trong một pop-up, nên người dùng không bao giờ rời khỏi trang đang xem.
Mọi thứ offerwall làm cho bạn
- Một trang offerwall đầy đủ
Tab Earn và My offers, tìm kiếm, danh mục và sắp xếp, với các offer phù hợp với quốc gia và thiết bị của từng người dùng.
- Đơn vị tiền tệ của bạn
Mọi phần thưởng được hiển thị bằng tên và biểu tượng tiền tệ của riêng bạn, tính theo tỷ lệ quy đổi và tỷ lệ chia cho người dùng.
- Thương hiệu của bạn
Màu sắc, độ bo góc, khoảng đệm, cỡ chữ và biểu tượng tiền tệ đều được đặt trong bảng điều khiển, không cần viết mã.
- Liên kết đã ký
"Bảo mật liên kết" được bật mặc định, nên không ai có thể mở offerwall của bạn dưới danh nghĩa một người dùng của bạn.
- Sub ID
Thêm tối đa năm giá trị của riêng bạn, chẳng hạn trang hoặc chiến dịch, và nhận lại chúng trong mọi postback và báo cáo.
- Hỗ trợ người dùng
Người dùng theo dõi offer của họ trong My offers và có thể báo cáo phần thưởng bị thiếu ngay từ offer đó.
Thử nghiệm, rồi ra mắt.
Mọi thứ bạn cần kiểm tra trước khi người dùng thật thấy offerwall của bạn, với các công cụ có sẵn trong bảng điều khiển.
Mở với tư cách người dùng thử nghiệm
Trong "Trạng thái tích hợp" ở tab "Tích hợp", hãy mở offerwall của bạn với tư cách người dùng owner-test. Lượt truy cập thử nghiệm không được tính là người dùng.
Kiểm tra liên kết
Dán một liên kết mà trang web của bạn đã tạo, hoặc nhập ID người dùng để xem chính xác liên kết mà máy chủ của bạn nên tạo. Hai liên kết phải giống hệt nhau.
Gửi postback thử nghiệm
Chọn người dùng, trạng thái và mức thanh toán, rồi xem chính xác máy chủ của bạn đã trả lời gì, kèm mã phản hồi và thời gian. ID giao dịch thử nghiệm bắt đầu bằng test_.
Thử nghiệm từ một kết nối bình thường
VPN, proxy, Tor và mạng đám mây đều bị chặn, vì vậy hãy thử nghiệm qua Wi-Fi gia đình hoặc dữ liệu di động, ở quốc gia có offer đang chạy.
Danh sách kiểm tra trước khi ra mắt
0 / 11 mục đã sẵn sàng
Sẵn sàng ra mắt. Tiến độ của bạn được lưu trong trình duyệt này.
Lỗi thường gặp, khắc phục nhanh.
Những lỗi bạn có thể gặp khi tích hợp offerwall vào trang web, nguyên nhân và cách khắc phục.
Link not validMã hash không khớp với ID người dùng trong link.
Khắc phụcKý đúng ID người dùng bằng link hash salt, không phải khóa bí mật postback, dưới dạng hex chữ thường.
Missing user IDID người dùng trống hoặc có ký tự mà chúng tôi không chấp nhận.
Khắc phụcDùng 1 đến 100 ký tự trong A-Z a-z 0-9 . _ @ : + - và mã hóa URL (URL-encode).
Blank iframe or pop-upTrang không nằm trên trang web bạn đã đăng ký cho ứng dụng, hoặc không dùng https.
Khắc phụcNhúng nó vào một trang https thuộc tên miền đó hoặc một tên miền phụ. Với trang web khác, hãy thêm một ứng dụng mới.
No floating buttondata-button-url bị thiếu hoặc không phải là liên kết offerwall.
Khắc phụcDùng liên kết đã ký đầy đủ, bắt đầu bằng https://wall.moonetix.com/.
VPN or Proxy detectedBạn đang thử nghiệm qua VPN, proxy hoặc mạng đám mây.
Khắc phụcThử nghiệm từ một kết nối gia đình hoặc di động bình thường.
Fewer offers than expectedBạn đã ẩn một số offer, hoặc quốc gia hay thiết bị đó có ít offer đang chạy hơn.
Khắc phụcMở "Offer" trong bảng điều khiển, đặt "Trạng thái" thành "Đã ẩn", và nhấn "Hiện" để đưa một offer trở lại.
Postback log shows 403 or 404Script của bạn đã từ chối postback, hoặc URL bị sai.
Khắc phụcMở URL trong log bằng trình duyệt và kiểm tra mã hash của bạn.
Postback log shows a timeoutScript của bạn mất hơn 6 giây để trả lời.
Khắc phụcTrả lời 200 trước, rồi chạy các tác vụ chậm ở chế độ nền.
Postback log shows 301 or 302URL của bạn có chuyển hướng, ví dụ từ http sang https.
Khắc phụcDùng URL cuối cùng. Postback không đi theo chuyển hướng.
Không tìm thấy. Xem danh sách đầy đủ trong tài liệu hoặc liên hệ với chúng tôi.
Tổng quan nhanh
- Hoạt động trên
- Mọi trang web https: WordPress, Next.js, Laravel, HTML thuần và nhiều hơn nữa
- Cách hiển thị
- Liên kết, iframe, nút nổi hoặc nút của riêng bạn
- Quy tắc nhúng
- Frame và pop-up tải trên trang web bạn đã đăng ký và các tên miền phụ của nó
- Kích thước script
- Một đoạn script nhỏ, chỉ dành cho nút và pop-up
- Phần thưởng
- Postback server-to-server có chữ ký, gửi lại tối đa 5 lần
- Giá
- Miễn phí cho publisher đã được duyệt
Bắt đầu từ mã chạy được
- Next.jsMột trang Earn bằng Next.js với liên kết offerwall được ký trên máy chủ và một route postback đã xác minh.
- LaravelMột ứng dụng Laravel với trang Earn và một route postback cộng thưởng cho mỗi offer đúng một lần.
- DjangoMột ứng dụng Django với trang Earn và một postback view cộng thưởng cho mỗi offer đúng một lần.
- Trang web phần thưởngMột trang web phần thưởng nhỏ với tài khoản, số dư, trang Earn, postback đã xác minh và yêu cầu đổi thưởng do bạn duyệt.
Cách tích hợp khác
- Offers APILấy danh sách offer dưới dạng JSON và hiển thị theo thiết kế của riêng bạn.
- Android SDKMàn hình offerwall native cho ứng dụng Kotlin và Java.
- iOS SDKOfferwall native cho Swift, SwiftUI và Objective-C.
- Unity SDKOffer có thưởng cho game Android và iOS, từ C#.
- Flutter SDKMột plugin Dart cho Android và iOS.
- React Native SDKDành cho ứng dụng React Native và Expo, có kèm kiểu TypeScript.
- Tất cả tích hợpSo sánh song song.
Câu hỏi về trang web
Những điều nhà phát triển thường hỏi trước khi thêm offerwall vào trang web.
Gặp vướng mắc? Liên hệ với chúng tôi
Tôi có cần cài đặt gì để thêm offerwall vào trang web của mình không?
Không. Offerwall chạy trên Moonetix. Bạn thêm một liên kết đã ký vào trang web, nhúng bằng iframe hoặc tải một đoạn script nhỏ cho nút nổi. Máy chủ của bạn chỉ tạo liên kết và nhận postback.
Có hoạt động với WordPress không?
Có. Tạo liên kết đã ký trong một plugin nhỏ hoặc trong theme của bạn bằng ví dụ PHP, rồi nhúng vào trang Earn hoặc thêm nút nổi. Academy có hướng dẫn WordPress từng bước.
Vì sao liên kết cần mã hash?
Mã hash là HMAC-SHA256 của ID người dùng, được tạo bằng link hash salt của bạn. Nó chứng minh rằng máy chủ của bạn đã tạo liên kết cho người dùng đó, nên không ai có thể đổi ID người dùng trên thanh địa chỉ để kiếm tiền dưới danh nghĩa người khác.
Vì sao offerwall không tải trong iframe của tôi?
Vì lý do an toàn, frame và pop-up chỉ tải trên các trang https của trang web bạn đã đăng ký cho ứng dụng và các tên miền phụ của nó. Mở liên kết trực tiếp trong tab, cửa sổ mới hoặc WebView di động thì hoạt động ở mọi nơi.
Người dùng của tôi nhận phần thưởng như thế nào?
Moonetix gửi một postback có chữ ký tới máy chủ của bạn cho mỗi phần thưởng. Máy chủ của bạn kiểm tra mã hash và cộng thưởng cho người dùng bằng đơn vị tiền tệ của bạn. Nếu sau đó bị thu hồi, postback sẽ đến với cùng ID giao dịch, để bạn có thể lấy lại phần thưởng.
Tôi có thể chọn những offer nào được hiển thị không?
Có. Trên trang "Offer" trong bảng điều khiển, bạn có thể ẩn bất kỳ offer nào, và nó sẽ biến mất khỏi offerwall, offerwall nhúng, nút nổi và Offers API của ứng dụng đó.
Biến lưu lượng truy cập thành thu nhập.
Tạo tài khoản publisher miễn phí và kiếm tiền từ mỗi offer mà người dùng hoàn thành trên trang web, ứng dụng, game hoặc cộng đồng của bạn.