Configuring Ads in Game Server
Chunk #0
* * *
### Introduction
In this article, you’ll learn how to configure advertisements inside Game Server. Ads are A/B testable and can be configured following the logic used in Game Settings.
**Table of Contents**
* * *
## Ads Configuration
In Ads Configurations, you’ll find the basic settings required to serve ads into the game, and they are used to distribute the settings to players using rules and overrides.
Configurations work very much alike [Game Settings](/wiki/spaces/KB/pages/2580021328/Game+Settings+Configuration), and in the main page you’ll find 3 main areas:
- Base Config
- New (to create overrides)
- A list of overrides, with their priority, status, labels, availability and rules applied
**What does** _ **Override Used** _ **mean?**
_Override Used_ is a counter displays the number of times data from an override has been sent to a user within a 24-hour period, resetting at midnight UTC for accurate tracking every day.
## Ads Base Config
Base Config is the main configuration that includes all basic ads settings that are common for all users. Base Config is always Live, does not have rules, and has a priority of zero by default. Within the Base Config, you'll find the core game settings for each application, organized under various tabs. The number displayed next to each tab title indicates how many settings re enabled in that category.
While the Base Config is fully editable, if you need to apply specific values for a targeted group of users, you'll need to create an Override to customise the settings for that audience.
### **Accessing & Editing Ads Base Config**
To access Ads Base Config, navigate to Ads \> Configuration, and click **[Base Config]**.
 
