---
title: Mapping rules tab
description: In this tab, users can configure the mapping rules for a specific Inventory. These rules ensure that setups made in other platforms or systems are properly reflected in the requests sent to the Inventory.
---

[Skip to content](https://help.gamoshi.com/knowledge/mapping-rules-tab#main-content)

English

Show submenu for translations

[More support](https://help.gamoshi.com/knowledge/kb-tickets/new?hsLang=en)

[![gamoshi logo din-4](https://help.gamoshi.com/hs-fs/hubfs/gamoshi%20logo%20din-4.png?width=300&height=53&name=gamoshi%20logo%20din-4.png)](https://gamoshi.com)

- [Tickets](https://support.gamoshi.com/tickets-view)
- [Sign out](https://support.gamoshi.com/_hcms/mem/logout)

Open main navigation

Close main navigation

- [Tickets](https://support.gamoshi.com/tickets-view)
- [Sign out](https://support.gamoshi.com/_hcms/mem/logout)
- English
  
  Show submenu for translations
- [More support](https://help.gamoshi.com/knowledge/kb-tickets/new)
- [Gamoshi.com](https://www.gamoshi.com/)

[Gamoshi.com](https://www.gamoshi.com/)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.gamoshi.com/knowledge?hsLang=en)
2. [Programmatic Exchange Enterprise Modules](https://help.gamoshi.com/knowledge/programmatic-exchange-enterprise-modules?hsLang=en)
3. [Inventory](https://help.gamoshi.com/knowledge/programmatic-exchange-enterprise-modules?hsLang=en#inventory)

# Mapping rules tab

## In this tab, users can configure the mapping rules for a specific Inventory. These rules ensure that setups made in other platforms or systems are properly reflected in the requests sent to the Inventory.

### **Mapping Rules – Customizing Request Mapping**

**Content**

- [Overview](https://help.gamoshi.com/knowledge/mapping-rules-tab#overview)
- [How to access mapping rules](https://help.gamoshi.com/knowledge/mapping-rules-tab#access_mappingrules)
- [Creating and managing mapping rules](https://help.gamoshi.com/knowledge/mapping-rules-tab#create_mng_mapping)
  
    - [Defining rules](https://help.gamoshi.com/knowledge/mapping-rules-tab#define_rules)
    - [Adding data records](https://help.gamoshi.com/knowledge/mapping-rules-tab#add_data_records)
    - [Bulk replacement](https://help.gamoshi.com/knowledge/mapping-rules-tab#bulk_replacement)
    - [Applying rules across Inventories](https://help.gamoshi.com/knowledge/mapping-rules-tab#apply_across)
- [Understanding incoming properties](https://help.gamoshi.com/knowledge/mapping-rules-tab#understand_incoming)
- [Understanding target properties](https://help.gamoshi.com/knowledge/mapping-rules-tab#understand_target)
- [Deal ID's rules](https://help.gamoshi.com/knowledge/mapping-rules-tab#dealids_rules)
- [Pricing rules](https://help.gamoshi.com/knowledge/mapping-rules-tab#pricing_rules)
- [Video Placement types](https://help.gamoshi.com/knowledge/mapping-rules-tab#video_plc)
- [Filters](https://help.gamoshi.com/knowledge/mapping-rules-tab#filters)
- [Troubleshooting](https://help.gamoshi.com/knowledge/mapping-rules-tab#troubleshooting)

---

 

### **Overview**

The **Mapping Rules** tab enables you to define custom rules that modify how incoming request properties are mapped to target properties in your inventory setup. This is useful for aligning your system with an inventory’s configuration, such as mapping bundles or domains to placements.

---

Key Requirement: When you create a mapping rule for a Domain or Bundle, you must associate it with data records. Otherwise, your advertiser’s activity will be paused.

 

---

 

### **How to Access Mapping Rules**

- **For New Advertisers:**
  
    - Create and save the inventory’s General tab
    - Go to the **Mapping Rules** tab in the inventory’s details form
- **For Existing Advertisers:**
  
    - Navigate to **Inventories Module \> Inventories List**
    - Click the edit icon in the Actions column
    - Go to the **Mapping Rules** tab
- **Alternative Access:** Manage all mapping rules across advertisers in **the Inventory Module \> Mapping Rules,** allowing for searching, filtering, bulk editing, and data records management.

---

 

### **Creating and Managing Mapping Rules**

 

**1.  Defining Rules**

- Each rule connects an **Incoming Property** (the request dimension being matched) to a **Target Property** (the request dimension that holds the mapped value).
- Example: map domains or bundles (incoming) to placements (target).
- Note: Defining a mapping rule for a domain or bundle automatically creates an **allowlist** for that property. No need to duplicate them in the Lists module.

 

**2.  Adding Data Records**

- Add records manually or by uploading a **CSV/TXT** file (max size 10MB).
- Use the special value `$_other_$` when you wish to catch all values not explicitly listed.
  
    - ⚠ **Important: This rule will not act as an allowlist.**
- Please make sure records are always added for bundle/domain mappings; otherwise, activity will be paused.

 

**3.  Bulk Replacement**

- Use bulk replacement to substitute a specific **TO value** across all data records in a mapping rule.

 

**4.  Applying Rules Across Inventories**

- While creating/editing a mapping rule, you can apply it to multiple inventories or to **All Partners** with one switch.
- ⚠ Be advised: Applying rules globally may cause conflicts if other inventories already have their own mapping rules.

---

 

### **Understanding Incoming Properties**

Incoming properties represent dimensions in the bid request you want to match.  
Examples include:

- ALL\_REQUESTS (matches all incoming requests, can only contain one record)
- APP\_ID, APP\_NAME, BUNDLE, DOMAIN, SITE\_ID, SITE\_URL
- BID\_FLOOR, PRICE, DEAL\_ID, MEDIA\_TYPE
- For the full list of incoming properties, refer to [Mapping rules Metrics](https://support.gamoshi.com/knowledge/mapping-rules-metrics).

 

### **Understanding Target Properties**

Target properties represent where the mapped values are applied in the inventory setup.  
Examples include:

- APP\_ID, APP\_NAME, BID\_FLOOR, PRICE, PLACEMENT, OS, SITE\_URL
- 'BLOCKED\_xxx' properties:
  
    - BLOCKED\_ADVERTISERS, BLOCKED\_APPS, BLOCKED\_ATTRIBUTES, BLOCKED\_CATEGORIES
    - The values must be in quotes, comma-separated.  
      For example: "value1, value2, value3, value4, value5"
- For the full list of target properties, refer to [Mapping rules metrics](https://support.gamoshi.com/knowledge/mapping-rules-metrics).

 

### Deal ID rules

- The format is: id|price|seat
- Multiple seats: id|price|seat1,seat2,seat3
- Multiple deals: separate with $   
  Example: *my\_deal|3.3|234$my\_deal2|0|34,23* 
    - Per this example, Gamoshi will create two private deals:  
      **First deal**  
      name: my\_sp\_deal  
      price: 3.3 and   
      Seat: 234  
      **Second deal**  
      name: my\_sp\_deal\_2  
      price: auction price   
      Seat: 34,23
    - ⚠ The Price and Seat are not mandatory.

 

### **Pricing Rules**

- Price = 0/nothing → use the bid request price
- Price \> 0 → use the defined price
- Price \< 0 (-1) → use the bid floor price

 

- ### **Video placement types**
  
    - For your Video placement type mapping, use the  ID number only (x) from the detail values lists below.
    - `VIDEO_PLACEMENT_TYPE`:  
      (1) In-Stream, (2) In-Banner, (3) In-Article, (4) In-Feed, (5) Interstitial
    - `VIDEO_PLCMT`:  
      (1) Instream, (2) Accompanying Content, (3) Interstitial, (4) Standalone

 

---

 

### **Filters**

Mapping rules can be filtered by:

- Ad Sizes
- Ad Type
- Device Type
- Countries
- Source
- Operating System

---

 

### **Troubleshooting**

- **Advertiser paused unexpectedly?**
  
    - Check if a domain/bundle mapping rule exists without data records.
- **Conflicting behavior?**
  
    - Verify/check if rules are being applied to multiple inventories via "All Partners."
- **Not seeing expected mapping results?**
  
    - Confirm correct Incoming/Target property pairing.
    - Validate CSV/TXT formatting & file size.
    - Ensure "Block\_xxx"   record values are enclosed in quotes and comma-separated.

- [FAQ](https://help.gamoshi.com/knowledge/faq?hsLang=en)
- [General Information](https://help.gamoshi.com/knowledge/general-information?hsLang=en)
- [Programmatic Exchange Enterprise Modules](https://help.gamoshi.com/knowledge/programmatic-exchange-enterprise-modules?hsLang=en#main-content)

    - [Analytics](https://help.gamoshi.com/knowledge/programmatic-exchange-enterprise-modules?hsLang=en#analytics)
    - [Users](https://help.gamoshi.com/knowledge/programmatic-exchange-enterprise-modules?hsLang=en#users)
    - [Business partners](https://help.gamoshi.com/knowledge/programmatic-exchange-enterprise-modules?hsLang=en#business-partners)
    - [Advertisers](https://help.gamoshi.com/knowledge/programmatic-exchange-enterprise-modules?hsLang=en#advertisers)
    - [Inventory](https://help.gamoshi.com/knowledge/programmatic-exchange-enterprise-modules?hsLang=en#inventory)
    - [Audience](https://help.gamoshi.com/knowledge/programmatic-exchange-enterprise-modules?hsLang=en#audience)
    - [Targeting](https://help.gamoshi.com/knowledge/programmatic-exchange-enterprise-modules?hsLang=en#targeting)
- [Programmatic Exchange Enterprise How To](https://help.gamoshi.com/knowledge/programmatic-exchange-enterprise-how-to?hsLang=en)
- [General How To](https://help.gamoshi.com/knowledge/general-how-to?hsLang=en)
- [Programmatic Exchange Pro Account](https://help.gamoshi.com/knowledge/programmatic-exchange-pro-account?hsLang=en#main-content)

    - [Analytics](https://help.gamoshi.com/knowledge/programmatic-exchange-pro-account?hsLang=en#analytics)
    - [Users](https://help.gamoshi.com/knowledge/programmatic-exchange-pro-account?hsLang=en#users)
    - [Business partners](https://help.gamoshi.com/knowledge/programmatic-exchange-pro-account?hsLang=en#business-partners)
    - [Advertisers](https://help.gamoshi.com/knowledge/programmatic-exchange-pro-account?hsLang=en#advertisers)
    - [Inventory](https://help.gamoshi.com/knowledge/programmatic-exchange-pro-account?hsLang=en#inventory)
    - [How To (Pro account)](https://help.gamoshi.com/knowledge/programmatic-exchange-pro-account?hsLang=en#how-to-pro-account)
- [DSP account](https://help.gamoshi.com/knowledge/dsp-account?hsLang=en#main-content)

    - [Analytics](https://help.gamoshi.com/knowledge/dsp-account?hsLang=en#analytics)
    - [Users](https://help.gamoshi.com/knowledge/dsp-account?hsLang=en#users)
    - [Business Partners](https://help.gamoshi.com/knowledge/dsp-account?hsLang=en#business-partners)
    - [Advertisers](https://help.gamoshi.com/knowledge/dsp-account?hsLang=en#advertisers)
    - [Inventory](https://help.gamoshi.com/knowledge/dsp-account?hsLang=en#inventory)
    - [Audience](https://help.gamoshi.com/knowledge/dsp-account?hsLang=en#audience)
    - [Targeting](https://help.gamoshi.com/knowledge/dsp-account?hsLang=en#targeting)
    - [DSP How to](https://help.gamoshi.com/knowledge/dsp-account?hsLang=en#dsp-how-to)

[![Chill listening crop-3](https://help.gamoshi.com/hs-fs/hubfs/gamoshi%20logo%20din-2.png?width=136&height=24&name=gamoshi%20logo%20din-2.png "Chill listening crop-3")](http://gamoshi.com)

Gamoshi Help Center

Copyright © 2026, Gamoshi LTD.