Offerwall для любого сайта. Ссылка, iframe или кнопка.
Разместите offerwall Moonetix на любом сайте, от WordPress до собственного приложения, с помощью подписанной ссылки, iframe или плавающей кнопки. Ваши пользователи зарабатывают вашу валюту, а каждая награда приходит на ваш сервер в виде подписанного postback.
- 3Способы показа
- 0SDK для установки
- HTTPSЛюбой сайт, любой стек
<iframe title="Offerwall"
src="https://wall.moonetix.com/APP_ID?user_id=USER_ID&hash=HASH"
style="border:0;width:100%;height:100vh"></iframe>Запуск за три шага.
Скопируйте код, замените плейсхолдеры значениями из личного кабинета (Offerwall, ваш offerwall, Интеграция) и протестируйте перед запуском.
-
Создайте подписанную ссылку на сервере
Каждая ссылка содержит ID вашего авторизованного пользователя и хеш HMAC-SHA256, созданный с вашей солью хеша ссылки (link hash salt). Хеш не дает никому изменить ID пользователя, чтобы открыть offerwall от чужого имени, поэтому формируйте его на сервере и никогда не размещайте соль на странице.
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}" -
Показывайте его так, как удобно вашему сайту
Открывайте ссылку из меню, встройте ее на отдельную страницу или добавьте плавающую кнопку на каждую страницу. Можно использовать несколько способов сразу: у всех них общие награды и 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>Ссылкаhttps://wall.moonetix.com/{APP_ID}?user_id={USER_ID}&hash={HASH}&sub1=homepage -
Начисляйте награды через postback
Каждая награда приходит на ваш сервер в виде подписанного postback. Проверьте хеш, начислите награду один раз на каждый ID транзакции и спишите ее, если последующий postback ее отменяет. Неудачные postback отправляются повторно до 5 раз.
Личный кабинет, вкладка "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 TownДостигните 15 уровня+1,500
WPS OfficeУстановка и открытие+2,000
Bus EscapeДостигните 20 уровня+450
CapCutSign up in the app+800
Прямо на вашей странице
Плавающая кнопка открывает offerwall во всплывающем окне, поэтому пользователи не покидают текущую страницу.
Все, что offerwall делает за вас
- Полноценная страница offerwall
Вкладки Earn и My offers, поиск, категории и сортировка, с офферами, подходящими для страны и устройства каждого пользователя.
- Ваша валюта
Каждая награда показывается с названием и значком вашей собственной валюты и рассчитывается по вашему курсу конвертации и доле пользователя.
- Ваш бренд
Цвета, радиус углов, отступы, размер шрифта и значок валюты задаются в личном кабинете, без кода.
- Подписанные ссылки
Функция "Безопасность ссылок" включена по умолчанию, поэтому никто не сможет открыть ваш offerwall под видом одного из ваших пользователей.
- Sub ID
Добавьте до пяти собственных значений, например страницу или кампанию, и получайте их обратно в каждом postback и отчете.
- Поддержка пользователей
Пользователи следят за своими офферами в My offers и могут сообщить о неполученной награде прямо из оффера.
Протестируйте, затем запускайте.
Все, что нужно проверить, прежде чем реальные пользователи увидят ваш offerwall, с помощью инструментов, встроенных в личный кабинет.
Открыть как тестовый пользователь
В блоке "Статус интеграции" на вкладке "Интеграция" откройте свой offerwall как пользователь owner-test. Тестовые визиты не учитываются как пользователи.
Проверить ссылку
Вставьте ссылку, созданную вашим сайтом, или введите ID пользователя, чтобы увидеть точную ссылку, которую должен создать ваш сервер. Они должны совпадать.
Отправить тестовый postback
Выберите пользователя, статус и выплату и посмотрите, что именно ответил ваш сервер, с кодом ответа и временем. ID тестовых транзакций начинаются с test_.
Тестируйте с обычного подключения
VPN, прокси, Tor и облачные сети блокируются, поэтому тестируйте через домашний Wi-Fi или мобильный интернет, в стране, где доступны офферы.
Чек-лист запуска
0 из 11 готово
Все готово к запуску. Ваш прогресс сохраняется в этом браузере.
Частые ошибки и быстрые решения.
Что вы можете увидеть при интеграции offerwall на сайт, в чем причина и как это исправить.
Link not validХеш не совпадает с ID пользователя в ссылке.
РешениеПодписывайте точный ID пользователя солью хеша ссылки (link hash salt), а не секретным ключом postback, в виде hex в нижнем регистре.
Missing user IDID пользователя пустой или содержит недопустимые символы.
РешениеИспользуйте от 1 до 100 символов из набора A-Z a-z 0-9 . _ @ : + - и кодируйте значение для URL.
Blank iframe or pop-upСтраница находится не на сайте, который вы указали для приложения, или работает не по https.
РешениеВстраивайте его на https-страницу этого домена или поддомена. Для другого сайта добавьте новое приложение.
No floating buttondata-button-url отсутствует или не является ссылкой на offerwall.
РешениеИспользуйте полную подписанную ссылку, которая начинается с https://wall.moonetix.com/.
VPN or Proxy detectedВы тестируете через VPN, прокси или облачную сеть.
РешениеТестируйте с обычного домашнего или мобильного подключения.
Fewer offers than expectedВы скрыли часть офферов, или в этой стране либо на этом устройстве доступно меньше офферов.
РешениеОткройте "Офферы" в личном кабинете, в поле "Статус" выберите "Скрыт" и нажмите "Показать", чтобы вернуть оффер.
Postback log shows 403 or 404Ваш скрипт отклонил postback, или URL неверен.
РешениеОткройте URL из лога в браузере и проверьте код, который вычисляет хеш.
Postback log shows a timeoutВаш скрипт отвечает дольше 6 секунд.
РешениеСначала отвечайте кодом 200, а медленную работу выполняйте в фоне.
Postback log shows 301 or 302Ваш URL выполняет редирект, например с http на https.
РешениеИспользуйте конечный URL. Postback-запросы не следуют редиректам.
Ничего не найдено. Посмотрите полный список в документации или свяжитесь с нами.
Коротко о главном
- Работает на
- Любой сайт на https: WordPress, Next.js, Laravel, обычный HTML и другие
- Способы показа
- Ссылка, iframe, плавающая кнопка или ваша собственная кнопка
- Правила встраивания
- Фреймы и всплывающие окна загружаются на указанном вами сайте и его поддоменах
- Размер скрипта
- Один небольшой скрипт, только для кнопки и всплывающего окна
- Награды
- Подписанный postback типа server-to-server, до 5 повторных попыток
- Цена
- Бесплатно для одобренных паблишеров
Начните с рабочего кода
- Next.jsСтраница Earn на Next.js с подписанной сервером ссылкой на offerwall и проверенным postback-маршрутом.
- LaravelПриложение на Laravel со страницей Earn и postback-маршрутом, который засчитывает каждый оффер ровно один раз.
- DjangoПриложение на Django со страницей Earn и postback-обработчиком, который засчитывает каждый оффер ровно один раз.
- Сайт с наградамиНебольшой сайт с наградами: аккаунты, баланс, страница Earn, проверенные postback и заявки на вывод, которые вы одобряете.
Другие интеграции
- Offers APIПолучайте офферы в JSON и показывайте их в собственном дизайне.
- Android SDKНативный экран offerwall для приложений на Kotlin и Java.
- iOS SDKНативный offerwall для Swift, SwiftUI и Objective-C.
- Unity SDKОфферы с наградами для игр на Android и iOS, прямо из кода на C#.
- Flutter SDKОдин плагин на Dart для Android и iOS.
- React Native SDKДля приложений React Native и Expo, с типами TypeScript.
- Все интеграцииСравните их между собой.
Вопросы о сайтах
Что спрашивают разработчики, прежде чем добавить offerwall на сайт.
Что-то не получается? Свяжитесь с нами
Нужно ли что-то устанавливать, чтобы добавить offerwall на сайт?
Нет. Offerwall работает на стороне Moonetix. Вы добавляете на сайт подписанную ссылку, встраиваете ее через iframe или загружаете один небольшой скрипт для плавающей кнопки. Ваш сервер только формирует ссылку и принимает postback.
Работает ли он с WordPress?
Да. Создайте подписанную ссылку в небольшом плагине или в своей теме по примеру на PHP, затем встройте ее на страницу Earn или добавьте плавающую кнопку. В Academy есть пошаговое руководство для WordPress.
Зачем ссылке хеш?
Хеш - это HMAC-SHA256 от ID пользователя, созданный с вашей солью хеша ссылки (link hash salt). Он доказывает, что ссылку для этого пользователя создал ваш сервер, поэтому никто не сможет изменить ID пользователя в адресной строке и заработать от чужого имени.
Почему offerwall не загружается в моем iframe?
В целях безопасности фреймы и всплывающие окна загружаются только на https-страницах сайта, который вы указали для приложения, и его поддоменов. Прямое открытие ссылки во вкладке, новом окне или мобильном WebView работает везде.
Как мои пользователи получают награды?
Moonetix отправляет на ваш сервер подписанный postback за каждую награду. Ваш сервер проверяет хеш и начисляет пользователю награду в вашей валюте. Последующая отмена приходит с тем же ID транзакции, поэтому вы можете списать награду.
Можно ли выбрать, какие офферы будут показаны?
Да. На странице "Офферы" в личном кабинете можно скрыть любой оффер, и он исчезнет из вашего offerwall, встроенного offerwall, плавающей кнопки и Offers API этого приложения.
Превратите свой трафик в доход.
Создайте бесплатный аккаунт паблишера и зарабатывайте на каждом оффере, который ваши пользователи выполняют на вашем сайте, в приложении, игре или сообществе.