Placements and Content Cards

Tapjoy provides great flexibility in customizing when and what gets shown to your users. We do this by allowing you to specify placements (the where) and content cards (the what).


Placements need to be implemented via the Tapjoy SDK. More details on how to do this within your code can be found in our docs for their respective platforms. Placement names can be reused within all platforms, so there's no need to create specific platform placements.

Placements will need to be decided and implemented by your team. The recommended placements would be:

Placement Description
Store In your currency store along with your IAP
AppOpen After your main app has finished loading
InsufficientCurrency As an option if your user does not have enough currency to make a purchase
AbandonCurrency As an option when your user did not make an IAP
Inbox From a message in your inbox so your users can get sent directly to a currency sale from an inbox message.
LevelComplete After a level or event completion
AppMessage From your app's internal user messaging system
MainMenu As an option from your main menu

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

  1. Navigate to the 'Placements' tab
  2. Click 'Create Placement'
  3. Fill in Name with exactly the text used in your app's code. Case, spacing, and special characters are all important here.
  4. 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.
  5. If this will be a video placement only, then check the "Mediation" checkbox, otherwise, leave this unchecked.
  6. Click "Create" to create this new placement.

You will need to continue and create content cards for this placement in order to actually start receiving ads through these placements.

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.

Content Cards

Content cards require no code changes and are managed through the Tapjoy dashboard. Instructions on how to do this can be found here. Content cards are platform specific, so you will need to add content card for each platform within the same placement.

When a placement gets called for content, Tapjoy will go through the listed content cards and show the first content card that applies for that user. This allows you to set up content cards that target specific segments of users to show them content relevant to them. Utilize our flexible User Tags, Ad Behaviour, or User Cohorts to target specific groups of users that you setup. For example, you could set up an Offerwall targeting first time users with a better Tiered Currency Exchange to incentivize new users to complete an offer. Underneath that content card, you could then add a currency sale content card that is targeted to all users for a holiday weekend all within the same flow within your game's placement.

Offerwall Plus

The most popular content card. This content card shows a fully customizable offerwall to the user. Target specific users, cohorts, and currencies to optimize what is shown to your users. Apply currency sales to specific content cards to customize the experience for each user. Add a message to show to your user pertaining to anything related to sales before showing the Offerwall to the user.

Message to Earn

Use a customizable in-app message before redirecting your user to an Offerwall or video content to maximize your monetizing potential. Give the user context for the upcoming ad unit or announce a special sale just for them with a message popup that leads to the Offerwall. There is no need to have your development team create a deeplink from your internal messaging system. Instead, just set up the same creative within the Message to Earn content card directly from an existing placement without needing any app updates.