Tài liệu

Hỗ trợ

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.
Thời gian đọc 3 phútCập nhật lần cuối 10 ngày trước

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 typesLearn about the different types of placements.
Create placementsConfigure placements in the Tapjoy dashboard.
Recommended placementsLearn 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.

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
  1. From the left navigation menu, select Placements.
  2. Select + Placement to open the Create placement dialog.
  3. Type the Placement name.
  1. 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.

Placement

Type

Description

MainMenu
User-initiatedA location in your app's main menu where users tap to access the Offerwall.
MainMenu_Messaging
ContextualA prompt in the main menu that shows in-app messages to guide users to the Offerwall.
AppLaunch
ContextualA prompt after your app loads.
Store
User-initiatedA location in your currency store alongside in-app purchases (IAP).
InsufficientCurrency
ContextualA prompt for users who lack enough currency to make a purchase.
AbandonCurrency
ContextualA prompt for users who didn't complete an IAP.
Inbox
User-initiatedAn inbox message including a direct path to a currency sale Offerwall.
LevelComplete
ContextualA prompt for users who completed a level or event.
AppMessage
User-initiatedIn-app messages from your own in-app messaging system. Users tap these messages to access the Offerwall.

Placements setup • Unity Grow • Unity Docs