Web Surveywall

The Web Surveywall by ayeT-Studios allows you to easily monetize your desktop and mobile traffic with surveys that users can complete in exchange for getting a virtual currency reward.

Eligible Placement & AdSlot Combinations

The below table shows all Placement & AdSlot Type combinations that allow you to utilize the Web Surveywall integration.

Placement Type	AdSlot Type	Eligible Integration Type
Website	Web Surveywall	Web Surveywall

If you integrate the Web Surveywall while using a different Placement & AdSlot combination in the ayeT-Studios dashboard, you won't be able to initialize the Surveywall.

Utilization for Desktop, Mobile Web & In-App

Technically, the Surveywall has to be implemented by opening a new browser tab or loading the Surveywall link inside an iframe.

This type of Web Surveywall is intended to be called directly in an actual browser and is not very well suited for webview (in-app) integration.

(COMING SOON) For in-app integrations, please take a look at our seamless In-App integrations by checking out our available SDKs, Wrappers and Plugins.

The Web Surveywall can nevertheless be used in-app if you follow a few guidelines

• Your placement has to be a "Website" placement

• You have to link out of your app to open the Web Surveywall in a mobile browser

Please follow the Integration Best Practises.

Integration Best Practices

Platform	Integration Best Practise	Surveys
Desktop	Open the web surveywall in a new tab or iframe.	The web surveywall shows surveys to the user.
Mobile Web	Open the web surveywall in a new tab or iframe.	The web surveywall adjusts its layout if users access via a mobile device. E.g. for accessing via an Android device, users will see a single column layout as oposed to a two-column layout like for desktop.
In-App	Create a button in your app that leads users into their mobile browser and into the ayeT-Studios Web Surveywall.	The web surveywall shows eligible surveys to the user in a mobile optimized layout.

Getting Started

Before you start with the integration, make sure you:

• Create an Account

• Add a Placement

• Add an AdSlot

You will find more details here:

🖥️pageDashboard Setup

Your Web Survewall Link - Mandatory Parameters

The URL template for our web surveywall looks like this:

https://surveys.ayet.io/surveys?adSlot=ADSLOT_ID&external_identifier={YOUR_USER_IDENTIFIER}

To retrieve the URL for one of your web surveywall adslots, click on "Edit" next to an AdSlot under Placements / Apps and retrieve the Integration URL in the modal.

URL Parameters:

Parameter	Mandatory	Description
external_identifier	yes	Your identifier for the calling user - this is mandatory and allows you to attribute our Server2Server conversion callbacks to a specific user (returned in {uid})
custom_1	no	Custom parameter you can pass to the Surveywall Entry Link in the form of: &custom_1={YOUR_CUSTOM_PARAMETER} You can get this variable back via conversion callbacks
custom_2	no	Custom parameter you can pass to the Surveywall Entry Link in the form of: &custom_2={YOUR_CUSTOM_PARAMETER} You can get this variable back via conversion callbacks
custom_3	no	Custom parameter you can pass to the Surveywall Entry Link in the form of: &custom_3={YOUR_CUSTOM_PARAMETER} You can get this variable back via conversion callbacks
custom_4	no	Custom parameter you can pass to the Surveywall Entry Link in the form of: &custom_4={YOUR_CUSTOM_PARAMETER} You can get this variable back via conversion callbacks
custom_5	no	Custom parameter you can pass to the Surveywall Entry Link in the form of: &custom_5={YOUR_CUSTOM_PARAMETER} You can get this variable back via conversion callbacks

Conversion Callbacks & Currency Handling

Learn about:

• Setting up callbacks

• IP Whitelists

• Securing callbacks using HMAC Security Hash

• Testing callbacks

Click on the link below:

💡pageCallbacks & Testing