User Segmentation on the Fyber Ad Monetization Platform

Why Should I Use Segments?

User Segments can be defined in the Dashboard and used for Ad Control adjustments for certain groups of your app’s users. This gives you more granular control over the balance between monetization and user experience, allowing you to execute such strategies as:

“Only showing interstitials to non-paying users”

or:

“Capping the number of Rewarded Video ad impressions for new users to 10 per day”

These examples and more can be achieved using a combination of User Segments and Ad Control features.

How to Set Up and Use Segments
How to Populate the User Object
Setting Values for the Segment Parameters
Updating Parameter Values
Custom Segment Parameters
How to Create a User Segment in the Fyber Dashboard
Using a User Segment on the Ad Control Page
Targeting an Ad Delivery rule to One or More User Segments
Targeting a Demand Priority Item to One or More User Segments

How to Set Up and Use Segments

To start using Segments, complete the following steps first:

How to Populate the User Object

Important: The User Segment Reference contains information on all of the parameters you can populate in your SDK integration that are used to define user segments.

Setting Values for the Segment Parameters

You should populate and update the User object in your Fyber SDK integration with data corresponding to the supported parameters. You can also define custom parameters, should you wish to segment users based on your own proprietary data.

Example:

FyberSDK.instance.getUser.age = 12;

Updating Parameter Values

If user data that you provided in the user object is updated, you should update the value correspondingly so that Fyber’s User Segmentation can segment users based on the most up-to-date data available.

Note: See the User Segment SDK Reference for more information on populating segment parameters in your SDK integration.

Custom Segment Parameters

If you want to segment users based on data that isn’t reflected in the list of supported segment parameters, you can add one or more custom parameters and define user segments based on these. Adding custom parameters in the SDK integration requires a Key and a Value and would be added:

// Custom parameter:
var dict:Dictionary = new Dictionary();
dict["user_level"] = 12;
FyberSDK.instance.getUser.customParameters = dict;

Note: See the User Segment SDK Reference for more information on custom segment parameters.

How to Create a User Segment in the Fyber Dashboard

  1. Log in to the Fyber Ad Monetization Dashboard.
  2. Navigate to the App you wish to manage in the Apps list.
  3. Go to the Segments page by clicking the Segments tab.
  4. On the Segments page, click the Add Segment button.
  5. In the Add Segment window, give your segment a descriptive name, e.g. non-paying users.
  6. Add one or more rules, using the provided segment parameters and values, to define the criteria for a user to be included in the segment.
  7. You can also choose whether a user should match all or any of the segment rules to be included in the segment (the default is all, which we recommend in most cases).
  8. Click Save to finish creating the segment.
  9. Each request from your app will now be evaluated against your newly-created user segment. You can now also use this segment in the Ad Control page, to target Demand Priority rules or Ad Delivery rules.

Example: A user segment configured with 2 rules img

Using a User Segment on the Ad Control Page

Once you have created one or more user segments in the Segments page, you can use these segments in the Ad Control page to control the Ad user experience for these specific users.

Targeting an Ad Delivery rule to One or More User Segments

  1. Create a new Ad Delivery rule or open the Edit window for an existing rule.
  2. In the Targeting section of the edit window, click the Segments field, and select the segment for which you wish to target the rule.
  3. Click Save to save the rule. You should now see an icon next to this Ad Delivery rule to indicate that it is targeted to a segment.

Example: Targeting an Ad Delivery rule for a segment:

img

Example: A segment-targeted ad delivery rule:

img

Targeting a Demand Priority Item to One or More User Segments

  1. Create a new Demand Priority item, or open the Edit window for an existing item in the priority list.
  2. Click the Segments field, and select the segment for the rule.
  3. Click Save to save the priority item. You should now see an icon next to this priority item to indicate that it is targeted to a segment.

Note: If you target a priority item to one or more segments, the rest of your users will not be served this ad network, unless there is another un-targeted priority item for it.

Example: Targeting a priority item to a segment:

img

Example: A segment-targeted priority item:

img