Documentation

Support

Targeting

Configure and implement Tapjoy Offerwall targeting functionalities to define user segments, deliver tailored offers, and optimize app monetization through personalized user experiences.
Read time 4 minutesLast updated 3 hours ago

Level up your Offerwall strategy by targeting different users with different incentives to increase engagement. Tapjoy supports several types of targeting to help you optimize your different user segments. Some best practices include:
  • High Multipliers for New Converters - Give a higher currency multiplier to users who haven’t converted before to encourage their first engagement.
  • Maximize Currency Sale Revenue - During sales, apply a 2x multiplier for regular converters and 5x multiplier for new converters to maximize a currency sales’ potential revenue.
  • Target OW Converters for App Opens - If there are concerns applaunch feels too intrusive, target OW converters for these placements.
To set up targeting, go to the Content Creation page and click into advanced settings at the bottom of the page.
Targeting configuration section of the content card

Targeting Dimensions

The targeting types will require separate set up outside the dashboard. To learn more about how to set each of these targeting options, refer to the description.

Type

Targeting Dimension

Description

BasicCountryTarget based on the user's country that is determined from information gathered either the SIM card or IP address of the user’s device.
BasicLanguageTarget based on the user’s language setting.
CohortUser LevelTarget based on the user’s level within the app. To enable user level targeting, ensure that user properties are set correctly.
CohortTagsTarget selected users based on user tags that have already been implemented. For example, you can tag users who have participated in specific events (e.g., 'Event01', 'Event02'). You can use these tags to display content only to tagged users, or you can exclude them to target users who have not participated in any events.
SessionInstall DateTarget based on the first time the Offerwall SDK connects with the user’s device. For existing users, their install date is set to the first time they open the app after updating to the version with Offerwall. Therefore, we recommend only targeting dates after the release of your app version that includes Offerwall and exclude pre-existing users with user tags.
SessionApp VersionTarget based on the app version received by the SDK.
SessionOS VersionTarget based on the OS version received by the SDK.
Purchase (USD)PurchasesThis has been deprecated.
Purchase (USD)Last Purchase DateTarget based on the date the user last made a purchase. To enable purchase date targeting, ensure that you’re passing us this information. Learn more on how to do so under “trackPurchase” here.
Ad BehaviorAd BehaviorTarget users based on their interaction with the offerwall. See the following section for the definition of each ad behavior group.

Ad Behavior Targeting

  • Converted on - Users who have already completed an offer.
  • Viewed but never converted on - Users who have seen the offer wall but never completed an offer.
  • Never seen - Users who have never viewed the offerwall.
  • Never Converted On - Users who have never converted on the offerwall. Includes two users groups, "Never seen" and "Viewed but never converted on"
Note:
  • Data is refreshed once a day. If a non-converted user decides to convert an ad today the system will consider him/her a non-converted user until the database refreshes tonight.
  • Ad behavior is per app basis, meaning users’ ad behaviors are independent from other apps.

More Information on User Tags

Tagging API

In each case, "tag" is a string. We recommend keeping tags short so that they are easier to use in the dashboard user interface.
[Tapjoy addUserTag:tag]; // to add a tag
[Tapjoy removeUserTag:tag]; // to remove a tag from current tag list
[Tapjoy removeAllUserTags]; // to clear all tags

Segment Targeting with User Tags

When targeting Tapjoy content at user segments, you can include or exclude users based on their tags. To do this:
  1. “Tags” targeting is in the "Target User Segment" box, under "Cohort" tab in the create/edit content screen.
  2. You can enter multiple tags. Press ENTER or TAB to add more tags.
  3. You can use the "Exclude these" checkbox to exclude tags from a segment instead of including them.
Selected tags in the Targeting section of the content card

Notes

  • User tags are case sensitive, so "warrior" and "WARRIOR" would be different tags.
  • Tag targeting works in an "any" fashion: If you list "tagA", "tagB", and "tagC" in your Target User Segment, that content will be visible to a user with any combination of ""tagA", "tagB", or "tagC". The user does not need to have all the tags to be in the segment. Similarly, if you check the "Exclude these" box, the user will be excluded from the segment if they have any combination of "tagA", "tagB", or "tagC"; the user does not need all three to be excluded from the segment.
  • Targeting by User Tag is only available for Tapjoy Monetize Content, not for push notifications.
  • A device can have up to 200 tags at a time. If you assign more than 200 tags, a previously assigned tag will be removed at random.
  • Targeting is based on ‘device level’. The tag information will be removed when the user uninstalls the app.
  • If you save a segment with user tags, the user tags cannot be retrieved if you try to use the segment in push notification targeting.