Android Offerwall SDK. Nativ, mit wenigen Zeilen Kotlin.
Öffnen Sie die Moonetix Offerwall als nativen Bildschirm in Ihrer Android-App. Installieren Sie eine Gradle-Abhängigkeit, erstellen Sie eine Session auf Ihrem Server und rufen Sie open auf. Funktioniert mit Kotlin, Java und Jetpack Compose.
- 5.0+Android, API 21
- 2.0.1Aktuelle Version
- 0Zusätzliche Berechtigungen
// Once, in your Application class
Moonetix.init(applicationContext, "YOUR_APP_ID")
// When the user taps Earn
Moonetix.open(activity, token)Live in vier Schritten.
Kopieren Sie den Code, ersetzen Sie die Platzhalter durch die Werte aus Ihrem Dashboard unter Offerwalls, Ihre Offerwall, Integration, und testen Sie vor dem Start.
-
SDK installieren
Fügen Sie das Moonetix-Maven-Repository und eine Abhängigkeit hinzu. Das SDK trägt die Internet-Berechtigung und seinen Bildschirm selbst in Ihr Manifest ein und bringt eigene R8- und ProGuard-Regeln mit.
settings.gradle.ktsdependencyResolutionManagement { repositories { google() mavenCentral() maven { url = uri("https://moonetix.com/maven") } } } // app/build.gradle.kts dependencies { implementation("com.moonetix:offerwall:2.0.1") }settings.gradledependencyResolutionManagement { repositories { google() mavenCentral() maven { url 'https://moonetix.com/maven' } } } // app/build.gradle dependencies { implementation 'com.moonetix:offerwall:2.0.1' } -
Token-Endpunkt auf Ihrem Server hinzufügen
Ihre App enthält nie den API-Schlüssel. Wenn ein Nutzer auf Earn tippt, fragt Ihre App Ihren Server nach einer Session, und Ihr Server fordert bei Moonetix ein einmal nutzbares Token für diesen angemeldeten Nutzer an. Ein Token funktioniert einmal, für 10 Minuten.
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 -
Offerwall öffnen
Rufen Sie init einmal mit der App ID aus Ihrem Dashboard auf und öffnen Sie dann die Offerwall mit dem Token von Ihrem Server. Fehler lösen nie Exceptions aus: sie kommen als Events an, und onClosed ist ein guter Moment, um das Guthaben des Nutzers zu aktualisieren.
EarnActivity.ktMoonetix.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) }EarnActivity.javaMoonetix.init(getApplicationContext(), "YOUR_APP_ID"); // with a fresh token from your server Moonetix.open(activity, token);EarnButton.kt@Composable fun EarnButton(authToken: String) { val context = LocalContext.current val scope = rememberCoroutineScope() Button(onClick = { scope.launch { val token = runCatching { fetchMoonetixToken(authToken) } .getOrNull() ?: return@launch context.findActivity()?.let { Moonetix.open(it, token) } } }) { Text("Earn coins") } } -
Belohnungen per Postback gutschreiben
Jede Belohnung erreicht Ihren Server als signierter Postback. Prüfen Sie den Hash, schreiben Sie die Belohnung pro Transaktions-ID einmal gut und nehmen Sie sie zurück, wenn ein späterer Postback sie rückbucht. Fehlgeschlagene Postbacks werden bis zu 5 Mal wiederholt.
Dashboard, Tab 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 TownLevel 15 erreichen+1,500
WPS OfficeInstallieren und öffnen+2,000
Bus EscapeLevel 20 erreichen+450
CleanfoxSign up in the app+800
Was Ihre Nutzer sehen
Ein nativer Bildschirm über Ihrer App, mit Ihrem Titel, Ihren Farben und Ihrer Währung, und jede Belohnung wird durch einen Postback bestätigt.
Was das SDK für Sie erledigt
- Angebote öffnen sich am richtigen Ort
Angebote, die zu Google Play führen, öffnen sich in der Store-App, andere Websites im Browser, sodass Installationen korrekt getrackt werden.
- Kein Schlüssel in Ihrer App
Ihre App enthält nur die App ID. Sessions werden auf Ihrem Server erstellt und funktionieren einmal, sodass niemand die Offerwall als ein anderer Nutzer öffnen kann.
- Ein abgeschotteter Bildschirm
Darin laden nur Offerwall-Seiten, ohne JavaScript-Brücke in Ihre App.
- Native Navigation
Die Zurück-Taste navigiert innerhalb der Offerwall zurück, und bei einer Bildschirmdrehung oder einem Neustart wegen wenig Speicher bleibt der Nutzer, wo er war.
- Ihr Design, ohne zusätzlichen Code
Der Bildschirm nutzt Titel und Farben aus dem Tab Design Ihres Dashboards und übernimmt Änderungen innerhalb weniger Minuten.
- Keine Werbe-ID
Das SDK nutzt keine Werbe-ID und verfolgt Nutzer nicht über Apps hinweg.
Erst testen, dann starten.
Alles, was Sie prüfen sollten, bevor echte Nutzer Ihre Offerwall sehen, mit den Tools in Ihrem Dashboard.
Open as a test user
Öffnen Sie unter Integration status im Tab Integration Ihre Offerwall als Nutzer owner-test. Testbesuche werden nicht als Nutzer gezählt.
Auf einem echten Gerät ausführen
Erstellen Sie den Build für Android oder iOS und öffnen Sie die Offerwall über Ihren Earn-Button jedes Mal mit einem neuen Token.
Send a test postback
Wählen Sie Nutzer, Status und Auszahlung und sehen Sie genau, was Ihr Server geantwortet hat, mit Antwortcode und Zeit. Test-Transaktions-IDs beginnen mit test_.
Über eine normale Verbindung testen
VPNs, Proxys, Tor und Cloud-Netzwerke werden blockiert. Testen Sie daher über Ihr WLAN zu Hause oder mobile Daten, in einem Land, in dem Angebote laufen.
Checkliste vor dem Start
0 von 11 erledigt
Startklar. Ihr Fortschritt wird in diesem Browser gespeichert.
Häufige Fehler, schnell behoben.
Was Ihnen bei der Integration des Android SDK begegnen kann, woran es liegt und wie Sie es beheben.
INVALID_APP_IDDer an init übergebene Wert ist nicht die App ID. Hier den API-Schlüssel zu übergeben, ist der häufigste Fehler.
LösungKopieren Sie die 24-stellige App ID erneut aus dem Tab Integration.
INVALID_TOKENDie App hat etwas anderes als das Token übergeben, oder ein Token, das mit dem API-Schlüssel einer anderen App erstellt wurde.
LösungÜbergeben Sie nur das Feld token, das mit sst_ beginnt, und verwenden Sie App ID und API-Schlüssel derselben App.
TOKEN_EXPIRED_OR_USEDDas Token ist älter als 10 Minuten oder wurde bereits verwendet, zum Beispiel weil es von einem früheren Tippen stammt.
LösungErstellen Sie für jedes Öffnen ein neues Token, genau dann, wenn der Nutzer auf Earn tippt.
NOT_INITIALIZEDopen wurde vor init aufgerufen.
LösungRufen Sie Moonetix.init in Application.onCreate auf.
UNKNOWNAndroid System WebView fehlt oder ist deaktiviert, oder die übergebene Activity wurde bereits geschlossen.
LösungBitten Sie den Nutzer, Android System WebView zu aktualisieren, und übergeben Sie eine Activity, die auf dem Bildschirm sichtbar ist.
onClosed never arrivesDer Listener wurde in onStop entfernt, oder er gehörte zu einem Bildschirm, der nicht mehr existiert.
LösungSetzen Sie ihn in onCreate und entfernen Sie ihn in onDestroy, oder setzen Sie ihn einmal in Ihrer Application.
403 from /v1/sessionapp_not_live bedeutet, dass die App pausiert oder Ihr Konto nicht aktiv ist. user_blocked bedeutet, dass wir diesen Nutzer gesperrt haben.
LösungZeigen Sie die Offerwall nicht an. Prüfen Sie bei app_not_live Ihre Benachrichtigungen.
VPN or Proxy detectedDas Gerät nutzt ein VPN, einen Proxy oder ein Cloud-Netzwerk, wo Angebote nicht getrackt werden können.
LösungTesten Sie über eine normale Heim- oder Mobilfunkverbindung in einem Land, in dem Angebote laufen.
Postback log shows 403 or 404Ihr Skript hat den Postback abgelehnt, oder die URL ist falsch.
LösungÖffnen Sie die URL aus dem Log in einem Browser und prüfen Sie Ihren Hash-Code.
Postback log shows a timeoutIhr Skript braucht länger als 6 Sekunden für die Antwort.
LösungAntworten Sie zuerst mit 200 und erledigen Sie langsame Aufgaben im Hintergrund.
Postback log shows 301 or 302Ihre URL leitet weiter, zum Beispiel von http auf https.
LösungVerwenden Sie die endgültige URL. Postbacks folgen keinen Weiterleitungen.
Kein Treffer. Die vollständige Liste finden Sie in den Docs, oder kontaktieren Sie uns.
Auf einen Blick
- Mindestversion
- Android 5.0 (API 21), mit Android System WebView oder Chrome
- Sprachen
- Kotlin, Java und Jetpack Compose
- Paket
- com.moonetix:offerwall:2.0.1 von moonetix.com/maven
- Abhängigkeiten
- Nur die Kotlin-Standardbibliothek
- Berechtigungen
- Nur Internet, vom SDK hinzugefügt
- Preis
- Kostenlos für freigegebene Publisher
Weitere Integrationen
- WebsiteEin Link, ein iframe oder ein schwebender Earn-Button. Kein SDK nötig.
- Offers APIRufen Sie die Angebote als JSON ab und zeigen Sie sie in Ihrem eigenen Design.
- iOS SDKEine native Offerwall für Swift, SwiftUI und Objective-C.
- Unity SDKAngebote mit Belohnung für Android- und iOS-Spiele, aus C#.
- Flutter SDKEin Dart-Plugin für Android und iOS.
- React Native SDKFür React-Native- und Expo-Apps, mit TypeScript-Typen.
- Alle IntegrationenVergleichen Sie sie direkt nebeneinander.
Fragen zu Android
Was Entwickler fragen, bevor sie das Android SDK einbinden.
Kommen Sie nicht weiter? Kontaktieren Sie uns
Welche Android-Versionen unterstützt das Moonetix SDK?
Android 5.0 (API 21) oder neuer, mit Android System WebView oder Chrome auf dem Gerät. Die einzige Abhängigkeit ist die Kotlin-Standardbibliothek, daher funktioniert es in Kotlin- und Java-Apps.
Muss ich ProGuard- oder R8-Regeln hinzufügen?
Nein. Das SDK bringt eigene R8- und ProGuard-Regeln mit und trägt die Internet-Berechtigung und seinen Offerwall-Bildschirm selbst in Ihr Manifest ein.
Gehört mein API-Schlüssel in die App?
Nein. Ihre App enthält nur die App ID. Ihr Server erstellt mit dem API-Schlüssel eine Session und übergibt der App ein Token. Ein Token funktioniert einmal und für 10 Minuten, sodass nichts in Ihrer App die Offerwall eines anderen Nutzers öffnen kann.
Verwendet das SDK die Werbe-ID?
Nein. Es nutzt keine Werbe-ID, fordert außer dem Internetzugriff keine Berechtigung an und verfolgt Nutzer nicht über Apps hinweg. Die Docs listen auf, was Sie im Data-safety-Formular von Google Play angeben müssen.
Wie belohne ich Nutzer in meiner App?
Schreiben Sie Belohnungen auf Ihrem Server über den signierten Postback gut, niemals über Events in der App, denn Events lassen sich auf einem Gerät fälschen. Wenn der Nutzer die Offerwall schließt, laden Sie sein neues Guthaben von Ihrem Server.
Kann der Offerwall-Bildschirm zu meiner App passen?
Ja. Er übernimmt Titel und Farben aus dem Tab Design Ihres Dashboards. Sie können mit MoonetixOptions auch einen eigenen Titel und eine eigene Toolbar-Farbe übergeben oder das Logo ausblenden.
Machen Sie Ihren Traffic zu Einnahmen.
Erstellen Sie ein kostenloses Publisher-Konto und verdienen Sie an jedem Angebot, das Ihre Nutzer auf Ihrer Website, in Ihrer App, Ihrem Spiel oder Ihrer Community abschließen.