Integrating Pley into a Web Games Portal
Pley makes it easy to distribute mobile games on the web through a lightweight iframe integration.
In most cases, the portal only needs to embed our iframe and allow iframe content on the site.
Basic Integration
The game runs inside a Pley-hosted iframe that handles:
- Game runtime and streaming
- Authentication
- In-game purchases
- Advertising
- Updates and compatibility
A typical integration looks like this:
<iframe
src="https://play.pley.com/game/your-game-id"
width="100%"
height="100%"
allowfullscreen
></iframe>Portal Requirements
Your portal must:
- Allow third-party iframes
- Allow JavaScript execution within the iframe
- Avoid restrictive sandboxing policies that block payments, ads, or login flows
Depending on the integration model, additional permissions may be required.
Ads, Payments, and Authentication
By default, Pley provides:
- Advertising
- In-game purchases
- User authentication
This allows portals to integrate quickly with minimal engineering effort.
However, Pley can also delegate these systems to the portal if preferred. For example:
- Use the portal’s own ad stack instead of Pley Ads
- Use the portal’s payment solution
- Use the portal’s account/authentication system
This is handled through integration APIs and commercial agreements.
Revenue Sharing
If the portal uses Pley’s default monetization systems, no additional setup is typically required.
If the portal replaces Pley Ads and/or Pley Purchases with their own monetization systems, we still need a commercial agreement that defines how revenue generated by the game is shared between the portal, the developer, and Pley.
In those cases, please contact our commercial team before launch.
Ad Integration (Google AdSense)
If Pley Ads are used, the portal must authorize Pley’s Google AdSense account on their domain by adding the following entry to their ads.txt file:
google.com, pub-3269777183832488, DIRECT, f08c47fec0942fa0This is required for proper ad serving and monetization.
Configure Allowed Origins
To ensure your game can be embedded and launched correctly through Pley, you must configure your allowed origins in the Game Manager.
In the Game Manager, navigate to:
Settings → Allowed Origins
Add every domain that will host or embed your game, including all localized or regional subdomains.
Examples
If a domain is not added to the allowed origins list, the game may fail to load due to browser security restrictions (CSP / iframe origin restrictions).
Important: Only add the origin/domain itself — do not include page paths or subpages.
Example:
This configuration is required for every domain and localized subdomain where the game will be embedded or distributed.
Support
If you are a portal operator or developer interested in integrating Pley games into your platform, contact the Pley team for technical onboarding and commercial setup details.
Updated about 9 hours ago
