OM
Offermaru
Publisher Area

Help & FAQ

Help center for Offermaru publishers

Learn how to create apps, choose an integration method, understand callbacks and rewards, and solve common issues.

Getting started

Offermaru helps you monetize your users through performance-based offers. Users complete tasks inside partner apps and services, you earn revenue, and you reward your users in your own in-app currency.

  1. Create or log in to your Offermaru publisher account.
  2. Add an app or website in the Apps section of the dashboard.
  3. Configure your currency and S2S callback URL in app settings.
  4. Pick an integration option: the hosted Offerwall URL or the getOffers API.
  5. Test the flow end-to-end with your own test user before sending real traffic.

How to create an app

Apps are created in the publisher dashboard under the Apps tab.

  1. Go to Apps > Add New App.
  2. Select a platform: Play Store, App Store, or Website.
  3. Search for your app in the store or enter your website URL.
  4. Confirm the app details and click Add.

After creation, each app has an App ID (e.g. 12568) which is used in both the Offerwall URL and API integration.

Offerwall vs API – which one should I use?

Offerwall URL (hosted)

  • Fastest way to get started – no UI work needed.
  • You open a single URL: https://wall.offermaru.com/{APP_ID}?user_id={USER_ID}.
  • Fully hosted experience with sorting, details pages, and progress.
  • Great if you just want a “Tasks” or “Earn” screen in your app.

API (getOffers)

  • Use your own custom UI and styling.
  • Call GET https://api.offermaru.com/getOffers with your api_key, app_id, user_id and ip.
  • API returns a list of offers including tasks, rewards and the offer_url to open.
  • Best if you want a seamless experience deeply integrated into your app’s design.

Both options use the same server-to-server callback flow. You can start with the Offerwall URL for speed and later upgrade to the API integration.

Integrating with iFrame / WebView

The Offerwall URL is: 

https://wall.offermaru.com/{APP_ID}?user_id={USER_ID}
  • For Web, embed it in an iFrame or open in a new tab.
  • For Android, open this URL inside a WebView.
  • For iOS, open it in a WKWebView or SFSafariViewController.

For detailed code examples, see the Offerwall Integration Guide.

API key for API integration

This is only required if you're using API integration to show offers in your custom UI. Offermaru uses a single API key per publisher account. This key is used together with an App ID to authenticate and scope API requests.

  • Your API key identifies your publisher account.
  • The app_id parameter identifies which app the request is for.
  • You can reuse the same API key across all your apps.

To find your API key:

  1. Open any app in the Apps section.
  2. Scroll to API Integration.
  3. Copy Your API Key.

Treat your API key like a password. Keep it on your backend only — never expose it in client-side code.

Understanding S2S callbacks

When a user completes an offer event, Offermaru notifies your server via a server-to-server (S2S) HTTP request to your configured callback URL.

In your app settings you configure a URL like: 

https://yourdomain.com/callback?user_id={user_id}&user_reward={user_reward}

When a completion happens, Offermaru replaces placeholders like {user_id} with real data and notifies your server.

For detailed instructions on S2S callbacks, see the S2S Callbacks Guide.

Understanding rewards & currency

In app settings you define:

  • Currency Name – e.g. “Gems”, “Coins”, “Points”.
  • Reward Per $1 You Earn – how many units of your currency users receive for each dollar of publisher revenue (e.g. 1000).

Offermaru uses this setting to:

  • Show rewards in your in-app currency inside the Offerwall.
  • Return max_reward and reward values in your currency in the getOffers API.
  • Send user_reward in your currency in S2S callbacks.

Common issues & fixes

Offerwall not loading

  • Check that your Offerwall link uses the correct App ID: https://wall.offermaru.com/12568?user_id=USER_123.
  • Make sure the app status is Live in the dashboard.
  • Confirm there is no network filter, VPN or ad blocker blocking the domain.

User completed an offer but no reward

  • Check if your S2S callback URL is configured correctly in app settings.
  • Inspect your server logs to see whether the callback was received.
  • Ensure you return HTTP 200 and that your code credits the user by user_reward.
  • Ensure you are matching user_id to your own user records correctly.

Duplicate rewards

  • Use transaction_id as a unique key in your database.
  • If the same transaction_id appears again, ignore it.

Frequently asked questions

Which user ID should I send?

Use a stable internal user ID from your own system (e.g. a database ID). This ID is sent back in the callback so you can credit the correct user.

What’s the difference between user_reward and publisher_payout in S2S callback?

user_reward is the amount of your virtual currency you should give the user. publisher_payout is the amount in cents that you earn from that completion.

Contact support

If you’re stuck or need help debugging callbacks, integration, or stats, reach out:

  • Email: partners@offermaru.com
  • Include your publisher ID, app ID, callback logs, and any relevant screenshots.