Offers API. Ihr Design, unsere Angebote.

Rufen Sie die Angebote für jeden Nutzer als JSON ab, mit Bildern, Schritten und Belohnungen bereits in Ihrer Währung, und zeigen Sie sie in Ihren eigenen Karten neben Ihren eigenen Inhalten. Belohnungen kommen per Postback, genau wie bei der Offerwall.

  • JSONREST über HTTPS
  • 600Anfragen pro Minute
  • OpenAPISpezifikation inklusive
Offers APIREST, JSON
Terminal
curl -G "https://api.moonetix.com/v1/offers" \
  -d user_id=user_1234 -d country=US -d device=android \
  -H "Authorization: Bearer $MOONETIX_API_KEY"

Live in drei 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. Angebote für einen Nutzer abrufen

    Rufen Sie die API von Ihrem Server aus auf, mit dem API-Schlüssel Ihrer App, der Nutzer-ID, dem Land, in dem sich der Nutzer befindet, und seinem Gerät oder User-Agent. Die Liste lässt Angebote weg, die der Nutzer bereits abgeschlossen hat oder noch nicht erneut machen kann.

    Terminal
    curl -G "https://api.moonetix.com/v1/offers" \
      -d user_id=user_1234 -d country=US -d device=android \
      -H "Authorization: Bearer $MOONETIX_API_KEY"
  2. Zeigen Sie sie in Ihrem eigenen Design

    Jedes Angebot kommt mit Titel, Bild, Schritten und der Belohnung in Ihrer Währung. Stellen Sie sie dar, wie Sie möchten, und schicken Sie den Nutzer zur start_url des Angebots, wenn er eines auswählt. Die Angebotsseite öffnet sich auf Moonetix und leitet ihn von dort zum Werbetreibenden weiter.

    JSON
    {
      "ok": true,
      "currency": "Coins",
      "offers": [
        {
          "id": 58,
          "title": "Nova Quest: reach level 10",
          "reward": 975,
          "payout_usd": 1.5,
          "start_url": "https://wall.moonetix.com/..."
        }
      ]
    }
  3. 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}
GET /v1/offers
{
  "title": "Nova Quest: reach level 10",
  "goals": [
    { "name": "Create an account", "reward": 325 },
    { "name": "Reach level 10", "reward": 650 }
  ],
  "reward": 975,
  "start_url": "https://wall.moonetix.com/..."
}
Ihr Design
Nova QuestLevel 10 erreichen
  1. Konto erstellen+325
  2. Level 10 erreichen+650
Gesamt975 CoinsAngebot starten

Von JSON zu Ihrem Design

Jedes Angebot kommt fertig zur Anzeige, mit seinen Schritten und Belohnungen bereits in Ihrer Währung.

Was die API Ihnen liefert

  • Angebote pro Nutzer

    Die Angebote passen zu dem Land und Gerät, das Sie senden, und solche, die ein Nutzer bereits abgeschlossen hat, werden weggelassen.

  • Belohnungen in Ihrer Währung

    Jede Belohnung ist bereits mit Ihrem Umrechnungskurs, Nutzeranteil, Ihrer Rundung und jedem laufenden Bonus berechnet.

  • Schritte und Bilder

    Mehrstufige Angebote listen jeden Schritt mit eigener Belohnung auf, sodass Sie genau zeigen können, was sich auszahlt.

  • Sub IDs

    Senden Sie bis zu fünf eigene Werte. Sie werden an jede start_url angehängt und kommen im Postback zurück.

  • Ausgeblendete Angebote bleiben ausgeblendet

    Angebote, die Sie auf der Seite Offers ausblenden, fehlen auch in der API, sodass sie Ihrer Offerwall entspricht.

  • OpenAPI-Spezifikation

    Eine maschinenlesbare openapi.json beschreibt jedes Feld, bereit für Codegeneratoren und KI-Coding-Agenten.

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. API mit curl aufrufen

    Fordern Sie die Liste für eine Test-Nutzer-ID und ein Land an, in dem Angebote laufen, und öffnen Sie eine start_url in einem Browser.

  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 10 erledigt

