Skip to main content

adjoe Playtime Integration (SDK Integrations)

Let rewarded app users earn points by playing games through adjoe Playtime: set up the SDK integration, connect the S2S callback and see where adjoe shows up in the app.

adjoe Playtime lets your users earn points by playing mobile games. The adjoe SDK runs inside the Swaarm rewarded app and shows adjoe's game catalogue. adjoe reports every reward to Swaarm through a server-to-server (S2S) callback, and Swaarm credits the points to the user.

Setup Checklist

  1. Get the SDK hash (Android and/or iOS), the S2S token and optionally the API token from your adjoe account manager

  2. Create the integration under Integration → Realtime Integrations → SDK → Add SDK Integration

  3. Paste the S2S callback URL into the adjoe dashboard

  4. Give your app's publisher Approved access to the container offer

  5. Optional: set how many points users get on the adjoe advertiser


Step 1 - Create the Integration

Go to Integration → Realtime Integrations, open the SDK tab and click Add SDK Integration.

📷 Screenshot: Realtime Integrations, SDK tab

Field

What to enter

Name

Any name, e.g. adjoe Playtime

Advertiser

The advertiser that represents adjoe. Rewards are booked under it. Cannot be changed later.

SDK

adjoe Playtime

Android SDK hash / iOS SDK hash

From adjoe. Leave one empty if you only use one platform; adjoe is then hidden on the other.

S2S token

From adjoe. Used to verify that reward callbacks really come from adjoe.

API token

Optional.

Title / Description / Image URL

Optional. What users see in the app, e.g. Play & Earn.

📷 Screenshot: Create SDK Integration form

ℹ️ Container Offer
Saving creates one offer under the selected advertiser. All adjoe rewards are recorded on it, so they show up in your reports like any other conversion.


Step 2 - Add the S2S URL in adjoe

After saving, the integration page shows the S2S callback URL. Click Copy and paste it into the adjoe dashboard as your S2S payout URL.

📷 Screenshot: S2S callback URL on the integration page

⚠️ Keep the {…} placeholders as they are. adjoe fills them in for every reward.


Step 3 - Give Your App Access to the Offer

The container offer is Private. Open it (click the offer number on the integration page) and, under Publishers, add your rewarded app's publisher with access status Approved. Without this, adjoe does not appear in the app and rewards are rejected.

📷 Screenshot: Container offer with the app publisher approved


Step 4 (Optional) - Set How Many Points Users Get

By default users get exactly the amount adjoe reports (e.g. 50 adjoe coins = 50 points). To change this, open the adjoe advertiser, go to Rewarded Payout Policy and set:

  • Network provides: Network pays us — in points

  • Pay the player in: Points

  • Adjustment: Scale by a factor (e.g. factor 2 doubles the points) or Keep a margin (e.g. margin 0.2 gives users 80% of the coins)

📷 Screenshot: Rewarded Payout Policy on the advertiser


Where adjoe Shows Up in the App

In the rewarded app, adjoe appears on the Home tab in the More ways to earn section, below Daily rewards, with the title and description from Step 1. Tapping it opens adjoe's game catalogue.

📷 Screenshot: More ways to earn on the app Home tab

  • When adjoe has no games for the user, or the SDK hash is not valid yet, the row is greyed out with No games right now · check back later (as in the screenshot above).

  • On iPhone, users are asked to allow tracking first. adjoe needs it to see which games they play.

  • Points are added to the user's balance as soon as adjoe reports the reward.


Troubleshooting

Symptom

Check

adjoe is not shown in the app

The integration is enabled, the SDK hash for that platform is filled in, and the app's publisher is Approved on the container offer (Step 3).

The row is always greyed out

The SDK hash is wrong or not active yet at adjoe, or adjoe has no games for the user's country.

Users play but get no points

The S2S URL in the adjoe dashboard matches the one on the integration page, and the S2S token matches the one adjoe gave you.

Did this answer your question?