SDK de offerwall para Android. Nativo, en unas pocas líneas de Kotlin.

Abra el offerwall de Moonetix como una pantalla nativa en su app de Android. Instale una dependencia de Gradle, cree una sesión en su servidor y llame a open. Funciona desde Kotlin, Java y Jetpack Compose.

  • 5.0+Android, API 21
  • 2.0.1Versión actual
  • 0Permisos adicionales
SDK de AndroidVersió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)

Comience en cuatro pasos.

Copie el código, reemplace los marcadores con los valores de su panel en Offerwalls, su offerwall, Integration, y haga pruebas antes de lanzar.

  1. Instale el SDK

    Agregue el repositorio Maven de Moonetix y una dependencia. El SDK agrega por sí solo el permiso de internet y su pantalla a su manifest, e incluye sus propias reglas de R8 y 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. Agregue un endpoint de tokens a su servidor

    Su app nunca contiene la clave de API. Cuando un usuario toca Earn, su app le pide una sesión a su servidor, y su servidor le pide a Moonetix un token de un solo uso para ese usuario con sesión iniciada. Un token funciona una sola vez, durante 10 minutos.

    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. Abra el offerwall

    Llame a init una vez con el App ID de su panel y luego abra el offerwall con el token de su servidor. Los errores nunca lanzan excepciones: llegan como eventos, y onClosed es un buen momento para actualizar el saldo del usuario.

    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. Acredite las recompensas con el postback

    Cada recompensa llega a su servidor como un postback firmado. Verifique el hash, sume la recompensa una sola vez por ID de transacción y retírela si un postback posterior la revierte. Los postbacks fallidos se reintentan hasta 5 veces.

    Macros y reintentos de postback

    Panel, pestaña Postback
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
9:41
Ganar monedas12,450 monedas
GanarMis ofertas
  • Travel TownLlegue al nivel 15+1,500
  • WPS OfficeInstalar y abrir+2,000
  • Bus EscapeLlegue al nivel 20+450
  • CleanfoxSign up in the app+800
Recompensa acreditadaTravel Town · +1,500 monedas
Pantalla nativa
Postback 200 OK

Lo que ven sus usuarios

Una pantalla nativa sobre su app, con su título y sus colores, su moneda y cada recompensa confirmada por un postback.

Lo que el SDK hace por usted

  • Las ofertas se abren en el lugar correcto

    Las ofertas que llevan a Google Play se abren en la app de la tienda y los demás sitios se abren en el navegador, para que las instalaciones se registren correctamente.

  • Ninguna clave dentro de su app

    Su app contiene solo el App ID. Las sesiones se crean en su servidor y funcionan una sola vez, así que nadie puede abrir el offerwall como si fuera otro usuario.

  • Una pantalla protegida

    Dentro solo se cargan páginas del offerwall, sin ningún puente de JavaScript hacia su app.

  • Navegación nativa

    El botón Atrás retrocede dentro del offerwall, y al girar la pantalla o al reiniciarse por falta de memoria el usuario se queda donde estaba.

  • Su diseño, sin código adicional

    La pantalla usa el título y los colores de la pestaña Design de su panel, y aplica los cambios en pocos minutos.

  • Sin ID de publicidad

    El SDK no usa el identificador de publicidad y no rastrea a los usuarios entre apps.

Pruébelo y luego publíquelo.

Todo lo que necesita verificar antes de que los usuarios reales vean su offerwall, con las herramientas integradas en su panel.

  1. Open as a test user

    En Integration status, en la pestaña Integration, abra su offerwall como el usuario owner-test. Las visitas de prueba no cuentan como usuarios.

  2. Ejecútelo en un dispositivo real

    Compile para Android o iOS y abra el offerwall desde su botón Earn con un token nuevo cada vez.

  3. Send a test postback

    Elija el usuario, el estado y el pago, y vea exactamente qué respondió su servidor, con el código de respuesta y el tiempo. Los ID de transacción de prueba empiezan con test_.

  4. Pruebe desde una conexión normal

    Las VPN, los proxies, Tor y las redes en la nube están bloqueados, así que pruebe con el Wi-Fi de su casa o con datos móviles, en un país donde haya ofertas activas.

Lista de verificación para el lanzamiento

0 de 11 listos

Errores comunes, resueltos rápido.

