Segments is used to track statistics for various user categories and to manage ads for this categories. A segment is a fraction of audience unified by restrictions: e.g. by gender, age or any other parameter known to the app and directed to Appodeal SDK. Additional ad management settings can be applied to each segment.
Settings can be adjusted for each segment to manage ad distribution logic. For example, you can set a minimum price for a fullscreen banner impression in a specific country. The following settings are available for fine-tuning segments:
Available Settings:
Disable Ad Types: Turn off any ad types for a specific segment.
Disable Network: Turn off specific ad networks by ad type.
Minimal Pricefloor: Set a minimum price for impressions for each ad type separately.
Overridden eCPM: Set the eCPM for each ad network, influencing the position in the waterfall.
Use As Preset: Save a segment as a template to use for creating new segments. It will appear in “Use Your Presets.”
Name: Define a name for the segment, which will appear in the segment list and in impression statistics (e.g., "Gamers_US").
Segment Activity
A segment may not be active for several reasons:
Time Delay: It may take some time to match your settings. Once impressions start appearing, the segment should work as expected.
Incorrect Settings: If the segment remains inactive for an extended period, review and correct your settings before relaunching the segment.
Settings Breakdown
Min Pricefloor: Set the minimum price for 1,000 impressions in a placement. If an ad’s price is lower than the minimum, it won’t be shown. The same ad may appear in other placements where the price floor is not set or is lower.
Disable Ad Types: Disable specific ad formats for a segment. This is useful when a particular ad format negatively affects the audience. No app update is needed.
Overridden eCPM: Manually set the eCPM of any ad network to control the ad’s position in the waterfall. This is useful if you have agreements regarding the first impression from a specific country.
Disable Network: Disable specific ad networks for a segment if an ad network is negatively affecting the audience.
Filters are used to differentiate segments based on user characteristics. You can combine multiple filters to create highly targeted segments. Here are the available filters:
Available Filters:
Age: Group users by age (e.g., 20-30 years old).
App: Group users of one or more specific apps.
Country: Group users by one or multiple countries.
Device Type: Group users by device type (phone or tablet).
Gender: Group users by gender.
App Version: Group users by the version of your app.
Average Session Length: Group users based on their average session time.
Bought In-apps: Group users who have made in-app purchases.
Connection Type: Group users by the type of connection they use (e.g., Wi-Fi, 4G).
In-app Amount: Group users who have made a specific number of in-app purchases.
OS Version: Group users by their operating system version.
Part of Audience: Select a percentage of users for A/B testing or campaigns.
SDK Version: Group users by the version of the Appodeal SDK.
Session Count: Group users by how many times they've opened the app.
Session Time: Group users based on when they use the app (e.g., time of day).
Device RAM Size: Group users by their device's RAM size.
Model: Group users by device model.
Manufacturer: Group users by device manufacturer.
Days Since Install: Group users based on the number of days since app installation.
Install Date: Group users by their app installation date.
Creating Custom Segments with Filters
You can combine multiple filters to create segments based on several characteristics. For example:
Age + Country: Group users aged 20-30 in the U.S.
Device Type + OS Version: Group users with tablets running Android 10.
This allows you to fine-tune your segments and target users more accurately.
Manual Filters
You can also create custom filters using boolean, numeric, or string values for specific attributes. This provides flexibility for tracking and targeting users based on custom criteria.
Example for Android:
java
Copy code
Appodeal.setCustomFilter("Source", "Facebook");
Filter Examples and Use Cases:
Average Session Length: Segment users based on how long they stay in the app. This can help you analyze user activity and its impact on monetization.
Bought In-apps: Use this filter to adjust ad settings for users who’ve made purchases, or to turn off ads for this group entirely. Make sure to integrate the purchase info through the Appodeal SDK.
Android Example:
java
Copy code
Appodeal.trackInAppPurchase(this, 5, "USD");
Part of Audience: Use this for A/B testing by splitting your audience into percentages. For example, you could create a segment that includes the top 33%, the next 33%, and the final 34% of users.
Important
After creating and configuring your segments, make sure to enable them and drag the test segment to the top of the list to ensure it's activated. Once the segment starts receiving impressions, the status will show a red checkmark.
Example: Setting Up an A/B Test
Add a New Segment: Name the segment to clearly reflect what’s being tested. For example, “PuzzleAndroid_NewAdNetworks_Russia_Test33.”
Use Presets: If applicable, use the "Use a preset" option to save time by modifying pre-configured settings.
Set Filters:
Select the application to test from the dropdown suggestion list
Choose "Part of Audience" and set the percentage split using the range-based method (33%, 66%, and 100% for a 3-segment setup or 50% and 100% for a 2-segment setup).
If necessary, filter by SDK version.
Choose Settings: You may configure settings to test the following elements.
Disabling/Enabling Ad Types
Disabling/Enabling Ad Networks
Minimum Price Floors
Overridden eCPM.
Test vs. Control Segments: Typically, the test segment is the first, followed by two control segments.
Create Control Segments: Create control segments with audience percentages set to 66% and 100%.
Final Steps: Enable the segments and drag the test segment to the top.
NB: Not all segment settings will work if your app runs on MAX configuration. If you'd like to switch to the default configuration for testing, please reach out to us. Please be aware that switching configurations may impact your revenue. More information can be found here.