SDK offerwall per React Native. Pronto per Expo, TypeScript incluso.
Apra l'offerwall Moonetix come schermata nativa da React Native o Expo. Il pacchetto include gli SDK Android e iOS, funziona con la New Architecture e fornisce i propri tipi TypeScript.
- 0.77+React Native
- 53+Expo SDK
- TSTipi inclusi
import { Moonetix } from '@moonetix/react-native-offerwall';
Moonetix.init('YOUR_APP_ID');
// When the user taps Earn
Moonetix.open(token);Vada live in quattro passaggi.
Copi il codice, sostituisca i segnaposto con i valori della sua dashboard in Offerwall, il suo offerwall, Integrazione, e faccia un test prima del lancio.
-
Installi il pacchetto
Aggiunga il registry Moonetix per lo scope @moonetix, poi installi il pacchetto e ricompili l'app. Per Expo, aggiunga il config plugin e usi una development build, perché Expo Go non può caricare codice nativo.
Terminale# .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" -
Aggiunga un endpoint token al suo server
La sua app non contiene mai la chiave API. Quando un utente tocca Earn, l'app chiede una sessione al suo server, e il server chiede a Moonetix un token monouso per quell'utente connesso. Un token vale una sola volta, per 10 minuti.
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 -
Apri l'offerwall
Chiami init una volta con l'App ID della sua dashboard, poi open con un token nuovo. addListener restituisce una subscription, quindi la rimuova quando la schermata viene chiusa.
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); } -
Accrediti le ricompense con il postback
Ogni ricompensa raggiunge il suo server come postback firmato. Verifichi l'hash, aggiunga la ricompensa una volta per ID transazione e la riprenda se un postback successivo la storna. I postback non riusciti vengono ritentati fino a 5 volte.
Dashboard, scheda "Postback"https://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 TownRaggiungi il livello 15+1,500
WPS OfficeInstalla e apri+2,000
Bus EscapeRaggiungi il livello 20+450
CapCutSign up in the app+800
Cosa vedono i suoi utenti
Una schermata nativa sopra la sua app, con il suo titolo e i suoi colori, la sua valuta e ogni ricompensa confermata da un postback.
Cosa gestisce il pacchetto per lei
- SDK nativi inclusi
Gradle per Android e CocoaPods per iOS vengono configurati automaticamente. Esegua pod install e ricompili.
- Config plugin di Expo
Aggiunga una riga a app.json, poi esegua prebuild o avvii una EAS Build.
- Tipi TypeScript
init, open, eventi e codici di errore tipizzati, con gli stessi nomi usati dagli SDK nativi.
- Le offerte si aprono nel posto giusto
Le offerte degli store si aprono in Google Play o nell'App Store, così le installazioni vengono tracciate correttamente.
- Nessuna chiave nel suo bundle
Il suo bundle JavaScript contiene solo l'App ID. Le sessioni arrivano dal suo server e valgono una sola volta.
- Nessun ID pubblicitario
L'SDK non usa l'identificatore pubblicitario e non traccia gli utenti tra le app.
Lo testi, poi lo lanci.
Tutto ciò che deve verificare prima che utenti reali vedano il suo offerwall, con gli strumenti integrati nella sua dashboard.
Apri come utente di prova
In "Stato dell'integrazione", nella scheda "Integrazione", apra il suo offerwall come utente owner-test. Le visite di test non vengono conteggiate come utenti.
Lo esegua su un dispositivo reale
Compili per Android o iOS e apra l'offerwall dal suo pulsante Earn con un token nuovo ogni volta.
Invia un postback di prova
Scelga utente, stato e pagamento, e veda esattamente cosa ha risposto il suo server, con codice di risposta e tempo. Gli ID transazione di test iniziano con test_.
Test da una connessione normale
VPN, proxy, Tor e reti cloud sono bloccati, quindi faccia il test da Wi-Fi domestico o rete dati mobile, in un paese in cui ci sono offerte attive.
Checklist per il lancio
0 di 11 pronti
Pronto per il lancio. I suoi progressi sono salvati in questo browser.
Errori comuni, risolti in fretta.
Cosa potrebbe incontrare durante l'integrazione del React Native SDK, la causa e la soluzione.
INVALID_APP_IDIl valore passato a init non è l'App ID. Passare qui la chiave API è l'errore più comune.
SoluzioneCopi di nuovo l'App ID di 24 caratteri dalla scheda "Integrazione".
INVALID_TOKENL'app ha passato qualcosa di diverso dal token, oppure un token creato con la chiave API di un'altra app.
SoluzionePassi solo il campo token, che inizia con sst_, e usi App ID e chiave API della stessa app.
TOKEN_EXPIRED_OR_USEDIl token ha più di 10 minuti o è già stato usato, ad esempio perché conservato da un tocco precedente.
SoluzioneCrei un nuovo token per ogni apertura, nel momento in cui l'utente tocca Earn.
NOT_INITIALIZEDopen è stato chiamato prima di init.
SoluzioneChiami Moonetix.init una sola volta all'avvio dell'app.
UNSUPPORTED on a phoneLa parte nativa non è nella build, ad esempio in Expo Go o prima di una ricompilazione.
SoluzioneRicompili l'app o usi una development build di Expo. Un reload di Metro non aggiunge codice nativo.
Gradle cannot find com.moonetixIl suo settings.gradle non permette ai progetti di aggiungere repository.
SoluzioneAggiunga il repository Maven di Moonetix a settings.gradle.
403 from /v1/sessionapp_not_live significa che l'app è in pausa o che il suo account non è attivo. user_blocked significa che abbiamo bloccato questo utente.
SoluzioneNon mostri l'offerwall. Per app_not_live, controlli le sue notifiche.
VPN or Proxy detectedIl dispositivo usa una VPN, un proxy o una rete cloud, dove le offerte non possono essere tracciate.
SoluzioneEsegua il test da una normale connessione domestica o mobile, in un paese in cui ci sono offerte attive.
Postback log shows 403 or 404Il suo script ha rifiutato il postback, oppure l'URL è errato.
SoluzioneApra in un browser l'URL presente nel log e controlli il suo codice hash.
Postback log shows a timeoutIl suo script impiega più di 6 secondi a rispondere.
SoluzioneRisponda prima con 200 ed esegua le operazioni lente in background.
Postback log shows 301 or 302Il suo URL reindirizza, ad esempio da http a https.
SoluzioneUsi l'URL finale. I postback non seguono i reindirizzamenti.
Nessun risultato. Veda l'elenco completo nella documentazione oppure ci contatti.
In sintesi
- React Native
- 0.77 o successiva, New Architecture supportata
- Expo
- SDK 53 o successivo, con una development build
- Pacchetto
- @moonetix/react-native-offerwall 2.0.1 da moonetix.com/npm
- Android
- Kotlin 2.0 o successivo, il predefinito in queste versioni
- Lingua
- TypeScript e JavaScript
- Prezzo
- Gratuito per i publisher approvati
Altre integrazioni
- Sito webUn link, un iframe o un pulsante Earn flottante. Nessun SDK necessario.
- Offers APIRiceva le offerte in JSON e le mostri con il suo design.
- Android SDKUna schermata offerwall nativa per app Kotlin e Java.
- iOS SDKUn offerwall nativo per Swift, SwiftUI e Objective-C.
- Unity SDKOfferte con ricompensa per giochi Android e iOS, da C#.
- Flutter SDKUn solo plugin Dart per Android e iOS.
- Tutte le integrazioniLi confronti fianco a fianco.
Domande su React Native
Cosa chiedono gli sviluppatori prima di aggiungere il React Native SDK.
Bloccato su qualcosa? Ci contatti
Quali versioni di React Native ed Expo sono supportate?
React Native 0.77 o successivo, oppure Expo SDK 53 o successivo. Il pacchetto funziona con la New Architecture e, da React Native 0.77 a 0.81, anche con la vecchia architettura.
Funziona in Expo Go?
No. Expo Go non può caricare codice nativo, quindi lì Moonetix.isSupported è false. Aggiunga il config plugin e faccia il test con una development build o una EAS Build.
Il pacchetto è sul registry npm pubblico?
Si trova nel registry npm di Moonetix. Aggiunga @moonetix:registry=https://moonetix.com/npm/ al suo .npmrc, oppure la voce npmScopes per Yarn 2 e successivi, poi lo installi come di consueto.
I tipi TypeScript sono inclusi?
Sì. I tipi per init, open, eventi e codici di errore sono inclusi nel pacchetto.
Come ricompenso gli utenti?
Il suo server riceve un postback firmato per ogni ricompensa e accredita l'utente una volta per ID transazione. Gli eventi dell'app possono essere falsificati su un dispositivo, quindi li usi solo per aggiornare l'interfaccia.
Dove va la mia chiave API?
Solo sul suo server. La sua app contiene l'App ID e il suo server crea un token di sessione monouso per l'utente connesso.
Trasformi il suo traffico in guadagni.
Crei un account publisher gratuito e guadagni da ogni offerta che i suoi utenti completano sul suo sito web, app, gioco o community.