Discover our all-in-one iFrame solution, seamlessly integrating engaging games, surveys, and deals into a single, user-friendly offerwall. 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 offerwall in the Besitos Admin portal.
Build your offerwall URL.
(Optional) Specify a redirect link for surveys.
Set up postback to receive conversion data.
Embed the offerwall in your platform.
Step 1 - Theme your offerwall
You can theme your Offers wall 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 offerwall 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 |
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 an iFrame in a native app, the value can be read and appended to the URL on click.
Example: | no |
| string | The official Google advertising identifier for Android devices is used for MMP attribution and tracking.
When using an iFrame in a native app, the value can be read and appended to the URL on click.
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 wall 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 in to 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 offerwall URL 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.