Chat #14

# Configuring and Using Segments in Hawk ## Overview Segments are groups of users created based on specific characteristics using attributes. Once configured, they can be used throughout Hawk to deliver personalized experiences, targeted offers, and customized campaigns. --- ## What Are Segments? Segments are created by combining attributes to target specific player groups. For example, you might create a segment for "Daily Challenge players" by defining conditions such as: - Frequent players (e.g., `avg_number_of_games_7d >= X`) - Play at least 80% of Daily Challenges (e.g., `daily_challenge_play_rate >= 0.8`) - Rarely play Journeys (e.g., `journey_play_rate < Y`) ### How Segments Are Created Segments are built using **attributes**, which come from three sources: 1. **System Attributes** — Calculated internally by Player Service (available by default) 2. **External Attributes** — Created by Data Science & Engineering and sent daily to Player Service 3. **Custom Attributes** — Created by Client developers and sent immediately based on triggers **Note:** Attributes can only be created by backend teams upon request. --- ## Finding Your Segments in Hawk Your segments are accessible in the Hawk sidebar under the **Segmentation** section. This area displays a table with the following information for each segment: - **Name and ID** of the segment - **Entities using the segment** — Click to see which features (Catalogs, Campaigns, etc.) are using it - **Status information** — Shows whether the segment is active/inactive and test/live - **Last synchronization date** — When the segment was last updated from Harmony ### Synchronizing Segments Segments synchronize automatically from Harmony once every minute. If you need to expedite an update, use the **Synchronize** button in the Segmentation section.  --- ## Using Segments in Hawk Features Segments can be used in Hawk features that support segmentation, such as: - Catalogs - Campaigns - A/B Experiments - And other LiveOps features ### Steps to Apply a Segment 1. Navigate to the desired feature (Catalog, Campaign, etc.) 2. Locate the **Segment** dropdown menu 3. Select your segment from the dropdown list  --- ## Important Considerations ### Segment Priority When multiple segments target the same player, **Harmony respects the priority settings configured for each segment** — the player will receive the segment with higher priority. **However**, when using segments in **Game Server**, this priority does not apply. Instead, **the priority of your Game Server configurations overrides the Harmony priority**. ### Segment Updates Attributes used in segments can be updated at different frequencies: - **System Attributes** — Processed immediately when triggers occur (App Open, Payment Success, etc.) - **External Attributes** — Updated daily by Data Engineering - **Custom Attributes** — Sent immediately by the Client based on specific triggers Segment updates align with the designated start day, though attributes can be used in Harmony immediately upon data arrival. --- ## Related Resources For more detailed information on segmentation, see: - [Complete Segmentation Guide](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/2884468783) - [Campaigns & App Links in Hawk](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/3622731872/Campaigns+App+Links+in+Hawk) - [A/B Experiments in Hawk](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/3319988247/A+B+Experiments+in+Hawk)