SDK offerwall Unity. Người chơi kiếm tiền tệ trong game của bạn.

Cho phép người chơi kiếm tiền tệ trong game của bạn bằng cách hoàn thành offer, mà không có quảng cáo banner trong game. Một package Unity hỗ trợ cả Android và iOS, và mọi phần thưởng tới máy chủ game của bạn dưới dạng postback có chữ ký.

  • 2022.3+Unity LTS hoặc Unity 6
  • 2.0.1Phiên bản hiện tại
  • 2Nền tảng, một package
Unity SDKPhiên bản 2.0.1
EarnButton.cs
using MoonetixOfferwall;
 
void Awake()
{
    Moonetix.Init("YOUR_APP_ID");
}
 
public void ShowOfferwall(string token)
{
    Moonetix.Open(token);
}

Triển khai trong bốn 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.

  1. Cài đặt package

    Thêm scoped registry của Moonetix và package vào Packages/manifest.json, hoặc thêm registry trong Project Settings rồi cài Moonetix Offerwall từ Package Manager. SDK Android và iOS đi kèm sẵn.

    Packages/manifest.json
    {
      "scopedRegistries": [
        {
          "name": "Moonetix",
          "url": "https://moonetix.com/upm",
          "scopes": ["com.moonetix"]
        }
      ],
      "dependencies": {
        "com.moonetix.offerwall": "2.0.1"
      }
    }
  2. Thêm endpoint token vào máy chủ của bạn

    Ứng dụng của bạn không bao giờ giữ khóa API. Khi người dùng nhấn Earn, ứng dụng yêu cầu máy chủ của bạn tạo phiên, và máy chủ yêu cầu Moonetix cấp một token dùng một lần cho người dùng đã đăng nhập đó. Mỗi token chỉ dùng được một lần, trong 10 phút.

    session.php
    <?php
    // POST /api/moonetix/session: a fresh token for the signed-in user
    $user = current_user();
    if (!$user) {
        http_response_code(401);
        exit;
    }
     
    $key = getenv('MOONETIX_API_KEY');
    $ch  = curl_init('https://api.moonetix.com/v1/session');
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query(['user_id' => (string)$user->id]),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 10,
        CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $key],
    ]);
    $data = json_decode((string)curl_exec($ch), true);
    $code = (int)curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
     
    header('Content-Type: application/json');
    if ($code === 201 && !empty($data['token'])) {
        echo json_encode(['token' => $data['token']]);
        exit;
    }
    http_response_code($code === 403 ? 403 : 503);
    echo json_encode(['error' => 'offerwall_unavailable']);
  3. Mở offerwall

    Gọi Init một lần với App ID từ bảng điều khiển, sau đó gọi Open với token mới. Mọi sự kiện đều đến trên main thread của Unity, nên bạn có thể cập nhật UI trực tiếp. Package cũng có sẵn mẫu Offerwall demo.

    EarnButton.cs
    using MoonetixOfferwall;
    using UnityEngine;
     
    public class EarnButton : MonoBehaviour
    {
        void Awake() => Moonetix.Init("YOUR_APP_ID");
     
        void OnEnable()
        {
            Moonetix.OnClosed += RefreshBalance;
            Moonetix.OnError += HandleError;
        }
     
        void OnDisable()
        {
            Moonetix.OnClosed -= RefreshBalance;
            Moonetix.OnError -= HandleError;
        }
     
        public void ShowOfferwall(string token) => Moonetix.Open(token);
     
        void HandleError(MoonetixError error)
        {
            Debug.LogWarning(error.CodeName + ": " + error.Message);
        }
     
        void RefreshBalance() { }
    }
  4. 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.

    Macro postback và gửi lại

    Bảng điều khiển, tab "Postback"
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
9:41
Nhận ngọc12,450 ngọc
EarnMy offers
  • 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
Đã cộng phần thưởngTravel Town · +1,500 ngọc
Màn hình native
Postback 200 OK

Những gì người dùng nhìn thấy

Một màn hình native hiển thị trên ứng dụng của bạn, với tiêu đề và màu sắc của bạn, đơn vị tiền tệ của bạn, và mọi phần thưởng đều được xác nhận bằng postback.

