Chunks Used in Chat #61

Adding User Groups In managing ad configurations, ensuring targeted and optimised ad experiences across diverse user segments is essential. Previously, to cater to these unique needs, the monetisation and product teams had to create multiple overrides for each setting, making it difficult to manage and review configurations across various segments. To streamline this process, a new feature called **User Groups** has been introduced. User Groups allow you to define multiple configurations for a single setting in one centralised location, with flexibility to assign different values for each user segment. In this section, you’ll learn how to create, edit, and manage User Groups within the **Base Ads Configuration** settings. You will also understand how priorities are defined between user groups, overrides, and experiments. This feature gives you the ability to add rules for each group, assign priority levels, and control the exact ad experience tailored to various user segments, all from a single interface. ### **Understanding User Groups in Configuration Priority** In the configuration hierarchy, **User Groups** serve as an intermediate layer, positioned between **Overrides** and **Base Configurations**. Here’s how they function and their role in the priority system: **Priority Order** - **Overrides** : Highest priority. Overrides take precedence over all other settings, ensuring that specific configurations are applied when explicitly defined. - **User Groups** : Second priority. User Groups provide a flexible layer that allows configurations to be tailored for specific subsets of users. - **Base Configurations** : Lowest priority. Base Configurations act as the default settings, applying when neither Overrides nor User Groups are applicable. The **User Groups** will only apply if no Overrides or higher-priority settings (like experiments) are present. **How User Groups Apply** 1. When a user matches a set of defined rules and there are **no Overrides or Experiments** that take precedence, the system checks which User Group the user belongs to. 2. The settings from this User Group will then be applied, based on the specific configuration associated with that group. **Resolving Conflicts When a User Belongs to Multiple Groups** - If a user qualifies for multiple User Groups (i.e., matches the rules of more than one group), the system will select the setting from the **group with the highest priority**. - Priorities are set as numeric values, with **higher numbers indicating higher priority** (e.g., a group with priority 100 will override a group with priority 50). **User Groups and Availability** **User Groups impact** _ **Live/Test Availability** _: User Groups configurations are applied to settings that are both live and test, meaning they affect both the active and inactive configurations. To configure a user group: 1. Navigate to Base Ads Configuration - Go to the **Edit Base Ads Configuration**.  1. Access User Groups for a Setting - In each ad setting tab, there will be a **User Groups** button next to each setting, displaying the number of user groups created. - Click the **User Groups** button for the desired setting (e.g., "Placement Bank" for Rewarded Videos) to open the User Group configuration page for that specific setting. 1. Edit User Groups Page Overview A list of user groups is displayed, each with its assigned priority. - You will also see a list of user groups created for this setting, each with specific priority. In the _Edit User Groups_ page, configurations are prioritised from **highest to lowest**. - This means that a configuration with **priority 10** is ranked higher than one with **priority 1**. - With higher-priority groups (those with larger numbers) taking precedence over lower-priority groups. This structure ensures that configurations are enforced according to their designated importance, impacting the _LIVE_ availability and usage displayed for each group. 1. Adding User Groups - Click on the **Add User Group** button to create a new group. - Assign a unique **Name** for the new user group. Each user group is sorted by priority, with the highest priority at the top. - Add details like **Status** (Active/Inactive), **Labels** , **Notes** , and any configuration for settings in the group. (These are optional) 1. Setting Rules for User Groups - Define at least one rule for each user group. - Add more rules by clicking on **Add Rule** , or organise rules with **AND/OR** conditions for more complex configurations. 1. User Group Management Options. You can duplicate, delete, reorder and expand/collapse the user groups.  1. Saving Changes - After configuring or modifying user groups, click **Save** to apply the changes. This will return you to the **Base Ads Configuration** page. - If you click **Cancel** , you will be redirected back to the **Base Ads Configuration** page without saving changes. Activity Log - Use the **Activity Log** button at the top of the **Edit User Groups** page to view the history of changes for the selected ad configuration and user groups. 1. Viewing ‘In Use’ Configurations To make navigation easier, there is a “Jump to Configuration” link. This allows you to quickly view the associated configurations for a User Group.  - When archiving a setting, ensure that it is not used in any user group. The system will validate this automatically to prevent errors. ## **User Groups in Audience Groups** User Groups allow configurations to be tailored for specific segments within Audience Groups. Perform the following steps for creating user groups in audience groups: 1. Click **Audience Groups**. ### **Accessing User Groups for a new Audience Group** When configuring a new **Audience Group** for the first time in **Ads Configuration** , user groups cannot be set up immediately. Upon enabling a setting, the **User Groups** button appears next to it but remains inactive. Hovering over the button displays a tooltip: _"User groups will be available after the audience group is saved."_ To proceed with configuring user groups, the **Audience Group must first be saved**. This ensures that all configurations are properly initialised before assigning user groups. ### **Accessing User Groups for an Existing Audience Group** When an audience group has already been configured as an Ads Config audience group, managing user groups becomes accessible within the settings. Upon opening the audience group, users will see a **User Groups** button next to each previously enabled setting, allowing for further configuration. If a new setting is enabled, the **User Groups** button remains disabled until the audience group is successfully saved with the updated setting. Perform the following steps to configure a user group: 1. Click **Edit** to configure the **Audience Group**. 2. Enable the relevant setting. For each **enabled setting** , a **"User Groups"** button appears 3. If the setting was enabled previously, the user groups button is active and can be configured. 4. If the **setting was just enabled** , the button is **inactive until saved.** Once an Audience Group is **saved** , User Groups can be configured. 5. Configure the setting and save the Audience group. The **User Groups** button is now enabled. ### **Adding a New User Group** 1. Click **[+Add User Group]**. 2. Enter User Group Details: Name, Status, Availability, and optional details like Labels and Notes. 3. Define Rules for the User Group.  ### **Managing User Groups.** You can reorder, duplicate and delete the user groups.  * * * ### **Validation & Restrictions** **Cannot disable a setting if User Groups exist. Can disable a setting only if no User Groups are present** * * *

