How to create an Inventory

This article is a step-by-step guide on how to create an inventory.

Step-by-step guide

1. General tab
2. Pricing
3. Lists
4. Mapping rules
5. Integration
   1. Open RTB
   2. VAST
   3. Header bidding
   4. Script
      1. How to inject the Passback function into a script
      2. Examples 
         
         
   5. Custom/3rd party/Mediation

Navigation: 

Go to Inventory module -> List tab -> press the '+' button in the top right corner of the grid.

1. Once the new Inventory form is opened, start by filling in the General tab. Only upon saving the General tab, other tabs will become available.
2. General tab
   
   
   1. Mandatory fields
      
      

      Field name	Description
      Name	The name of your Inventory. Free text.
      Inventory Source	Users can choose between a Site or App.
      Inventory Integration Type	Once the source is selected, the Integration type field will appear. Select one value from the list.  This value cannot be updated in edit mode.

       

   2. Optional fields
      
      

      Field name	Description
      Associated with Business Partner	You can choose at this point to associate a Business partner with this inventory if the Business partner has already been created & exist in the system. (For information about Business partner creation, refer to how to create a business partner).
      Max QPS	Here you can cap the Inventory's QPS. Zero or empty value means no limit.
      Max Incoming Requests (In thousands)	You can cap the Inventory incoming requests. Zero or empty value means no limit.
      A-Domain Mandatory	A switch. The default is off. When switched On: The Inventory will exclude advertiser's responses that do not contain the advertiser's domain.
      Allowed Fraud Sensitivity	Value can be set between 50% to 95%, where the higher you set the number the less sensitive the system is to fraud. The system default is 85%. You can set a default value at account level which will apply to all your inventories.
      MRAID filters	Users can exclude MRAID responses for all the Inventory traffic, or for specific bundles.

       

3. Pricing tab
   1. When entering the switch of ‘Post Bid Rev-Share’ will show the default pricing method applied at your system level. Users can override it here at the Inventory level.
      For full instructions regarding pricing methods implementation refer to Pricing.
   2. Simulator:
      You can change the inventory bid floor and use the pricing simulator to test beforehand for each method, what will be the advertiser requested price, the inventory revenue, and your profit.
   3. General bid floor:
      The value you set here will apply in all the Inventory campaigns unless a granular bid floor rule is defined.
      
      The default value is as defined at your system level (refer to the Settings module).
   4. Bid Floor Rules:
      
      1. A rule will be used based on priority and granularity.
      2. You can determine for each rule a priority, the higher the value the higher the priority will be.
         
         
      3. In case two or more floor prices are applicable Gamoshi will take the one with the highest CPM.
      4. Press the '+' icon -> A 'Create your inventory default bid floors' form will be opened.
         Fill in the form.
         The only mandatory field is the 'Bid Floor': it will be applied when the rule conditions are met.
      5. The 'Priority'  field will establish the priority of the bid floor rule in the auction.
         It ranges from 0 to 10. '0' = no priority.

      6. Press 'Create' -> a new bid floor rule is created and in an active status.

      7. Users can duplicate, pause, edit, and remove a bid floor rule at any time.
      8. You can filter your rules by App ID, bundle ID, or domain.
4. Lists
   
   In this tab, you can view the associated lists, add/remove/pause associations, and create a new list that will be associated with the Inventory partner.
   For the full instructions refer to How to create a list.
   
   
   
5. Mapping rules tab
   
   Here you can view the associated mapping rules, edit/pause/archive rules as well as update the rule's data records, and create a new mapping rule that will be associated with the Inventory.
   For the full manual on how to create a mapping rule refer to How to create a mapping rule.
   
   
   
   
