A placement is the part of your application where users can access TapResearch's survey wall. Generally, it's associated with a call to action such as an action button or a list item. Placements are created within the Supplier Dashboard.

Placement Considerations#

Placements should be called just prior to the call-to-action being presented to the user. If the initialization is successful and the placement survey availability property is true, the call-to-action can be presented to the user. If the survey availability property is false, the call-to-action should not be shown.

Please Note

Although the survey availability flag is false, the placement can still be used to allow a user entry to TapResearch.

This will result in a poor user experience as the user will only be met with a rejection once they enter the experience.

A Placement may indicate that no surveys are available for the user under the following circumstances:

  • The Placement was initialized before the SDK initialization was complete
  • The user failed to pass certain validations (e.g. underage user, VPN connections, fraudulent behavior)
  • In some locales, inventory is limited

A single placement call can only initiate TapResearch for a user once. After the user returns from TapResearch, they will not be able to reuse the prior placement. The best practice is to request a new Placement before showing the call-to-action again.

Placement Visualization#

The following chart describes the best flow to achieve maximum results from the integration:

Placement Flow Chart

For each placement, you will need to specify an Exchange Rate, a Profile Reward, and a Currency Name.

Best Practice For Naming Placements

We recommend naming your placements using this template:

GameTitle - Platform - CurrencyName

For example, "Soccer Stars - Android - Coins"