모든 웹사이트를 위한 오퍼월. 링크, iframe 또는 버튼.
WordPress부터 맞춤형 앱까지, 서명된 링크, iframe 또는 플로팅 버튼으로 어떤 웹사이트에든 Moonetix 오퍼월을 넣으세요. 사용자는 내 화폐를 얻고, 모든 리워드는 서명된 postback으로 서버에 전달됩니다.
- 3표시 방법
- 0설치할 SDK
- HTTPS모든 사이트, 모든 스택
<iframe title="Offerwall"
src="https://wall.moonetix.com/APP_ID?user_id=USER_ID&hash=HASH"
style="border:0;width:100%;height:100vh"></iframe>세 단계로 시작하세요.
코드를 복사하고, 자리 표시자를 대시보드의 오퍼월, 해당 오퍼월, 연동에 있는 값으로 바꾼 다음 출시 전에 테스트하세요.
-
서버에서 서명된 링크 생성
모든 링크에는 로그인한 사용자의 ID와 링크 해시 솔트로 만든 HMAC-SHA256 해시가 포함됩니다. 해시가 있으면 누구도 사용자 ID를 바꿔 다른 사람으로 오퍼월을 열 수 없으므로, 해시는 서버에서 생성하고 솔트는 절대 페이지에 넣지 마세요.
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}" -
사이트에 맞는 방식으로 표시하세요
메뉴에서 링크를 열거나, 별도 페이지에 삽입하거나, 모든 페이지에 플로팅 버튼을 추가하세요. 여러 방식을 함께 사용할 수 있으며, 모두 같은 리워드와 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>링크https://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}&sub1=homepage -
postback으로 리워드 적립
모든 리워드는 서명된 postback으로 서버에 전달됩니다. 해시를 확인하고, 거래 ID당 한 번만 리워드를 추가하고, 이후 postback이 취소를 알리면 회수하세요. 실패한 postback은 최대 5회까지 재시도됩니다.
대시보드, 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레벨 15 달성+1,500
WPS Office설치 후 실행+2,000
Bus Escape레벨 20 달성+450
CapCutSign up in the app+800
내 페이지에 바로
플로팅 버튼은 오퍼월을 팝업으로 열기 때문에 사용자가 보고 있던 페이지를 떠나지 않습니다.
오퍼월이 대신 처리해 주는 모든 것
- 전체 오퍼월 페이지
Earn 및 My offers 탭, 검색, 카테고리, 정렬 기능과 함께 각 사용자의 국가와 기기에 맞는 오퍼를 보여 줍니다.
- 내 화폐
모든 리워드는 환율과 사용자 배분율로 계산되어 자체 화폐 이름과 아이콘으로 표시됩니다.
- 내 브랜드
색상, 모서리 둥글기, 여백, 글꼴 크기, 화폐 아이콘을 코드 없이 대시보드에서 설정합니다.
- 서명된 링크
링크 보안이 기본으로 켜져 있어 누구도 내 사용자인 척 오퍼월을 열 수 없습니다.
- Sub ID
페이지나 캠페인 등 원하는 값을 최대 5개까지 추가하면 모든 postback과 리포트에서 그대로 돌려받을 수 있습니다.
- 사용자 지원
사용자는 My offers에서 오퍼 진행 상황을 확인하고, 오퍼에서 바로 누락된 리워드를 신고할 수 있습니다.
테스트한 다음 출시하세요.
실제 사용자가 오퍼월을 보기 전에 확인해야 할 모든 것을 대시보드에 내장된 도구로 점검하세요.
테스트 사용자로 열기
연동 탭의 연동 상태에서 owner-test 사용자로 오퍼월을 여세요. 테스트 방문은 사용자로 집계되지 않습니다.
링크 확인
사이트에서 만든 링크를 붙여 넣거나, 사용자 ID를 입력해 서버가 만들어야 할 정확한 링크를 확인하세요. 두 링크는 완전히 같아야 합니다.
테스트 postback 보내기
사용자, 상태, 지급액을 선택하고 서버가 어떻게 응답했는지 응답 코드와 시간까지 정확히 확인하세요. 테스트 거래 ID는 test_로 시작합니다.
일반 연결에서 테스트
VPN, 프록시, Tor, 클라우드 네트워크는 차단되므로, 오퍼가 운영되는 국가에서 가정용 Wi-Fi나 모바일 데이터로 테스트하세요.
출시 체크리스트
11개 중 0개 준비됨
출시 준비 완료. 진행 상황은 이 브라우저에 저장됩니다.
자주 발생하는 오류, 빠르게 해결.
웹사이트를 연동하는 동안 볼 수 있는 오류와 그 원인, 해결 방법.
Link not valid해시가 링크의 사용자 ID와 일치하지 않습니다.
해결 방법postback 비밀 키가 아닌 링크 해시 솔트로 정확한 사용자 ID에 서명하고, 소문자 hex로 보내세요.
Missing user ID사용자 ID가 비어 있거나 허용되지 않는 문자가 포함되어 있습니다.
해결 방법A-Z a-z 0-9 . _ @ : + - 중에서 1자에서 100자까지 사용하고 URL 인코딩하세요.
Blank iframe or pop-up페이지가 앱에 등록한 웹사이트에 있지 않거나 https가 아닙니다.
해결 방법해당 도메인 또는 서브도메인의 https 페이지에 삽입하세요. 다른 사이트라면 새 앱을 추가하세요.
No floating buttondata-button-url이 없거나 오퍼월 링크가 아닙니다.
해결 방법https://wall.moonetix.com/으로 시작하는 서명된 전체 링크를 사용하세요.
VPN or Proxy detectedVPN, 프록시 또는 클라우드 네트워크를 통해 테스트하고 있습니다.
해결 방법일반 가정용 또는 모바일 연결에서 테스트하세요.
Fewer offers than expected일부 오퍼를 숨겼거나, 해당 국가나 기기에서 운영되는 오퍼가 적습니다.
해결 방법대시보드에서 오퍼 페이지를 열고 상태를 숨김으로 설정한 뒤, "표시"를 클릭하면 오퍼가 다시 표시됩니다.
Postback log shows 403 or 404스크립트가 postback을 거부했거나 URL이 잘못되었습니다.
해결 방법로그에 있는 URL을 브라우저에서 열고 해시 코드를 확인하세요.
Postback log shows a timeout스크립트가 응답하는 데 6초보다 오래 걸립니다.
해결 방법먼저 200으로 응답하고, 오래 걸리는 작업은 백그라운드에서 실행하세요.
Postback log shows 301 or 302URL이 리디렉션됩니다. 예를 들어 http에서 https로 이동합니다.
해결 방법최종 URL을 사용하세요. Postback은 리디렉션을 따라가지 않습니다.
일치하는 항목이 없습니다. 문서에서 전체 목록을 보거나 문의해 주세요.
한눈에 보기
- 지원 환경
- 모든 https 웹사이트: WordPress, Next.js, Laravel, 일반 HTML 등
- 표시 방법
- 링크, iframe, 플로팅 버튼 또는 자체 버튼
- 삽입 규칙
- 프레임과 팝업은 등록한 웹사이트와 그 서브도메인에서 로드됩니다
- 스크립트 크기
- 버튼과 팝업에만 쓰는 작은 스크립트 하나
- 리워드
- 서명된 서버 간 postback, 최대 5회 재시도
- 가격
- 승인된 퍼블리셔는 무료
다른 연동 방식
- Offers API오퍼를 JSON으로 받아 자체 디자인으로 표시하세요.
- Android SDKKotlin 및 Java 앱용 네이티브 오퍼월 화면.
- iOS SDKSwift, SwiftUI, Objective-C용 네이티브 오퍼월.
- Unity SDKC#으로 구현하는 Android 및 iOS 게임용 리워드형 오퍼.
- Flutter SDKAndroid와 iOS를 모두 지원하는 Dart 플러그인 하나.
- React Native SDKTypeScript 타입이 포함된 React Native 및 Expo 앱용 패키지.
- 모든 연동 방식나란히 비교해 보세요.
웹사이트에 오퍼월을 추가하려면 무언가를 설치해야 하나요?
아니요. 오퍼월은 Moonetix에서 실행됩니다. 사이트에 서명된 링크를 추가하거나, iframe으로 삽입하거나, 플로팅 버튼용 작은 스크립트 하나를 불러오면 됩니다. 서버는 링크를 만들고 postback을 받기만 하면 됩니다.
WordPress에서 작동하나요?
네. PHP 예제를 참고해 작은 플러그인이나 테마에서 서명된 링크를 만든 다음, Earn 페이지에 삽입하거나 플로팅 버튼을 추가하세요. Academy에 단계별 WordPress 가이드가 있습니다.
링크에 해시가 필요한 이유는 무엇인가요?
해시는 링크 해시 솔트로 만든 사용자 ID의 HMAC-SHA256입니다. 서버가 해당 사용자를 위해 링크를 만들었다는 것을 증명하므로, 누구도 주소창에서 사용자 ID를 바꿔 다른 사람으로 리워드를 받을 수 없습니다.
iframe에서 오퍼월이 로드되지 않는 이유는 무엇인가요?
보안을 위해 프레임과 팝업은 앱에 등록한 웹사이트와 그 서브도메인의 https 페이지에서만 로드됩니다. 링크를 탭, 새 창, 모바일 WebView에서 직접 여는 방식은 어디서나 작동합니다.
사용자는 리워드를 어떻게 받나요?
Moonetix는 리워드가 발생할 때마다 서명된 postback을 서버로 보냅니다. 서버는 해시를 확인하고 자체 화폐로 사용자에게 적립합니다. 이후 취소가 발생하면 같은 거래 ID로 전달되므로 리워드를 회수할 수 있습니다.
표시될 오퍼를 직접 고를 수 있나요?
네. 대시보드의 오퍼 페이지에서 원하는 오퍼를 숨기면 해당 앱의 오퍼월, 삽입된 오퍼월, 플로팅 버튼, Offers API에서 모두 사라집니다.