Chunks Used in Chat #60

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** * * *

Reactivating and Searching Archived Settings Archived settings do not appear in the UI, but they are still searchable and marked as Archived in the UI. Clicking on the link will allow you to edit the archiving configuration of the setting:  To reactivate an archived setting, navigate to **Game Settings \> Archived Settings** , and click the yellow button  to reactivate the setting.  A confirmation message will appear. Click **[Yes]** to reactivate the setting:  **About Reactivated Settings** - Setting are moved back to its original location in Games Settings (Base config and Overrides) as a **disabled** setting - Reactivated settings will have the default values they had before archiving - Reactivated settings can be used as all existing settings including to A/B Experiments. Changes to the setting can also be tracked via activity log. # Adding User Groups 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 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 groups. ## **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: **Priority Order** - **Overrides** : Higher 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. **Resolving Conflicts When a User Belongs to Multiple Groups** 3. **User Groups only impact** _ **Live Availability** _: User Groups configurations are only applied to settings that are live, meaning they affect only the active, real-time configuration. 4. For **Test Availability** : Overrides must be used to control settings for testing purposes, as User Groups do not influence test configurations. This ensures that testing remains isolated from live user configurations. ## User Group Configuration 1. Navigate to Base Configuration - Go to the **Edit Basic Game Settings** 1. Access User Groups for a Setting - In each Game 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., "Display Game Visuals Setting) 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. Here, it's important to note the _LIVE availability_ status of each group—this status is fixed, non-editable, and cannot be changed. - 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**. 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 higher priority at the top. - Add details like **Status** (Active/Inactive), **Labels** , **Notes** , and any configuration for settings in the group. ( **Optiona** l) 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 user groups and also expand/collapse them.  1. Saving Changes - After configuring or modifying user groups, click **Save** to apply the changes. This will return you to the **Edit Basic** **Game Settings** page. - If you click **Cancel** , you will be redirected back to the **Edit Basic** **Game Settings** page without saving changes. 1. 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 are available only for **Live** configurations. Test configurations require overrides to be applied. - Only users with Live permissions can view and edit user groups.

**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)