Unity Offerwall SDK. Spieler verdienen Ihre In-Game-Währung.

Lassen Sie Spieler Ihre In-Game-Währung verdienen, indem sie Angebote abschließen, ganz ohne Bannerwerbung in Ihrem Spiel. Ein einziges Unity-Paket deckt Android und iOS ab, und jede Belohnung erreicht Ihren Spielserver als signierter Postback.

  • 2022.3+Unity LTS oder Unity 6
  • 2.0.1Aktuelle Version
  • 2Plattformen, ein Paket
Unity SDKVersion 2.0.1
EarnButton.cs
using MoonetixOfferwall;
 
void Awake()
{
    Moonetix.Init("YOUR_APP_ID");
}
 
public void ShowOfferwall(string token)
{
    Moonetix.Open(token);
}

Live in vier Schritten.

Kopieren Sie den Code, ersetzen Sie die Platzhalter durch die Werte aus Ihrem Dashboard unter Offerwalls, Ihre Offerwall, Integration, und testen Sie vor dem Start.

  1. Paket installieren

    Fügen Sie die Moonetix Scoped Registry und das Paket zu Packages/manifest.json hinzu, oder fügen Sie die Registry in den Project Settings hinzu und installieren Sie Moonetix Offerwall über den Package Manager. Die Android- und iOS-SDKs sind enthalten.

    Packages/manifest.json
    {
      "scopedRegistries": [
        {
          "name": "Moonetix",
          "url": "https://moonetix.com/upm",
          "scopes": ["com.moonetix"]
        }
      ],
      "dependencies": {
        "com.moonetix.offerwall": "2.0.1"
      }
    }
  2. Token-Endpunkt auf Ihrem Server hinzufügen

    Ihre App enthält nie den API-Schlüssel. Wenn ein Nutzer auf Earn tippt, fragt Ihre App Ihren Server nach einer Session, und Ihr Server fordert bei Moonetix ein einmal nutzbares Token für diesen angemeldeten Nutzer an. Ein Token funktioniert einmal, für 10 Minuten.

    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. Offerwall öffnen

    Rufen Sie Init einmal mit der App ID aus Ihrem Dashboard auf und dann Open mit einem neuen Token. Alle Events kommen im Unity-Hauptthread an, sodass Sie Ihre UI direkt aktualisieren können. Das Paket enthält außerdem ein Offerwall-Demo-Sample.

    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. Belohnungen per Postback gutschreiben

    Jede Belohnung erreicht Ihren Server als signierter Postback. Prüfen Sie den Hash, schreiben Sie die Belohnung pro Transaktions-ID einmal gut und nehmen Sie sie zurück, wenn ein späterer Postback sie rückbucht. Fehlgeschlagene Postbacks werden bis zu 5 Mal wiederholt.

    Postback-Makros und Wiederholungen

    Dashboard, Tab Postback
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
9:41
Gems verdienen12,450 Gems
VerdienenMy offers
  • Travel TownLevel 15 erreichen+1,500
  • WPS OfficeInstallieren und öffnen+2,000
  • Bus EscapeLevel 20 erreichen+450
  • CleanfoxSign up in the app+800
Belohnung gutgeschriebenTravel Town · +1,500 Gems
Nativer Bildschirm
Postback 200 OK

Was Ihre Nutzer sehen

Ein nativer Bildschirm über Ihrer App, mit Ihrem Titel, Ihren Farben und Ihrer Währung, und jede Belohnung wird durch einen Postback bestätigt.

Was das Paket für Sie erledigt

  • Builds für Android und iOS

    Auf Android fügt es Ihrem Gradle-Projekt das Maven-Repository, das SDK und die R8-Regel hinzu. Auf iOS verlinkt es das iOS SDK in Xcode und bettet es ein.

  • Angebote öffnen sich am richtigen Ort

    Angebote, die zu Google Play oder dem App Store führen, öffnen sich in der Store-App, sodass Installationen korrekt getrackt werden.

  • Kein Schlüssel in Ihrem Spiel

    Ihr Spiel enthält nur die App ID. Sessions kommen von Ihrem Server und funktionieren einmal.

  • Events im Hauptthread

    OnOpened, OnClosed und OnError werden im Unity-Hauptthread ausgelöst, bereit für Ihre UI.

  • Ihre In-Game-Währung

    Belohnungen werden in Ihrer eigenen Währung angezeigt und gutgeschrieben, mit Ihrem Umrechnungskurs und Nutzeranteil.

  • Keine Werbe-ID

    Das SDK nutzt keine Werbe-ID und verfolgt Spieler nicht über Apps hinweg.

Erst testen, dann starten.

Alles, was Sie prüfen sollten, bevor echte Nutzer Ihre Offerwall sehen, mit den Tools in Ihrem Dashboard.

  1. Open as a test user

    Öffnen Sie unter Integration status im Tab Integration Ihre Offerwall als Nutzer owner-test. Testbesuche werden nicht als Nutzer gezählt.

  2. Auf einem echten Gerät ausführen

    Erstellen Sie den Build für Android oder iOS und öffnen Sie die Offerwall über Ihren Earn-Button jedes Mal mit einem neuen Token.

  3. Send a test postback

    Wählen Sie Nutzer, Status und Auszahlung und sehen Sie genau, was Ihr Server geantwortet hat, mit Antwortcode und Zeit. Test-Transaktions-IDs beginnen mit test_.

  4. Über eine normale Verbindung testen

    VPNs, Proxys, Tor und Cloud-Netzwerke werden blockiert. Testen Sie daher über Ihr WLAN zu Hause oder mobile Daten, in einem Land, in dem Angebote laufen.

Checkliste vor dem Start

0 von 11 erledigt

Häufige Fehler, schnell behoben.

Was Ihnen bei der Integration des Unity SDK begegnen kann, woran es liegt und wie Sie es beheben.

  • InvalidAppId

    Der an init übergebene Wert ist nicht die App ID. Hier den API-Schlüssel zu übergeben, ist der häufigste Fehler.

    LösungKopieren Sie die 24-stellige App ID erneut aus dem Tab Integration.

  • InvalidToken

    Die App hat etwas anderes als das Token übergeben, oder ein Token, das mit dem API-Schlüssel einer anderen App erstellt wurde.

    LösungÜbergeben Sie nur das Feld token, das mit sst_ beginnt, und verwenden Sie App ID und API-Schlüssel derselben App.

  • TokenExpiredOrUsed

    Das Token ist älter als 10 Minuten oder wurde bereits verwendet, zum Beispiel weil es von einem früheren Tippen stammt.

    LösungErstellen Sie für jedes Öffnen ein neues Token, genau dann, wenn der Nutzer auf Earn tippt.

  • NotInitialized

    open wurde vor init aufgerufen.

    LösungRufen Sie Moonetix.Init in Awake Ihrer ersten Szene auf.

  • Unsupported

    Das Spiel läuft im Unity Editor, auf dem Desktop oder in WebGL.

    LösungErstellen Sie den Build für Android oder iOS und prüfen Sie Moonetix.IsSupported, bevor Sie den Button anzeigen.

  • iOS build stops on the iOS version

    Die Ziel-Mindestversion für iOS in den Player Settings liegt unter 13.0.

    LösungSetzen Sie den Wert auf 13.0 oder höher.

  • 403 from /v1/session

    app_not_live bedeutet, dass die App pausiert oder Ihr Konto nicht aktiv ist. user_blocked bedeutet, dass wir diesen Nutzer gesperrt haben.

    LösungZeigen Sie die Offerwall nicht an. Prüfen Sie bei app_not_live Ihre Benachrichtigungen.

  • VPN or Proxy detected

    Das Gerät nutzt ein VPN, einen Proxy oder ein Cloud-Netzwerk, wo Angebote nicht getrackt werden können.

    LösungTesten Sie über eine normale Heim- oder Mobilfunkverbindung in einem Land, in dem Angebote laufen.

  • Postback log shows 403 or 404

    Ihr Skript hat den Postback abgelehnt, oder die URL ist falsch.

    LösungÖffnen Sie die URL aus dem Log in einem Browser und prüfen Sie Ihren Hash-Code.

  • Postback log shows a timeout

    Ihr Skript braucht länger als 6 Sekunden für die Antwort.

    LösungAntworten Sie zuerst mit 200 und erledigen Sie langsame Aufgaben im Hintergrund.

  • Postback log shows 301 or 302

    Ihre URL leitet weiter, zum Beispiel von http auf https.

    LösungVerwenden Sie die endgültige URL. Postbacks folgen keinen Weiterleitungen.

Fragen zu Unity

Was Entwickler fragen, bevor sie das Unity SDK einbinden.

Kommen Sie nicht weiter? Kontaktieren Sie uns

Welche Unity-Versionen werden unterstützt?

Unity 2022.3 LTS oder Unity 6 (6000.0) oder neuer. Für iOS setzen Sie die iOS-Mindestversion in den Player Settings auf 13.0 oder höher.

Funktioniert es für Android- und iOS-Builds?

Ja. Ein Paket deckt beides ab. Unity fügt das Android SDK selbst dem Gradle-Projekt und das iOS SDK dem Xcode-Projekt hinzu, auch bei exportierten Projekten und eigenen Gradle-Templates.

Wie installiere ich das Moonetix-Unity-Paket?

Fügen Sie die Moonetix Scoped Registry und com.moonetix.offerwall zu Packages/manifest.json hinzu oder installieren Sie das Paket über My Registries im Package Manager. Sie können es auch aus einem Tarball installieren.

Ist eine Offerwall Pay-to-Win?

Nein. Spieler verdienen dieselbe Währung, die sie auch beim Spielen verdienen würden, indem sie Apps und Spiele von Werbetreibenden ausprobieren. So kommen auch nicht zahlende Spieler voran, ohne Bannerwerbung in Ihrem Spiel.

Wie schreibe ich Spielern sicher gut?

Schreiben Sie Belohnungen auf Ihrem Spielserver über den signierten Postback gut, niemals über Client-Events, denn Spieler können diese fälschen. Wenn OnClosed ausgelöst wird, laden Sie das Guthaben des Spielers von Ihrem Server.

Kann ich es im Unity Editor testen?

Sie können Ihren Ablauf testen. Im Editor, auf dem Desktop und in WebGL prüft Open die App ID und das Token und meldet dann Unsupported, und Moonetix.IsSupported ist false. Um die Offerwall selbst zu sehen, bauen Sie für Android oder iOS und testen auf einem Smartphone oder im iOS Simulator.

Machen Sie Ihren Traffic zu Einnahmen.

Erstellen Sie ein kostenloses Publisher-Konto und verdienen Sie an jedem Angebot, das Ihre Nutzer auf Ihrer Website, in Ihrer App, Ihrem Spiel oder Ihrer Community abschließen.

Weltweites Targeting
Mehr
Anmelden