Android 오퍼월 SDK. Kotlin 코드 몇 줄로 네이티브 화면을.

Android 앱에서 Moonetix 오퍼월을 네이티브 화면으로 여세요. Gradle 의존성 하나를 설치하고, 서버에서 세션을 만든 다음 open을 호출하면 됩니다. Kotlin, Java, Jetpack Compose에서 작동합니다.

  • 5.0+Android, API 21
  • 2.0.1현재 버전
  • 0추가 권한
Android SDK버전 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)

네 단계로 시작하세요.

코드를 복사하고, 자리 표시자를 대시보드의 오퍼월, 해당 오퍼월, 연동에 있는 값으로 바꾼 다음 출시 전에 테스트하세요.

  1. SDK 설치

    Moonetix Maven 저장소와 의존성 하나를 추가하세요. SDK가 인터넷 권한과 자체 화면을 매니페스트에 자동으로 추가하고, R8 및 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. 서버에 토큰 엔드포인트 추가

    앱은 API 키를 절대 갖지 않습니다. 사용자가 Earn을 탭하면 앱이 서버에 세션을 요청하고, 서버는 로그인한 사용자를 위한 일회용 토큰을 Moonetix에 요청합니다. 토큰은 10분 동안 한 번만 사용할 수 있습니다.

    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. 오퍼월 열기

    대시보드의 App ID로 init을 한 번 호출한 다음, 서버에서 받은 토큰으로 오퍼월을 여세요. 오류는 예외를 던지지 않고 이벤트로 전달되며, onClosed는 사용자 잔액을 새로 고치기 좋은 시점입니다.

    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. postback으로 리워드 적립

    모든 리워드는 서명된 postback으로 서버에 전달됩니다. 해시를 확인하고, 거래 ID당 한 번만 리워드를 추가하고, 이후 postback이 취소를 알리면 회수하세요. 실패한 postback은 최대 5회까지 재시도됩니다.

    Postback 매크로 및 재시도

    대시보드, Postback 탭
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
9:41
코인 받기12,450 코인
EarnMy offers
  • Travel Town레벨 15 달성+1,500
  • WPS Office설치 후 실행+2,000
  • Bus Escape레벨 20 달성+450
  • CapCutSign up in the app+800
리워드 적립됨Travel Town · +1,500 코인
네이티브 화면
Postback 200 OK

사용자에게 보이는 화면

앱 위에 뜨는 네이티브 화면입니다. 자체 제목과 색상, 자체 화폐를 사용하며 모든 리워드는 postback으로 확인됩니다.

SDK가 대신 처리하는 것

  • 오퍼가 알맞은 곳에서 열립니다

    Google Play로 연결되는 오퍼는 스토어 앱에서, 다른 사이트는 브라우저에서 열리므로 설치가 정확히 추적됩니다.

  • 앱 안에 키 없음

    앱에는 App ID만 들어갑니다. 세션은 서버에서 만들어지고 한 번만 사용할 수 있으므로 누구도 다른 사용자로 오퍼월을 열 수 없습니다.

  • 외부 이동이 차단된 전용 화면

    그 안에서는 오퍼월 페이지만 로드되며, 앱으로 연결되는 JavaScript 브리지는 없습니다.

  • 네이티브 내비게이션

    뒤로 가기 버튼은 오퍼월 안에서 이전 화면으로 이동하며, 화면 회전이나 메모리 부족으로 인한 재시작 후에도 사용자는 보던 위치에 그대로 머뭅니다.

  • 추가 코드 없이 내 디자인으로

    화면에는 대시보드 디자인 탭의 제목과 색상이 사용되며, 변경 사항은 몇 분 안에 반영됩니다.

  • 광고 ID 미사용

    SDK는 광고 식별자를 사용하지 않으며 앱 간에 사용자를 추적하지 않습니다.

테스트한 다음 출시하세요.

실제 사용자가 오퍼월을 보기 전에 확인해야 할 모든 것을 대시보드에 내장된 도구로 점검하세요.

  1. 테스트 사용자로 열기

    연동 탭의 연동 상태에서 owner-test 사용자로 오퍼월을 여세요. 테스트 방문은 사용자로 집계되지 않습니다.

  2. 실제 기기에서 실행하기

    Android 또는 iOS용으로 빌드하고, Earn 버튼에서 매번 새 토큰으로 오퍼월을 여세요.

  3. 테스트 postback 보내기

    사용자, 상태, 지급액을 선택하고 서버가 어떻게 응답했는지 응답 코드와 시간까지 정확히 확인하세요. 테스트 거래 ID는 test_로 시작합니다.

  4. 일반 연결에서 테스트

    VPN, 프록시, Tor, 클라우드 네트워크는 차단되므로, 오퍼가 운영되는 국가에서 가정용 Wi-Fi나 모바일 데이터로 테스트하세요.

출시 체크리스트

11개 중 0개 준비됨

자주 발생하는 오류, 빠르게 해결.

