Create ad units in bulk

Upload a spreadsheet to create multiple ad units at one time

You can create multiple ad units at one time by uploading a CSV file into Google Ad Manager. If you need to update existing ad units or create more than 1,000 ad units at one time, use the Ad Manager API.

  1. Sign in to Google Ad Manager.
  2. Navigate to Inventory and then Ad units.
  3. Click Upload Upload
  4. Click Download sample CSV file to download a file that you can use to define your ad units. Open the CSV file and make changes based on the examples and the descriptions in the table below. When you're done, save the CSV file using your file editor.
  5. Click Browse to find the CSV file you saved in step 4.
  6. Click Upload and validate to verify that the ad unit settings are correct. If you identify an issue with any of the ad units defined in your CSV file, click Back to re-upload a corrected CSV file.
  7. Click Confirm to create all of the ad units from your CSV file.
If there is a problem with your upload, a message is displayed to let you know. The "View users, roles, and teams" user role permission is required to see this detailed message.

The sample CSV file

The sample CSV file contains fields and examples relevant to your network.

  • Don't remove columns, or change the column order. Doing so results in a failed upload
  • Delete header rows from bulk upload sample CSV prior to upload. If you don't delete header rows, the upload will likely fail
  • Remove semicolon (;) from your file editor's list of delimiter or separator characters to ensure the sample file renders columns and values correctly
  • Rows that begin with the pound (#) character are ignored when you upload the file

Columns in the sample CSV file

"Target platform" and "Mobile platform" were retired in April 2016 as ad unit settings and no longer available as bulk upload criteria. Do not include these columns in your bulk upload files.

The values for each column must follow the same formatting rules as when you create a single ad unit. Refer to the Create an ad unit article for definitions of each ad unit setting.

Column Description
Code

The ad unit code, used in the tags. Only letters, numbers, underscores, hyphens, periods, asterisks, forward slashes*, backslashes, exclamations, left angle brackets, colons and parentheses are allowed. Maximum length: 100 characters.

Top-level ad unit: For a top-level ad unit, use the code name.
Example: News_International_BoxATF

Hierarchical ad unit: For ad units that are part of an inventory hierarchy, the full path of the ad unit is required.
Example: NewsApp/Sports/Cricket_320x50

* Note: The forward slash character needs to be defined as // in the Code column of the CSV file when included as part of an individual ad unit's code.

Name

Ad unit name.

Example: International News Section (Box Above the Fold)

Sizes

List of ad unit sizes, in pixels, entered in WIDTHxHEIGHT format, separated by semicolon. For "Out-of-page," use out-of-page. Other acceptable values include fluid and custom rendering. Do not enter duplicate sizes (example: 300x250;300x250).

Use a standard AdSense ad unit size to activate an ad unit for AdSense. Otherwise, any size is acceptable.

Example: 728x90;300x250;out-of-page

Description Free-form ad unit description. Maximum length: 4,000 characters.
Enable for AdSense

Use only if the publisher has inventory unit backfill.

Activate the ad unit as available to buyers via AdSense. Ad units activated are eligible to serve ads from AdSense demand. Guaranteed campaign continue to take priority over AdSense or other non-guaranteed transaction.

Enter Yes to make the ad unit eligible for AdSense demand. Enter No to make it ineligible.

Placements

List of placement names to be associated with the ad unit, separated by semicolon. If a placement name does not currently exist in your network, Ad Manager will automatically create a new placement and associate your ad unit.

Example: My first placement;All news pages

Target window

The target window setting for the ad unit. Acceptable values include: _top or _blank. If not defined, the value defaults to your network's default AdSense inventory settings.

Example: _blank

Labels

List of label IDs to be associated with the an ad unit, separated by semicolon.

Example: 14225;54848;55658

Teams

If your network uses Teams, list Team IDs to be associated with the an ad unit, separated by semicolon.

Example: 45792;84645

Special ad unit If the ad unit should be marked as a special ad unit, enter Yes, otherwise enter  No.

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Google apps
Main menu
11156890563971043565
true
Search Help Center
true
true
true
true
true
148
false
false