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 to enhance 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.
If testing for the first time, use a randomly generated user ID.
Maximum 65 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}&idfa={idfa}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 generated by your (partner's) app or SDK.
Device ID is used for game suppression and fraud detection. | no* |
| string | The IDFA (Identifier for Advertiser) for iOS devices.
When using the iFrame inside a native app, the value can be read and appended to the URL upon click.
Example: | no |
| string | The official Google advertising identifier for Android devices is used for MMP attribution and tracking.
When using the iFrame in a native app, the value can be read and added to the URL when clicked.
Example: | 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 deeper 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.