Getting Started

This documentation covers the steps required to begin monetizing with Offerwall in the LTV dashboard. For technical implementation of Tapjoy’s Offerwall SDK, please refer to the respective platform pages iOS, Android, Unity, ReactNative.

Please note that implementing placements and user tags will require steps from both you and your technical implementation team. It is recommended to align with your team on the placement locations and user tagging strategy for targeting before starting the setup process. More information on recommended placements found here.


Adding an App

To add an app, follow these steps:

  1. Click on the drop down in the top right corner of the screen and select “Add App”.


  1. Fill out the create app form and click “Create Now” once complete.

Creating Virtual Currencies

  1. On the left side navigation, click "Virtual Currency". Then, click "Create Virtual Currency" in the top right corner.
  2. Select between Tapjoy Managed and Self Managed currency. Refer to this documentation for more information about the key differences between the two options.
    1. With Tapjoy Managed currency, Tapjoy keeps the user’s balance on its own servers. For technical implementation documentation for Tapjoy managed, please refer here.
    2. With Self Managed currency, Tapjoy notifies your server of currency activity via a Callback URL, but you keep track of the balance yourself. For technical implementation documentation for Self Managed, please refer here.
  3. Fill out form and click “Create Now”

Creating Placements

A placement is a specific location in your app where you want to display Offerwalls or Messaging to Earn to your users. For example, instead of directly calling an Offerwall configuration to display, you call the Placement that contains it in the Tapjoy Dashboard. Placement configurations require technical implementation, while Offerwalls configuration changes are managed solely through the Tapjoy dashboard. More details on how to implement placements within your code, please refer to the respective platform pages iOS, Android, Unity, ReactNative.

When strategizing placements to implement, you and your team should consider both contextual and user initiated placements to provide maximum flexibility to test and implement both standard Offerwalls as well as Message to Earn. To learn more about placements, continue reading here.

Once a placement is specified within your app's code by your technical team, connect it to a placement in our dashboard using the following steps:

  1. Navigate to the 'Placements' tab on the left side navigation
  2. Click 'Create Placement'
  3. Fill in the name with the text exactly used in your app's code. Case, spacing, and special characters are all important here.
  4. Click "Create" to create this new placement.
  5. In this step, we strongly advise integrating all recommended placements in your app to add flexibility in content control and avoid additional coding efforts in the future. For the full list of recommended placements, please refer to the table in this page.

Creating Offerwall cards (also known as content card)

Multiple offerwalls can be configured under a single placement. You can leverage Offerwall card customizations to display tailored Offerwalls to specific segments, targeting specific users, cohorts, with different currencies to optimize performance. When a placement is called, Tapjoy will go down the list of Offerwall cards and display the first that applies to that user. To learn more about placements, continue reading here.

Create an Offerwall card using the following steps:

  1. Navigate to “Create Content” on the left side navigation.
  2. Select between “Offerwall Plus” and “Message to Earn”.
  3. Fill out the form, setting user segmentation, placement, schedule, and virtual currency.

See below for an example of a recommended set up.


Creating Message to Earn Cards

Messaged to Earn (M2E) content cards are customizable in-app messages that provide content before directing users to an Offerwall. M2E used in conjunction with currency sales and targeting, can maximize engagement with your users. It is strongly recommended to configure M2E with contextual placements instead of user initiated ones. To learn more, read here.

  1. On the left navigation, select “Create Content”. Then select “Message to Earn”.
  2. Proceed to set up your content card.
  3. Under Message, you can add your own custom image.
    • To add custom image
      • Select Upload Image
      • Select a transition type
      • Create a custom message text
  4. Under placement, select the placement where you would like the Message to Earn to appear to your users.
  5. Save

Adding Segmentation (Recommended)

We strongly recommend configuring user tags in your setup. User tags enable you to tailor Offerwall cards to specific user segments. Once you’ve set up user tags, you can use the dashboard to target specific Offerwall configurations to users who either have or do not have one or more given user tags.

For example, you can offer a currency sale to users who have attended an in-game event. By tagging these event participants, you can ensure that only these users have access to the currency sale.

Learn more about how to implement user tags here.

Troubleshooting during testing

  • In order to receive a test offer, please include your test device’s Advertising ID in Test Devices under App settings.
  • If Offerwall is not showing, please double check that the placement names within the app’s code and dashboard match exactly.
  • If Offerwall is not showing offers, please make sure that you are not on VPN.
  • If Offerwall is not showing, make sure Tapjoy’s SDK is initialized and internet connectivity is not an issue.

Further Offerwall Optimizations

Congratulations! You’re now all set up to start monetizing with Offerwall. Tapjoy offers many tools to help publishers optimize their Offerwall performance. Continue exploring the links below to learn more about ways to unlock more revenue potential.