SDK offerwall Android. Native, chỉ với vài dòng Kotlin.

Mở offerwall Moonetix như một màn hình native trong ứng dụng Android. Cài một dependency Gradle, tạo phiên trên máy chủ và gọi open. Hoạt động với Kotlin, Java và Jetpack Compose.

  • 5.0+Android, API 21
  • 2.0.1Phiên bản hiện tại
  • 0Quyền bổ sung
Android SDKPhiên bản 2.0.1
EarnActivity.kt
// Once, in your Application class
Moonetix.init(applicationContext, "YOUR_APP_ID")
 
// When the user taps Earn
Moonetix.open(activity, 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 SDK

    Thêm kho Maven của Moonetix và một dependency. SDK tự thêm quyền internet và màn hình của nó vào manifest, đồng thời đi kèm sẵn các quy tắc R8 và ProGuard.

    settings.gradle.kts
    dependencyResolutionManagement {
        repositories {
            google()
            mavenCentral()
            maven { url = uri("https://moonetix.com/maven") }
        }
    }
     
    // app/build.gradle.kts
    dependencies {
        implementation("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 đó mở offerwall bằng token từ máy chủ của bạn. Lỗi không bao giờ được ném ra dưới dạng exception: chúng đến dưới dạng sự kiện, và onClosed là thời điểm tốt để làm mới số dư của người dùng.

    EarnActivity.kt
    Moonetix.init(applicationContext, "YOUR_APP_ID")
     
    Moonetix.setListener(object : MoonetixListener {
        override fun onClosed() {
            refreshBalance()
        }
        override fun onError(error: MoonetixError) {
            Log.w("Earn", "${error.code}: ${error.message}")
        }
    })
     
    lifecycleScope.launch {
        val token = fetchMoonetixToken(authToken)
        Moonetix.open(this@EarnActivity, token)
    }
  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 xu12,450 xu
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 xu
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.

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

  • Offer mở đúng nơi

    Offer dẫn tới Google Play mở trong ứng dụng cửa hàng, còn các trang khác mở trong trình duyệt, nên lượt cài đặt được ghi nhận chính xác.

  • Không có khóa trong ứng dụng

    Ứng dụng của bạn chỉ giữ App ID. Phiên được tạo trên máy chủ của bạn và chỉ dùng được một lần, nên không ai có thể mở offerwall dưới danh nghĩa người dùng khác.

  • Một màn hình được khóa chặt

    Chỉ các trang offerwall được tải bên trong, không có JavaScript bridge vào ứng dụng của bạn.

  • Điều hướng native

    Nút quay lại sẽ quay lại bên trong offerwall, và khi xoay màn hình hoặc khởi động lại do thiếu bộ nhớ, người dùng vẫn ở đúng chỗ cũ.

  • Thiết kế của bạn, không cần thêm mã

    Màn hình dùng tiêu đề và màu sắc từ tab "Thiết kế" trong bảng điều khiển của bạn, và cập nhật thay đổi trong vòng vài phút.

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

  • INVALID_APP_ID

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

  • INVALID_TOKEN

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

  • TOKEN_EXPIRED_OR_USED

    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.

  • NOT_INITIALIZED

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

    Khắc phụcGọi Moonetix.init trong Application.onCreate.

  • UNKNOWN

    Android System WebView bị thiếu hoặc đã tắt, hoặc Activity bạn truyền vào đang đóng.

    Khắc phụcĐề nghị người dùng cập nhật Android System WebView, và truyền vào một Activity đang hiển thị trên màn hình.

  • onClosed never arrives

    Listener đã bị xóa trong onStop, hoặc thuộc về một màn hình đã không còn.

    Khắc phụcĐặt nó trong onCreate và xóa trong onDestroy, hoặc đặt một lần trong Application.

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

Tổng quan nhanh

Phiên bản tối thiểu
Android 5.0 (API 21), có Android System WebView hoặc Chrome
Ngôn ngữ
Kotlin, Java và Jetpack Compose
Package
com.moonetix:offerwall:2.0.1 từ moonetix.com/maven
Dependency
Chỉ thư viện chuẩn Kotlin
Quyền
Chỉ quyền internet, do SDK tự thêm
Giá
Miễn phí cho publisher đã được duyệt

Cách tích hợp khác

Câu hỏi về Android

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

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

Moonetix SDK hỗ trợ những phiên bản Android nào?

Android 5.0 (API 21) trở lên, có Android System WebView hoặc Chrome trên thiết bị. Dependency duy nhất là thư viện chuẩn Kotlin, nên SDK hoạt động trong cả ứng dụng Kotlin lẫn Java.

Tôi có cần thêm quy tắc ProGuard hoặc R8 không?

Không. SDK có sẵn quy tắc R8 và ProGuard riêng, đồng thời tự thêm quyền internet và màn hình offerwall vào manifest.

Khóa API của tôi có nằm trong ứng dụng không?

Không. Ứng dụng của bạn chỉ giữ App ID. Máy chủ của bạn tạo phiên bằng khóa API và chuyển token cho ứng dụng. Mỗi token chỉ dùng được một lần và trong 10 phút, nên không gì trong ứng dụng có thể mở offerwall của người dùng khác.

SDK có dùng ID quảng cáo không?

Không. SDK không dùng ID quảng cáo, không xin quyền nào ngoài quyền truy cập internet và không theo dõi người dùng giữa các ứng dụng. Tài liệu liệt kê những gì cần khai báo trong biểu mẫu Data safety của Google Play.

Làm sao để thưởng cho người dùng trong ứng dụng của tôi?

Cộng thưởng từ postback có chữ ký trên máy chủ của bạn, không bao giờ từ sự kiện trong ứng dụng, vì sự kiện có thể bị giả mạo trên thiết bị. Khi người dùng đóng offerwall, hãy tải số dư mới của họ từ máy chủ.

Màn hình offerwall có thể phù hợp với giao diện ứng dụng của tôi không?

Có. Màn hình dùng tiêu đề và màu sắc từ tab "Thiết kế" trong bảng điều khiển của bạn. Bạn cũng có thể truyền tiêu đề, màu thanh công cụ của riêng mình, hoặc ẩn logo bằng MoonetixOptions.

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