SDK offerwall Unity. Les joueurs gagnent votre monnaie de jeu.
Laissez les joueurs gagner votre monnaie de jeu en terminant des offres, sans bannières publicitaires dans votre jeu. Un seul package Unity couvre Android et iOS, et chaque récompense arrive sur votre serveur de jeu sous forme de postback signé.
- 2022.3+Unity LTS ou Unity 6
- 2.0.1Version actuelle
- 2Plateformes, un seul package
using MoonetixOfferwall;
void Awake()
{
Moonetix.Init("YOUR_APP_ID");
}
public void ShowOfferwall(string token)
{
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 scoped registry Moonetix et le package à Packages/manifest.json, ou ajoutez le registre dans Project Settings et installez Moonetix Offerwall depuis le Package Manager. Les SDK Android et iOS sont inclus.
{ "scopedRegistries": [ { "name": "Moonetix", "url": "https://moonetix.com/upm", "scopes": ["com.moonetix"] } ], "dependencies": { "com.moonetix.offerwall": "2.0.1" } } -
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. Tous les événements arrivent sur le thread principal de Unity, vous pouvez donc mettre à jour votre interface directement. Le package contient aussi un exemple Offerwall demo.
using MoonetixOfferwall; using UnityEngine; public class EarnButton : MonoBehaviour { void Awake() => Moonetix.Init("YOUR_APP_ID"); void OnEnable() { Moonetix.OnClosed += RefreshBalance; Moonetix.OnError += HandleError; } void OnDisable() { Moonetix.OnClosed -= RefreshBalance; Moonetix.OnError -= HandleError; } public void ShowOfferwall(string token) => Moonetix.Open(token); void HandleError(MoonetixError error) { Debug.LogWarning(error.CodeName + ": " + error.Message); } void RefreshBalance() { } } -
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
- Builds Android et iOS
Sur Android, il ajoute le dépôt Maven, le SDK et la règle R8 à votre projet Gradle. Sur iOS, il lie et intègre le SDK iOS dans Xcode.
- Les offres s’ouvrent au bon endroit
Les offres qui mènent à Google Play ou à l’App Store s’ouvrent dans l’app du store, pour que les installations soient correctement suivies.
- Aucune clé dans votre jeu
Votre jeu ne contient que l’App ID. Les sessions viennent de votre serveur et ne fonctionnent qu’une fois.
- Événements sur le thread principal
OnOpened, OnClosed et OnError sont déclenchés sur le thread principal de Unity, prêts pour votre interface.
- Votre monnaie de jeu
Les récompenses sont affichées et créditées dans votre propre monnaie, avec votre taux de change et la part de l’utilisateur.
- Pas d’identifiant publicitaire
Le SDK n’utilise pas l’identifiant publicitaire et ne suit pas les joueurs 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 Unity, la cause et la solution.
InvalidAppIdLa 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".
InvalidTokenL’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.
TokenExpiredOrUsedLe 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.
NotInitializedopen a été appelé avant init.
SolutionAppelez Moonetix.Init dans Awake de votre première scène.
UnsupportedLe jeu tourne dans le Unity Editor, sur ordinateur ou en WebGL.
SolutionCompilez pour Android ou iOS, et vérifiez Moonetix.IsSupported avant d’afficher le bouton.
iOS build stops on the iOS versionLa version iOS minimale cible dans Player Settings est inférieure à 13.0.
SolutionRéglez-la sur 13.0 ou plus.
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
- Version de Unity
- Unity 2022.3 LTS, ou Unity 6 (6000.0) ou plus récent
- Plateformes
- Android, et iOS 13 ou plus récent
- Package
- com.moonetix.offerwall 2.0.1 depuis moonetix.com/upm
- Langage
- C#
- Exemple
- Démo d’offerwall avec un bouton Earn, dans le Package Manager
- 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 FlutterUn seul plugin Dart pour Android et iOS.
- SDK React NativePour les apps React Native et Expo, avec les types TypeScript.
- Toutes les intégrationsComparez-les côte à côte.
Questions sur Unity
Les questions des développeurs avant d’ajouter le SDK Unity.
Un point bloquant ? Contactez-nous
Quelles versions de Unity sont prises en charge ?
Unity 2022.3 LTS, ou Unity 6 (6000.0) ou plus récent. Sur iOS, réglez la version iOS minimale sur 13.0 ou plus dans Player Settings.
Est-ce que cela fonctionne pour les builds Android et iOS ?
Oui. Un seul package couvre les deux. Unity ajoute lui-même le SDK Android au projet Gradle et le SDK iOS au projet Xcode, y compris pour les projets exportés et les modèles Gradle personnalisés.
Comment installer le package Unity de Moonetix ?
Ajoutez le scoped registry Moonetix et com.moonetix.offerwall à Packages/manifest.json, ou installez-le depuis My Registries dans le Package Manager. Vous pouvez aussi l’installer depuis un tarball.
Un offerwall, est-ce du pay-to-win ?
Non. Les joueurs gagnent la même monnaie qu’en jouant, en essayant des apps et des jeux d’annonceurs. Cela donne aux joueurs qui ne paient pas un moyen de progresser, sans bannières publicitaires dans votre jeu.
Comment créditer les joueurs en toute sécurité ?
Créditez les récompenses sur votre serveur de jeu à partir du postback signé, jamais à partir des événements client, car les joueurs peuvent les falsifier. Quand OnClosed se déclenche, chargez le solde du joueur depuis votre serveur.
Puis-je le tester dans le Unity Editor ?
Vous pouvez tester votre parcours. Dans l’Editor, sur ordinateur et en WebGL, Open vérifie l’App ID et le jeton puis renvoie Unsupported, et Moonetix.IsSupported vaut false. Pour voir l’offerwall lui-même, compilez pour Android ou iOS et testez sur un téléphone ou dans le simulateur iOS.
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é.