DSP How to
      Back to home
      1. Help Center
      2. DSP account
      3. DSP How to

      How to create an Inventory (DSP)

      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. 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.

      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.
      1. 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  Zero or empty value means no limit.
          Max Incoming Requests (In thousands) Zero or empty value means no limit.
          A-Domain Mandatory A switch. Default: off.
          Excluding advertiser responses that do not contain advertiser domain
          MRAID filters Default: Off.
          Users can exclude MRAID responses for all the Inventory traffic, or for specific bundles.

           

      2. Pricing tab
        1. 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.
      3. 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.
      4. 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.

      1. When placing the script in an ad server make sure to replace the macros with the ad server macros in the bidParams section.

      2. If you are using static values replace the bidParams values with the static values.
      3. If you have a few placements, duplicate the script for each placement and put the relevant values.

      4. In order to add a placement id when the target type is site remove the comment from the javascript in the placement id section and replace the id with the relevant placement id.

      5. In order to add a passback remove the comment from the javascript in the passback section and place your passback.

       

       

      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:

      Custom Integration name Required parameter
      Amazon TAM Inventory Id On Amazon TAM
      Google Open Bidding Inventory Id On Google Open bidding
      Iron Source None
      Pubmatic SDK None
      BidSwitch Your Seat Id On BidSwitch