Eligible Placement & AdSlot Combinations

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

Before you start with the integration, make sure you:

• Created an Account

• Added a Placement

• Added an AdSlot

You will find more details here:

For API Calls, all surveys matching the parameters provided will be returned and can be displayed to the user.

The Surveywall API supports both server and client-side calls.

Follow the link below to get to the detailed technical documentation.

If you already collect profiling data from your users, you can optionally pass this information to us through the Surveywall API call. While not required, providing profiling details can improve targeting and survey performance.

To enable this feature, open the Edit Adslot modal for your Surveywall API adslot in the dashboard and generate a Profiling Data Validation Hash.

You can find the complete list of supported profiling questions and acceptable answer formats here: 👉 Please check this document regularly for updates.

To include profiling data in your API call, append the appropriate question and answer parameters to the request URL. You'll also need to generate a cryptographic hash to validate the data.

For example, to pass the following information:

• Gender: Male

• ZIP Code: 20500

• Birthdate: 1995-05-31

The API call would look like this:

The hash parameter is calculated as a SHA256 HMAC, using the Profiling Data Validation Hash as the secret key. The input string is a URL-encoded query string of all parameters except the hash itself, sorted by key.

Here’s a PHP example:

Learn about:

• Setting up callbacks

• IP Whitelists

• Securing callbacks using HMAC Security Hash

• Testing callbacks

Click on the link below: