SDK offerwall per Unity. I giocatori guadagnano la valuta del suo gioco.

Permetta ai giocatori di guadagnare la valuta del suo gioco completando offerte, senza banner nel gioco. Un solo pacchetto Unity copre Android e iOS, e ogni ricompensa raggiunge il server del suo gioco come postback firmato.

  • 2022.3+Unity LTS o Unity 6
  • 2.0.1Versione attuale
  • 2Piattaforme, un solo pacchetto
Unity SDKVersione 2.0.1
EarnButton.cs
using MoonetixOfferwall;
 
void Awake()
{
    Moonetix.Init("YOUR_APP_ID");
}
 
public void ShowOfferwall(string token)
{
    Moonetix.Open(token);
}

Vada live in quattro 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.

  1. Installi il pacchetto

    Aggiunga lo scoped registry di Moonetix e il pacchetto a Packages/manifest.json, oppure aggiunga il registry in Project Settings e installi Moonetix Offerwall dal Package Manager. Gli SDK per Android e iOS sono inclusi.

    Packages/manifest.json
    {
      "scopedRegistries": [
        {
          "name": "Moonetix",
          "url": "https://moonetix.com/upm",
          "scopes": ["com.moonetix"]
        }
      ],
      "dependencies": {
        "com.moonetix.offerwall": "2.0.1"
      }
    }
  2. Aggiunga un endpoint token al suo server

    La sua app non contiene mai la chiave API. Quando un utente tocca Earn, l'app chiede una sessione al suo server, e il server chiede a Moonetix un token monouso per quell'utente connesso. Un token vale una sola volta, per 10 minuti.

    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']);
  3. Apri l'offerwall

    Chiami Init una volta con l'App ID della sua dashboard, poi Open con un token nuovo. Tutti gli eventi arrivano sul thread principale di Unity, quindi può aggiornare direttamente la sua interfaccia. Il pacchetto include anche l'esempio Offerwall demo.

    EarnButton.cs
    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() { }
    }
  4. 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.

    Macro e nuovi tentativi dei postback

    Dashboard, scheda "Postback"
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
9:41
Guadagna gemme12,450 gemme
EarnLe mie offerte
  • 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
Ricompensa accreditataTravel Town · +1,500 gemme
Schermata nativa
Postback 200 OK

Cosa vedono i suoi utenti

Una schermata nativa sopra la sua app, con il suo titolo e i suoi colori, la sua valuta e ogni ricompensa confermata da un postback.

Cosa gestisce il pacchetto per lei

  • Build Android e iOS

    Su Android aggiunge al suo progetto Gradle il repository Maven, l'SDK e la regola R8. Su iOS collega e incorpora l'SDK iOS in Xcode.

  • Le offerte si aprono nel posto giusto

    Le offerte che portano a Google Play o all'App Store si aprono nell'app dello store, così le installazioni vengono tracciate correttamente.

  • Nessuna chiave nel suo gioco

    Il suo gioco contiene solo l'App ID. Le sessioni arrivano dal suo server e valgono una sola volta.

  • Eventi sul thread principale

    OnOpened, OnClosed e OnError vengono generati sul thread principale di Unity, pronti per la sua interfaccia.

  • La valuta del suo gioco

    Le ricompense vengono mostrate e accreditate nella sua valuta, con il suo tasso di cambio e la quota per gli utenti.

  • Nessun ID pubblicitario

    L'SDK non usa l'identificatore pubblicitario e non traccia i giocatori tra le app.

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.

  1. 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.

  2. Lo esegua su un dispositivo reale

    Compili per Android o iOS e apra l'offerwall dal suo pulsante Earn con un token nuovo ogni volta.

  3. 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_.

  4. 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

Errori comuni, risolti in fretta.

Cosa potrebbe incontrare durante l'integrazione dell'SDK Unity, la causa e la soluzione.

  • InvalidAppId

    Il valore passato a init non è l'App ID. Passare qui la chiave API è l'errore più comune.

    SoluzioneCopi di nuovo l'App ID di 24 caratteri dalla scheda "Integrazione".

  • InvalidToken

    L'app ha passato qualcosa di diverso dal token, oppure un token creato con la chiave API di un'altra app.

    SoluzionePassi solo il campo token, che inizia con sst_, e usi App ID e chiave API della stessa app.

  • TokenExpiredOrUsed

    Il token ha più di 10 minuti o è già stato usato, ad esempio perché conservato da un tocco precedente.

    SoluzioneCrei un nuovo token per ogni apertura, nel momento in cui l'utente tocca Earn.

  • NotInitialized

    open è stato chiamato prima di init.

    SoluzioneChiami Moonetix.Init in Awake della sua prima scena.

  • Unsupported

    Il gioco gira nell'Unity Editor, su desktop o in WebGL.

    SoluzioneCompili per Android o iOS e controlli Moonetix.IsSupported prima di mostrare il pulsante.

  • iOS build stops on the iOS version

    La versione minima di iOS impostata in Player Settings è inferiore a 13.0.

    SoluzioneLo imposti su 13.0 o superiore.

  • 403 from /v1/session

    app_not_live significa che l'app è in pausa o che il suo account non è attivo. user_blocked significa che abbiamo bloccato questo utente.

    SoluzioneNon mostri l'offerwall. Per app_not_live, controlli le sue notifiche.

  • VPN or Proxy detected

    Il dispositivo usa una VPN, un proxy o una rete cloud, dove le offerte non possono essere tracciate.

    SoluzioneEsegua il test da una normale connessione domestica o mobile, in un paese in cui ci sono offerte attive.

  • Postback log shows 403 or 404

    Il 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 timeout

    Il 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 302

    Il suo URL reindirizza, ad esempio da http a https.

    SoluzioneUsi l'URL finale. I postback non seguono i reindirizzamenti.

Domande su Unity

Cosa chiedono gli sviluppatori prima di aggiungere l'SDK Unity.

Bloccato su qualcosa? Ci contatti

Quali versioni di Unity sono supportate?

Unity 2022.3 LTS, oppure Unity 6 (6000.0) o successivo. Su iOS, imposti la versione minima di iOS su 13.0 o superiore in Player Settings.

Funziona per le build Android e iOS?

Sì. Un solo pacchetto copre entrambi. Unity aggiunge da solo l'Android SDK al progetto Gradle e l'SDK iOS al progetto Xcode, compresi i progetti esportati e i template Gradle personalizzati.

Come installo il pacchetto Unity di Moonetix?

Aggiunga lo scoped registry di Moonetix e com.moonetix.offerwall a Packages/manifest.json, oppure lo installi da My Registries nel Package Manager. Può anche installarlo da un tarball.

Un offerwall è pay-to-win?

No. I giocatori guadagnano la stessa valuta che guadagnerebbero giocando, provando app e giochi degli inserzionisti. Offre ai giocatori che non pagano un modo per progredire senza banner nel suo gioco.

Come accredito i giocatori in modo sicuro?

Accrediti le ricompense sul server del gioco dal postback firmato, mai dagli eventi del client, perché i giocatori possono falsificarli. Quando scatta OnClosed, carichi il saldo del giocatore dal suo server.

Posso testarlo nell'Unity Editor?

Può testare il suo flusso. Nell'Editor, su desktop e in WebGL, Open verifica l'App ID e il token e poi segnala Unsupported, e Moonetix.IsSupported è false. Per vedere l'offerwall vero e proprio, compili per Android o iOS e faccia il test su un telefono o nel simulatore iOS.

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.

Targeting in tutto il mondo
Altro
Accedi