Unity Ads User Acquisition

Campaign Setups template reference

Review the parameters in the Campaign setups template for Bulk Campaign Management.
Read time 2 minutesLast updated 4 hours ago

After you've downloaded the Campaign Setups template, use the following reference table to populate it with data for your campaigns.

Column header

Description

Type

Notes

Campaign IDThe Campaign ID must match an existing campaign. If you leave this field empty, the bulk campaign upload tool automatically generates a new campaign with a corresponding Campaign IDstring
Campaign nameThe name of the campaignstring (max 255 characters)
Scheduling startThe date and time (UTC) for the campaign to start
YYYY-MM-DD HH:MM:SS
Scheduling endThe date and time (UTC) for the campaign to end
YYYY-MM-DD HH:MM:SS
Status
The status of the campaign. The following statuses are available:
  • live
  • paused
  • Daily capped
  • Geo capped
string
Campaign goal
The goal of the campaign. The following goals are available:
  • installs
  • retention
  • roas
string
ROAS Optimization types
The campaign's ROAS optimization type (if applicable). The following types are available:
  • iap
  • adRevenue
string
Creative pack IDsThe ID for the creative pack(s) associated with the campaign, separated by commasstringThis field is required for campaigns to go live.
Size
The targeted device size(s), separated by commas. The following sizes are available:
  • small
  • normal
  • large
  • xlarge
string
Density
The targeted device resolution(s), separated by commas. The following resolutions are available:
  • ldpi
  • mdpi
  • hdpi
  • xhdpi
  • xxhdpi
  • xxxhdpi
string
Min OSThe minimum targeted operating system versionfloat
Use
latest
to indicate the most recent supported OS.
Max OSThe maximum targeted operating system versionfloat
Use
latest
to indicate the most recent supported OS.
Connection type
The targeted device network connection(s), separated by commas. The following connections are available:
  • cellular
  • wifi
string
Limited Ad Tracking
The targeted device Limited Ad Tracking (LAT) setting(s), separated by commas. The following settings are available:
  • LAT
  • non-LAT
string
Start attribution URLThe campaign's Start attribution tracking URLstring
View attribution URLThe campaign's View attribution tracking URLstring
Click attribution URLThe campaign's Click attribution tracking URLstringThis field is required for campaigns to go live.
Blocklisted source app IDsThe blocked source app ID(s), separated by commasstring
This field is disabled if you've populated the
Allowlisted
field.. Source app IDs are case-sensitive
Allowlisted source app IDsThe allowed source app ID(s), separated by commasstring
This field is disabled if you've populated the
Blocklisted
field.. Source app IDs are case-sensitive
Budget IDThis read-only field is ignored on import.string

Add new campaigns

To upload new campaigns, leave the Campaign ID column empty (the bulk campaign upload feature automatically generates this value when you import the file). Configure the other columns by directly entering values in the appropriate cells of the spreadsheet.