Bulk management
Last edited: 2024/11/22
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?
- First, fully configure at least one ad unit on your Domain directly in the Yieldbird Platform.
- Download the .xlsx file (Download option)
- Open the file with a program like Microsoft Excel
- Add new ad units by adding new rows in the .xlsx file or modify the parameters in particular columns
- Save the .xlsx file on your computer
- Upload the new .xlsx file to the Platform
Always use the exact taxonomy as in the first line to ensure the inventory is configured as desired.
This flow makes it much easier to follow the correct taxonomy for parameters that can be changed in Bulk Management.
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
Old Platform:
Go to Prebid Stack > Domain > <’Download’ >/ ‘Upload' options in ad units table:
In the New Platform:
Go to Inventory > Domains > edit the domain > General: Bulk Management
