SDK de offerwall para React Native. Listo para Expo, con TypeScript incluido.

Abra el offerwall de Moonetix como una pantalla nativa desde React Native o Expo. El paquete incluye los SDK de Android e iOS, funciona con la New Architecture y trae sus propios tipos de TypeScript.

  • 0.77+React Native
  • 53+Expo SDK
  • TSTipos incluidos
SDK de React NativeVersión 2.0.1
EarnScreen.tsx
import { Moonetix } from '@moonetix/react-native-offerwall';
 
Moonetix.init('YOUR_APP_ID');
 
// When the user taps Earn
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 paquete

    Agregue el registro de Moonetix para el scope @moonetix y luego instale el paquete y vuelva a compilar su app. En Expo, agregue el config plugin y use una development build, porque Expo Go no puede cargar código nativo.

    Terminal
    # .npmrc, next to package.json
    @moonetix:registry=https://moonetix.com/npm/
     
    npm install @moonetix/react-native-offerwall
    cd ios && pod install
  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. addListener devuelve una suscripción, así que elimínela cuando su pantalla desaparezca.

    EarnScreen.tsx
    import { Moonetix } from '@moonetix/react-native-offerwall';
     
    Moonetix.init('YOUR_APP_ID');
     
    useEffect(() => {
      const closed = Moonetix.addListener('closed', refreshBalance);
      const failed = Moonetix.addListener('error', (error) => {
        console.warn(`${error.code}: ${error.message}`);
      });
      return () => {
        closed.remove();
        failed.remove();
      };
    }, []);
     
    async function openOfferwall() {
      const url = 'https://your-server.example/api/moonetix/session';
      const res = await fetch(url, { method: 'POST' });
      const { token } = await res.json();
      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 paquete hace por usted

  • SDK nativos incluidos

    Gradle en Android y CocoaPods en iOS se configuran automáticamente. Ejecute pod install y vuelva a compilar.

  • Config plugin de Expo

    Agregue una línea a app.json y luego ejecute prebuild o inicie un EAS Build.

  • Tipos de TypeScript

    init, open, eventos y códigos de error tipados, con los mismos nombres que usan los SDK nativos.

  • Las ofertas se abren en el lugar correcto

    Las ofertas de tiendas se abren en Google Play o la App Store, para que las instalaciones se registren correctamente.

  • Ninguna clave en su bundle

    Su bundle de JavaScript contiene solo el App ID. Las sesiones vienen de su servidor y funcionan una sola vez.

  • 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 React Native, 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 una sola vez cuando se inicie su app.

  • UNSUPPORTED on a phone

    La parte nativa no está en la compilación, por ejemplo en Expo Go o antes de volver a compilar.

    SoluciónVuelva a compilar la app o use una development build de Expo. Una recarga de Metro no agrega código nativo.

  • Gradle cannot find com.moonetix

    Su settings.gradle no permite que los proyectos agreguen repositorios.

    SoluciónAgregue el repositorio Maven de Moonetix a settings.gradle.

  • 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 React Native

Lo que preguntan los desarrolladores antes de agregar el SDK de React Native.

¿Se quedó atascado? Contáctenos

¿Qué versiones de React Native y Expo son compatibles?

React Native 0.77 o posterior, o Expo SDK 53 o posterior. El paquete funciona con la New Architecture y, en React Native 0.77 a 0.81, también con la arquitectura anterior.

¿Funciona en Expo Go?

No. Expo Go no puede cargar código nativo, así que ahí Moonetix.isSupported es false. Agregue el config plugin y pruebe con una development build o un EAS Build.

¿El paquete está en el registro público de npm?

Está en el registro npm de Moonetix. Agregue @moonetix:registry=https://moonetix.com/npm/ a su .npmrc, o la entrada npmScopes en Yarn 2 y posteriores, y luego instálelo como de costumbre.

¿Se incluyen los tipos de TypeScript?

Sí. El paquete incluye los tipos para init, open, los eventos y los códigos de error.

¿Cómo recompenso a los usuarios?

Su servidor recibe un postback firmado por cada recompensa y acredita al usuario una vez por ID de transacción. Los eventos de la app se pueden falsificar en un dispositivo, así que úselos solo para actualizar su UI.

¿Dónde va mi clave de API?

Solo en su servidor. Su app contiene el App ID, y su servidor crea un token de sesión de un solo uso para el usuario con sesión iniciada.

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