SDK offerwall React Native. Prêt pour Expo, TypeScript inclus.
Ouvrez l’offerwall Moonetix dans un écran natif depuis React Native ou Expo. Le package inclut les SDK Android et iOS, fonctionne avec la New Architecture et fournit ses propres types TypeScript.
- 0.77+React Native
- 53+Expo SDK
- TSTypes inclus
import { Moonetix } from '@moonetix/react-native-offerwall';
Moonetix.init('YOUR_APP_ID');
// When the user taps Earn
Moonetix.open(token);En ligne en quatre étapes.
Copiez le code, remplacez les espaces réservés par les valeurs de votre tableau de bord sous Offerwalls, votre offerwall, Intégration, et testez avant le lancement.
-
Installer le package
Ajoutez le registre Moonetix pour le scope @moonetix, puis installez le package et recompilez votre app. Pour Expo, ajoutez le config plugin et utilisez un build de développement, car Expo Go ne peut pas charger de code natif.
Terminal# .npmrc, next to package.json @moonetix:registry=https://moonetix.com/npm/ npm install @moonetix/react-native-offerwall cd ios && pod installapp.json{ "expo": { "plugins": ["@moonetix/react-native-offerwall"] } }.yarnrc.ymlnpmScopes: moonetix: npmRegistryServer: "https://moonetix.com/npm" -
Ajoutez un endpoint de jetons à votre serveur
Votre app ne contient jamais la clé API. Quand un utilisateur appuie sur Earn, votre app demande une session à votre serveur, et votre serveur demande à Moonetix un jeton à usage unique pour cet utilisateur connecté. Un jeton ne fonctionne qu’une fois, pendant 10 minutes.
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']);session.js// POST /api/moonetix/session: a fresh token for the signed-in user app.post('/api/moonetix/session', requireLogin, async (req, res) => { const r = await fetch('https://api.moonetix.com/v1/session', { method: 'POST', headers: { Authorization: `Bearer ${process.env.MOONETIX_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ user_id: String(req.user.id) }), signal: AbortSignal.timeout(10000), }); const data = await r.json().catch(() => ({})); if (r.status === 201 && data.token) { return res.json({ token: data.token }); } const status = r.status === 403 ? 403 : 503; res.status(status).json({ error: 'offerwall_unavailable' }); });session.py# POST /api/moonetix/session: a fresh token for the signed-in user @app.post("/api/moonetix/session") @login_required def moonetix_session(): key = os.environ["MOONETIX_API_KEY"] r = requests.post( "https://api.moonetix.com/v1/session", data={"user_id": str(current_user.id)}, headers={"Authorization": f"Bearer {key}"}, timeout=10, ) data = r.json() if r.status_code == 201 and data.get("token"): return {"token": data["token"]} status = 403 if r.status_code == 403 else 503 return {"error": "offerwall_unavailable"}, status -
Ouvrir l’offerwall
Appelez init une seule fois avec l’App ID de votre tableau de bord, puis open avec un nouveau jeton. addListener renvoie un abonnement, supprimez-le donc quand votre écran disparaît.
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); } -
Créditez les récompenses avec le postback
Chaque récompense arrive sur votre serveur sous forme de postback signé. Vérifiez le hash, ajoutez la récompense une seule fois par ID de transaction, et reprenez-la si un postback ultérieur l’annule. Les postbacks échoués sont relancés jusqu’à 5 fois.
Tableau de bord, onglet Postbackhttps://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}postback.php<?php $tx = $_GET['tx'] ?? ''; $userId = $_GET['user'] ?? ''; $reward = $_GET['reward'] ?? ''; $status = $_GET['status'] ?? ''; $secret = getenv('MOONETIX_POSTBACK_SECRET'); $expected = hash_hmac('sha256', "$tx:$userId:$reward:$status", $secret); if (!hash_equals($expected, $_GET['hash'] ?? '')) { http_response_code(403); exit; } if ($status === '1') { credit_once($userId, $tx, $reward); // once per transaction ID } elseif ($status === '2') { reverse_if_credited($userId, $tx, $reward); } http_response_code(200);postback.jsconst crypto = require('crypto'); app.get('/postback', (req, res) => { const { tx, user, reward, status, hash } = req.query; const secret = process.env.MOONETIX_POSTBACK_SECRET; const expected = crypto.createHmac('sha256', secret) .update(`${tx}:${user}:${reward}:${status}`) .digest('hex'); const valid = typeof hash === 'string' && hash.length === expected.length && crypto.timingSafeEqual(Buffer.from(hash), Buffer.from(expected)); if (!valid) return res.sendStatus(403); if (status === '1') creditOnce(user, tx, reward); // once per transaction ID if (status === '2') reverseIfCredited(user, tx, reward); res.sendStatus(200); });postback.pyimport hmac, hashlib, os from flask import request, abort @app.get("/postback") def postback(): a = request.args parts = [a.get(k, "") for k in ("tx", "user", "reward", "status")] msg = ":".join(parts) secret = os.environ["MOONETIX_POSTBACK_SECRET"].encode() expected = hmac.new(secret, msg.encode(), hashlib.sha256).hexdigest() if not hmac.compare_digest(expected, a.get("hash", "")): abort(403) if a.get("status") == "1": credit_once(a["user"], a["tx"], a["reward"]) # once per transaction ID elif a.get("status") == "2": reverse_if_credited(a["user"], a["tx"], a["reward"]) return "", 200
Travel TownAtteindre le niveau 15+1,500
WPS OfficeInstaller et ouvrir+2,000
Bus EscapeAtteindre le niveau 20+450
CapCutSign up in the app+800
Ce que voient vos utilisateurs
Un écran natif au-dessus de votre app, avec votre titre et vos couleurs, votre monnaie, et chaque récompense confirmée par un postback.
Ce que le package gère pour vous
- SDK natifs inclus
Gradle sur Android et CocoaPods sur iOS sont configurés pour vous. Lancez pod install et recompilez.
- Config plugin Expo
Ajoutez une ligne à app.json, puis lancez prebuild ou un EAS Build.
- Types TypeScript
init, open, événements et codes d’erreur typés, avec les mêmes noms que dans les SDK natifs.
- Les offres s’ouvrent au bon endroit
Les offres des stores s’ouvrent dans Google Play ou l’App Store, pour que les installations soient correctement suivies.
- Aucune clé dans votre bundle
Votre bundle JavaScript ne contient que l’App ID. Les sessions viennent de votre serveur et ne fonctionnent qu’une fois.
- Pas d’identifiant publicitaire
Le SDK n’utilise pas l’identifiant publicitaire et ne suit pas les utilisateurs d’une app à l’autre.
Testez, puis lancez.
Tout ce que vous devez vérifier avant que de vrais utilisateurs voient votre offerwall, avec les outils intégrés à votre tableau de bord.
Ouvrir en tant qu’utilisateur test
Dans "État de l’intégration" de l’onglet "Intégration", ouvrez votre offerwall en tant qu’utilisateur owner-test. Les visites de test ne sont pas comptées comme des utilisateurs.
Lancez-le sur un appareil réel
Compilez pour Android ou iOS et ouvrez l’offerwall depuis votre bouton Earn avec un nouveau jeton à chaque fois.
Envoyer un postback de test
Choisissez l’utilisateur, le statut et le paiement, et voyez exactement ce que votre serveur a répondu, avec le code de réponse et le temps. Les ID de transaction de test commencent par test_.
Testez depuis une connexion normale
Les VPN, proxys, Tor et réseaux cloud sont bloqués : testez donc en Wi-Fi domestique ou en données mobiles, dans un pays où des offres sont disponibles.
Checklist de lancement
0 sur 11 prêts
Prêt pour le lancement. Votre progression est enregistrée dans ce navigateur.
Erreurs courantes, vite corrigées.
Ce que vous pouvez rencontrer en intégrant le SDK React Native, la cause et la solution.
INVALID_APP_IDLa valeur passée à init n’est pas l’App ID. Passer la clé API à cet endroit est l’erreur la plus courante.
SolutionCopiez à nouveau l’App ID de 24 caractères depuis l’onglet "Intégration".
INVALID_TOKENL’app a transmis autre chose que le jeton, ou un jeton créé avec la clé API d’une autre app.
SolutionPassez uniquement le champ token, qui commence par sst_, et utilisez l’App ID et la clé API de la même app.
TOKEN_EXPIRED_OR_USEDLe jeton a plus de 10 minutes ou a déjà été utilisé, par exemple conservé depuis un appui précédent.
SolutionCréez un nouveau jeton à chaque ouverture, au moment où l’utilisateur appuie sur Earn.
NOT_INITIALIZEDopen a été appelé avant init.
SolutionAppelez Moonetix.init une seule fois au démarrage de votre app.
UNSUPPORTED on a phoneLa partie native n’est pas dans le build, par exemple dans Expo Go ou avant une recompilation.
SolutionRecompilez l’app ou utilisez un build de développement Expo. Un rechargement Metro n’ajoute pas de code natif.
Gradle cannot find com.moonetixVotre settings.gradle n’autorise pas les projets à ajouter des dépôts.
SolutionAjoutez le dépôt Maven de Moonetix à settings.gradle.
403 from /v1/sessionapp_not_live signifie que l’app est en pause ou que votre compte n’est pas actif. user_blocked signifie que nous avons bloqué cet utilisateur.
SolutionN’affichez pas l’offerwall. Pour app_not_live, consultez vos notifications.
VPN or Proxy detectedL’appareil utilise un VPN, un proxy ou un réseau cloud, où les offres ne peuvent pas être suivies.
SolutionTestez sur une connexion domestique ou mobile normale, dans un pays où des offres sont disponibles.
Postback log shows 403 or 404Votre script a rejeté le postback, ou l’URL est incorrecte.
SolutionOuvrez l’URL du journal dans un navigateur et vérifiez votre code de hash.
Postback log shows a timeoutVotre script met plus de 6 secondes à répondre.
SolutionRépondez d’abord avec 200, et exécutez les tâches lentes en arrière-plan.
Postback log shows 301 or 302Votre URL redirige, par exemple de http vers https.
SolutionUtilisez l’URL finale. Les postbacks ne suivent pas les redirections.
Aucun résultat. Consultez la liste complète dans la documentation ou contactez-nous.
En bref
- React Native
- 0.77 ou plus récent, New Architecture prise en charge
- Expo
- SDK 53 ou plus récent, avec un build de développement
- Package
- @moonetix/react-native-offerwall 2.0.1 depuis moonetix.com/npm
- Android
- Kotlin 2.0 ou plus récent, présent par défaut dans ces versions
- Langage
- TypeScript et JavaScript
- Prix
- Gratuit pour les éditeurs approuvés
Autres intégrations
- Site webUn lien, un iframe ou un bouton Earn flottant. Aucun SDK nécessaire.
- Offers APIRécupérez les offres en JSON et affichez-les avec votre propre design.
- SDK AndroidUn écran d’offerwall natif pour les apps Kotlin et Java.
- SDK iOSUn offerwall natif pour Swift, SwiftUI et Objective-C.
- SDK UnityDes offres avec récompense pour les jeux Android et iOS, depuis C#.
- SDK FlutterUn seul plugin Dart pour Android et iOS.
- Toutes les intégrationsComparez-les côte à côte.
Questions sur React Native
Les questions des développeurs avant d’ajouter le SDK React Native.
Un point bloquant ? Contactez-nous
Quelles versions de React Native et d’Expo sont prises en charge ?
React Native 0.77 ou plus récent, ou Expo SDK 53 ou plus récent. Le package fonctionne avec la New Architecture et, de React Native 0.77 à 0.81, aussi avec l’ancienne architecture.
Est-ce que cela fonctionne dans Expo Go ?
Non. Expo Go ne peut pas charger de code natif, Moonetix.isSupported y vaut donc false. Ajoutez le config plugin et testez avec un build de développement ou un EAS Build.
Le package est-il sur le registre npm public ?
Il se trouve dans le registre npm de Moonetix. Ajoutez @moonetix:registry=https://moonetix.com/npm/ à votre .npmrc, ou l’entrée npmScopes pour Yarn 2 et plus récent, puis installez-le comme d’habitude.
Les types TypeScript sont-ils inclus ?
Oui. Les types pour init, open, les événements et les codes d’erreur sont fournis avec le package.
Comment récompenser les utilisateurs ?
Votre serveur reçoit un postback signé pour chaque récompense et crédite l’utilisateur une seule fois par ID de transaction. Les événements de l’app peuvent être falsifiés sur un appareil, utilisez-les donc uniquement pour actualiser votre interface.
Où va ma clé API ?
Uniquement sur votre serveur. Votre app contient l’App ID, et votre serveur crée un jeton de session à usage unique pour l’utilisateur connecté.
Transformez votre trafic en revenus.
Créez un compte éditeur gratuit et gagnez de l’argent sur chaque offre que vos utilisateurs terminent sur votre site web, votre app, votre jeu ou votre communauté.