Documentation Index
Fetch the complete documentation index at: https://docs.primeearn.com/llms.txt
Use this file to discover all available pages before exploring further.
Survey IFrame Integration Guide
Embed the PrimeEarn survey wall directly into your app or website using an IFrame or WebView. This guide walks you through the full setup in six steps.
Step 1 — Get Your URL
Your dedicated survey wall URL is:
https://monetize.primeearn.com/?app=XXXXXXXX&uuid=Test123
XXXXXXXX with your Publisher App ID and Test123 with your user’s unique identifier (see Step 3).
Need the combined wall (Surveys + Games)? Use https://monetize.primeearn.com/featured?app=XXXXXXXX&uuid=Test123 instead.
Step 2 — Implement in Your App or Website
Choose the integration method that fits your platform:
WebView (Mobile Apps)
Load the URL inside a native WebView component. Make sure the WebView has:
- JavaScript enabled
- DOM storage enabled
- Redirect/navigation handling so external links open in a browser
IFrame (Web)
<iframe
src="https://monetize.primeearn.com/?app=XXXXXXXX&uuid=Test123"
width="100%"
height="700"
frameborder="0"
allow="clipboard-write"
title="PrimeEarn Survey Wall"
></iframe>
New Browser Tab
If an IFrame is not suitable, open the URL in a new tab:
window.open(
'https://monetize.primeearn.com/?app=XXXXXXXX&uuid=Test123',
'_blank',
'noopener,noreferrer'
);
Step 3 — Pass Parameters
Replace the uuid placeholder with a unique, stable identifier for the current user. This ties survey completions to the correct account.
| Parameter | Required | Description |
|---|
app | Yes | Your Publisher App ID (provided in your dashboard) |
uuid | Yes | A unique, persistent ID for the end user |
maid | If available | Mobile Advertising ID — IDFA on iOS or GAID on Android. Must be provided when available; significantly improves performance. |
age | No | User age (0–150). Passing this skips the age onboarding question in surveys. |
gender | No | User gender: m (Male) or f (Female). Passing this skips the gender onboarding question. |
zip | No | Postal / ZIP code. Passing this skips the location onboarding question. |
When zip, gender, or age are passed, users skip related onboarding questions in surveys — significantly improving their experience and match rate.
https://monetize.primeearn.com/?app=myApp1234&uuid=user_abc_987
Never reuse uuid values across different users. Each user must have a stable, unique ID to ensure rewards are attributed correctly.
Step 4 — Customize Design
The survey wall supports several design parameters you can append to the URL.
| Parameter | Values | Description |
|---|
theme | light / dark | Sets the color scheme |
color | Hex code (e.g. 3498db) | Primary accent color (no #) |
logo | URL-encoded image URL | Your brand logo displayed at top |
https://monetize.primeearn.com/?app=XXXXXXXX&uuid=Test123&theme=dark&color=3498db
Match the theme parameter to your app’s current color mode for a seamless user experience.
Step 5 — Handle Rewards via Postback
When a user completes a survey, PrimeEarn fires a server-to-server postback to your configured callback URL.
Postback URL Format
Configure your callback URL in the dashboard. PrimeEarn will substitute the placeholders at the time of the event:
https://your-server.com/reward?user={user_id}&amount={reward}&type={type}&tx={tx_id}
Postback Parameters
| Parameter | Type | Description |
|---|
{reward} | Integer | Amount of in-app currency to award to the user |
{payout} | Float | Publisher payout in USD |
{type} | Integer | Event type (see table below) |
{user} | String | The unique user ID you passed as uuid |
{tx_id} | String | Unique transaction ID for deduplication |
Survey Event Types ({type})
| Value | Event | Description |
|---|
1 | Complete | User successfully finished a survey |
2 | Screenout | User was screened out mid-survey |
3 | Bonus | Bonus reward event |
4 | Reconciliation | A previously paid event has been reconciled |
Whitelisting IPs
Ensure your server accepts postback requests from these PrimeEarn IPs:
168.119.57.82
49.12.33.196
49.13.14.251
Reject any postback requests that do not originate from these IPs to prevent reward fraud.
Step 6 — Go Live
Before enabling for all users, run through this checklist:
Once all checks pass, deploy and start earning!