This article describes bulk bid modifiers. Bulk bid modifiers are a type of bid modifiers that let upload a bulk file where you specify many different modifications to the bid based on many different values of the same tag.

Bid Modifiers  

Bid modifiers are rules you set up in a real-time bidding (RTB) campaign to modify bids based on tag values before you pass the bid on. You can set up bid modifiers to add, subtract, multiply, or override the bid based on the value in a tag. You can also reject bids based on a tag value.

For example, you can create a bid modifier to add $2 to a bid if the inboundNumber:state field contains California. Meanwhile, you can create another bid modifier to reject the bid if it is missing the zip code:Zip code tag. 

You set up bid modifiers on the Real Time Bidding tab of a campaign that has real-time bidding enabled. The Bid Modifiers section contains a table where you create a row for each bid modifier you want to create. The Bid Modifiers table can contain no more than 100 rows.

Bulk Bid Modifiers

Bulk RTB bid modifiers are for a special case: when a single tag can have many different value and you want to modify the bid in different ways depending on the value. A very common reason to use bulk bid modifiers is to upload a list of modifications based on different ZIP Codes.

To create a bulk bid modifier, you set up a rule in the Bid Modifiers table. You choose the tag you want to evaluate in the Tag field and you choose Bulk as the Logic. A new field appears where you upload a TXT or CSV file. Each row in the file contains instructions for how to modify the bid based on the different values of the tag.  

The file lists all the tag values and all the bid modifications you want based on those values. There is no limit to how many rows you can include in the file, but when you upload it, it takes only a single row in the Bid Modifiers table. 

Bulk Bid Modifier File Requirements

The file you upload must meet requirements for Ringba to process the information and modify the bid based on the content. 

• The file must be TXT or CSV format.
• Each row in the file must represents a tag value that triggers the modification
• If you want to modify the bid based on the tag value, the row must contain a dollar value to modify the bid by
• Each row should contain the operation you want to use to adjust the bid. You can choose Add, Subtract, Multiply, Override, or Reject. If the row contains a dollar value but not an operation, Ringba assumes the operation is Add.  

For example, an uploaded file contains the following lines:

insured,10,Add
uninsured,5,Subtract
unknown

The system interprets this to mean it should add 10 to the base value if the tag value is insured and should add 5 to the base value if the tag value is uninsured. If the value is unknown, Ringba does not modify the bid amount.

Creating Bulk RTB Bid Modifiers

Note: You need to create your bulk modifier file before you complete these steps.

Use the following steps to create bulk RTB bid modifiers:

1. Open an RTB campaign and select the Real Time Bidding tab. Scroll down to the last section, Bid Modifiers.
2. Click the Add New Modifier button to show the fields to create a new row. 
3. In the Tag field, enter the name of the tag you want to modify.
   Tip: You can use the Token button to see a list of existing tags in your account.
4. In the Logic field, choose Bulk from the drop-down menu. Click it and another field appears, asking for the file to upload.
   
5. Click the upload button next to the field and navigate to the bulk modifier file you want to use. Select the file that contains your bulk logic. 

6. Since the file does the work of indicating what the system should do for each potential tag value, it doesn't matter what value you choose for the Operation or what value you add to the Value field. Therefore, you can just add any logic and amount for the Value field.