SDK de offerwall para Unity. Los jugadores ganan la moneda de su juego.

Permita que los jugadores ganen la moneda de su juego completando ofertas, sin banners en su juego. Un solo paquete de Unity cubre Android e iOS, y cada recompensa llega al servidor de su juego como un postback firmado.

  • 2022.3+Unity LTS o Unity 6
  • 2.0.1Versión actual
  • 2Plataformas, un solo paquete
SDK de UnityVersión 2.0.1
EarnButton.cs
using MoonetixOfferwall;
 
void Awake()
{
    Moonetix.Init("YOUR_APP_ID");
}
 
public void ShowOfferwall(string token)
{
    Moonetix.Open(token);
}

Comience en cuatro pasos.

Copie el código, reemplace los marcadores con los valores de su panel en Offerwalls, su offerwall, Integration, y haga pruebas antes de lanzar.

  1. Instale el paquete

    Agregue el scoped registry de Moonetix y el paquete a Packages/manifest.json, o agregue el registro en Project Settings e instale Moonetix Offerwall desde el Package Manager. Los SDK de Android e iOS vienen incluidos.

    Packages/manifest.json
    {
      "scopedRegistries": [
        {
          "name": "Moonetix",
          "url": "https://moonetix.com/upm",
          "scopes": ["com.moonetix"]
        }
      ],
      "dependencies": {
        "com.moonetix.offerwall": "2.0.1"
      }
    }
  2. Agregue un endpoint de tokens a su servidor

    Su app nunca contiene la clave de API. Cuando un usuario toca Earn, su app le pide una sesión a su servidor, y su servidor le pide a Moonetix un token de un solo uso para ese usuario con sesión iniciada. Un token funciona una sola vez, durante 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']);
  3. Abra el offerwall

    Llame a Init una vez con el App ID de su panel y luego a Open con un token nuevo. Todos los eventos llegan en el hilo principal de Unity, así que puede actualizar su UI directamente. El paquete también incluye el ejemplo 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. Acredite las recompensas con el postback

    Cada recompensa llega a su servidor como un postback firmado. Verifique el hash, sume la recompensa una sola vez por ID de transacción y retírela si un postback posterior la revierte. Los postbacks fallidos se reintentan hasta 5 veces.

    Macros y reintentos de postback

    Panel, pestaña Postback
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
9:41
Ganar gemas12,450 gemas
GanarMis ofertas
  • Travel TownLlegue al nivel 15+1,500
  • WPS OfficeInstalar y abrir+2,000
  • Bus EscapeLlegue al nivel 20+450
  • CleanfoxSign up in the app+800
Recompensa acreditadaTravel Town · +1,500 gemas
Pantalla nativa
Postback 200 OK

Lo que ven sus usuarios

Una pantalla nativa sobre su app, con su título y sus colores, su moneda y cada recompensa confirmada por un postback.

Lo que el paquete hace por usted

  • Compilaciones para Android e iOS

    En Android agrega el repositorio Maven, el SDK y la regla de R8 a su proyecto de Gradle. En iOS enlaza e integra el SDK de iOS en Xcode.

  • Las ofertas se abren en el lugar correcto

    Las ofertas que llevan a Google Play o a la App Store se abren en la app de la tienda, para que las instalaciones se registren correctamente.

  • Ninguna clave dentro de su juego

    Su juego contiene solo el App ID. Las sesiones vienen de su servidor y funcionan una sola vez.

  • Eventos en el hilo principal

    OnOpened, OnClosed y OnError se disparan en el hilo principal de Unity, listos para su UI.

  • La moneda de su juego

    Las recompensas se muestran y se acreditan en su propia moneda, con su tasa de cambio y su reparto con el usuario.

  • Sin ID de publicidad

    El SDK no usa el identificador de publicidad y no rastrea a los jugadores entre apps.

Pruébelo y luego publíquelo.

Todo lo que necesita verificar antes de que los usuarios reales vean su offerwall, con las herramientas integradas en su panel.

  1. Open as a test user

    En Integration status, en la pestaña Integration, abra su offerwall como el usuario owner-test. Las visitas de prueba no cuentan como usuarios.

  2. Ejecútelo en un dispositivo real

    Compile para Android o iOS y abra el offerwall desde su botón Earn con un token nuevo cada vez.

  3. Send a test postback

    Elija el usuario, el estado y el pago, y vea exactamente qué respondió su servidor, con el código de respuesta y el tiempo. Los ID de transacción de prueba empiezan con test_.

  4. Pruebe desde una conexión normal

    Las VPN, los proxies, Tor y las redes en la nube están bloqueados, así que pruebe con el Wi-Fi de su casa o con datos móviles, en un país donde haya ofertas activas.

