Skip to main content
Version: 3.x

Setup

Account Setup​

Don't have a TapResearch account yet? No problem, it's quick and easy to sign up for one. You will not be able to complete an integration without an account an API Token.

When creating your account, please select the Publisher/Developer option.

Supplier Dashboard

Until your app is approved, you'll see the following

Supplier Dashboard

Account approval can take a few business hours.

Waiting for Review?

We typically review new accounts within a few hours, but if you need access sooner you can reach out to us at developers@tapresearch.com.

Create your App​

Now that your account has been approved, you will be able to create your first app! Your app can be created from the Supplier Dashboard.

info

Notes on apps in test mode! If your app is in test mode, you MUST use a test user. These are defined in "Test Devices" on the dashboard.

Supplier DashboardSupplier Dashboard

Your app has now been created! 🥳

App Configuration​

Now that your app has been created, you can begin configuring your App and its placement(s).

App settings​

Colors​

  • Colors are used in the survey wall for primary and secondary actions.

  • Each color is in HEX code

App Store Identifier​

  • Set the app store identifier for your app
App not live yet?

No problem. You can leave that field blank and fill it in later.

Callback URL​

You can optionally set a callback URL for your app. This will be called when a user completes a survey. For more information on server-to-server callbacks, please see the callbacks section. There is a different callback for each platform your app is on. These can be the same value, if you want.

Supplier Dashboard

Currencies​

A currency is required to create a placement. For additional information on currencies, please see the Currency Sales section.

  1. Click on the "Add currency" button in the currencies section
  2. Add in the currency info
  3. The Currency Name is what is used in callbacks and in the dashboard
  4. The Display Name is what is used any time the user sees the currency name
  5. The Currency Image is used in the navbar on the survey wall
    1. Allowed file formats are: PNG, JPG, SVG, and PDF
    2. The image should be a 1:1 aspect ratio
  6. The Profile Reward is the amount of currency that the user will receive for completing the profiler
Supplier Dashboard

Placements​

  • There are 3 default placements:
    • Earn center - This is a manual placement type that can be used for a button in the earn center
    • Home screen - This is an automatic placement type that can be used for a banner on the home screen
    • Not published - This is where all content lives that is unassociated to other content types
  • Placements dictate a place in the game and what type of interaction the user will see.

Want to know about other placement types? Check out the Placements section.

Your app has now been created! 🥳

Going Live​

Until your app is live, you must use a test user to access any content

Navigate to App Titles -> (Your app) -> Settings -> iOS or Android to see the steps needed to go live.

Once you've completed the steps to bring your app live, click the button.

Supplier Dashboard

Access the Supplier Dashboard​

Once you create an account, the Supplier Dashboard will become available to you. This is where you'll be able to create apps, update settings, access your API token for authentication, and soon enough, monitor performance.

Supplier Dashboard