Get your games up and running quickly! With our simple Games iFrame integration, you can customize your interface's appearance and link to it within your existing platform—no development needed. It can be used independently or in conjunction with our APIs.
Here are the steps you need to take to get your Games iFrame up and running:
(Optional) Theme your Games wall in Besitos Admin.
Build your Games wall URL.
Set up postback to receive conversion data.
Embed your Games wall URL in your platform.
Step 1 - Theme your Games wall
You can theme your Games 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 Games wall URL
Your Games wall URL leads users to their unique instance of your webpage. The URL includes several required parameters to ensure your users see their available, in-progress, and complete games.
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/v1/[partner_ID]/[user_ID]/[sub_ID]
Path parameter | Data type | Description | Required |
| string | The version number determines the interface configuration; only v1 is currently available. | yes |
| string | Your Besitos partner ID. | yes |
| string | The user ID for 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/v1/[partner_ID]/[user_ID]/[sub_ID]?info={info}&device_ID={deviceid}&gaid={gaid}Parameter | Data type | Description | Required |
| string | Provides further information relevant to your business. For example, you may include a click or session ID.
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 official Apple advertising identifier for iOS devices is used for MMP attribution and tracking.
When using the iFrame in a native app, the value can be read and appended to the URL when clicked.
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 - Set up postback
Set up postback to receive and track conversions.
Step 4 - Embed the Games wall URL in your platform
You're now ready to add the URL 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/v1/{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.