Discover our all-in-one iFrame solution, seamlessly integrating engaging games, surveys, and deals into a single, user-friendly offerwall. Direct your users to a single convenient location for all offer types, enhancing their experience. This solution also supports our Wallet service, which empowers your users to effortlessly track and redeem their rewards.
Here are the steps you'll need to take to implement the Offers iFrame:
(Optional) Theme your Offers wall in the Besitos Admin portal.
Build your Offers wall URL.
(Optional) Specify a redirect link for surveys.
Set up postback to receive conversion data.
Embed the Offers iFrame in your platform.
Step 1 - Theme your Offers wall
You can theme your offerwall with a logo and colors that match your brand. Use the Theme feature in Besitos Admin or contact your Besitos Account Manager for help.
Step 2 - Build your Offers wall URL
Path parameters
All path parameters are required except for the sub_ID, which is used only if you segment users in your database.
https://wall.besitos.ai/offers/[partner_ID]/[user_ID]/[sub_ID]
Parameter | Data type | Description | Required |
| string | Your Besitos partner ID. | yes |
| string | The user ID of a user in your database.
Maximum 50 characters | yes |
| string | Identifies the user's segment within your database. | no |
| string | Provides further information relevant to your business. For example, you may include a click or session ID.
Maximum 255 characters | no |
Query parameters
These optional query parameters can pass additional information or return specific user data.
https://wall.besitos.ai/offers/[partner_ID]/[user_ID]/[sub_ID]?info={info}&device_ID={deviceid}Parameter | Data type | Description | Required |
| string | Provides further information relevant to your business.
Maximum 255 characters | no |
| string | A unique identifier for a user's device. We use device ID to track and manage interactions across sessions and suppress game offers already installed.
Supported formats:
*Only one device is supported per user. | no* |
*Offer suppression is only available with device_id. The device_id parameter isn't required for partners whose users access the site through a desktop or mobile browser, but it is recommended for partners whose users access the site via an app and want to suppress offers and increase conversions.
Step 3 - Specify a redirect link for surveys
By default, users are automatically sent to the Surveys page after completing a survey. However, you can specify a different location, such as a page within your app or website, where users will be redirected afterward. Just contact your Besitos Account Manager to set up a custom redirect link.
The link should look something like this:
https://{your_custom_survey_redirect}/?survey_id={surveyid}&user_id={userid}&status={status}Parameter | Data Type | Description |
| string | Unique survey ID |
| string | Unique user ID |
| string | C = complete T = terminate |
Step 4 - Set up postback
Set up postback to receive and track conversions. Conversions for each offer type include slightly different postback parameters.
If you opted into surveys, you might also want to connect to our User Profiling API. This API returns user responses to basic survey profiling questions, giving you greater insights into your users. Contact your Besitos Account Manager to request access.
Step 5 - Embed the Offers iFrame in your platform
You're now ready to add the URL as an iFrame to your website or app. It's as simple as adding this code, along with your unique parameters, to your platform.
<iframe src="https://wall.besitos.ai/offers/[partner_ID]/[user_ID]"></iframe>
For help, contact your Besitos Account Manager or our Implementation Team at [email protected] or via your project channel in Slack.