Android SDK를 연동하는 동안 볼 수 있는 오류와 그 원인, 해결 방법.

  • INVALID_APP_ID

    init에 전달한 값이 App ID가 아닙니다. 여기에 API 키를 넣는 것이 가장 흔한 실수입니다.

    해결 방법연동 탭에서 24자리 App ID를 다시 복사하세요.

  • INVALID_TOKEN

    앱이 토큰이 아닌 다른 값을 전달했거나, 다른 앱의 API 키로 만든 토큰을 전달했습니다.

    해결 방법sst_로 시작하는 token 필드만 전달하고, 같은 앱의 App ID와 API 키를 사용하세요.

  • TOKEN_EXPIRED_OR_USED

    토큰이 10분보다 오래되었거나 이미 사용되었습니다. 예를 들어 이전 탭에서 받아 둔 토큰일 수 있습니다.

    해결 방법사용자가 Earn을 탭하는 바로 그 순간에, 열 때마다 새 토큰을 만드세요.

  • NOT_INITIALIZED

    init 전에 open이 호출되었습니다.

    해결 방법Application.onCreate에서 Moonetix.init을 호출하세요.

  • UNKNOWN

    Android System WebView가 없거나 꺼져 있거나, 전달한 Activity가 이미 닫히는 중이었습니다.

    해결 방법사용자에게 Android System WebView를 업데이트하도록 요청하고, 화면에 표시된 Activity를 전달하세요.

  • onClosed never arrives

    onStop에서 리스너가 해제되었거나, 이미 사라진 화면에 속한 리스너였습니다.

    해결 방법onCreate에서 설정하고 onDestroy에서 해제하거나, Application에서 한 번만 설정하세요.

  • 403 from /v1/session

    app_not_live는 앱이 일시 중지되었거나 계정이 활성 상태가 아니라는 뜻입니다. user_blocked는 저희가 이 사용자를 차단했다는 뜻입니다.

    해결 방법오퍼월을 표시하지 마세요. app_not_live인 경우 알림을 확인하세요.

  • VPN or Proxy detected

    기기가 VPN, 프록시 또는 클라우드 네트워크를 사용하고 있어 오퍼를 추적할 수 없습니다.

    해결 방법오퍼가 운영되는 국가에서 일반 가정용 또는 모바일 연결로 테스트하세요.

  • Postback log shows 403 or 404

    스크립트가 postback을 거부했거나 URL이 잘못되었습니다.

    해결 방법로그에 있는 URL을 브라우저에서 열고 해시 코드를 확인하세요.

  • Postback log shows a timeout

    스크립트가 응답하는 데 6초보다 오래 걸립니다.

    해결 방법먼저 200으로 응답하고, 오래 걸리는 작업은 백그라운드에서 실행하세요.

  • Postback log shows 301 or 302

    URL이 리디렉션됩니다. 예를 들어 http에서 https로 이동합니다.

    해결 방법최종 URL을 사용하세요. Postback은 리디렉션을 따라가지 않습니다.

Android 자주 묻는 질문

Android SDK를 추가하기 전에 개발자들이 묻는 질문.

막히는 부분이 있나요? 문의하기

Moonetix SDK는 어떤 Android 버전을 지원하나요?

Android 5.0(API 21) 이상, 기기에 Android System WebView 또는 Chrome이 필요합니다. 유일한 의존성은 Kotlin 표준 라이브러리이므로 Kotlin과 Java 앱 모두에서 작동합니다.

ProGuard나 R8 규칙을 추가해야 하나요?

아니요. SDK에 자체 R8 및 ProGuard 규칙이 포함되어 있으며, 인터넷 권한과 오퍼월 화면도 매니페스트에 자동으로 추가합니다.

API 키를 앱에 넣어야 하나요?

아니요. 앱에는 App ID만 들어갑니다. 서버가 API 키로 세션을 만들고 토큰을 앱에 전달합니다. 토큰은 한 번만, 10분 동안만 유효하므로 앱 안의 어떤 것으로도 다른 사용자의 오퍼월을 열 수 없습니다.

SDK가 광고 ID를 사용하나요?

아니요. 광고 ID를 사용하지 않고, 인터넷 접근 외에는 어떤 권한도 요청하지 않으며, 앱 간에 사용자를 추적하지 않습니다. Google Play 데이터 보안 양식에 신고할 항목은 문서에 정리되어 있습니다.

앱에서 사용자에게 리워드를 주려면 어떻게 하나요?

리워드는 앱의 이벤트가 아니라 서버의 서명된 postback으로 적립하세요. 이벤트는 기기에서 위조될 수 있기 때문입니다. 사용자가 오퍼월을 닫으면 서버에서 새 잔액을 불러오세요.

오퍼월 화면을 앱 디자인에 맞출 수 있나요?

네. 대시보드 디자인 탭의 제목과 색상을 사용합니다. MoonetixOptions로 자체 제목이나 툴바 색상을 지정하거나 마크를 숨길 수도 있습니다.

트래픽을 수익으로 바꾸세요.

무료 퍼블리셔 계정을 만들고, 사용자가 웹사이트, 앱, 게임, 커뮤니티에서 완료하는 모든 오퍼로 수익을 올리세요.

전 세계 타기팅
더 보기
로그인