SDK de offerwall para iOS. Swift, SwiftUI e Objective-C.
Abra o offerwall da Moonetix no seu app para iPhone e iPad com um único pacote Swift. Ele usa apenas UIKit e WebKit, não tem dependências de terceiros e vem com um privacy manifest.
- 13+iOS e iPadOS
- 2.0.1Versão atual
- 0Dependências de terceiros
import MoonetixOfferwall
Moonetix.configure(appId: "YOUR_APP_ID")
// When the user taps Earn
Moonetix.open(token: token)Entre no ar em quatro passos.
Copie o código, substitua os placeholders pelos valores do seu painel em Offerwalls, seu offerwall, Integration, e teste antes de lançar.
-
Instale o SDK
Adicione o pacote no Xcode em File, Add Package Dependencies, ou use o CocoaPods. Você também pode baixar o xcframework e incorporá-lo manualmente. Gere o build com o Xcode 16 ou mais recente.
Package.swiftdependencies: [ .package(url: "https://moonetix.com/ios/moonetix-ios.git", from: "2.0.1"), ], targets: [ .target(name: "MyApp", dependencies: [ .product(name: "MoonetixOfferwall", package: "moonetix-ios"), ]), ]Podfilepod 'MoonetixOfferwall', :podspec => 'https://moonetix.com/ios/2.0.1/MoonetixOfferwall.podspec' -
Adicione um endpoint de token ao seu servidor
O seu app nunca guarda a API key. Quando um usuário toca em Earn, o seu app pede uma sessão ao seu servidor, e o seu servidor pede à Moonetix um token de uso único para aquele usuário logado. Um token funciona uma única vez, por 10 minutos.
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 -
Abra o offerwall
Chame configure uma vez com o App ID do seu painel e depois abra o offerwall com um token novo. Sem um view controller, o SDK é apresentado a partir da tela do topo do seu app, então funciona também com SwiftUI.
EarnViewController.swiftMoonetix.configure(appId: "YOUR_APP_ID") Moonetix.onClosed = { [weak self] in self?.refreshBalance() } Moonetix.onError = { error in print(error.code.name, error.message) } Moonetix.open(token: token, from: self)EarnButton.swiftButton("Earn coins") { Task { let token = try await api.fetchMoonetixToken() Moonetix.open(token: token) } }EarnViewController.m@import MoonetixOfferwall; [Moonetix configureWithAppId:@"YOUR_APP_ID"]; [Moonetix openWithToken:token from:self options:nil]; -
Credite as recompensas com o postback
Cada recompensa chega ao seu servidor como um postback assinado. Verifique o hash, adicione a recompensa uma única vez por ID de transação e retire-a se um postback posterior a estornar. Postbacks com falha são reenviados até 5 vezes.
Painel, aba 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 TownChegue ao nível 15+1,500
WPS OfficeInstalar e abrir+2,000
Bus EscapeChegue ao nível 20+450
CleanfoxSign up in the app+800
O que os seus usuários veem
Uma tela nativa sobre o seu app, com seu título e suas cores, sua moeda e cada recompensa confirmada por um postback.
O que o SDK faz por você
- As ofertas abrem no lugar certo
As ofertas que levam à App Store abrem no app da loja, e os outros sites abrem no navegador, para que as instalações sejam rastreadas corretamente.
- Nenhuma chave dentro do seu app
O seu app guarda apenas o App ID. As sessões são criadas no seu servidor e funcionam uma única vez, então ninguém consegue abrir o offerwall como outro usuário.
- Uma tela protegida
Somente páginas do offerwall carregam dentro dela, sem nenhuma ponte JavaScript para o seu app.
- Navegação nativa
O botão fechar volta para o seu app, deslizar a partir da borda esquerda volta à página anterior dentro do offerwall, e ele retoma de onde o usuário estava depois de ir para segundo plano.
- Acessível por padrão
Modo claro e escuro, tamanhos de texto maiores e VoiceOver funcionam sem configuração extra.
- Privacy manifest incluído
O SDK vem com o próprio privacy manifest, não usa fingerprinting do dispositivo e não usa o identificador de publicidade.
Teste e depois lance.
Tudo o que você precisa verificar antes que usuários reais vejam o seu offerwall, com as ferramentas integradas ao seu painel.
Open as a test user
Em Integration status, na aba Integration, abra o seu offerwall como o usuário owner-test. Visitas de teste não são contadas como usuários.
Execute em um dispositivo real
Gere o build para Android ou iOS e abra o offerwall pelo seu botão Earn com um token novo a cada vez.
Send a test postback
Escolha o usuário, o status e o pagamento, e veja exatamente o que o seu servidor respondeu, com o código de resposta e o tempo. Os IDs de transação de teste começam com test_.
Teste a partir de uma conexão normal
VPNs, proxies, Tor e redes de nuvem são bloqueados, então teste no Wi-Fi de casa ou nos dados móveis, em um país onde haja ofertas ativas.
Checklist de lançamento
0 de 11 prontos
Pronto para lançar. Seu progresso fica salvo neste navegador.
Erros comuns, resolvidos rápido.
O que pode aparecer enquanto você integra o iOS SDK, a causa e a solução.
INVALID_APP_IDO valor passado para init não é o App ID. Passar a API key aqui é o erro mais comum.
SoluçãoCopie novamente o App ID de 24 caracteres na aba Integration.
INVALID_TOKENO app passou algo diferente do token, ou um token criado com a API key de outro app.
SoluçãoPasse apenas o campo token, que começa com sst_, e use o App ID e a API key do mesmo app.
TOKEN_EXPIRED_OR_USEDO token tem mais de 10 minutos ou já foi usado, por exemplo guardado de um toque anterior.
SoluçãoCrie um novo token a cada abertura, logo quando o usuário tocar em Earn.
NOT_INITIALIZEDopen foi chamado antes de init.
SoluçãoChame Moonetix.configure quando o seu app iniciar.
UNKNOWNO offerwall já está aberto, ou não havia nenhum view controller na tela para fazer a apresentação.
SoluçãoAbra uma vez de cada vez e passe um view controller visível com open(token:from:).
Delegate is never calledMoonetix.delegate é uma referência fraca, então o objeto já tinha sido liberado.
SoluçãoMantenha uma referência forte ao seu delegate ou use as closures.
403 from /v1/sessionapp_not_live significa que o app está pausado ou que a sua conta não está ativa. user_blocked significa que bloqueamos esse usuário.
SoluçãoNão mostre o offerwall. Para app_not_live, confira suas notificações.
VPN or Proxy detectedO dispositivo está em uma VPN, um proxy ou uma rede de nuvem, onde as ofertas não podem ser rastreadas.
SoluçãoTeste em uma conexão residencial ou móvel normal, em um país onde haja ofertas ativas.
Postback log shows 403 or 404O seu script rejeitou o postback, ou a URL está errada.
SoluçãoAbra a URL do log em um navegador e confira o seu código de hash.
Postback log shows a timeoutO seu script leva mais de 6 segundos para responder.
SoluçãoResponda primeiro com 200 e execute o trabalho demorado em segundo plano.
Postback log shows 301 or 302A sua URL redireciona, por exemplo de http para https.
SoluçãoUse a URL final. Os postbacks não seguem redirecionamentos.
Nenhum resultado. Veja a lista completa na documentação ou fale conosco.
Em resumo
- Versão mínima
- iOS 13, iPhone e iPad, com build no Xcode 16 ou mais recente
- Linguagens
- Swift, SwiftUI e Objective-C
- Instalação
- Swift Package Manager, CocoaPods ou um xcframework
- Dependências
- Apenas UIKit e WebKit
- Privacidade
- Privacy manifest incluído, sem identificador de publicidade
- Preço
- Gratuito para publishers aprovados
Comece com código que funciona
Outras integrações
- SiteUm link, um iframe ou um botão Earn flutuante. Não precisa de SDK.
- Offers APIReceba as ofertas em JSON e mostre-as com o seu próprio design.
- Android SDKUma tela de offerwall nativa para apps em Kotlin e Java.
- Unity SDKOfertas com recompensa para jogos Android e iOS, em C#.
- Flutter SDKUm plugin em Dart para Android e iOS.
- React Native SDKPara apps React Native e Expo, com tipos de TypeScript.
- Todas as integraçõesCompare lado a lado.
Perguntas sobre iOS
O que os desenvolvedores perguntam antes de adicionar o iOS SDK.
Travou em alguma coisa? Fale conosco
Quais versões do iOS o SDK da Moonetix suporta?
iOS 13 ou mais recente no iPhone e iPad, com build no Xcode 16 ou mais recente. O SDK usa apenas UIKit e WebKit e não tem dependências de terceiros.
Posso usar com SwiftUI?
Sim. Chame Moonetix.open(token:) sem um view controller e o SDK é apresentado a partir da tela do topo do seu app, o que funciona com botões do SwiftUI.
Como faço a instalação?
Com o Swift Package Manager a partir de https://moonetix.com/ios/moonetix-ios.git, com o CocoaPods a partir do nosso podspec, ou incorporando o xcframework manualmente.
O que devo declarar nos detalhes de privacidade da App Store?
User ID, Device ID, Coarse Location e Product Interaction, todos vinculados ao usuário, não usados para rastreamento, para App Functionality. O privacy manifest do SDK lista os mesmos dados.
O offerwall viola as regras de revisão da App Store?
A Apple tem regras para apps que recompensam usuários. A Academy tem um guia sobre como rodar um offerwall em um app iOS dentro dessas regras, incluindo como descrever as suas recompensas.
Como os usuários são recompensados?
O seu servidor recebe um postback assinado a cada recompensa e credita o usuário. Nunca credite a partir de eventos do app, porque eles podem ser falsificados no dispositivo.
Transforme o seu tráfego em ganhos.
Crie uma conta de publisher gratuita e ganhe com cada oferta que seus usuários concluírem no seu site, app, jogo ou comunidade.