Segment

1. What is segment?

TopOn supports grouping users in multiple dimensions. Different segments can be configured with different waterfalls to achieve the purpose of refined traffic monetization. Currently, TopOn supports the following segment dimensions: Area, City,Date, Week, Hour, Loading Time, Network type, App Version Name, App Version Code, SDK Version, OS Version, Device ID, Device Type, Device Brand, Installation Time, Channel, Sub-channel, IDFA Status, Installation Source, User Number, SDK Preset Strategy and Custom.

2. How to configure segment

(1) In the TopOn developer backend, to create a segment for the first time, you need to go to [Mediation]→[Add segment] to add it.

(2) The setting rules for each segment are as follows:

When setting multiple rules in a single segment, each rule uses the AND condition for judgment. That is, when all conditions are met at the same time, the segment will be sent.

3.TopOn SDK sets customs for segment

Note: If you need to use the "channel", "sub-channel", and "custom" segment functions, follow the following instructions to pass the corresponding fields to TopOn when you need to integrate. You cannot directly configure and use them in the TopOn background.  Before initializing the TopOn SDK, you need to call the interface of the TopOn SDk to complete the custom parameter input.

The following code examples are for users who are 18 years old, male, and brought in by Toutiao promotion

TopOn Android SDK code example:

Map<String, String> customMap = new HashMap<>();
customMap.put("age", "18");  //age=18
customMap.put("sex", "male"); //sex=male
customMap.put("pnetwork", "bytedance"); //promotion network is byte dance
ATSDK.initCustomMap(customMap); //  The custom rules of the App are global settings and are valid for all Placements.
ATSDK.initPlacementCustomMap(customMap); // Supported by TopOn Android SDK V5.5.2 and above, it is only valid for the current Placement. You can add Placement-specific custom rules based on the App custom rules.

[ATAPI sharedInstance].customData = @{@"age":@"18", @"sex":@"male", @"pnetwork":@"bytedance"}; //age=18,sex=male and promotion network is byte dance, App’s custom rules are global settings and are valid for all Placements

[[ATAPI sharedInstance] setCustomData:@{@"test_key":@"test_val"} forPlacementID:@"placmentid"]; //Supported by TopOn iOS SDK V5.5.1 and above, it is only valid for the current Placement. You can add Placement-specific custom rules based on the App custom rules.

4. About segment priority setting

One TopOn ad slot can be configured with multiple segments. When multiple segments are configured, each segment will have a priority. The prefix number of the segment is the priority, 1 is the highest priority, and the priority decreases from left to right. When a request hits multiple segments at the same time, TopOn will return the segment advertising source configuration with the highest priority.

For example: segment A is the United States, and segment B is Europe and America (including the United States). At this time, the priority of segment A needs to be adjusted to be ahead of the priority of segment B to ensure the waterfall of segment A requested by US users.

You can use the [mediation]->[Add segment]->[set priority]-> drag and drop a single group to sort.

5. How to copy segments

5.1 Copy segment entry

When adding segments in mediation, you can select the copy segment function.

5.2 Select the content to be copied

The content that can be copied: Copy Segment Name & Rules (default), Copy Segment Setting (Advanced Settings), Copy Waterfalls (check to copy the waterfall configuration of the currently selected segment)

5.3 Choose placements and segments

(1) After selecting Copy the waterfall configuration of the segment, only placements with the same style will be displayed.

(2) If Copy waterfall configuration is not checked, the segment will be copied and created directly.

(3) Only supports copying non-default segments.

(4) If Copy waterfall configuration is selected, after selecting placements and segments, the page will jump to the waterfall configuration page, and all ad sources will be newly created.

6. How to perform batch modification

When you need to make unified adjustments to multiple segments under the ad slot, you can use the batch operation function to modify the settings in batches.

(1) First click [Setting]

(2) Check the segment that needs to adjust the policy  

(3) Click the batch operation button to display the adjustment items

(4) Submit after modification

7. FAQ

(1) In what situations do you need to use customs for segment?

TopOn supports grouping users in multiple dimensions. Different segments can be configured with different waterfalls to achieve the purpose of refined traffic monetization.

Currently, TopOn supports the following segment dimensions: Area, City, Date, Hour, Zone Time, Network type, App Version Name, SDK Version, OS Version, Device ID, Device Type, Device Brand, Installation Time, Channel, Sub-channel and Custom.

segment dimensions that TopOn does not support by default can be handled by using customs segment. As long as the developer can label the user rules and pass the field to TopOn, all groupings can be achieved through customs.

Note: The three segment rules, including channels, sub-channels, and customs, all require developers to transfer fields and update the version before they can be used; other segment dimensions can be used directly in the TopOn background configuration.

To configure customs, please refer to our help document: >>Custom Configuration Guide

(2) How to distinguish the source of user channels?

After the developer returns the channel information to TopOn, the data of different channels can be distinguished in multiple reports and configurations.

① Before initializing TopOn SDK, follow the Custom Configuration Guide to pass in the channel field.

② Fill in the channel field passed in the code in the segment configuration.  

③ Adjust the operation strategies of different channels according to segment.  

Note:

• After completing Step 1, you can view data directly by channel for full reports, cohorts reports, user engagement, and hourly reports;
• If you need to adjust the operation strategy for different channels, you need to complete Step 1~Step 3.

(3) I set a segment for some devices in mediation. Why doesn’t the segment take effect?

Currently TopOn supports the following device IDs to set segments:

• Android: GAID, Android ID, OAID, IMEI. (Tips: TopOn recommends that you use Android ID in China and GAID overseas when setting)
• iOS: IDFA, IDFV