Configure Source Bidding

Configure source bidding in Unity Ads

Read time 2 minutes

Last updated 22 days ago

To start using source bids from the Unity Ads User Acquisition dashboard:

From the Apps page, select the app that has the campaign that you want to modify. The Campaigns page for this app appears.
Select the campaign you want to modify, or create a new campaign.
Scroll to the Source bids section, then select Export template.
After exporting the template, populate the spreadsheet as described in the next section.
Return to the Source bids section of the campaign menu, then select Import to upload your modified spreadsheet.

Important

The

source_app_ID

is an alphanumeric, case-sensitive, 12-character string.

Once you have successfully imported your configuration, the Source bids section displays a list view of the countries you are targeting, and the bid amounts imported from your spreadsheet. A green icon indicates that Source Bidding is enabled and active. Select Clear all to clear any imported bids and disable Source Bidding for the campaign. Alternatively, you can pause or stop the campaign.

Note

If this section remains disabled after uploading your spreadsheet, refer to the Errors section below. If you have several sources to update across campaigns, you can use the bulk campaign management tool.

Source bid templates

To specify your source bids, open the exported template and populate the fields according to the following guidelines:

Column	Description	Example values
`Country code`	The two-letter (Alpha 2) ISO country code representing the source's geographic location. Note: Using three-letter country codes causes an error.	`US` `CA` `KR`
`Source ID`	The Unity Ads identifier for the source app, the `source_app_id` . Note: This is a 12-character, alphanumeric, case-sensitive value.	`9g74cAw7WM1L`
`Bid`	The amount you are willing to spend in U.S. currency. This field supports up to three decimal places.	`5` `5.1` `5.12` `5.123`

Important

Ensure you save the template as an XLSX file.

Note

If you've already entered standard bids in the Countries & Bids section, those bids act as default bids for any sources that aren't explicitly defined in your spreadsheet. You can also run a campaign that consists of source bids only.

Errors

The Source bids section of the campaign menu details a Any errors when importing your spreadsheet. Some examples of potential errors include:

Missing column headers
Blank values
Incorrect values (such as three-character country codes, or bids with the wrong number of decimal places)
Unpopulated fields from a row
Mismatch in format. For example,
```
source_app_ID
```
is a 12-character alphanumeric case-sensitive string.

If there are multiple errors, a detailed explanation of all errors appears:

The dashboard warning and details for Source Bidding errors.

Fix the issues in your spreadsheet, and re-import the file.

Updating source bids

To update source bids, revise your spreadsheet and re-import it. As a validation check, your previous bids appear crossed out for you to preview. For additional validation, an alert appears if a bid changes by a substantial amount.

App targeting and Source Bidding

Allowlisting and Source Bidding are separate campaign targeting tactics. You must clear any allowlisted apps from a campaign in order to use source bids in that campaign. You can still use app blocking (blocklisting) in tandem with Source Bidding.

Documentation

Development

User Acquisition

Monetization

Industry

Documentation

Development

User Acquisition

Monetization

Industry

Unity Ads User Acquisition

Advertising Management API

Advertising Statistics API

Unity Ads User Acquisition

Configure Source Bidding

Source bid templates

Column

Description

Example values

Errors

Updating source bids

App targeting and Source Bidding