오퍼월 링크 빌더 사용 방법
대시보드의 오퍼월, 해당 오퍼월, 연동에서 App ID와 링크 해시 솔트를 복사하세요. 테스트 계정의 사용자 ID를 입력하고, 지면을 추적한다면 sub ID를 추가하세요. 빌더가 해시, 서명된 전체 링크, 바로 붙여 넣을 수 있는 iframe 및 Earn 버튼 코드를 보여 줍니다. 입력한 내용은 어디에도 전송되지 않으며, 해시는 Web Crypto API로 브라우저에서 계산됩니다.
자체 서버 코드를 확인하는 데 사용하세요. 같은 사용자 ID로 서버가 만든 링크가 여기의 링크와 다르면, 차이는 Moonetix가 아니라 코드에 있습니다.
해시 생성 방식
hash = HMAC-SHA256(user_id, link_hash_salt), as lowercase hex
link = https://wall.moonetix.com/APP_ID?user_id=USER_ID&hash=HASH
사용자 ID가 메시지이고 솔트가 키입니다. sub ID는 해시에 포함되지 않아 사용자가 바꿀 수 있으므로, 추적에만 쓰고 적립에는 절대 쓰지 마세요. 오퍼월 링크 문서에 PHP, Node.js, Python으로 된 같은 코드가 있습니다.
솔트는 서버에 보관하세요
이 페이지는 테스트 도구입니다. 실제 운영 환경에서는 서버에서 해시를 만들고 완성된 링크만 브라우저나 앱으로 보내세요. JavaScript, 앱 번들, 공개 저장소에 솔트가 있으면 누구나 내 사용자인 척 오퍼월을 열 수 있습니다. 솔트가 유출되면 교체하세요. 키와 링크 솔트를 교체하는 방법에서 안전한 순서를 설명합니다.
자주 발생하는 문제
- Link not valid (403). 해시가 사용자 ID와 일치하지 않습니다. postback 시크릿 키가 아니라 링크 해시 솔트로, 링크에 넣은 사용자 ID 문자열을 그대로 해시했는지 확인하세요.
- 숫자와 문자열. 사용자 ID는 문자열로 해시하세요.
42와042는 서로 다른 사용자입니다. - 인코딩. 원래 사용자 ID를 해시한 다음 링크에서 URL 인코딩하세요. 인코딩된 값을 해시하지 마세요.
자주 묻는 질문
여기에 링크 해시 솔트를 입력해도 안전한가요?
이 페이지는 어디에도 전송하지 않지만, 테스트 앱이나 테스트 솔트를 쓰는 편이 더 좋은 습관입니다. 실제 솔트를 클라이언트 측 코드에 절대 넣지 마세요.
Moonetix 오퍼월 링크는 어떤 해시를 사용하나요?
링크 해시 솔트를 키로 사용한 사용자 ID의 HMAC-SHA256 값(소문자 16진수).
sub ID가 해시에 영향을 주나요?
아닙니다. sub ID는 해시에 포함되지 않으므로 해시를 다시 만들지 않고도 추가하거나 변경할 수 있습니다.
이 링크를 모바일 앱에서 사용할 수 있나요?
네. 백엔드에서 링크를 생성한다면 WebView나 시스템 브라우저에서 사용할 수 있습니다. 네이티브 화면에서는 대신 세션 토큰과 함께 Android, iOS, Unity, Flutter 또는 React Native SDK를 사용하세요.