Overview
If your product runs in a web browser, you can embed the Perkox Offerwall directly inside an HTML <iframe> or open it in a dedicated browser window.
Offerwall URL Structure
Every app property has a designated offerwall host (default: https://wall.perkox.com, or your customized white-label CNAME domain configured under Settings). Append your query parameters:
https://wall.perkox.com?app_id={YOUR_APP_ID}&player_id={YOUR_PLAYER_ID}&click_id={OPTIONAL_TRACKING_ID}Query Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
| app_id | Yes | Unique application identifier found in your App Overview. | 1001 |
| player_id | Yes | Unique user ID on your platform. Passed back in S2S postbacks. | user_98214 |
| click_id | No | Optional custom sub-tracking identifier. | camp_2026 |
| sub1 - sub10 | No | Optional sub-affiliate parameters for granular attribution. | placement_hero |
Embedding via iFrame
index.htmlhtml
<iframe
src="https://wall.perkox.com?app_id=YOUR_APP_ID&player_id=USER_12345"
width="100%"
height="800px"
frameborder="0"
allow="clipboard-write"
style="border-radius: 12px; border: 1px solid rgba(255, 255, 255, 0.1);"
></iframe>Opening via JavaScript Popup
offerwall.jsjavascript
// Opening Perkox Web Offerwall in a popup or new tab
function openPerkoxOfferwall(userId) {
const appId = "YOUR_APP_ID";
// Use your assigned offerwall domain from App Overview (default: https://wall.perkox.com)
const domain = "https://wall.perkox.com";
const url = `${domain}?app_id=${encodeURIComponent(appId)}&player_id=${encodeURIComponent(userId)}`;
window.open(url, "PerkoxOfferwall", "width=850,height=900,scrollbars=yes,resizable=yes");
}URL Parameter Encoding
Always URL-encode dynamic values (e.g.
player_id) using encodeURIComponent() to ensure special characters (like underscores, dashes, or emails) are preserved accurately.
