Cách dùng công cụ tạo liên kết offerwall
Sao chép App ID và link hash salt từ bảng điều khiển của bạn trong mục "Offerwall", offerwall của bạn, "Tích hợp". Nhập ID người dùng của một tài khoản thử nghiệm, thêm sub ID nếu bạn theo dõi vị trí đặt, và công cụ sẽ hiển thị hash, liên kết đã ký đầy đủ cùng mã iframe và nút Earn sẵn sàng để dán. Không có gì bạn nhập được gửi đi đâu cả: hash được tính trong trình duyệt của bạn bằng Web Crypto API.
Hãy dùng nó để kiểm tra mã máy chủ của bạn. Nếu liên kết máy chủ tạo cho cùng một ID người dùng không khớp với liên kết ở đây, thì sự khác biệt nằm trong mã của bạn, không phải ở Moonetix.
Cách tạo hash
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 người dùng là thông điệp và salt là khóa. Sub ID không thuộc phần được băm, nên người dùng có thể thay đổi chúng: hãy dùng để theo dõi, không bao giờ dùng để cộng thưởng. Tài liệu về liên kết offerwall có cùng đoạn mã bằng PHP, Node.js và Python.
Giữ salt trên máy chủ của bạn
Trang này là công cụ thử nghiệm. Khi chạy thật (production), hãy tạo hash trên máy chủ và chỉ gửi liên kết hoàn chỉnh đến trình duyệt hoặc ứng dụng. Salt nằm trong JavaScript, trong gói ứng dụng hoặc trong kho mã công khai sẽ cho phép bất kỳ ai mở offerwall của bạn dưới danh nghĩa bất kỳ người dùng nào của bạn. Nếu salt bị lộ, hãy đổi nó: cách đổi khóa và link salt giải thích thứ tự an toàn.
Các lỗi thường gặp
- Liên kết không hợp lệ (403). Hash không khớp với ID người dùng. Hãy kiểm tra rằng bạn băm đúng chuỗi ID người dùng đã đặt trong liên kết, bằng link hash salt, không phải khóa bí mật postback.
- Số và chuỗi. Hãy băm ID người dùng dưới dạng chuỗi.
42và042là hai người dùng khác nhau. - Mã hóa. Hãy băm ID người dùng gốc, sau đó mã hóa URL (URL-encode) nó trong liên kết. Đừng băm giá trị đã mã hóa.
Câu hỏi thường gặp
Nhập link hash salt của tôi vào đây có an toàn không?
Trang này không bao giờ gửi nó đi đâu, nhưng dùng ứng dụng thử nghiệm hoặc salt thử nghiệm vẫn là thói quen tốt hơn. Không bao giờ đặt salt thật vào mã phía máy khách.
Liên kết offerwall Moonetix dùng loại hash nào?
HMAC-SHA256 của ID người dùng, dùng link hash salt làm khóa, ở dạng hex chữ thường.
Sub ID có làm thay đổi hash không?
Không. Sub ID không thuộc phần được băm, nên bạn có thể thêm hoặc thay đổi chúng mà không cần tạo lại hash.
Tôi có thể dùng liên kết này trong ứng dụng di động không?
Có, trong WebView hoặc trình duyệt hệ thống, nếu backend của bạn tạo liên kết. Với màn hình gốc, hãy dùng SDK Android, iOS, Unity, Flutter hoặc React Native với token phiên.