Bulk management

Last edited: 2025/04/29

Bulk management allows you to quickly change or add inventory in Yieldbird Platform by editing ad unit properties in an .xlsx file.

Most common use cases are:

• Adding a new domain and defining multiple ad units at once
• Adding new bidders and defining their bid parameters across multiple ad units
• Enabling or disabling Yieldbird modules on multiple ad units at once

How to use Bulk Management?

<aside> <img src="/icons/arrow-right_green.svg" alt="/icons/arrow-right_green.svg" width="40px" /> Good practice: We recommend the following flow for using Bulk Management:

1. First, fully configure at least one ad unit on your Domain directly in the Yieldbird Platform.

2. Download the .xlsx file (Download option)

3. Open the file with a program like Microsoft Excel

4. Add new ad units by adding new rows in the .xlsx file or modify the parameters in particular columns

   Always use the exact taxonomy as in the first line to ensure the inventory is configured as desired.

5. Save the .xlsx file on your computer

6. Upload the new .xlsx file to the Platform

This flow makes it much easier to follow the correct taxonomy for parameters that can be changed in Bulk Management.

</aside>

Rules for Making Changes to Inventory Setup via Bulk Management

• If a column (e.g., Media type) is included in the headers but contains only empty fields in the spreadsheet, the script will ignore it. The exception is ignore_viewport_attributes, which must always be filled in (default value: true).
• All fields that handle data structures such as arrays or hashes (e.g., certain bid parameters) must be defined in JSON format.
• Uploading a spreadsheet with empty rows (gaps) will not disrupt functionality, but it may affect validation error reporting (e.g., reported row numbers may be incorrect).

Data Validation Process

All data imported into the Yieldbird Platform via Bulk Upload is validated to ensure it complies with the required formatting and allowed values. If validation errors are found, the entire upload (import) process stops, and an error message specifying the faulty rows is displayed.

How to access Bulk Management

Go to Inventory > Domains > edit the domain > General: Bulk Management

On this page: