Our Surveys iFrame allows you to quickly and easily embed surveys into your existing platform. It can be used independently or in conjunction with our APIs.
Here are the steps you'll need to take to implement the Survey iFrame:
(Optional) Theme your Surveys wall in the Besitos Admin portal.
Build your Surveys wall URL.
Specify a redirect link.
Set up postback to receive conversion data.
Embed the Surveys wall URL in your platform.
Step 1 - Theme your Surveys wall
You can theme your Surveys 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.
If you're using our Games iFrame and you've already set your theme, it will also be applied to your Surveys iFrame.
Step 2 - Build your Surveys wall URL
Your Surveys wall URL directs users to their unique Surveys wall webpage. The URL contains several required parameters to ensure proper functionality.
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 |
Surveys URL without optional parameters:
https://wall.besitos.ai/survey/wall/[partner_ID]/[user_ID]
Surveys URL with optional parameters:
https://wall.besitos.ai/survey/wall/[partner_ID]/[user_ID]/[sub_ID]/[info]
Step 3 - Specify a redirect link
As part of the setup, we need to know where to send users after they complete a survey. For example, you might return them to your app or website or to the list of surveys, where they can take more surveys.
The redirect URL will look 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. If you have already set up postback for the Games wall, the postback response will contain two additional survey attributes.
You can also connect to our User Profiling API, which 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 Survey 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/survey/wall/[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.