Placements setup
Learn to create and configure placements in the Tapjoy Offerwall monetization dashboard. Control where offerwalls and in-app messages appear to improve user engagement.
Read time 5 minutesLast updated 8 months ago
A placement is a specific location in your app where you want to display content cards or use messaging to direct users to an offerwall. One placement can include multiple content cards, each configured for a specific user segment.
Your app code calls the placement in the Tapjoy dashboard, which selects and displays the content card that matches the user segment criteria.
Refer to the following sections for information on using placements:
Topic | Description |
|---|---|
| Placement types | Learn about the different types of placements. |
| Create placements | Configure placements in the Tapjoy dashboard. |
| Recommended placements | Learn about the recommended placements to implement in your app. |
Placement types
When choosing where to implement placements, consider both contextual and user- initiated placements.
User-initiated placements
You implement user-initiated placements in physical locations of the game that users tap to access the Offerwall. Because users choose to access the Offerwall, this type of placement needs no additional in-app message.
Contextual placements
Your app calls contextual placements when certain conditions occur during gameplay.
You can use Message to Earn or your own in-app messages with these placements to provide users context before they access the Offerwall. For example, if a user’s virtual currency runs low, you can display a message like ‘Running low on coins? Earn more now!’ before they access the Offerwall. For more information, refer to Messaging.
Create placements
Create placements in the Tapjoy dashboard to define where content cards and in-app messages appear in your app. Creating placements is a way to efficiently manage and display offerwalls. Instead of directly calling an offerwall configuration, you can call the placement that contains it in the Tapjoy dashboard.
For more information about the types of placements you can implement, refer to Placement types.
Important
The recommended best practice is to integrate all recommended placements in your app to help prepare your app code for future optimizations. For the full list of recommended placements to implement, refer to Recommended placements.
Prerequisites
Before you create placements in the Tapjoy dashboard, you must implement them in your app code.
For instruction on how to implement placements in your app code, refer to the following platform-specific placement guides:
Create a placement
After you implement a placement in your app code, connect it to a placement in the Tapjoy dashboard by doing the following
-
From the left navigation menu, select Placements.
-
Select + Placement to open the Create placement dialog.
-
Type the Placement name.
Tip
To keep your placements organized and manageable, name them clearly to indicate their purpose. For example, the placement name indicates a placement for a message that appears after a user finishes a game level.
Level_Complete_Popup- Select Create to commit this new placement setup.
After you create a placement, you must create content cards for each placement so that Tapjoy displays offers to users at those specific locations in your app. For instructions on how to create content cards, refer to Create a content card.
Recommended placements
The following table describes the recommended placements to implement in the Tapjoy SDK and dashboard.
You can reuse the same placements across different platforms.
Note
Tapjoy has a default placement. The Tapjoy SDK calls this placement when it finishes initializing during your app's launch. While you can't stop the SDK from calling this placement, you can disable it by leaving its content empty in the Tapjoy dashboard.
AppLaunchImportant
If you use deep links with the default #WebOfferwallevent_name#WebOfferwallPlacement | Type | Description |
|---|---|---|
| User-initiated | A location in your app's main menu where users tap to access the Offerwall. Note If you're unable to implement all recommended placements, the recommended best practice is to implement at least the |
| Contextual | A prompt in the main menu that shows in-app messages to guide users to the Offerwall. Note If you're unable to implement all recommended placements, the recommended best practice is to implement at least the |
| Contextual | A prompt after your app loads. |
| User-initiated | A location in your currency store alongside in-app purchases (IAP). |
| Contextual | A prompt for users who lack enough currency to make a purchase. |
| Contextual | A prompt for users who didn't complete an IAP. |
| User-initiated | An inbox message including a direct path to a currency sale Offerwall. |
| Contextual | A prompt for users who completed a level or event. |
| User-initiated | In-app messages from your own in-app messaging system. Users tap these messages to access the Offerwall. |