Plugin offerwall Flutter. Une seule API Dart, Android et iOS.

Ajoutez l’offerwall Moonetix à votre app Flutter avec un seul plugin. Il inclut les SDK natifs Android et iOS, il n’y a donc rien d’autre à configurer dans Gradle ou Xcode.

  • 3.27+Flutter
  • 2.0.1Version actuelle
  • 2Plateformes, un seul plugin
SDK FlutterVersion 2.0.1
main.dart
import 'package:moonetix_offerwall/moonetix_offerwall.dart';
 
Moonetix.init('YOUR_APP_ID');
 
// When the user taps Earn
await 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 plugin

    Ajoutez le plugin depuis le dépôt de packages Moonetix et lancez flutter pub get. Sur Android, il apporte le dépôt Maven, le SDK et les règles R8. Sur iOS, il apporte le SDK iOS pour CocoaPods et Swift Package Manager.

    pubspec.yaml
    dependencies:
      moonetix_offerwall:
        hosted: https://moonetix.com/pub
        version: ^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. Écoutez Moonetix.events avant d’appeler open, et actualisez le solde quand l’utilisateur ferme l’offerwall.

    main.dart
    void main() {
      WidgetsFlutterBinding.ensureInitialized();
      Moonetix.init('YOUR_APP_ID');
      runApp(const MyApp());
    }
     
    Moonetix.events.listen((MoonetixEvent event) {
      switch (event) {
        case MoonetixOpened():
          break;
        case MoonetixClosed():
          refreshBalance();
        case MoonetixErrorEvent(:final MoonetixError error):
          debugPrint('${error.code.name}: ${error.message}');
      }
    });
     
    await Moonetix.open(token);
  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 pièces12,450 pièces
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 pièces
É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 plugin gère pour vous

  • SDK natifs inclus

    Le plugin inclut les SDK Android et iOS. Aucun dépôt Gradle ni aucune étape Xcode à ajouter à la main.

  • Les offres s’ouvrent au bon endroit

    Les offres des stores s’ouvrent dans Google Play ou l’App Store, et les autres sites dans le navigateur, pour que les installations soient correctement suivies.

  • Aucune clé dans votre app

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

  • Événements typés

    Un flux broadcast de MoonetixOpened, MoonetixClosed et MoonetixErrorEvent, ou un listener si vous préférez les callbacks.

  • Votre design

    L’écran utilise le titre et les couleurs de l’onglet "Design" de votre tableau de bord.

  • Pas d’identifiant publicitaire

    Le plugin n’utilise pas l’identifiant publicitaire et ne suit pas les utilisateurs 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 Flutter, 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 main().

  • unsupported

    L’app tourne sur le web ou sur ordinateur, ou la partie native du plugin n’est pas encore dans le build.

    SolutionLancez l’app sur Android ou iOS, puis arrêtez-la et recompilez-la. Le hot reload n’ajoute pas de code natif.

  • No events arrive

    L’app a commencé à écouter après avoir appelé open.

    SolutionÉcoutez Moonetix.events avant d’appeler open, depuis un objet qui reste actif.

  • 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 Flutter

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

Un point bloquant ? Contactez-nous

Quelles versions de Flutter le plugin prend-il en charge ?

Flutter 3.27 ou plus récent. Sur iOS, compilez avec Xcode 16 ou plus récent.

Le plugin est-il sur pub.dev ?

Il est hébergé dans le dépôt de packages Moonetix. Ajoutez-le à pubspec.yaml avec hosted: https://moonetix.com/pub et lancez flutter pub get, comme pour n’importe quel package.

Dois-je modifier les réglages Gradle ou Xcode ?

En général, non. Le plugin inclut les SDK Android et iOS. Ajoutez le dépôt Maven de Moonetix dans votre android/settings.gradle uniquement si ce fichier bloque les dépôts au niveau du projet.

Comment savoir quand l’utilisateur ferme l’offerwall ?

Écoutez Moonetix.events, un flux broadcast, avant d’appeler open. MoonetixClosed est le bon moment pour charger le solde de l’utilisateur depuis votre serveur.

Comment les récompenses sont-elles créditées ?

À partir du postback signé sur votre serveur, une fois par ID de transaction. Les événements dans l’app servent uniquement à votre interface utilisateur.

Que dois-je déclarer dans les formulaires de confidentialité des stores ?

User ID, Device ID, Coarse Location et Product Interaction, liés à l’utilisateur, non utilisés pour le suivi. La documentation indique les noms Google Play pour les mêmes types de données.

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