SDK offerwall Unity. Les joueurs gagnent votre monnaie de jeu.

Laissez les joueurs gagner votre monnaie de jeu en terminant des offres, sans bannières publicitaires dans votre jeu. Un seul package Unity couvre Android et iOS, et chaque récompense arrive sur votre serveur de jeu sous forme de postback signé.

  • 2022.3+Unity LTS ou Unity 6
  • 2.0.1Version actuelle
  • 2Plateformes, un seul package
SDK UnityVersion 2.0.1
EarnButton.cs
using MoonetixOfferwall;
 
void Awake()
{
    Moonetix.Init("YOUR_APP_ID");
}
 
public void ShowOfferwall(string token)
{
    Moonetix.Open(token);
}

En ligne en quatre é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.

  1. Installer le package

    Ajoutez le scoped registry Moonetix et le package à Packages/manifest.json, ou ajoutez le registre dans Project Settings et installez Moonetix Offerwall depuis le Package Manager. Les SDK Android et iOS sont inclus.

    Packages/manifest.json
    {
      "scopedRegistries": [
        {
          "name": "Moonetix",
          "url": "https://moonetix.com/upm",
          "scopes": ["com.moonetix"]
        }
      ],
      "dependencies": {
        "com.moonetix.offerwall": "2.0.1"
      }
    }
  2. Ajoutez un endpoint de jetons à votre serveur

    Votre app ne contient jamais la clé API. Quand un utilisateur appuie sur Earn, votre app demande une session à votre serveur, et votre serveur demande à Moonetix un jeton à usage unique pour cet utilisateur connecté. Un jeton ne fonctionne qu’une fois, pendant 10 minutes.

    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. Ouvrir l’offerwall

    Appelez Init une seule fois avec l’App ID de votre tableau de bord, puis Open avec un nouveau jeton. Tous les événements arrivent sur le thread principal de Unity, vous pouvez donc mettre à jour votre interface directement. Le package contient aussi un exemple 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. 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.

    Macros de postback et nouvelles tentatives

    Tableau de bord, onglet Postback
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
9:41
Gagner des gemmes12,450 gemmes
EarnMes offres
  • 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
Récompense créditéeTravel Town · +1,500 gemmes
Écran natif
Postback 200 OK

Ce que voient vos utilisateurs

Un écran natif au-dessus de votre app, avec votre titre et vos couleurs, votre monnaie, et chaque récompense confirmée par un postback.

Ce que le package gère pour vous

  • Builds Android et iOS

    Sur Android, il ajoute le dépôt Maven, le SDK et la règle R8 à votre projet Gradle. Sur iOS, il lie et intègre le SDK iOS dans Xcode.

  • Les offres s’ouvrent au bon endroit

    Les offres qui mènent à Google Play ou à l’App Store s’ouvrent dans l’app du store, pour que les installations soient correctement suivies.

  • Aucune clé dans votre jeu

    Votre jeu ne contient que l’App ID. Les sessions viennent de votre serveur et ne fonctionnent qu’une fois.

  • Événements sur le thread principal

    OnOpened, OnClosed et OnError sont déclenchés sur le thread principal de Unity, prêts pour votre interface.

  • Votre monnaie de jeu

    Les récompenses sont affichées et créditées dans votre propre monnaie, avec votre taux de change et la part de l’utilisateur.

  • Pas d’identifiant publicitaire

    Le SDK n’utilise pas l’identifiant publicitaire et ne suit pas les joueurs d’une app à l’autre.

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.

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

  2. Lancez-le sur un appareil réel

    Compilez pour Android ou iOS et ouvrez l’offerwall depuis votre bouton Earn avec un nouveau jeton à chaque fois.

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

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

Erreurs courantes, vite corrigées.

Ce que vous pouvez rencontrer en intégrant le SDK Unity, la cause et la solution.

  • InvalidAppId

    La valeur passée à init n’est pas l’App ID. Passer la clé API à cet endroit est l’erreur la plus courante.

    SolutionCopiez à nouveau l’App ID de 24 caractères depuis l’onglet "Intégration".

  • InvalidToken

    L’app a transmis autre chose que le jeton, ou un jeton créé avec la clé API d’une autre app.

    SolutionPassez uniquement le champ token, qui commence par sst_, et utilisez l’App ID et la clé API de la même app.

  • TokenExpiredOrUsed

    Le jeton a plus de 10 minutes ou a déjà été utilisé, par exemple conservé depuis un appui précédent.

    SolutionCréez un nouveau jeton à chaque ouverture, au moment où l’utilisateur appuie sur Earn.

  • NotInitialized

    open a été appelé avant init.

    SolutionAppelez Moonetix.Init dans Awake de votre première scène.

  • Unsupported

    Le jeu tourne dans le Unity Editor, sur ordinateur ou en WebGL.

    SolutionCompilez pour Android ou iOS, et vérifiez Moonetix.IsSupported avant d’afficher le bouton.

  • iOS build stops on the iOS version

    La version iOS minimale cible dans Player Settings est inférieure à 13.0.

    SolutionRéglez-la sur 13.0 ou plus.

  • 403 from /v1/session

    app_not_live signifie que l’app est en pause ou que votre compte n’est pas actif. user_blocked signifie que nous avons bloqué cet utilisateur.

    SolutionN’affichez pas l’offerwall. Pour app_not_live, consultez vos notifications.

  • VPN or Proxy detected

    L’appareil utilise un VPN, un proxy ou un réseau cloud, où les offres ne peuvent pas être suivies.

    SolutionTestez sur une connexion domestique ou mobile normale, dans un pays où des offres sont disponibles.

  • Postback log shows 403 or 404

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

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

    Votre URL redirige, par exemple de http vers https.

    SolutionUtilisez l’URL finale. Les postbacks ne suivent pas les redirections.

Questions sur Unity

Les questions des développeurs avant d’ajouter le SDK Unity.

Un point bloquant ? Contactez-nous

Quelles versions de Unity sont prises en charge ?

Unity 2022.3 LTS, ou Unity 6 (6000.0) ou plus récent. Sur iOS, réglez la version iOS minimale sur 13.0 ou plus dans Player Settings.

Est-ce que cela fonctionne pour les builds Android et iOS ?

Oui. Un seul package couvre les deux. Unity ajoute lui-même le SDK Android au projet Gradle et le SDK iOS au projet Xcode, y compris pour les projets exportés et les modèles Gradle personnalisés.

Comment installer le package Unity de Moonetix ?

Ajoutez le scoped registry Moonetix et com.moonetix.offerwall à Packages/manifest.json, ou installez-le depuis My Registries dans le Package Manager. Vous pouvez aussi l’installer depuis un tarball.

Un offerwall, est-ce du pay-to-win ?

Non. Les joueurs gagnent la même monnaie qu’en jouant, en essayant des apps et des jeux d’annonceurs. Cela donne aux joueurs qui ne paient pas un moyen de progresser, sans bannières publicitaires dans votre jeu.

Comment créditer les joueurs en toute sécurité ?

Créditez les récompenses sur votre serveur de jeu à partir du postback signé, jamais à partir des événements client, car les joueurs peuvent les falsifier. Quand OnClosed se déclenche, chargez le solde du joueur depuis votre serveur.

Puis-je le tester dans le Unity Editor ?

Vous pouvez tester votre parcours. Dans l’Editor, sur ordinateur et en WebGL, Open vérifie l’App ID et le jeton puis renvoie Unsupported, et Moonetix.IsSupported vaut false. Pour voir l’offerwall lui-même, compilez pour Android ou iOS et testez sur un téléphone ou dans le simulateur iOS.

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

Ciblage mondial
Plus
Se connecter