Package xử lý những gì cho bạn

  • Bản build Android và iOS

    Trên Android, package thêm kho Maven, SDK và quy tắc R8 vào dự án Gradle. Trên iOS, package liên kết và nhúng iOS SDK trong Xcode.

  • Offer mở đúng nơi

    Offer dẫn tới Google Play hoặc App Store mở trong ứng dụng cửa hàng, nên lượt cài đặt được ghi nhận chính xác.

  • Không có khóa trong game

    Game của bạn chỉ giữ App ID. Phiên đến từ máy chủ của bạn và chỉ dùng được một lần.

  • Sự kiện trên main thread

    OnOpened, OnClosed và OnError được phát trên main thread của Unity, sẵn sàng cho UI của bạn.

  • Tiền tệ trong game của bạn

    Phần thưởng được hiển thị và cộng bằng đơn vị tiền tệ của riêng bạn, theo tỷ giá quy đổi và tỷ lệ chia cho người dùng của bạn.

  • Không dùng ID quảng cáo

    SDK không dùng mã định danh quảng cáo và không theo dõi người chơi giữa các ứng dụng.

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.

  1. 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.

  2. Chạy trên thiết bị thật

    Build cho Android hoặc iOS và mở offerwall từ nút Earn với token mới mỗi lần.

  3. 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_.

  4. 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

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 Unity SDK, nguyên nhân và cách khắc phục.

  • InvalidAppId

    Giá trị truyền vào init không phải là App ID. Truyền khóa API vào đây là lỗi phổ biến nhất.

    Khắc phụcSao chép lại App ID gồm 24 ký tự từ tab "Tích hợp".

  • InvalidToken

    Ứng dụng đã truyền thứ khác ngoài token, hoặc một token được tạo bằng khóa API của ứng dụng khác.

    Khắc phụcChỉ truyền trường token, bắt đầu bằng sst_, và dùng App ID cùng khóa API của cùng một ứng dụng.

  • TokenExpiredOrUsed

    Token đã quá 10 phút hoặc đã được dùng, ví dụ được giữ lại từ một lần nhấn trước.

    Khắc phụcTạo token mới cho mỗi lần mở, ngay khi người dùng nhấn Earn.

  • NotInitialized

    open được gọi trước init.

    Khắc phụcGọi Moonetix.Init trong Awake của scene đầu tiên.

  • Unsupported

    Game chạy trong Unity Editor, trên máy tính hoặc trong WebGL.

    Khắc phụcBuild cho Android hoặc iOS, và kiểm tra Moonetix.IsSupported trước khi hiển thị nút.

  • iOS build stops on the iOS version

    Target minimum iOS Version trong Player Settings thấp hơn 13.0.

    Khắc phụcĐặt thành 13.0 trở lên.

  • 403 from /v1/session

    app_not_live nghĩa là ứng dụng đang tạm dừng hoặc tài khoản của bạn không hoạt động. user_blocked nghĩa là chúng tôi đã chặn người dùng này.

    Khắc phụcKhông hiển thị offerwall. Với app_not_live, hãy kiểm tra thông báo của bạn.

  • VPN or Proxy detected

    Thiết bị đang dùng VPN, proxy hoặc mạng đám mây, nơi offer không thể được theo dõi.

    Khắc phụcThử nghiệm trên kết nối gia đình hoặc di động bình thường, ở quốc gia có offer đang chạy.

  • Postback log shows 403 or 404

    Script 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 timeout

    Script 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 302

    URL 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.

Câu hỏi về Unity

Những điều nhà phát triển thường hỏi trước khi thêm Unity SDK.

Gặp vướng mắc? Liên hệ với chúng tôi

Những phiên bản Unity nào được hỗ trợ?

Unity 2022.3 LTS, hoặc Unity 6 (6000.0) trở lên. Trên iOS, hãy đặt phiên bản iOS tối thiểu là 13.0 trở lên trong Player Settings.

Có hoạt động với bản build Android và iOS không?

Có. Một package hỗ trợ cả hai. Unity tự thêm Android SDK vào dự án Gradle và iOS SDK vào dự án Xcode, kể cả dự án đã xuất và Gradle template tùy chỉnh.

Làm sao để cài đặt package Moonetix Unity?

Thêm scoped registry của Moonetix và com.moonetix.offerwall vào Packages/manifest.json, hoặc cài từ My Registries trong Package Manager. Bạn cũng có thể cài từ file tarball.

Offerwall có phải là pay-to-win không?

Không. Người chơi kiếm cùng loại tiền tệ mà họ kiếm được khi chơi, bằng cách dùng thử ứng dụng và game của nhà quảng cáo. Nó mang lại cho người chơi không trả phí một cách để tiến bộ mà không có quảng cáo banner trong game.

Làm sao để cộng thưởng cho người chơi một cách an toàn?

Cộng thưởng trên máy chủ game từ postback có chữ ký, không bao giờ từ sự kiện phía client, vì người chơi có thể giả mạo chúng. Khi OnClosed được kích hoạt, hãy tải số dư của người chơi từ máy chủ.

Tôi có thể thử nghiệm trong Unity Editor không?

Bạn có thể thử nghiệm luồng hoạt động. Trong Editor, trên máy tính và trong WebGL, Open kiểm tra App ID và token rồi báo Unsupported, và Moonetix.IsSupported là false. Để xem chính offerwall, hãy build cho Android hoặc iOS và thử nghiệm trên điện thoại hoặc iOS Simulator.

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.

Nhắm mục tiêu toàn cầu
Thêm
Đăng nhập