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.
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.
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.
The following chart describes the best flow to achieve maximum results from the integration:
Best Practice For Naming Placements
We recommend naming your placements using this template:
GameTitle - Platform - CurrencyName
For example, "Soccer Stars - Android - Coins"