6. Integration
   You can view/generate the script/VAST URL/Endpoint of the Inventory partner here and send it to your Inventory partner. 
   You can reach it also by pressing the linkable integration type column in the inventories grid.
   
   1. Open RTB 
      
      You can copy your Inventory RTB endpoint from the text window and send it to your partner.
   2. VAST
      
      Media type: Video
      Source: App or Site or CTV.
      Client/Player or Server Side.
      
      1. Select a source.
         The default macros for the selected source type will appear in the VAST URL text window.
      2. You can add/remove macros using the drop-down arrow in the text window and the 'x' next to each value.
         You can select between the SSPs: Gamoshi (default), Spring Serve & Publica, and the correct syntax for each SSP will apply.
      3. Use the copy icon to copy your VAST URL.
   3. Header Bidding
      
      
      1. Server header bidding
         
         Media type = Video, Banner
         
         This integration type is for Inventory to implement a prebid server adapter and needs to configure the Gamoshi server and the Inventory partner ID.
      2. Client Header bidding
         
         Media type = Video, Banner
         
         1. Refer your Inventory partner to the prebid.js site →  download section (http://prebid.org/download.html), in order to download the Gamoshi adapter or, if you have an alias adapter, to download your adapter.
         2. The only configuration needed from the publisher is inserting his Inventory partner id in Gamoshi, which you need to provide him with (Can be found in the Inventory module ->   ID column in the inventories grid).
      3. Mobile header bidding
         
         Media type = Video, Banner
         
         You need to ask your publisher which mediation layer he is using and request accordingly instructions from the Gamoshi support team.
         For the relevant info in Prebid refer to https://docs.prebid.org/prebid-mobile/download.html
         
   4. Script
      
      The Script integration type is for Inventory partners using javascript on-site or on an ad server.
      Media type= Video or Banner
      Source = App or Site as defined in the Inventory form/General tab
      1. Choose the Inventory source type (App/Site).
      2. Select the ad type.
      3. Choose ‘Target Type’: ‘Ad server’ or ‘Web Page/Client’ and press 'Apply'.
      4. Use the copy icon to copy the script.
      5. How to inject the Passback function into a script
         
         1. Add the list in the ‘ADS_txt_file.txt’ file to the ADS.txt file on your site.
         2. Implement the script in your DFP or ad server.

Script's examples

Example for Gamoshi Script ( with no passback ):

<script type="application/javascript">
window.$gambid = {
"rtb": "https://rtb.gamoshi.io/r/1162/bidr",
"bidParams":
{
"adtype" : "banner",
"adh" : 250,
"adw" : 300,
"bidfloor" : 0.01
}
};
</script>
<script type="text/javascript" src="https://static.gambid.io/tag/latest"></script>

Example for Gamoshi Script with Passback function (JavaScript):

<script type="application/javascript">
window.$gambid = {
"rtb": "https://rtb.gamoshi.io/r/1162/bidr",
"bidParams": {
"adType": "Banner",
"adw": 300,
"adh": 250,
"bidfloor" : 0.01
},
"passbackJs": function() {
var passbackJsCode = "googletag.pubads().definePassback('/186299052/Mundo.com_New/MUNDO_NEW_PASSBACK_300x250', [300, 250]).display();";
var scriptElt = document.createElement( "script" );
scriptElt.type = "text/javascript";
scriptElt.src = "https://www.googletagservices.com/tag/js/gpt.js";
try {
scriptElt.appendChild( document.createTextNode( passbackJsCode ) );
} catch( e ) {
scriptElt.text = code;
}
document.body.appendChild( scriptElt );
}
};
</script>
<script type="text/javascript" src="https://static.gambid.io/tag/latest"></script>

Example for Gamoshi Script with Passback function (HTML):

<script type="application/javascript">
window.$gambid = {
"rtb": "https://rtb.gamoshi.io/r/1162/bidr",
"bidParams": {
"adType": "Banner",
"adw": 300,
"adh": 250,
"bidfloor" : 0.01

},
"passback": "<div class='backup'><h1>Yes! This is the backup Ad :)</h1></div><scr" + "ipt type='application/javascript'>console.info('Passback!');</scr" + "ipt>"
};
</script>
<script type="text/javascript" src="https://static.gambid.io/tag/latest"></script>

Custom Integration

When selecting App as your Inventory source, you can choose Custom/3rd party Integration as your type.
The full list of supported custom integration can be found in the table below: