SDK offerwall Android. Natif, en quelques lignes de Kotlin.

Ouvrez l’offerwall Moonetix dans un écran natif de votre app Android. Installez une dépendance Gradle, créez une session sur votre serveur et appelez open. Fonctionne avec Kotlin, Java et Jetpack Compose.

  • 5.0+Android, API 21
  • 2.0.1Version actuelle
  • 0Autorisations supplémentaires
SDK AndroidVersion 2.0.1
EarnActivity.kt
// Once, in your Application class
Moonetix.init(applicationContext, "YOUR_APP_ID")
 
// When the user taps Earn
Moonetix.open(activity, 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 SDK

    Ajoutez le dépôt Maven de Moonetix et une dépendance. Le SDK ajoute lui-même l’autorisation internet et son écran à votre manifest, et apporte ses propres règles R8 et ProGuard.

    settings.gradle.kts
    dependencyResolutionManagement {
        repositories {
            google()
            mavenCentral()
            maven { url = uri("https://moonetix.com/maven") }
        }
    }
     
    // app/build.gradle.kts
    dependencies {
        implementation("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 ouvrez l’offerwall avec le jeton fourni par votre serveur. Les erreurs ne lèvent jamais d’exception : elles arrivent sous forme d’événements, et onClosed est le bon moment pour actualiser le solde de l’utilisateur.

    EarnActivity.kt
    Moonetix.init(applicationContext, "YOUR_APP_ID")
     
    Moonetix.setListener(object : MoonetixListener {
        override fun onClosed() {
            refreshBalance()
        }
        override fun onError(error: MoonetixError) {
            Log.w("Earn", "${error.code}: ${error.message}")
        }
    })
     
    lifecycleScope.launch {
        val token = fetchMoonetixToken(authToken)
        Moonetix.open(this@EarnActivity, 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 SDK gère pour vous

  • Les offres s’ouvrent au bon endroit

    Les offres qui mènent à Google Play s’ouvrent dans l’app du 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 sont créées sur votre serveur et ne fonctionnent qu’une fois, personne ne peut donc ouvrir l’offerwall à la place d’un autre utilisateur.

  • Un écran sécurisé

    Seules les pages de l’offerwall s’y chargent, sans pont JavaScript vers votre app.

  • Navigation native

    Le bouton retour revient en arrière dans l’offerwall, et une rotation d’écran ou un redémarrage dû au manque de mémoire garde l’utilisateur là où il était.

  • Votre design, sans code supplémentaire

    L’écran utilise le titre et les couleurs de l’onglet "Design" de votre tableau de bord, et prend en compte les modifications en quelques minutes.

  • Pas d’identifiant publicitaire

    Le SDK 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 Android, la cause et la solution.

  • INVALID_APP_ID

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

  • INVALID_TOKEN

    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.

  • TOKEN_EXPIRED_OR_USED

    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.

  • NOT_INITIALIZED

    open a été appelé avant init.

    SolutionAppelez Moonetix.init dans Application.onCreate.

  • UNKNOWN

    Android System WebView est absent ou désactivé, ou l’Activity que vous avez passée était déjà en train de se fermer.

    SolutionDemandez à l’utilisateur de mettre à jour Android System WebView, et passez une Activity affichée à l’écran.

  • onClosed never arrives

    Le listener a été supprimé dans onStop, ou il appartenait à un écran qui n’existe plus.

    SolutionDéfinissez-la dans onCreate et effacez-la dans onDestroy, ou définissez-la une seule fois dans votre Application.

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

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

Un point bloquant ? Contactez-nous

Quelles versions d’Android le SDK Moonetix prend-il en charge ?

Android 5.0 (API 21) ou plus récent, avec Android System WebView ou Chrome sur l’appareil. La seule dépendance est la bibliothèque standard Kotlin, il fonctionne donc dans les apps Kotlin et Java.

Dois-je ajouter des règles ProGuard ou R8 ?

Non. Le SDK apporte ses propres règles R8 et ProGuard, et ajoute lui-même l’autorisation internet et son écran d’offerwall à votre manifest.

Ma clé API va-t-elle dans l’app ?

Non. Votre app ne contient que l’App ID. Votre serveur crée une session avec la clé API et transmet un jeton à l’app. Un jeton ne fonctionne qu’une fois et pendant 10 minutes, rien dans votre app ne peut donc ouvrir l’offerwall d’un autre utilisateur.

Le SDK utilise-t-il l’identifiant publicitaire ?

Non. Il n’utilise pas l’identifiant publicitaire, ne demande aucune autorisation autre que l’accès à internet, et ne suit pas les utilisateurs d’une app à l’autre. La documentation indique quoi déclarer dans le formulaire Data safety de Google Play.

Comment récompenser les utilisateurs dans mon app ?

Créditez les récompenses à partir du postback signé sur votre serveur, jamais à partir des événements de l’app, car les événements peuvent être falsifiés sur un appareil. Quand l’utilisateur ferme l’offerwall, chargez son nouveau solde depuis votre serveur.

L’écran de l’offerwall peut-il s’accorder à mon app ?

Oui. Il utilise le titre et les couleurs de l’onglet "Design" de votre tableau de bord. Vous pouvez aussi passer votre propre titre, la couleur de la barre d’outils, ou masquer le logo avec MoonetixOptions.

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