All pages
Powered by GitBook
1 of 2

Loading...

Loading...

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

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.

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

Platform
Integration Best Practise
Surveys

Before you start with the integration, make sure you:

You will find more details here:

The URL template for our web surveywall looks like this:

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

Learn about:

  • Setting up callbacks

  • IP Whitelists

  • Securing callbacks using HMAC Security Hash

Click on the link below:

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.

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

Testing callbacks

Web Surveywall

Web Surveywall

Desktop

Open the web surveywall in a new tab or iframe.

The web surveywall shows surveys to the user.

Mobile Web

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

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

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

Getting Started

Your Web Survewall Link - Mandatory Parameters

Conversion Callbacks & Currency Handling

🖥️Dashboard Setup
đź’ˇCallbacks & Testing

Open the web surveywall in a new tab or iframe.

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

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

Web Integrations

Here are the articles in this section:

Web Surveywall