Placements Setup
Learn to create and configure placements in the Tapjoy Monetization dashboard. Control where offerwalls and in-app messages appear to improve user engagement.
Read time 3 minutesLast updated 3 hours ago
A placement is a specific location in your app where you want to display an Offerwall or a Message to Earn to your users. In the example below, your app would call the Main_Menu_Button placement and Tapjoy would go through the listed offerwalls and display the first one that matches the country targeting criteria for the user.
Contextual vs User Initiated Placements
When strategizing placements to implement, you and your team should consider both contextual and user initiated placements. User initiated placements need to be implemented in physical locations in the game where the user will have to tap to see the Offerwall. As a user is expecting to see the Offerwall based on their action, there is no need to use any additional messaging (such as Tapjoy's Message to Earn feature) when using this type of placement logic. Contextual placements need to be implemented to be called once certain conditions are met in game play by the user. For example, after an app loads or when the user has insufficient currency. In this scenario you would link Message to Earn to Offerwall cards in these placements so the user is given context before being led to the offerwall. Contextual placements, when used in conjunction with effective in-app messaging, are very effective at driving higher Offerwall performance.Creating a placement
Placements will need to be decided and implemented by your technical team within your app's code. We recommend the following placements. If your team is unable to implement all placements, we strongly recommend starting off with at least the MainMenu and MainMenu_Messaging placements to allow testing for both Offerwall and Message to Earn.Placement | Type | Description |
|---|---|---|
| MainMenu | User Initiated | As an option from your main menu |
| MainMenu_Messaging | Contextual | As an option to display in-app message that is displayed in your main menu that leads to an Offerwall |
| AppOpen | Contextual | After your main app has finished loading |
| Store | User Initiated | In your currency store along with your IAP |
| InsufficientCurrency | Contextual | As an option if your user does not have enough currency to make a purchase |
| AbandonCurrency | Contextual | As an option when your user did not make an IAP |
| Inbox | User Initiated | From a message in your inbox so your users can get sent directly to a currency sale from an inbox message. |
| LevelComplete | Contextual | After a level or event completion |
| AppMessage | User Initiated | From your app's internal user messaging system |
- Navigate to the 'Placements' tab
- Click 'Create Placement'
- Fill in Name with exactly the text used in your app's code. Case, spacing, and special characters are all important here.
- Optionally, if you would like to add a note about this placement, go ahead and put that into the "Description" field for your internal team.
- Click "Create" to create this new placement.
Note
Tapjoy has an AppLaunch placement by default. This placement gets triggered as soon as the Tapjoy SDK has finished initializing, which should occur during your app's launch phase. You cannot disable the Tapjoy SDK from trying to call for this placement, but you can have it do nothing by not adding any content to the AppLaunch placement in the Tapjoy dashboard.