Targeting

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, please go to the Content Creation page and click into advanced settings at the bottom of the page.

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, please refer to the description.

Type	Targeting Dimeonsion	Description
Basic	Country	Target based on the user's country that is determined from information gathered either the SIM card or IP address of the user’s device.
Basic	Language	Target based on the user’s language setting.
Cohort	User Level*	Target based on the user’s level within the app. To enable user level targeting, please ensure user properties are set correctly. Learn more here.
Cohort	Tags*	Target selected users based on user tags that have already been implemented. Learn more about how to implement please see below. 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.
Session	Install Date	Target 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.
Session	App Version	Target based on the app version received by the SDK.
Session	OS Version	Target based on the OS version received by the SDK.
Purchase (USD)	Purchases	This has been deprecated.
Purchase (USD)	Last Purchase* Date	Target based on the date the user last made a purchase. To enable purchase date targeting, please ensure you’re passing us this information. Learn more on how to do so under “trackPurchase” here.
Ad Behavior	Ad Behavior	Target users based on their interaction with the offerwall. See below 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"

Please 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

1. Tagging API

Note that in each case, "tag" is a string. We recommend keeping tags short so that they are easier to use in the dashboard user interface.

A. iOS

[Tapjoy addUserTag:tag]; // to add a tag
[Tapjoy removeUserTag:tag]; // to remove a tag from current tag list
[Tapjoy removeAllUserTags]; // to clear all tags

B. Android

Tapjoy.addUserTag(tag); // to add a tag
Tapjoy.removeUserTag(tag); // to remove a tag from current tag list
Tapjoy.clearUserTags(); // to clear all tags

C. Unity

Tapjoy.AddUserTag(tag); // to add a tag
Tapjoy.RemoveUserTag(tag); // to remove a tag from current tag list
Tapjoy.ClearUserTags(); // to clear all tags

D. React Native

Tapjoy.addUserTag(''); // to add a tag
Tapjoy.removeUserTag(''); // to remove a tag from current tag list
Tapjoy.clearUserTags(); // to clear all tags

2. 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.

3. 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.