Amazon Ads settings previously located under Game Settings are now available in **Ads Config** section (within the "General" tab). This ensures all ad package settings are maintained in one place for easier access and management.
**Migration Details**
- **Base Config Migration:**
All listed below Amazon settings have been migrated to Ads Config Base config.
- **Override Migration (Triple Tile only)**:
Settings from the Game Settings override in Triple Tile have been transferred to the Ads Config override in the same app.
These settings are marked as enabled in the Ads Config override to preserve the same behaviour.
You will now find the following Amazon Ads settings under:
**Ads Config → General Tab**
| **Platform** | **Setting Key** |
| --- | --- |
| iOS | `ads_amazon_ios_sdk_key` |
| iOS | `ads_amazon_ios_interstitial_id` |
| iOS | `ads_amazon_ios_banner_id` |
| iOS | `ads_amazon_ios_leaderboard_id` |
| Android | `ads_amazon_android_sdk_key` |
| Android | `ads_amazon_android_interstitial_id` |
| Android | `ads_amazon_android_banner_id` |
| Android | `ads_amazon_android_leaderboard_id` |
* * *
## Creating an Override
In order to send specific settings to sets of users, you can create an override for Ads Configuration. Overrides allow you to customise the advertisement experience for certain sets of users determined by rules.
- Overrides will **only** be applied to a user if the user complies with a set of rules that you will set up to differentiate groups of users. However, if the 2 overrides apply to different settings, the user can receive both overrides depending on the rules defined in each of them.
- Read more about overrides [](/wiki/spaces/KB/pages/2580021328/Game+Settings+Configuration#What-are-Overrides?).
- You can duplicate an existing override using the blue duplicate button.
1. To create an Override, navigate to **Ads \> Configuration** and click the green **[New]** button.
2. Assign a name, status, priority and availability to your Override. You can also add a label that will help you to organise and manage Ad Configs in Game Server easily. Start At/End At fields are optional, and allow you to create overrides scheduled to go live. Click [here](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/edit-v2/3682861062#About-Start-At%2FEnd-At) to read more.
3. Click the **[green + sign]** to enable the fields and edit the configurations for your override. The edited configurations will appear marked with a blue number next to each tab.
At least one field and one rule should be enabled in the override.
1. Add the relevant rules for your override. Rules are necessary to segment players and distribute the override to them, and target different sets of users depending on their attributes. Learn more about rules[in this guide](https://tripledotstudios.atlassian.net/l/cp/osgQ0TAC).
2. Once you’re done, click the blue **[Save]** on the upper right corner and your override will be complete.
#### About Start At/End At
Start At/End At are 2 **optional** fields allow you to create overrides that are scheduled to go live (ie. become active) in the future to avoid having to set the status of the override manually to Active. Please note, however, that when Game Server reaches the **End At** date, the system does **not** automatically revert the status of the override.
Below you can find a diagram that explains the logic for Start Date.
Generic Settings
Chunk #0
In this page you’ll find documentation regarding settings and configurations that can be used in any game:
- [Asset Bundles in Game Server](/wiki/spaces/KB/pages/2926346323/Asset+Bundles+in+Game+Server)
- [Generic Chapters and Levels](/wiki/spaces/KB/pages/2852126735/Generic+Chapters+and+Levels)
- [Generic Journeys and Events](/wiki/spaces/KB/pages/2926870529/Generic+Journeys+and+Events)
- [Generic Daily Challenges](/wiki/spaces/KB/pages/2933653553/Generic+Daily+Challenges)
Rules in Game Server
Chunk #1
Setting up Named Rule Groups
1. Navigate to Named Rule Groups. In this page you’ll be able to visualise the already existing groups, and which rules compose them. Click the green **[+ New]** to create a new rule group. You can also duplicate, edit, or delete them using the actions available in the right side of the screen.
2. Give the group a name, and include your rules or sections of rules.
3. In order to use your Rule Group, navigate to any entity with rules, and click **[Add Named Rule Group].** From there you can select your Rule Group without having to create it from scratch again!
- The valid operators for Named Group Rules are IN/NOT IN
- Named Rule Groups can be used in combination with other rules
### Creating Named Rule Groups from Rules
You can also create Named Rule Groups directly from the Rules section in your entity. To do so:
1. Create your Rule, and click the grey **[3 dots button]**
2. Click **[Create Named Rule Group]**
3. Assign a name to your new Named Rule Group, and select whether you want to replace the section with the Named Rule Group
4. Your new Named Rule Group will be available to use and you will be able to edit it from Named Rule Groups section in Game Server
* * *
# List of Available Rules
Below you’ll find a comprehensive list of all available rules with their conditions and the data available for each of them:
| **Rule** | **Available conditions** | **Data** | **Description** |
| **Country** | - IN - NOT IN | Country list | Country where the player is located |
| **Language** | Language list | Language of the device |
| **Platform** | Multi-select: - Other - iOS - Android - Amazon | OS of the player device |
| **Cohort day** | - \>= - \<= - \> - \< | Numeric input | Number of days starting from 12AM in local time zone |
| **User Ids** | - IN - NOT IN - \>= - \<= - \> - \< | Text input | User ID |
| **Current game version** | Current version of the game in the player’s device |
| **Install game version** | Version of the game originally installed in the player’s device |
| **Previous game version** | Previous version of the game installed in the player’s device |
| **Install date (UTC)** | - \>= - \<= | Date picker | Based on UTC time (Server time) |
| **Install date (Local timezone)** | - \>= - \<= | Date picker | Based on local time that the Client sent in `/init` call `"utc_offset": "-11:00:00"` |
| **OS version** | - IN - NOT IN - \> - \< - \>= - \<= | Text input | Operative system of the player’s device Example: - Android OS 11 / API-30 (RP1A.200720.012/A715FXXS4BUC1) - iPhone 12,4 |
| - **IDFAs** - **IDFVs** | - IN - NOT IN | Text input | |
| **Device model** | - LIKE - NOT LIKE | Text input. Regex can be used. | Example: samsung SM-A715F |
| **LAT user \*** | - | - | If added, means LAT = true |
| **Experiment variant** | - IN - NOT IN | 1st level: all existing A/B experiments 2nd level: variants in specific experiment | GS will search whether player participated in specified variant of the experiment. Archived participations are not counted in the rule. Multiple experiment participations can be added via OR relation |
| **Player Bucket ** | - IN - NOT IN | _\*User Id is divided by 100_ Lower bound Upper bound Bounds can span from 0 to 99. | Bounds, ex. 0-9, means that players with ids end on _ **xxx00 - xxx09** _ will match the rule. |
| **Campaign Name** | - CONTAINS - DOESN’T CONTAIN - IS BLANK - IS NOT BLANK | Case sensitive Partial search | Name of the ad campaign Note: When the user selects IS BLANK, the rule will match if there is no entity provided. |
| **Media source** | - IN - NOT IN - IS BLANK - IS NOT BLANK | Case sensitive Full search | Entity used to display ads |
| **Onboarding mode** | == | Text input | Available only for **Duplica** New object can be sent from client in `/init` call. Any unknown attribute except **"onboarding\_mode"** will be ignored by server. "custom_attributes": { "onboarding_mode": "hello" } Note: - Data is stored in separate Duplica table `duplica_app_user_custom_attributes` - Once sent to the server, it is saved in DB and there is no need to send this info again (only if you need to change) - Server handles `"custom_attributes"` only from **Duplica players** , otherwise it sends a 500 error (custom table created only for Duplica) |
| **Total payments amount** | - \> - \< - \>= - \<= - == | Single numeric decimal | Available only for **Blackjack, Duplica, Merge, PPC** |
| **Last payment amount** | - \> - \< - \>= - \<= - == | Single numeric decimal | Available only for **Blackjack, Duplica, Merge, PPC** |
| **Days since last payment** | - \> - \< - \>= - \<= - == | Single numeric decimal | Available only for **Blackjack, Duplica, Merge, PPC** |
| **Days since previous visit** | - \> - \< - \>= - \<= - == | Single numeric decimal | **Calendar days** are counted. Calculations are based on “Last visit at” and “Previous visit at” values for device. |
| **Sessions count** | - \> - \< - \>= - \<= - == | Single numeric decimal | Amount of sessions triggered by the user. Sessions is defined as as a period of play with no greater than a five minute break. |
| **Debug IDs** | - IN - NOT IN | String \<=16 characters | |
| **Device type** | - IN - NOT IN | Multi-select: - Phone - Tablet | Tablet/Phone is detected based on screen resolution and DPI that are sent by the client |
| **Days since version update** | - \> - \< - \>= - \<= - == | Single numeric decimal | **Calendar days** are counted. Calculations are based on “App version updated at” value for device. |
| **Version update date** | - \>= - \<= | Date picker | Based on UTC time (Server time) The purpose of this rule is excluding users who update their app their app to a version that supports a specific journey after that journey starts, so that they can continue playing the journey they’d been playing before updating their version. This information is updated when the user makes the first `/init` call to server with a new version. When this happens, the date & time of this first init call is captured as update date in the device record in the system. |
| **Build variant** | - IN - NOT IN | Multi-select: - Default - Google - Samsung - Amazon - Apple - Apple - China | Platform used by the player |
| **Device RAM capacity (MB)** | - \> - \< - \>= - \<= - == | Single integer | In `/init` call client sends `ram_capacity` parameter which allows to deliver special configs and A/B Experiments for Android Go clients (low-end devices). The value is in megabytes. |
| **Player segment** | - \>= - \<= - \> - \< - == | Multi-select: list of segments synced from Hawk (the segments need to be created in Hawk beforehand) | Only active segments can be selected. |
| **Days since Start At** | - \>= - \<= - \> - \< | Numeric input | **Usage** : When an A/B experiment has variant groups created using this rule, GS counts the number of days since the “Start at” date of the experiment and decides which group the user should be in. Game Server starts counting the number of days starting from 12AM in local time zone. This rule is available **only** as an A/B Experiment Variant Rule and cannot be used anywhere else. |
| **City** | - IN - NOT IN | Dropdown with single value (only city available for now is London) | **Behaviour:** If a player belongs to the country in which the selected city is found (currently the only option is London), Game Server will send a request to GeoIP to check their city. The player matches the rule if GeoIP returns London as a city. |
| **Player Buckets (NEW)** | - IN - NOT IN | Dropdown with single value | The purpose of this rule is to deliver configurations only to users who belong to specific player buckets. This information is retrieved from Harmony, which includes the list of bucket IDs a player belongs to in each response. When evaluating a rule that includes a Player Bucket condition, the system checks whether the player’s bucket list includes the specified bucket ID. If it does, the configuration is delivered. If not, the configuration is excluded from delivery. |
## \uD83D\uDCCB **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:
[Ads Config: Configuring Ads in Game Server](/wiki/spaces/Innovecs/pages/4442063826/Ads+Config+Configuring+Ads+in+Game+Server)
-
Page:
[File Configuration in Game Server](/wiki/spaces/Innovecs/pages/4441866278/File+Configuration+in+Game+Server)
-
Page:
[File Configuration in Game Server](/wiki/spaces/KB/pages/4440228000/File+Configuration+in+Game+Server)
-
Page:
[Rules in Game Server](/wiki/spaces/Innovecs/pages/4355850392/Rules+in+Game+Server)
-
Page:
[Game Settings Configuration](/wiki/spaces/Innovecs/pages/3849912340/Game+Settings+Configuration)
-
Page:
[Setting up A/B Experiments](/wiki/spaces/Innovecs/pages/3848602658/Setting+up+A+B+Experiments)
-
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)