**User Groups in Audience Groups** User Groups allow configurations to be tailored for specific segments within Audience Groups. Refer to [this User Guide](/wiki/spaces/KB/pages/3981377538/Player+Buckets+and+Audience+Groups#Audience-Groups) to know more about Audience Groups. Perform the following steps for creating user groups in audience groups: 1. Click **Audience Groups**. ### **Accessing User Groups for a new Audience Group** When configuring a new **Audience Group** for the first time in **Game Settings** , user groups cannot be set up immediately. Upon enabling a setting, the **User Groups** button appears next to it but remains inactive. Hovering over the button displays a tooltip: _"User groups will be available after the audience group is saved."_ To proceed with configuring user groups, the **Audience Group must first be saved**. This ensures that all configurations are properly initialised before assigning user groups. ### **Accessing User Groups for an Existing Audience Group** When an audience group has already been configured as a game settings audience group, managing user groups becomes accessible within the settings. Upon opening the audience group, users will see a **User Groups** button next to each previously enabled setting, allowing for further configuration. If a new setting is enabled, the **User Groups** button remains disabled until the audience group is successfully saved with the updated setting. Perform the following steps to configure a user group: 1. Click **Edit** to configure the **Audience Group**. 2. Enable the relevant setting. For each **enabled setting** , a **"User Groups"** button appears 3. If the setting was enabled previously, the user groups button is active and can be configured. 4. If the **setting was just enabled** , the button is **inactive until saved.** Once an Audience Group is **saved** , User Groups can be configured. 5. Configure the setting and save the Audience group. The **User Groups** button is now enabled. ### **Adding a New User Group** 1. Click **[+Add User Group]**. 2. Enter User Group Details like: Name, Status, Availability, and optional details like Labels and Notes. 3. Define Rules for the User Group.  ### **Managing User Groups** You can manage the user groups by reordering, duplicating and deleting them if required.  * * * ### **Validation & Restrictions** **Cannot disable a setting if User Groups exist. Can disable a setting only if no User Groups are present** * * * # **Related articles** - Page: [Configuring Game-Specific 3rd Party Machine Learning Models in Game Server](/wiki/spaces/KB/pages/4580999169/Configuring+Game-Specific+3rd+Party+Machine+Learning+Models+in+Game+Server) - Page: [Configuring Embedded Machine Learning Models in Game Server](/wiki/spaces/KB/pages/4548263939/Configuring+Embedded+Machine+Learning+Models+in+Game+Server) - Page: [File Configuration in Game Server](/wiki/spaces/KB/pages/4440228000/File+Configuration+in+Game+Server) - Page: [Managing Localisations in Harmony](/wiki/spaces/KB/pages/3230760961/Managing+Localisations+in+Harmony) - Page: [Generic Daily Challenges](/wiki/spaces/KB/pages/2933653553/Generic+Daily+Challenges) - Page: [Configuring Ads in Game Server](/wiki/spaces/KB/pages/2765029415/Configuring+Ads+in+Game+Server) - Page: [Rules in Game Server](/wiki/spaces/KB/pages/2668494860/Rules+in+Game+Server) - Page: [Setting up A/B Experiments](/wiki/spaces/KB/pages/2581889051/Setting+up+A+B+Experiments) - Page: [Game Settings Configuration](/wiki/spaces/KB/pages/2580021328/Game+Settings+Configuration)

**Introduction** In this page you’ll learn… - What are rules? - How to use rules and combine them? - Available rules **Table of Contents** * * * # Getting Started with Rules Rules are one of the most important components of Game Server, and they can be found in almost every available application. Rules allow you to differentiate entities for specific user groups, and they can be used to target different sets of users. # Basics of Rules Rules are based on logical operators. The 2 operators used are AND and OR: | **AND operator** | **OR operator** | | --- | --- | | Users must match **all added rules** to receive the entity | Users must match **at least one of the rules** to receive the entity  | You can add as many rules inside a section of rules, and you can also combine sets of rules using [Sections](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/2668494860/Rules+in+Game+Server#Sections). Some rules also allow you to add multiple values by using the **[green + button]**.  ### **Example** Let’s say we want to target the following set of users: - From France OR UK  **AND** - Has Game version equal 2.7.0 **AND** - Installed the app 15 days ago or more **How will we represent this in terms of rules?** - Country = France or UK  - Only the users who comply with all of these these conditions will receive the entity  # Sections  Sections allow you to nest sets of rules and combine them to target users more accurately. Sections allow **up to 3 levels of nesting** , and they use different colours so that they can be distinguished easier. Sections also use the basic AND/OR operators to combine rules. Next to **[Add Rules]**, you’ll find **[Add Section]** (1) **.** After clicking the button, a new container will appear on top (2), where you’ll be able to add new rules and select which relation (AND/OR) should have with the other set of rules.  If you added your rules previously, and now you need to create a section, you can use the yellow button **[Convert to a section]** to create sections of rules without having to delete and add the rules in a section.  - If there are rules without a section on the selected level, these rules will be moved to the newly created section - If there are 2 sections, then the system would convert it to a section with 2 sub sections (including top level) - By the click on the ‘Convert to a section’, system converts selected level of nesting into section and puts all the rules and sections from this level under created section - The button is disabled for the 3rd and 4th level of nesting #### **Example** Now we would like to target the following set of users: - Country = France or UK **AND** - Game version = 2.7.0 **AND** - Cohort day \>= 15 **OR**   - Country = France or UK **AND** - Game version =  3.0.0 **AND** - Cohort day \>= 3 **How will we represent this in terms of rules?** To do so, we need to create 2 sections of rules with the operand OR above, and include inside each set, the rules we want to match. Game Server will then look for players matching the rules on the first set OR the second one.  # Named Rule Groups _Named Rule Groups_ allow you to create and save a set of rules that can be later reused in any feature that uses rules, allowing you to save time setting up your configurations.