Getting Started
Set up Tapjoy Offerwall in your app and learn how to configure, integrate, and optimize it to increase user engagement and support higher revenue potential.
Read time 4 minutesLast updated 3 hours ago
This documentation covers the steps required to begin monetizing with Offerwall in the LTV dashboard. For technical implementation of Tapjoy's Offerwall SDK, refer to the respective platform pages iOS, Android, Unity, ReactNative.

Adding an App
To add an app, follow these steps:- Click on the drop down in the top right corner of the screen and select Add App.

- Fill out the create app form and click Create Now once complete.
Creating Virtual Currencies
- On the left side navigation, click Virtual Currency. Then, click Create Virtual Currency in the top right corner.
-
Select between Tapjoy Managed and Self Managed currency. Refer to this documentation for more information about the key differences between the two options.
- Managed Currency: With Tapjoy Managed currency, Tapjoy keeps the user's balance on its own servers. For technical implementation documentation for Tapjoy managed, refer here.
- Self Managed Currency: 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, refer here.
- 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, 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:- Navigate to the Placements tab on the left side navigation
- Click Create Placement
- Fill in the name with the text exactly used in your app's code. Case, spacing, and special characters are all important here.
- Click Create to create this new placement.
- 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, 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:- Navigate to Create Content on the left side navigation.
- Select between Offerwall Plus and Message to Earn.
- Fill out the form, setting user segmentation, placement, schedule, and virtual currency.

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.- On the left navigation, select Create Content. Then select Message to Earn.
- Proceed to set up your content card.
-
In the Message section, you can add your own custom image by doing the following:
- Select Upload Image.
- Select a transition type.
- Create custom message text.
- Under placement, select the placement where you would like the Message to Earn to appear to your users.
- 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. For more information, refer to Targeting.Troubleshooting during testing
- In order to receive a test offer, include your test device's Advertising ID in Test Devices under App settings.
- If Offerwall is not showing, check that the placement names within the app's code and dashboard match exactly.
- If Offerwall is not showing offers, ensure that you are not on VPN.
- If Offerwall is not showing, ensure the Tapjoy SDK is initialized and internet connectivity is not an issue.