Offerwall per qualsiasi sito web. Link, iframe o pulsante.
Inserisca l'offerwall Moonetix in qualsiasi sito web, da WordPress a un'app personalizzata, con un link firmato, un iframe o un pulsante flottante. I suoi utenti guadagnano la sua valuta e ogni ricompensa raggiunge il suo server come postback firmato.
- 3Modi per mostrarlo
- 0SDK da installare
- HTTPSQualsiasi sito, qualsiasi 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>Vada live in tre 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.
-
Crei il link firmato sul suo server
Ogni link contiene l'ID del suo utente connesso e un hash HMAC-SHA256 creato con il suo link hash salt. L'hash impedisce a chiunque di cambiare l'ID utente per aprire il wall come un'altra persona, quindi lo generi sul suo server e non inserisca mai il salt in una pagina.
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}" -
Lo mostri nel modo più adatto al suo sito
Apra il link dal suo menu, lo incorpori in una pagina dedicata o aggiunga il pulsante flottante a ogni pagina. Può usarne più di uno contemporaneamente: tutti condividono le stesse ricompense e gli stessi postback.
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>Linkhttps://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}&sub1=homepage -
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
Direttamente sulla sua pagina
Il pulsante flottante apre l'offerwall in un pop-up, così gli utenti non lasciano mai la pagina in cui si trovano.
Tutto ciò che il wall fa per lei
- Una pagina offerwall completa
Schede Earn e Le mie offerte, ricerca, categorie e ordinamento, con le offerte adatte al paese e al dispositivo di ogni utente.
- La sua valuta
Ogni ricompensa è mostrata con il nome e l'icona della sua valuta, calcolata con il suo tasso di cambio e la quota per gli utenti.
- Il suo brand
Colori, raggio degli angoli, spaziatura, dimensione del testo e icona della valuta si impostano nella dashboard, senza codice.
- Link firmati
L'opzione "Sicurezza dei link" è attiva di default, così nessuno può aprire il suo wall al posto di uno dei suoi utenti.
- Sub ID
Aggiunga fino a cinque valori propri, come la pagina o la campagna, e li riceva in ogni postback e report.
- Assistenza agli utenti
Gli utenti seguono le loro offerte in Le mie offerte e possono segnalare una ricompensa mancante direttamente dall'offerta.
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.
Verifica un link
Incolli un link generato dal suo sito, oppure digiti un ID utente per vedere il link esatto che il suo server dovrebbe generare. I due devono essere identici.
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 integrando l'offerwall nel suo sito web, la causa e la soluzione.
Link not validL'hash non corrisponde all'ID utente nel link.
SoluzioneFirmi l'ID utente esatto con il link hash salt, non con la chiave segreta del postback, in esadecimale minuscolo.
Missing user IDL'ID utente è vuoto o contiene caratteri non accettati.
SoluzioneUsi da 1 a 100 caratteri tra A-Z a-z 0-9 . _ @ : + - e lo codifichi per URL.
Blank iframe or pop-upLa pagina non si trova sul sito web registrato per l'app, oppure non è https.
SoluzioneLo incorpori in una pagina https di quel dominio o di un sottodominio. Per un altro sito, aggiunga una nuova app.
No floating buttondata-button-url manca o non è un link dell'offerwall.
SoluzioneUsi il link firmato completo che inizia con https://wall.moonetix.com/.
VPN or Proxy detectedSta facendo il test tramite una VPN, un proxy o una rete cloud.
SoluzioneEsegua il test da una normale connessione domestica o mobile.
Fewer offers than expectedHa nascosto alcune offerte, oppure in quel paese o su quel dispositivo ci sono meno offerte attive.
SoluzioneApra "Offerte" nella sua dashboard, imposti "Stato" su "Nascosta" e clicchi "Mostra" per far riapparire un'offerta.
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
- Funziona su
- Qualsiasi sito web https: WordPress, Next.js, Laravel, HTML semplice e altro
- Modi per mostrarlo
- Link, iframe, pulsante flottante o un suo pulsante
- Regole di incorporamento
- Frame e pop-up si caricano sul sito web registrato e sui suoi sottodomini
- Dimensione dello script
- Un piccolo script, solo per il pulsante e il pop-up
- Ricompense
- Postback firmato server-to-server, fino a 5 nuovi tentativi
- Prezzo
- Gratuito per i publisher approvati
Parta da codice funzionante
- Next.jsUna pagina Earn in Next.js con un link all'offerwall firmato dal server e una route per i postback verificata.
- LaravelUn'app Laravel con una pagina Earn e una route per i postback che accredita ogni offerta esattamente una volta.
- DjangoUn'app Django con una pagina Earn e una view per i postback che accredita ogni offerta esattamente una volta.
- Sito di ricompenseUn piccolo sito di ricompense con account, saldo, pagina Earn, postback verificati e richieste di riscatto che approva lei.
Altre integrazioni
- 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.
- React Native SDKPer app React Native ed Expo, con tipi TypeScript.
- Tutte le integrazioniLi confronti fianco a fianco.
Domande sul sito web
Cosa chiedono gli sviluppatori prima di aggiungere l'offerwall al proprio sito web.
Bloccato su qualcosa? Ci contatti
Devo installare qualcosa per aggiungere un offerwall al mio sito web?
No. L'offerwall gira su Moonetix. Lei aggiunge un link firmato al suo sito, lo incorpora con un iframe o carica un piccolo script per il pulsante flottante. Il suo server si limita a creare il link e a ricevere i postback.
Funziona con WordPress?
Sì. Crei il link firmato in un piccolo plugin o nel suo tema con l'esempio PHP, poi lo incorpori in una pagina Earn o aggiunga il pulsante flottante. L'Academy ha una guida passo passo per WordPress.
Perché il link ha bisogno di un hash?
L'hash è un HMAC-SHA256 dell'ID utente, creato con il suo link hash salt. Dimostra che il link per quell'utente è stato creato dal suo server, così nessuno può cambiare l'ID utente nella barra degli indirizzi e guadagnare al posto di un altro.
Perché l'offerwall non si carica nel mio iframe?
Per sicurezza, frame e pop-up si caricano solo su pagine https del sito web registrato per l'app e dei suoi sottodomini. Aprire il link direttamente in una scheda, in una nuova finestra o in una WebView mobile funziona ovunque.
Come ricevono le ricompense i miei utenti?
Moonetix invia un postback firmato al suo server per ogni ricompensa. Il suo server verifica l'hash e accredita l'utente nella sua valuta. Un eventuale storno successivo arriva con lo stesso ID transazione, così può riprendersi la ricompensa.
Posso scegliere quali offerte compaiono?
Sì. Nella pagina "Offerte" della sua dashboard può nascondere qualsiasi offerta, che scompare dal suo offerwall, dal wall incorporato, dal pulsante flottante e dalla Offers API di quell'app.
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.