Lista de verificación para el lanzamiento

0 de 11 listos

Errores comunes, resueltos rápido.

Lo que puede encontrar al integrar el SDK de Unity, qué lo causa y cómo solucionarlo.

  • InvalidAppId

    El valor que se pasa a init no es el App ID. Pasar aquí la clave de API es el error más común.

    SoluciónVuelva a copiar el App ID de 24 caracteres desde la pestaña Integration.

  • InvalidToken

    La app pasó algo distinto del token, o un token creado con la clave de API de otra app.

    SoluciónPase solo el campo token, que empieza con sst_, y use el App ID y la clave de API de la misma app.

  • TokenExpiredOrUsed

    El token tiene más de 10 minutos o ya se usó, por ejemplo porque se guardó de un toque anterior.

    SoluciónCree un token nuevo cada vez que se abra, justo cuando el usuario toque Earn.

  • NotInitialized

    Se llamó a open antes que a init.

    SoluciónLlame a Moonetix.Init en Awake de su primera escena.

  • Unsupported

    El juego se ejecuta en el Unity Editor, en escritorio o en WebGL.

    SoluciónCompile para Android o iOS y verifique Moonetix.IsSupported antes de mostrar el botón.

  • iOS build stops on the iOS version

    La versión mínima de iOS objetivo en Player Settings es inferior a 13.0.

    SoluciónConfigúrelo en 13.0 o superior.

  • 403 from /v1/session

    app_not_live significa que la app está en pausa o que su cuenta no está activa. user_blocked significa que bloqueamos a este usuario.

    SoluciónNo muestre el offerwall. Con app_not_live, revise sus notificaciones.

  • VPN or Proxy detected

    El dispositivo está en una VPN, un proxy o una red en la nube, donde las ofertas no se pueden registrar.

    SoluciónPruebe con una conexión normal de casa o de datos móviles, en un país donde haya ofertas activas.

  • Postback log shows 403 or 404

    Su script rechazó el postback, o la URL es incorrecta.

    SoluciónAbra en un navegador la URL que aparece en el registro y revise su código de hash.

  • Postback log shows a timeout

    Su script tarda más de 6 segundos en responder.

    SoluciónResponda primero con 200 y ejecute las tareas lentas en segundo plano.

  • Postback log shows 301 or 302

    Su URL redirige, por ejemplo de http a https.

    SoluciónUse la URL final. Los postbacks no siguen redirecciones.

Preguntas sobre Unity

Lo que preguntan los desarrolladores antes de agregar el SDK de Unity.

¿Se quedó atascado? Contáctenos

¿Qué versiones de Unity son compatibles?

Unity 2022.3 LTS, o Unity 6 (6000.0) o posterior. En iOS, configure la versión mínima de iOS en 13.0 o superior en Player Settings.

¿Funciona en compilaciones para Android e iOS?

Sí. Un solo paquete cubre ambas. Unity agrega por sí solo el SDK de Android al proyecto de Gradle y el SDK de iOS al proyecto de Xcode, incluidos los proyectos exportados y las plantillas de Gradle personalizadas.

¿Cómo instalo el paquete de Unity de Moonetix?

Agregue el scoped registry de Moonetix y com.moonetix.offerwall a Packages/manifest.json, o instálelo desde My Registries en el Package Manager. También puede instalarlo desde un tarball.

¿Un offerwall es pay-to-win?

No. Los jugadores ganan la misma moneda que ganarían jugando, probando apps y juegos de los anunciantes. Les da a los jugadores que no pagan una forma de avanzar sin banners en su juego.

¿Cómo acredito a los jugadores de forma segura?

Acredite las recompensas en el servidor de su juego a partir del postback firmado, nunca a partir de eventos del cliente, porque los jugadores pueden falsificarlos. Cuando se dispare OnClosed, cargue el saldo del jugador desde su servidor.

¿Puedo probarlo en el Unity Editor?

Puede probar su flujo. En el Editor, en escritorio y en WebGL, Open verifica el App ID y el token y luego informa Unsupported, y Moonetix.IsSupported es false. Para ver el offerwall en sí, compile para Android o iOS y pruebe en un teléfono o en el simulador de iOS.

Convierta su tráfico en ganancias.

Cree una cuenta gratuita de publisher y gane con cada oferta que sus usuarios completen en su sitio web, app, juego o comunidad.

Segmentación mundial
Más
Iniciar sesión