Plugin de offerwall para Flutter. Una sola API en Dart, Android e iOS.

Agregue el offerwall de Moonetix a su app de Flutter con un solo plugin. Incluye los SDK nativos de Android e iOS, así que no hay nada más que configurar en Gradle ni en Xcode.

  • 3.27+Flutter
  • 2.0.1Versión actual
  • 2Plataformas, un solo plugin
SDK de FlutterVersión 2.0.1
main.dart
import 'package:moonetix_offerwall/moonetix_offerwall.dart';
 
Moonetix.init('YOUR_APP_ID');
 
// When the user taps Earn
await Moonetix.open(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 plugin

    Agregue el plugin desde el repositorio de paquetes de Moonetix y ejecute flutter pub get. En Android incluye el repositorio Maven, el SDK y las reglas de R8. En iOS incluye el SDK de iOS para CocoaPods y Swift Package Manager.

    pubspec.yaml
    dependencies:
      moonetix_offerwall:
        hosted: https://moonetix.com/pub
        version: ^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 a open con un token nuevo. Escuche Moonetix.events antes de llamar a open y actualice el saldo cuando el usuario cierre el offerwall.

    main.dart
    void main() {
      WidgetsFlutterBinding.ensureInitialized();
      Moonetix.init('YOUR_APP_ID');
      runApp(const MyApp());
    }
     
    Moonetix.events.listen((MoonetixEvent event) {
      switch (event) {
        case MoonetixOpened():
          break;
        case MoonetixClosed():
          refreshBalance();
        case MoonetixErrorEvent(:final MoonetixError error):
          debugPrint('${error.code.name}: ${error.message}');
      }
    });
     
    await Moonetix.open(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 plugin hace por usted

  • SDK nativos incluidos

    El plugin incluye los SDK de Android e iOS. No hay repositorios de Gradle ni pasos de Xcode que agregar a mano.

  • Las ofertas se abren en el lugar correcto

    Las ofertas de tiendas se abren en Google Play o la App Store, y los demás sitios 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 vienen de su servidor y funcionan una sola vez.

  • Eventos tipados

    Un stream de difusión con MoonetixOpened, MoonetixClosed y MoonetixErrorEvent, o un listener si prefiere callbacks.

  • Su diseño

    La pantalla usa el título y los colores de la pestaña Design de su panel.

  • Sin ID de publicidad

    El plugin 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 Flutter, qué lo causa y cómo solucionarlo.

  • invalidAppId

    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.

  • invalidToken

    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.

  • tokenExpiredOrUsed

    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.

  • notInitialized

    Se llamó a open antes que a init.

    SoluciónLlame a Moonetix.init en main().

  • unsupported

    La app se ejecuta en web o escritorio, o la parte nativa del plugin todavía no está en la compilación.

    SoluciónEjecútela en Android o iOS, y detenga y vuelva a compilar la app. Hot reload no agrega código nativo.

  • No events arrive

    La app empezó a escuchar después de llamar a open.

    SoluciónEscuche Moonetix.events antes de llamar a open, desde un objeto que permanezca activo.

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

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

¿Se quedó atascado? Contáctenos

¿Qué versiones de Flutter admite el plugin?

Flutter 3.27 o posterior. En iOS, compile con Xcode 16 o posterior.

¿El plugin está en pub.dev?

Está alojado en el repositorio de paquetes de Moonetix. Agréguelo a pubspec.yaml con hosted: https://moonetix.com/pub y ejecute flutter pub get, igual que con cualquier otro paquete.

¿Tengo que cambiar la configuración de Gradle o Xcode?

Normalmente no. El plugin incluye los SDK de Android e iOS. Solo si su android/settings.gradle bloquea los repositorios del proyecto, agregue ahí el repositorio Maven de Moonetix.

¿Cómo sé cuándo el usuario cierra el offerwall?

Escuche Moonetix.events, un stream de difusión, antes de llamar a open. MoonetixClosed es un buen momento para cargar el saldo del usuario desde su servidor.

¿Cómo se acreditan las recompensas?

A partir del postback firmado en su servidor, una vez por ID de transacción. Los eventos en la app son solo para su interfaz de usuario.

¿Qué declaro en los formularios de privacidad de las tiendas?

User ID, Device ID, Coarse Location y Product Interaction, vinculados al usuario, no usados para rastreo. La documentación indica los nombres de Google Play para los mismos tipos de datos.

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