HTML (iframe version)
Integrate the offerwall into your website or app using a simple iframe.
App required
In order to integrate the offerwall you will need to have an app created in your publisher dashboard.
In order to integrate the offerwall you will need to have an app created in your publisher dashboard.
Overview
Our offerwall enables users to benefit from incentives and rewards thanks to segmented, automatically translated ads. The offerwall will adapt to any screen and will show offers depending on the user device and location.
The HTML offerwall works perfectly on both web and mobile. It's as simple as copying the following code into the section of your website where you want the offerwall to appear. It's also possible to open it in a new tab if desired.
Basic Implementation
Replace [API_KEY] with your api_key and [USER_ID] with the unique identifier of the user viewing the wall.
<iframe style="width:100%; height:800px; border:0; padding:0; margin:0;"
scrolling="yes"
frameborder="0"
src="https://preads.hansaldev.com/wall?apiKey=[API_KEY]&userId=[USER_ID]">
</iframe>
Parameters
| Parameter | Description | Type | Required |
|---|---|---|---|
apiKey |
API Key of your app (found in app details) | string | Yes |
userId |
Unique identifier of the user in your system | varchar(256) | Yes |
aff_sub |
Optional parameter returned in postback | varchar(45) | No |
aff_sub2 |
Optional parameter returned in postback | varchar(45) | No |
aff_sub3 |
Optional parameter returned in postback | varchar(45) | No |
aff_sub4 |
Optional parameter returned in postback | varchar(45) | No |
Example with Optional Parameters
<iframe style="width:100%; height:800px; border:0; padding:0; margin:0;"
scrolling="yes"
frameborder="0"
src="https://preads.hansaldev.com/wall?apiKey=YOUR_API_KEY&userId=USER123&gender=m&age=25&aff_sub=campaign1">
</iframe>
Surveywall Integration
To show only surveys, use the surveywall endpoint:
<iframe style="width:100%; height:800px; border:0; padding:0; margin:0;"
scrolling="yes"
frameborder="0"
src="https://preads.hansaldev.com/surveywall?apiKey=[API_KEY]&userId=[USER_ID]">
</iframe>
Best Practices
- Always use HTTPS for secure communication
- Ensure the userId is unique and consistent for each user
- Set appropriate iframe dimensions for your layout
- Test the integration before going live
- Configure postback URL to receive conversion notifications