Campaigns & App Links in Hawk
Chunk #5
**Adding Personal Offers in Campaigns**
The content section lets you select the content that will be shown. You can configure **Creatives** , such as pop-ups including **personal offers** from this section.
1. From the **Creative Template** dropdown, select the relevant template.
Please note that depending on the configuration of the creative template, the options under content will be different.
- If a creative template includes the offer\_container component, fields for personal offers will appear under the "Content" section in the campaign configuration.
- For templates with multiple offer\_container components, fields for multiple personal offers will be displayed, corresponding to each offer container.
1. If the selected creative template has an offer container included, you might see some fields to be populated.
In the table below you’ll find a detailed explanation of each field:
#### **Offer Fields**
| **Field** | **Validations** | **Description** |
| **Price Type** | Dropdown with the following options: - Store Product - In-game Currency - Ads - Free | The price type of item you are offering in the creative. - **Store Product** : Items can be obtained directly from the in-game store as part of a regular purchase or a special promotion. - **In-game Currency** : Players can acquire items by redeeming the virtual currency earned during gameplay. - **Ads** : Certain items may be unlocked by viewing advertisements. - **Free** : A selection of items is available at no cost, allowing players to enjoy additional content without any associated charges. |
| **Product** | Dropdown with the products offered | The product you will be offering in the creative. The data in this field comes from Game Items. See the [Configuring Game Items](/wiki/spaces/KB/pages/2916810950/Payments+and+Shop+Configuration+in+Hawk#Configuring-Game-Items) topic for more details. Game Items can be configured from **Game Server \> Game Items** |
| **Label** | Dropdown with existing labels | Label to appear in the App Store, which are used to highlight a special offer or similar. Labels can be configured from **Payments \> Product Labels.**  |
| **Sale Type** | Dropdown with the following options: - None - More Value % - Price Cut - Extra Amount | This field determines the type of sale that applies to the creative. Not Applicable for the “ **Ads”** and “ **Free”** Price Types. - **None:** no special sale - **More Value %:** more products for the same price. - **Price Cut:** lower price. If this is selected, a new dropdown will appear where you can select a new price. - **Extra Amount:** more items for the same price. |
| **Price** | Dropdown with existing prices/ Blank field | This dropdown/field is used to select/specify the price for the product offered. Depending on the Price Type selected, you can select or add the price. Not Applicable for the “ **Ads”** and “ **Free”** Price Types. |
| **% more** | Blank field | Applicable for the “ **More Value %** ” Sale Type. You can specify the required percentage of increment to the existing value. |
| **Rounding Type** | Dropdown with the following options: - Round Up - Math Round - Round Down | Applicable for the “ **More Value %** ” Sale Type. You can control how values are processed when applying percentages. - **Round Up** : This method rounds numbers upwards to the nearest whole number. For example, 4.1 would round up to 5. - **Math Round** : This method follows standard rounding rules. If the decimal part is 0.5 or greater, the number rounds up, and if it is less than 0.5, the number rounds down. For example, 4.5 rounds to 5, while 4.4 rounds to 4. - **Round Down** : This method rounds numbers down to the nearest whole number. For example, 4.9 would round down to 4. |
| **Sale Price** | Dropdown with existing prices | Applicable for the “ **Price Cut** ” Sale Type. |
| **extra** | Blank field | Applicable for the “ **Extra Amount** ” Sale Type. Allows you to define an additional quantity or value that will be offered in an offer. |
If the user switches the Price type, the form will be reset.
For example, when changing the Price type, the price input will be cleared.
1. **Reduce Availability** toggle: gives you control over whether the availability of an item should decrease as players obtain it, either through viewing ads or making purchases.
2. In the **text** field, add the title for the pop-up.
Please note, that the text field might differ for some creative templates based on the layouts configured by the Technical Artist. For some instances, you can specify the localisation key for the title.
**What does the Reduce Availability toggle do?**
The Reduce Availability toggle changes the availability in the following context:
- **First Item (Ad-based)**: When a player earns an item by viewing an ad, and the **"Reduce Availability"** toggle is **activated** , the total number of that item available to the player will decrease each time they receive it.
For instance, if there is an availability cap on how many times this item can be obtained (e.g., only 5 times), the availability will decrease with each ad view until the cap is reached.
- **Second Item (Purchase-based)**: When a player purchases an item, and the **"Reduce Availability"** toggle is **deactivated** , the total number of items available will **not** decrease after the purchase. This means the availability cap remains unchanged, allowing players to continue purchasing the item without affecting its availability.
### **Adding Quit Screen Offers in Campaigns**
Players who lose a game often forfeit rewards or break their streak. Introducing a **Quit Offer** at this moment provides an opportunity to re-engage the user by offering them a relevant incentive to continue playing.
1. Navigate to the Content section.
2. From the **Creative Template** dropdown, select the relevant Quit Offer template.
Please note that the offer template can be uploaded in the creative library section. [See the Uploading Creative Templates and Creative Icon](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/3622731872/Campaigns+App+Links+in+Hawk#Uploading-Creative-Templates-and-Creative-Icon) section above.
1. For the first offer, from the **Price Type** dropdown, specify the price for the product offered.
2. From the **Product** dropdown, select the product you will be offering in the creative. The data in this field comes from Game Items.
3. From the **Label** dropdown, select the Label to appear in the App Store.
4. **Reduce Availability** toggle: gives you control over whether the availability of an item should decrease as players obtain it, either through viewing ads or making purchases.
5. In the **Offer 2** field, add the text to be displayed for the quit offer.
6. In the **Offer 3** field, add the localisation key for the quit offer.
Please note, that the offer 2, offer 3 fields might differ for some creative templates based on the layouts configured by the Technical Artist. For some instances, you can specify the localisation key for the title.
7. Click **Save**.
Daily Rewards Configuration
Chunk #0
**Introduction**
Daily rewards in the game offer users incentives to log in consistently to increase engagement and habit formation.
Through Game Server, you can configure different daily rewards for users, and also configure a streak counter, a 7-day reward track, prompting users to continue logging in for additional rewards beyond the 7-day mark.
With this feature, you can provide new players with reasons to return daily, increasing daily retention. For existing users, the main benefit is to receive recognition for their consistent engagement and being exposed to new features they may not have explored yet.
**Table of Contents**
**Daily Rewards Availability**
Daily Rewards are available for Solitaire only
* * *
## Configuring Daily Rewards
To configure Daily Rewards, navigate to “Daily Rewards Config” on the sidebar of your game. You’ll find 2 sections:
- **Daily Reward Banks:** sets of daily rewards organised by day
- **Daily Rewards configs:** this is where you’ll configure the settings for the daily rewards
### **Configuring Daily Reward Banks**
Banks are a collection of daily rewards organised by day. Each day that the player opens the app, they will receive the reward set for that day.
To create a Daily Reward Bank, follow the steps below
1. Open Daily Reward Banks and click **[New]** on the upper right corner.
2. Give your Bank a name, assign a label (optional), and click **[+ Add Day]. Then, click the arrow to open the settings, and click [Add Rewards] to include your new rewards. You can also edit the amount of rewards given with the number picker next to the name of the reward**
- Each bank must have at least **1 reward,** and you can add up to 4 rewards (Game Items)
- Rewards are items available in Game Items
- You can duplicate an existing day and edit if if needed
- The mass operations button allows you to:
When you’ve created your new reward bank, it’s time to create a config for it.
### Creating Daily Rewards Config
Daily Rewards Config is where you’ll configure how and when the banks are sent to players and in which conditions they’re served
1. Navigate to Daily Rewards Configs and select **[New]**
2. **Give your Config a name and fill in the fields. A table can be found below with information about each setting:**
| **Field Name** | **Description** | **Validations** |
| **Non-repeatable rewards bank** | This setting allows you to select a non-repeatable reward bank for the user Each option in dropdown list includes number of days in the config which is displayed after config name in the brackets | Optional Default: 'None' |
| **Backup Rewards for non-repeatable bank enabled** | Enable this box if you’d like to select a backup reward bank in case the rewards from the main bank are disabled for specific user | Default: not enabled |
| **Backup Non-repeatable rewards bank** | Mandatory if the setting **Backup Rewards for non-repeatable bank enabled** has been activated The number of days in the selected “Backup Non-repeatable rewards bank” should be equal or more than in the config selected in “Non-repeatable rewards bank” Each option in the dropdown list includes number of days in the config which is displayed after config name in the brackets | Default: none, but mandatory if the checkbox “Backup Rewards for non-repeatable banks” has been enabled |
| **Repeatable rewards bank** | If the non-repeatable rewards bank finishes, Repeatable Rewards Bank allows you to serve a new bank to players | Default: None |
| **Backup Rewards for repeatable bank enabled** | Enable this box if you’d like to select a backup reward bank in case the rewards from Enable this box if you’d like to select a backup reward bank in case the rewards from the main bank are disabled for specific user are disabled for specific user | Default: Disabled |
| **Backup Repeatable rewards bank** | Mandatory if the setting **Backup Rewards for repeatable bank enabled** has been activated The number of days in the selected “Backup repeatable rewards bank” should be equal or more than in the config selected in “repeatable rewards bank” Each option in the dropdown list includes number of days in the config which is displayed after config name in the brackets | Default: none, but mandatory if the checkbox “Backup Rewards for repeatable banks” has been enabled |
### Enabling Daily Rewards in Game Settings
Once you’ve configured your Daily Reward banks and configs, the last step is enabling them in Game Settings. To do so:
1. Navigate to Game Settings
2. Click the tab “Daily Reward”
3. Enable the fields by clicking the **[green plus sign]**, and add your settings.
Game Settings Configuration
Chunk #2
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.