Manage PSP configurations in bulk

Bulk upload allows a user to manage multiple configurations via bulk template rather than creating configurations individually in the UI.

Create new PSP configurations in bulk

Follow these steps to create new PSP configurations in bulk:

  1. In the Monetize UI, go to the Publishers menu and click Prebid Server Premium. This loads the default Demand Partner Configurations.
  2. In the left navigation pane, click Bulk Upload New Configurations.

Configuration filters

You can also include these optional configuration settings:

Options Settings
Operating System (OS) To set the OS for your configuration click in the Search OS text field and select an OS, or type in the field to see filtered options. This will ensure the PSP configuration is utilized (PSP demand partners are sent ad requests) only when Microsoft Advertising detects the corresponding OS from the user's device in the auction. For more information, see the Operating System-Families API Service.
Ad Size Selection To specify which ad sizes will be allowed for this configuration, click in the Ad Size Selection field and select some ad sizes, or type in the field to see filtered options. This will ensure the PSP configuration is utilized (PSP demand partners are sent ad requests) only when the auction includes one of the selected ad sizes. The Ad Size Selection menu includes all standard sizes as well as any custom sizes saved to your member seat.
Follow these steps to add new custom sizes:
- Select Network > Tools > General from the top menu. This will display the Tools: General page.
- Select Custom Sizes from the horizontal sub-menu.
- Click the New custom size button. This will display the Custom Size Details popover.
- Enter values for Width and Height text fields and click the check box if you want to make this a standard size.
- Click the Save button.

If these optional settings are left blank, then any auction for the selected Placement/Placement Group/Publisher ID will trigger the corresponding PSP configuration to be used in the auction and enable PSP to call the associated Demand Partners.

Add a demand partner

  1. Type to search or select a demand partner from the Select a Demand Partner drop down.

    Note

    Follow below tips if you do not see the Demand Partner you wish to add in the drop down list:

    • Ensure that you have the proper media type selected above.
    • If the media type is set properly, ensure you have added the Demand Partner in the Global Settings page under Demand Partners, as described in Add or Edit a Demand Partner.
    • Check that the partner shows up as Enabled in that list. You can view a full list of available Demand Partners at Prebid.
  2. Once you select a Demand Partner from the dropdown, new input fields will appear representing the parameters, both required and optional, that each demand partner's adapter accepts.

    1. Required parameters will automatically be checked and cannot be excluded from the spreadsheet.
    2. Required parameters that stipulate that "one of" a set of values is required will note "Select at least one of...".
    3. Check boxes will also be displayed by optional parameters. If the check box is checked, then the parameter will be included in the spreadsheet.
  3. To add additional Demand Partners, click the Add a Demand Partner button.

  4. Click Download Bulk Spreadsheet.

  5. Enter the number of data rows. These represent the number of configurations to Monetize entities (placements, placement groups, publishers) you will map to external demand partners.

  6. Optionally, rename the file.

  7. Click Download.

Populate template

  1. Open the template and populate each row, representing one configuration, with the information requested for each column.

  2. Configuration Mapping Object ID is the ID of the placement, placement group, or publisher to be mapped to the demand partner in each row. Each mapping object ID can only be associated with one PSP configuration.

  3. Each demand partner and its selected (required + any optional chosen) parameters are represented as an additional section of columns to the right.

  4. Each demand partner and its parameter columns can only appear once per row. Additional values for the same demand partner must be applied on a separate row which represents a separate PSP configuration.

    Warning

    Do not edit any of the pre-populated cells except for the "data.demand_partner_config_params[X].enabled", which toggles the partner as active or inactive within that configuration (row).

  5. Save changes to the template.

Send template

Submit the completed template to your Microsoft Advertising account team for processing unless otherwise instructed.

Add demand partners to existing configurations in bulk

Follow these steps to add demand partners to PSP configurations in bulk:

  1. In the Monetize UI, go to the Publishers menu and click Prebid Server Premium. This loads the default Demand Partner Configurations screen.

  2. Use the multi-select check boxes to select the configurations to which you would like to add the demand partner.

    Note

    The partner must be new to all of the configurations selected. If the demand partner is already included in any of the configurations processing of the bulk template will fail.

  3. Select the Actions menu > Bulk Add Demand Partner to Configurations.

Configuration filters

You can also include these optional configuration settings:

Options Settings
Operating System (OS) To set the OS for your configuration click in the Search OS text field and select an OS, or type in the field to see filtered options. This will ensure the PSP configuration is utilized (PSP demand partners are sent ad requests) only when Microsoft Advertising detects the corresponding OS from the user's device in the auction. For more information, see the Operating System-Families API Service.
Ad Size Selection To specify which ad sizes will be allowed for this configuration, click in the Ad Size Selection field and select some ad sizes, or type in the field to see filtered options. This will ensure the PSP configuration is utilized (PSP demand partners are sent ad requests) only when the auction includes one of the selected ad sizes. The Ad Size Selection menu includes all standard sizes as well as any custom sizes saved to your member seat.
Follow these steps to add new custom sizes:
- Select Network > Tools > General from the top menu. This will display the Tools: General page.
- Select Custom Sizes from the horizontal sub-menu.
- Click the New custom size button. This will display the Custom Size Details popover.
- Enter values for Width and Height text fields and click the check box if you want to make this a standard size.
- Click the Save button.

If these optional settings are left blank, then any auction for the selected Placement/Placement Group/Publisher ID will trigger the corresponding PSP configuration to be used in the auction and enable PSP to call the associated Demand Partners.

Add a demand partner

  1. Type to search or select a demand partner from the Select a Demand Partner drop down.

    Note

    Follow these tips if you do not see the Demand Partner you wish to add in the drop down list.

    • Ensure you have the proper media type selected above.
    • If the media type is set properly, ensure you have added the Demand Partner in the Global Settings page under Demand Partners, as described in Add or Edit a Demand Partner.
    • Check that the partner shows up as Enabled in that list. You can view a full list of available Demand Partners at Prebid.
  2. Once you select a Demand Partner from the dropdown, new input fields will appear representing the parameters, both required and optional, that each demand partner's adapter accepts.

    1. Required parameters will automatically be checked and cannot be excluded from the spreadsheet.
    2. Required parameters that stipulate that "one of" a set of values is required will note "Select at least one of...".
    3. Check boxes will also be displayed by optional parameters. If the check box is checked, then the parameter will be included in the spreadsheet.
  3. Click Download Bulk Spreadsheet.

  4. Enter the number of data rows. These represent the number of configurations to Monetize entities (placements, placement groups, publishers) you will map to the external demand partner.

  5. Optionally, rename the file.

  6. Click Download.

Populate template

  1. Open the template and populate each row, representing one configuration, with the information requested for each column.

  2. Configuration Mapping Object ID is the ID of the placement, placement group, or publisher to be mapped to the demand partner in each row. Each mapping object ID can only be associated with one PSP configuration.

  3. The demand partner and its selected (required + any optional chosen) parameters are represented as an additional section of columns to the right.

  4. Each demand partner and its parameter columns can only appear once per row. Additional values for the same demand partner must be applied on a separate row which represents a separate PSP configuration

    Warning

    Do not edit any of the pre-populated cells except for the "data.demand_partner_config_params[X].enabled, which toggle the partner as active or inactive within that configuration (row).

  5. Save changes to the template.

Send template

Submit the completed template to your Microsoft Advertising account team for processing unless otherwise instructed.

Note

The bulk template cannot yet be used to edit configuration-level details (i.e. media type, size(s), OS family(ies)) or demand partner details (which parameters to utilize or their values). Those capabilities will be added in the future, as well as self-service processing and upload of the templates.