# TapResearch Publisher Documentation

> Monetize your mobile apps with high-paying surveys from top brands.

This index helps AI assistants and coding agents work with the TapResearch
integration docs. Each link below is one page; the full-text bundles at the
bottom are meant to be pasted into (or fetched by) your agent.

## Get Started

- [Welcome](https://supply-docs.tapresearch.com/docs/3.x/intro): Turn your engaged users into revenue. TapResearch rewards your users with your in-app
- [Features](https://supply-docs.tapresearch.com/docs/3.x/features/overview): TapResearch is built around the Survey Wall — rewarded surveys your users
- [Survey Wall](https://supply-docs.tapresearch.com/docs/3.x/features/survey-wall): The Survey Wall is the core of TapResearch — a full-screen wall of high-paying
- [Bonus Bar](https://supply-docs.tapresearch.com/docs/3.x/features/bonus-bar): The Bonus Bar is a recurring, gamified reward that drives repeat engagement.
- [User Boosts](https://supply-docs.tapresearch.com/docs/3.x/features/user-boosts): Boosts temporarily multiply the rewards your users earn — a "2× coins" window
- [Currency Sales](https://supply-docs.tapresearch.com/docs/3.x/features/currency-sales): Currency sales are optional but highly recommended as they drive user engagement and increase revenue.
- [Offerwall](https://supply-docs.tapresearch.com/docs/3.x/features/offerwall): The Offerwall is a wall of non-survey offers — primarily mobile app
- [Standalone Profiling](https://supply-docs.tapresearch.com/docs/3.x/features/standalone-profiling): By default, TapResearch profiles each user inside the survey wall — they answer
- [Native Survey Tiles](https://supply-docs.tapresearch.com/docs/3.x/features/native-survey-tiles): Native Survey Tiles  let you present available
- [Quick Questions](https://supply-docs.tapresearch.com/docs/3.x/features/quick-questions): Quick Questions are short, in-app questions you ask your own users — up to
- [Setup](https://supply-docs.tapresearch.com/docs/3.x/setup): A checklist to get your app ready in the dashboard. Create your account, choose how
- [Choose your integration](https://supply-docs.tapresearch.com/docs/3.x/choose-your-integration): TapResearch offers four integration paths. They share the same survey supply

## SDK

- [Overview](https://supply-docs.tapresearch.com/docs/3.x/basic-integration/integration-options): The TapResearch SDK is the fastest way to add surveys to a native app. It handles
- [Integrate with AI](https://supply-docs.tapresearch.com/docs/3.x/basic-integration/integrate-with-ai): Prefer to let an AI coding agent do the heavy lifting? Pick your platform and
- [iOS](https://supply-docs.tapresearch.com/docs/3.x/basic-integration/sdk-integration/ios): 1. Install the SDK
- [iOS Native Survey Tiles](https://supply-docs.tapresearch.com/docs/3.x/survey-wall-preview/ios-surveys): If your app is in test mode, you must use a test user. Configure test users in "Test Devices" on the dashboard.
- [iOS Orientation Handling](https://supply-docs.tapresearch.com/docs/3.x/basic-integration/sdk-integration/ios-alternate-orientation-handling): It's important that landscape apps not lock the screen rotation when rendering TapResearch. Landscape orientation within the TapResearch ...
- [Android](https://supply-docs.tapresearch.com/docs/3.x/basic-integration/sdk-integration/android): 1. Install the SDK
- [Android Native Survey Tiles](https://supply-docs.tapresearch.com/docs/3.x/survey-wall-preview/android-surveys): If your app is in test mode, you must use a test user. Configure test users in "Test Devices" on the dashboard.
- [TRError](https://supply-docs.tapresearch.com/docs/3.x/basic-integration/sdk-integration/tap-objects): Platform note: This object is only available on Android. iOS uses NSError
- [React Native](https://supply-docs.tapresearch.com/docs/3.x/basic-integration/sdk-integration/react-native): 1. Install the SDK
- [React Native Native Survey Tiles](https://supply-docs.tapresearch.com/docs/3.x/survey-wall-preview/react-native-surveys): If your app is in test mode, you must use a test user. Configure test users in "Test Devices" on the dashboard.
- [Unity](https://supply-docs.tapresearch.com/docs/3.x/basic-integration/sdk-integration/unity): 1. Install the SDK
- [Unity Native Survey Tiles](https://supply-docs.tapresearch.com/docs/3.x/survey-wall-preview/unity-surveys): If your app is in test mode, you MUST use a test user. These are defined in "Test Devices" on the dashboard.
- [Flutter](https://supply-docs.tapresearch.com/docs/3.x/basic-integration/sdk-integration/flutter): 1. Install the SDK
- [Flutter Native Survey Tiles](https://supply-docs.tapresearch.com/docs/3.x/survey-wall-preview/flutter-surveys):  Integration guide: See the Flutter SDK documentation
- [Quick Question How-To](https://supply-docs.tapresearch.com/docs/3.x/3.2-only/quick-question-how-to): Quick Questions allow you to ask up to three questions to your users at any point in your app. Currently available question types include:
- [Handling Quick Question Responses](https://supply-docs.tapresearch.com/docs/3.x/3.2-only/handling-quick-question-responses): There are several ways to ingest Quick Question responses:
- [Screen Orientation](https://supply-docs.tapresearch.com/docs/3.x/basic-integration/sdk-integration/screen-orientation): Critical for landscape apps: Do not lock screen rotation when displaying TapResearch content.
- [Callbacks](https://supply-docs.tapresearch.com/docs/3.x/basic-integration/sdk-integration/callbacks): Callbacks  allow TapResearch to notify your web service when:
- [TRReward](https://supply-docs.tapresearch.com/docs/3.x/basic-integration/sdk-integration/tr-reward): The reward object the SDK returns when a user earns a reward. It is the same
- [SDK Error Codes](https://supply-docs.tapresearch.com/docs/3.x/basic-integration/sdk-integration/sdk-error-codes): When using the SDK, you may encounter the following error codes:
- [Initialization Options](https://supply-docs.tapresearch.com/docs/3.x/operational-tools/initialization-options): The SDK supports a TapInitOptions object for additional configuration. The structure is shown below :
- [User Attributes and Targeting](https://supply-docs.tapresearch.com/docs/3.x/operational-tools/user-attributes): User attributes allow you to store additional information about users as key-value pairs. Use them to track information such as:

## Hosted Link

- [Hosted Link](https://supply-docs.tapresearch.com/docs/3.x/hosted-link/overview): The Hosted Link is the fastest, low-code way to connect your users to
- [Integrate with AI](https://supply-docs.tapresearch.com/docs/3.x/hosted-link/integrate-with-ai): Copy the prompt below into your AI assistant — Claude, ChatGPT, Cursor, Codex,
- [Implementation](https://supply-docs.tapresearch.com/docs/3.x/hosted-link/setup): This page covers how to use your hosted link: the URL format, the value you
- [Callbacks](https://supply-docs.tapresearch.com/docs/3.x/hosted-link/callbacks): With the Hosted Link path, rewards are delivered to your backend with a server-to-server postback. TapResearch sends a request to your ca...

## Eligibility API

- [Eligibility API](https://supply-docs.tapresearch.com/docs/3.x/eligibility-api/overview): The Eligibility API is a pre-send eligibility check. You make a single
- [Integrate with AI](https://supply-docs.tapresearch.com/docs/3.x/eligibility-api/integrate-with-ai): Copy the prompt below into your AI assistant — Claude, ChatGPT, Cursor, Codex,
- [Eligibility check](https://supply-docs.tapresearch.com/docs/3.x/eligibility-api/has-offer): Use this endpoint to check whether a user currently has a survey offer available
- [Callbacks](https://supply-docs.tapresearch.com/docs/3.x/eligibility-api/callbacks): When a user completes an offer surfaced through the Eligibility API, TapResearch

## Survey Feed API

- [Survey Feed API](https://supply-docs.tapresearch.com/docs/3.x/survey-feed-api/overview): The Survey Feed API is the only TapResearch integration path where you send a
- [Integrate with AI](https://supply-docs.tapresearch.com/docs/3.x/survey-feed-api/integrate-with-ai): Copy the prompt below into your AI assistant — Claude, ChatGPT, Cursor, Codex,
- [Impanel / player profile](https://supply-docs.tapresearch.com/docs/3.x/survey-feed-api/impanel): The /players/impanel endpoint ingests a participant's demographic and qualification data.
- [Fetch surveys](https://supply-docs.tapresearch.com/docs/3.x/survey-feed-api/fetch-surveys): Retrieve available campaigns  for a participant profile.
- [Fetch Surveys with Dynamic Currency](https://supply-docs.tapresearch.com/docs/3.x/survey-feed-api/fetch-surveys-with-dynamic-currency): Retrieve available campaigns  for a participant profile.
- [Countries & qualifications](https://supply-docs.tapresearch.com/docs/3.x/survey-feed-api/countries-qualifications): Before you impanel a participant, fetch the supported countries and the
- [Callbacks](https://supply-docs.tapresearch.com/docs/3.x/survey-feed-api/callbacks): TapResearch reports every reward to your backend through a server-to-server
- [Authentication & request signing](https://supply-docs.tapresearch.com/docs/3.x/survey-feed-api/authentication): TapResearch’s Partner API uses two mechanisms to control access and verify request integrity:
- [Segmentation](https://supply-docs.tapresearch.com/docs/3.x/survey-feed-api/segmentation): Segmentation allows publishers to control which users are eligible for specific survey experiences by attaching custom attributes to a pa...
- [Pass-through values](https://supply-docs.tapresearch.com/docs/3.x/survey-feed-api/pass-through): Pass-through values allow publishers to send custom key-value data when launching a survey. These values are stored and then returned on ...
- [Redirect URLs](https://supply-docs.tapresearch.com/docs/3.x/survey-feed-api/redirects): After survey completion, participants are redirected to your supplied URL with signed parameters.
- [Redirect statuses](https://supply-docs.tapresearch.com/docs/3.x/survey-feed-api/redirect-statuses): When TapResearch redirects a participant back to your platform, we include a status value that explains why the participant returned. Red...
- [Support center](https://supply-docs.tapresearch.com/docs/3.x/survey-feed-api/support-center): The supporturl field returned on each campaign in the /campaigns response provides a TapResearch-hosted support contact form pre-loaded w...
- [Best practices](https://supply-docs.tapresearch.com/docs/3.x/survey-feed-api/best-practices): - Refresh surveys every 2 minutes and whenever a user returns from a survey.

## Tools & Reference

- [Currencies](https://supply-docs.tapresearch.com/docs/3.x/operational-tools/currencies): Currencies define how you reward your users. They are managed in the Settings
- [Exchange Rates](https://supply-docs.tapresearch.com/docs/3.x/operational-tools/exchange-rate): The exchange rate determines how much of your app currency a user receives for
- [Profile Reward](https://supply-docs.tapresearch.com/docs/3.x/operational-tools/profile-reward): The profile reward is a one-time bonus, paid in your currency, that a user earns
- [Placements](https://supply-docs.tapresearch.com/docs/3.x/operational-tools/placements): A placement is a configured slot where TapResearch content appears, created in
- [Reporting API](https://supply-docs.tapresearch.com/docs/3.x/operational-tools/reporting-api): To get access to this stats API call, reach out to our account
- [Testing](https://supply-docs.tapresearch.com/docs/3.x/testing-and-qa): All apps created in the Publisher Dashboard are set to test mode by default.
- [Supported Countries](https://supply-docs.tapresearch.com/docs/3.x/operational-tools/supported-countries): TapResearch supports the following countries and language codes:
- [Callbacks with Reconciliation](https://supply-docs.tapresearch.com/docs/3.x/basic-integration/sdk-integration/callbacks-with-reconciliation): For an introduction to callbacks, see the Callbacks documentation.
- [FAQ](https://supply-docs.tapresearch.com/docs/3.x/faq):  We've had many successful apps integrate before going live. We encourage you to begin the integration process as early as possible.

## Guides

- [Upgrading to 3.x from 2.x](https://supply-docs.tapresearch.com/docs/3.x/upgrading-to-3.x):  Banner interstitials and Quick Questions - New content formats to engage users

## AI bundles (full text)

- [Everything (full text)](https://supply-docs.tapresearch.com/llms-full.txt)
- [SDK — all platforms](https://supply-docs.tapresearch.com/llms-sdk.txt)
- [SDK — iOS](https://supply-docs.tapresearch.com/llms-sdk-ios.txt)
- [SDK — Android](https://supply-docs.tapresearch.com/llms-sdk-android.txt)
- [SDK — React Native](https://supply-docs.tapresearch.com/llms-sdk-react-native.txt)
- [SDK — Unity](https://supply-docs.tapresearch.com/llms-sdk-unity.txt)
- [SDK — Flutter](https://supply-docs.tapresearch.com/llms-sdk-flutter.txt)
- [Hosted Link](https://supply-docs.tapresearch.com/llms-hosted-link.txt)
- [Eligibility API](https://supply-docs.tapresearch.com/llms-eligibility-api.txt)
- [Survey Feed API](https://supply-docs.tapresearch.com/llms-survey-feed-api.txt)