Lo que puede encontrar al integrar el SDK de Android, qué lo causa y cómo solucionarlo.

  • INVALID_APP_ID

    El valor que se pasa a init no es el App ID. Pasar aquí la clave de API es el error más común.

    SoluciónVuelva a copiar el App ID de 24 caracteres desde la pestaña Integration.

  • INVALID_TOKEN

    La app pasó algo distinto del token, o un token creado con la clave de API de otra app.

    SoluciónPase solo el campo token, que empieza con sst_, y use el App ID y la clave de API de la misma app.

  • TOKEN_EXPIRED_OR_USED

    El token tiene más de 10 minutos o ya se usó, por ejemplo porque se guardó de un toque anterior.

    SoluciónCree un token nuevo cada vez que se abra, justo cuando el usuario toque Earn.

  • NOT_INITIALIZED

    Se llamó a open antes que a init.

    SoluciónLlame a Moonetix.init en Application.onCreate.

  • UNKNOWN

    Android System WebView falta o está desactivado, o la Activity que pasó ya se estaba cerrando.

    SoluciónPida al usuario que actualice Android System WebView y pase una Activity que esté en pantalla.

  • onClosed never arrives

    El listener se eliminó en onStop, o pertenecía a una pantalla que ya no existe.

    SoluciónAsígnelo en onCreate y bórrelo en onDestroy, o asígnelo una sola vez en su Application.

  • 403 from /v1/session

    app_not_live significa que la app está en pausa o que su cuenta no está activa. user_blocked significa que bloqueamos a este usuario.

    SoluciónNo muestre el offerwall. Con app_not_live, revise sus notificaciones.

  • VPN or Proxy detected

    El dispositivo está en una VPN, un proxy o una red en la nube, donde las ofertas no se pueden registrar.

    SoluciónPruebe con una conexión normal de casa o de datos móviles, en un país donde haya ofertas activas.

  • Postback log shows 403 or 404

    Su script rechazó el postback, o la URL es incorrecta.

    SoluciónAbra en un navegador la URL que aparece en el registro y revise su código de hash.

  • Postback log shows a timeout

    Su script tarda más de 6 segundos en responder.

    SoluciónResponda primero con 200 y ejecute las tareas lentas en segundo plano.

  • Postback log shows 301 or 302

    Su URL redirige, por ejemplo de http a https.

    SoluciónUse la URL final. Los postbacks no siguen redirecciones.

Preguntas sobre Android

Lo que preguntan los desarrolladores antes de agregar el SDK de Android.

¿Se quedó atascado? Contáctenos

¿Qué versiones de Android admite el SDK de Moonetix?

Android 5.0 (API 21) o posterior, con Android System WebView o Chrome en el dispositivo. La única dependencia es la biblioteca estándar de Kotlin, así que funciona en apps de Kotlin y de Java.

¿Tengo que agregar reglas de ProGuard o R8?

No. El SDK incluye sus propias reglas de R8 y ProGuard, y agrega por sí solo el permiso de internet y su pantalla de offerwall a su manifest.

¿Mi clave de API va dentro de la app?

No. Su app solo contiene el App ID. Su servidor crea una sesión con la clave de API y le pasa un token a la app. Un token funciona una sola vez y durante 10 minutos, así que nada en su app puede abrir el offerwall de otro usuario.

¿El SDK usa el ID de publicidad?

No. No usa el ID de publicidad, no pide ningún permiso aparte del acceso a internet y no rastrea a los usuarios entre apps. La documentación indica qué declarar en el formulario de Data safety de Google Play.

¿Cómo recompenso a los usuarios en mi app?

Acredite las recompensas a partir del postback firmado en su servidor, nunca a partir de eventos en la app, porque los eventos se pueden falsificar en un dispositivo. Cuando el usuario cierre el offerwall, cargue su nuevo saldo desde su servidor.

¿La pantalla del offerwall puede combinar con mi app?

Sí. Usa el título y los colores de la pestaña Design de su panel. También puede pasar su propio título y el color de la barra de herramientas, u ocultar la marca con MoonetixOptions.

Convierta su tráfico en ganancias.

Cree una cuenta gratuita de publisher y gane con cada oferta que sus usuarios completen en su sitio web, app, juego o comunidad.

Segmentación mundial
Más
Iniciar sesión