Un offerwall pour n’importe quel site web. Lien, iframe ou bouton.
Placez l’offerwall Moonetix sur n’importe quel site web, de WordPress à une app sur mesure, avec un lien signé, un iframe ou un bouton flottant. Vos utilisateurs gagnent votre monnaie, et chaque récompense arrive sur votre serveur sous forme de postback signé.
- 3Façons de l’afficher
- 0SDK à installer
- HTTPSTout site, toute stack
<iframe title="Offerwall"
src="https://wall.moonetix.com/APP_ID?user_id=USER_ID&hash=HASH"
style="border:0;width:100%;height:100vh"></iframe>En ligne en trois é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.
-
Créez le lien signé sur votre serveur
Chaque lien contient l’ID de votre utilisateur connecté et un hash HMAC-SHA256 calculé avec votre sel de hash de lien. Le hash empêche quiconque de modifier l’ID utilisateur pour ouvrir l’offerwall à la place de quelqu’un d’autre : créez-le donc sur votre serveur et ne mettez jamais le sel dans une page.
offerwall.php<?php // Build the link on your server, for the signed-in user $hash = hash_hmac('sha256', $userId, $linkHashSalt); $url = 'https://wall.moonetix.com/' . $appId . '?user_id=' . rawurlencode($userId) . '&hash=' . $hash;offerwall.js// Build the link on your server, for the signed-in user const crypto = require('crypto'); const hash = crypto.createHmac('sha256', linkHashSalt) .update(String(userId)) .digest('hex'); const url = `https://wall.moonetix.com/${appId}` + `?user_id=${encodeURIComponent(userId)}&hash=${hash}`;offerwall.py# Build the link on your server, for the signed-in user import hmac, hashlib from urllib.parse import quote uid = str(user_id) hash = hmac.new(link_hash_salt.encode(), uid.encode(), hashlib.sha256).hexdigest() url = f"https://wall.moonetix.com/{app_id}?user_id={quote(uid)}&hash={hash}" -
Affichez-le de la façon qui convient à votre site
Ouvrez le lien depuis votre menu, intégrez-le sur une page dédiée, ou ajoutez le bouton flottant à toutes les pages. Vous pouvez en utiliser plusieurs à la fois : tous partagent les mêmes récompenses et les mêmes postbacks.
earn.html<iframe title="Offerwall" src="https://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}" style="border:0;width:100%;height:100vh"></iframe>layout.html<script src="https://wall.moonetix.com/embed.js" async data-button-url="https://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}" data-button-text="Earn rewards" data-button-color="#004ABB" data-button-position="right"></script>menu.html<a href="https://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}" data-moonetix-open>Earn rewards</a> <script src="https://wall.moonetix.com/embed.js" async></script>Lienhttps://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}&sub1=homepage -
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
Directement sur votre page
Le bouton flottant ouvre l’offerwall dans une fenêtre pop-up, pour que les utilisateurs ne quittent jamais la page où ils se trouvent.
Tout ce que l’offerwall fait pour vous
- Une page d’offerwall complète
Onglets Earn et My offers, recherche, catégories et tri, avec les offres adaptées au pays et à l’appareil de chaque utilisateur.
- Votre monnaie
Chaque récompense est affichée avec le nom et l’icône de votre propre monnaie, calculée avec votre taux de conversion et la part de l’utilisateur.
- Votre marque
Les couleurs, l’arrondi des coins, les marges internes, la taille de police et l’icône de la monnaie se règlent dans votre tableau de bord, sans code.
- Des liens signés
L’option "Sécurité des liens" est activée par défaut, personne ne peut donc ouvrir votre offerwall à la place de l’un de vos utilisateurs.
- Sub IDs
Ajoutez jusqu’à cinq valeurs personnalisées, comme la page ou la campagne, et retrouvez-les dans chaque postback et chaque rapport.
- Support utilisateurs
Les utilisateurs suivent leurs offres dans My offers et peuvent signaler une récompense manquante directement depuis l’offre.
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.
Vérifier un lien
Collez un lien créé par votre site, ou saisissez un ID utilisateur pour voir le lien exact que votre serveur doit créer. Les deux doivent être identiques.
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 l’offerwall sur votre site web, la cause et la solution.
Link not validLe hash ne correspond pas à l’ID utilisateur du lien.
SolutionSignez l’ID utilisateur exact avec le sel de hash du lien, et non avec la clé secrète du postback, en hexadécimal minuscule.
Missing user IDL’ID utilisateur est vide ou contient des caractères que nous n’acceptons pas.
SolutionUtilisez 1 à 100 caractères parmi A-Z a-z 0-9 . _ @ : + - et encodez-le pour l’URL.
Blank iframe or pop-upLa page n’est pas sur le site web enregistré pour l’app, ou elle n’est pas en https.
SolutionIntégrez-le sur une page https de ce domaine ou d’un sous-domaine. Pour un autre site, ajoutez une nouvelle app.
No floating buttondata-button-url est absent ou n’est pas un lien d’offerwall.
SolutionUtilisez le lien signé complet qui commence par https://wall.moonetix.com/.
VPN or Proxy detectedVous testez via un VPN, un proxy ou un réseau cloud.
SolutionTestez depuis une connexion domestique ou mobile normale.
Fewer offers than expectedVous avez masqué des offres, ou moins d’offres sont disponibles dans ce pays ou sur cet appareil.
SolutionOuvrez "Offres" dans votre tableau de bord, réglez "Statut" sur "Masqué", et cliquez sur "Afficher" pour réafficher une offre.
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
- Fonctionne sur
- Tout site web en https : WordPress, Next.js, Laravel, HTML simple, et plus encore
- Façons de l’afficher
- Lien, iframe, bouton flottant ou votre propre bouton
- Règles d’intégration
- Les iframes et les pop-ups se chargent sur le site web enregistré et ses sous-domaines
- Taille du script
- Un petit script, uniquement pour le bouton et la fenêtre pop-up
- Récompenses
- Postback signé de serveur à serveur, avec jusqu’à 5 nouvelles tentatives
- Prix
- Gratuit pour les éditeurs approuvés
Partez d’un code qui fonctionne
- Next.jsUne page Earn Next.js avec un lien d’offerwall signé par le serveur et une route de postback vérifiée.
- LaravelUne app Laravel avec une page Earn et une route de postback qui crédite chaque offre exactement une fois.
- DjangoUne app Django avec une page Earn et une vue de postback qui crédite chaque offre exactement une fois.
- Site de récompensesUn petit site de récompenses avec des comptes, un solde, une page Earn, des postbacks vérifiés et des demandes d’échange que vous approuvez.
Autres intégrations
- 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.
- SDK React NativePour les apps React Native et Expo, avec les types TypeScript.
- Toutes les intégrationsComparez-les côte à côte.
Questions sur les sites web
Les questions des développeurs avant d’ajouter l’offerwall à leur site web.
Un point bloquant ? Contactez-nous
Dois-je installer quelque chose pour ajouter un offerwall à mon site web ?
Non. L’offerwall fonctionne sur Moonetix. Vous ajoutez un lien signé à votre site, l’intégrez avec un iframe, ou chargez un petit script pour le bouton flottant. Votre serveur se contente de créer le lien et de recevoir les postbacks.
Est-ce que cela fonctionne avec WordPress ?
Oui. Créez le lien signé dans un petit plugin ou votre thème avec l’exemple PHP, puis intégrez-le sur une page Earn ou ajoutez le bouton flottant. L’Academy propose un guide WordPress pas à pas.
Pourquoi le lien a-t-il besoin d’un hash ?
Le hash est un HMAC-SHA256 de l’ID utilisateur, calculé avec votre sel de hash de lien. Il prouve que votre serveur a créé le lien pour cet utilisateur, pour que personne ne puisse modifier l’ID utilisateur dans la barre d’adresse et gagner à la place de quelqu’un d’autre.
Pourquoi l’offerwall ne se charge-t-il pas dans mon iframe ?
Par sécurité, les iframes et les pop-ups ne se chargent que sur les pages https du site web enregistré pour l’app et de ses sous-domaines. Ouvrir le lien directement dans un onglet, une nouvelle fenêtre ou une WebView mobile fonctionne partout.
Comment mes utilisateurs reçoivent-ils leurs récompenses ?
Moonetix envoie un postback signé à votre serveur pour chaque récompense. Votre serveur vérifie le hash et crédite l’utilisateur dans votre monnaie. Une annulation ultérieure arrive avec le même ID de transaction, vous pouvez donc reprendre la récompense.
Puis-je choisir les offres qui apparaissent ?
Oui. Sur la page "Offres" de votre tableau de bord, vous pouvez masquer n’importe quelle offre, et elle disparaît de votre offerwall, de l’offerwall intégré, du bouton flottant et de l’Offers API de cette app.
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é.