DocsWeb Offerwall Integration

Web Offerwall Integration

Integrating Perkox offerwalls directly into browser games, reward websites, or desktop portals.

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

ParameterRequiredDescriptionExample
app_idYesUnique application identifier found in your App Overview.1001
player_idYesUnique user ID on your platform. Passed back in S2S postbacks.user_98214
click_idNoOptional custom sub-tracking identifier.camp_2026
sub1 - sub10NoOptional 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.