Create new marketplaces and deals

  1. Open Programmatic from the menu (Programmatic icon).
  2. Click New Marketplace.

    A new page opens up:

    Private Marketplace creation page 1
  3. Fill in the following fields:
    1. Name: enter the name of the marketplace.
    2. Notes (optional): add a description of your marketplace which is visible to the buyers.
  4. Click Create Marketplace.

    This creates the marketplace and takes you to the Marketplace details page to fill in more information and add deals to the marketplace. You can also edit any entered information.

    Private Marketplace creation page 2
    Note: The deal ID and deal terms set in the following steps need to be communicated to the buyers so they can accurately match that in their demand side platform and successfully target a specific private marketplace.
  5. Transparency level: click to select transparency level. This setting dictates how a buyer sees your domain. You get three options, listed from most recommended to least recommended. Select one and click Save.
    1. Full (default): both the domain and page URL are fully transparent, meaning they are sent in full to each buyer in the bidding process.
    2. Semi: specify the domain and page URL as you would like them to appear in the bidding process.
    3. None: the domain and page URL are not sent in the bid request and buyers are not able to see this information.
    Note: We recommend using full transparency as many buyers bid and pay top CPMs only for fully transparent inventory.
  6. Advertiser domain blacklist: enter an advertiser domain you wish to block for this marketplace and click Add or press 'Enter'.

    The domain name appears below the input field. To add another domain, repeat the step.

    You can delete a domain by clicking X. When you add all desired domains, click Save.

    Note:

    Subdomains are also matched.

    • If you block example.com, then www.example.com and www.another.example.com are also blocked, however www.anotherexample.com is not affected.
    • If you block www.example.com but you allow example.com, the www.example.com domain is considered allowed.
    Attention:

    Whitelist settings on deal level (see step 9, substep j) always override blacklist settings on marketplace level.

    • If an advertiser domain is both blocked on marketplace level and allowed on deal level, it means the domain is allowed (whitelisted).
    • If the deal whitelist is not empty, all other advertiser domains are blocked regardless of what is included in the marketplace blacklist.
  7. Supported player APIs: select the corresponding boxes to inform the buyers if VPAID 1.0 or VPAID 2.0 is supported, and click Save. If neither is selected, this informs the buyers that VPAID is not supported.
  8. Click New Deal.

    A new window slides open. The same options are available when creating and updating deals.

    Deal creation page
  9. Fill in the following fields:
    1. Deal name: enter the name of the deal.
    2. Deal ID: use the automatically generated Deal ID, click Generate new, or create a Deal ID for this connection. You can also use the Deal ID generated by the buyer.
      Note: If you are creating the Deal ID, you need to send it to the buyer, in order for them to see and get your inventory.
    3. Auction type: choose the type of deal. You get two options:
      1. 2nd price: a deal with a floor price.
      2. Fixed price: a deal with a pre-negotiated price.

      The remaining procedure is the same for both types.

    4. Seat (Buyer)/DSP: this field provides a list of all the buyers you are connected to. Start typing and a list of search results appears. Choose the desired Seat (Buyer)/DSP from the list. You see the buyer name together with the DSP used for the connection, as shown below.

      Seat (Buyer)/DSP search results

      • Multiple buyers (seats) behind DSP: this means you select all buyers (seats) behind this DSP
      • One buyer (seat) behind DSP: this means you select only one buyer (seat) behind this DSP
      Note:
      • If the desired Seat (Buyer)/DSP is not shown in the list, contact your Account Manager to request and provide the Buyer name, DSP the buyer uses, and the Buyer's Seat ID within the DSP.
      • Xandr Invest does not support having multiple individual buyers behind their DSP. You can only add one buyer behind Xandr Invest for each deal you create or update, however it can be combined with other Seat (Buyer)/DSPs.
    5. Pricing rules: click Create new rule.

      You see the following:

      Pricing rules
    6. Select ad formats: you can add pricing rules for individual ad formats, or you can select multiple ad formats.
    7. Enter the price: fixed price or price floor, depending on the type of deal.
      • Enter the CPM value.
      • Select the corresponding currency so it matches the currency used by the buyer.
      Note:
      • Xandr Invest does not support different price per ad format when creating deals with a buyer behind their DSP. The price needs to be the same for all desired ad formats.
      • Xandr Invest does not support editing pricing rules when updating saved deals with a buyer behind their DSP. To change the pricing rules, you need to delete the incorrect deal and create a new deal with a different (unique) deal ID, which you need to communicate to the buyer.
    8. Creative Duration (optional): enter the Minimum and Maximum duration of the creative in seconds. You must either specify both the minimum and maximum duration or just the maximum duration. By default, the minimum duration is zero seconds and the maximum duration is 60 seconds. If you do not specify the creative duration, the default values are passed in the bid request.
      Note: If there are two or more deals in a marketplace with the same buyer but different creative durations for a specific format type, then the most restrictive settings apply, meaning that the shortest minimum duration and longest maximum duration for a specific format type are sent in the bid request.
    9. Click Add to finish adding the pricing rule.

      After adding a pricing rule, you can delete it by clicking X.

    10. Whitelist advertiser domains: enter an advertiser domain you wish to allow for this deal and click Add or press 'Enter'.

      The domain name appears below the input field. To add another domain, repeat the step.

      You can delete a domain by clicking X.

      Note:

      Subdomains are also matched.

      • If you block example.com, then www.example.com and www.another.example.com are also blocked, however www.anotherexample.com is not affected.
      • If you block www.example.com but you allow example.com, the www.example.com domain is considered allowed.
      Attention:

      Whitelist settings on deal level always override blacklist settings on marketplace level (see step 6).

      • If an advertiser domain is both blocked on marketplace level and allowed on deal level, it means the domain is allowed (whitelisted).
      • If the deal whitelist is not empty, all other advertiser domains are blocked regardless of what is included in the marketplace blacklist.
  10. When you finish configuring the deal, click Create deal. The deal is active by default, but since the newly created marketplace is not active by default, the deal is still not visible to buyers.
    Note: In case some deals in a marketplace should not be active for a certain period of time, or you have recurring deals with certain buyers, you can pause and resume those deals accordingly.

Result

When you finish adding deals, you see an overview of all the deals in the marketplace with information about the deal type, deal status (active or paused), buyers, ad formats, and price. In the upper right corner you can change the marketplace status from Draft to Active, as shown below. Changing the status of the marketplace to active makes the active deals from the marketplace visible to selected buyers.

Activate marketplace

Next steps

  • When you finish creating a marketplace, follow the instructions in Create a campaign to create your programmatic campaign, goal, and RTB ad.
  • The set deal ID and deal terms need to be communicated to the buyers so they can accurately match that in their demand side platform and successfully target a specific private marketplace.
  • You need to resume any paused deals in an active marketplace when you want to make them visible to buyers.
  • The Marketplace details page allows you to edit your marketplace and manage all the deals in the marketplace. The same options are available as when creating marketplaces and deals. When editing deals connected to Xandr Invest, keep the following restrictions in mind:
    • Xandr Invest does not support having multiple individual buyers behind their DSP. You can only add one buyer behind Xandr Invest for each deal you create or update, however it can be combined with other Seat (Buyer)/DSPs.
    • Xandr Invest does not support editing pricing rules when updating saved deals with a buyer behind their DSP. To change the pricing rules, you need to delete the incorrect deal and create a new deal with a different (unique) deal ID, which you need to communicate to the buyer.