Häufige Fehler, schnell behoben.

Was Ihnen bei der Integration der Offers API begegnen kann, woran es liegt und wie Sie es beheben.

  • 400 invalid_country

    Ein Parameter fehlt oder ist falsch: invalid_user_id, invalid_country oder invalid_device.

    LösungKorrigieren Sie den Parameter, der im Fehlercode genannt wird.

  • 401 invalid_api_key

    Der Schlüssel fehlt, ist falsch oder wurde ersetzt.

    LösungSenden Sie ihn im Authorization-Header als Bearer und kopieren Sie ihn erneut aus dem Tab Integration.

  • 403 app_not_live

    Die App ist pausiert, oder Ihr Konto ist nicht freigegeben oder nicht aktiv.

    LösungPrüfen Sie Ihre Benachrichtigungen. Zeigen Sie diesem Nutzer bei user_blocked keine Angebote an.

  • 429 rate_limited

    Mehr als 600 Anfragen pro Minute für diese App.

    LösungWarten Sie die Sekunden aus Retry-After ab und cachen Sie die Liste jedes Nutzers für 1 bis 5 Minuten.

  • Empty offers list

    Das ist eine normale Antwort: Für diesen Nutzer ist gerade nichts verfügbar.

    LösungZeigen Sie einen freundlichen Leerzustand an und prüfen Sie Land und Gerät, die Sie senden.

  • VPN detected on start_url

    Der Nutzer nutzt ein VPN, einen Proxy oder ein Cloud-Netzwerk, wenn sich die Angebotsseite öffnet.

    LösungBitten Sie den Nutzer, es auszuschalten. API-Anfragen von Ihrem Server werden nicht geprüft.

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

Auf einen Blick

Endpunkt
GET https://api.moonetix.com/v1/offers
Authentifizierung
Bearer-API-Schlüssel, einer pro App, nur serverseitig
Pflichtparameter
user_id, country und device oder ua
Rate Limit
Bis zu 600 Anfragen pro Minute für jede App
Format
JSON, mit OpenAPI-Beschreibung
Preis
Kostenlos für freigegebene Publisher

Weitere Integrationen

Fragen zur Offers API

Was Entwickler fragen, bevor sie die Offers API einbinden.

Kommen Sie nicht weiter? Kontaktieren Sie uns

Wann sollte ich die Offers API statt der Offerwall verwenden?

Mit dem Offerwall-Link sind Sie am schnellsten live. Nutzen Sie die Offers API, wenn Sie Angebote in Ihrer eigenen Website oder App in Ihrem eigenen Design zeigen möchten, zum Beispiel neben Angeboten aus anderen Quellen oder in Ihrem eigenen Prämien-Shop.

Kann ich die Offers API aus einem Browser oder einer mobilen App aufrufen?

Nein. Rufen Sie sie nur von Ihrem Server auf, denn die Anfrage enthält Ihren API-Schlüssel. Falls der Schlüssel jemals in falsche Hände gerät, erstellen Sie im Tab Integration einen neuen, und der alte funktioniert sofort nicht mehr.

Welches Land sollte ich senden?

Das Land, in dem sich der Nutzer tatsächlich befindet, als zweistelliger Code wie US. Angebote und Belohnungen hängen davon ab, und Land und Gerät werden erneut geprüft, wenn der Nutzer ein Angebot startet.

Unterscheiden sich die Belohnungen von denen der Offerwall?

Nein. Die API liefert dieselben Angebote wie Ihre Offerwall, mit denselben Belohnungen, und jeder abgeschlossene Schritt erreicht Ihren Server über denselben signierten Postback.

Gibt es ein Rate Limit?

Ja, bis zu 600 Anfragen pro Minute für jede App. Cachen Sie die Liste pro Nutzer für kurze Zeit, wenn Sie sie oft anzeigen.

Funktioniert derselbe Schlüssel auch für etwas anderes?

Ja. Der API-Schlüssel einer App funktioniert auch für die Reporting API und für Sessions der mobilen SDKs.

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