Create an ad unit
In DFP, the ad unit is the basic unit of inventory. You can group one or more ad slots as an ad unit, which is one block of inventory that can be targeted by line items.
This article covers how to:
New ad units must received traffic on your site for at least 28 days before inventory forecasts are optimized.
- In the "Ad units" section of the Inventory tab, click New ad unit.
- Enter a Code to identify the ad unit in Google Publisher Tags. Once created, the ad unit code cannot be edited so define a code that is easy to identify. For example,
Leaderboard_BTF.Ad unit codes can be up to 100 characters in length and are not case-sensitive.
Only letters, numbers, underscores, hyphens, periods, asterisks, forward slashes, backslashes, exclamations, left angle brackets, right angle brackets, colons and parentheses are allowed.
- Enter a Name for the ad unit, used in targeting and reports. You can change the name at any time. As with the code, publishers typically use naming conventions that give information about the ad unit's location and size.
- Enter a description for the ad unit, if needed, up to 4,000 characters in length.
- Set the Sizes to be associated with this ad unit to help DFP filter the list of ad units for traffickers.
To add a new ad unit size to your network, simply create a new ad unit and give it the new size, or set the new size for an existing ad unit.
- Select Fixed size to define a list of sizes for creatives you expect this ad unit to serve. Include the Out-of-page size for creatives that don’t fit in a traditional banner space or browser window, including pop-ups, floating line items, and interstitials.
- Select Smart Banner if the ad unit is for a mobile app and you want the ad unit to have a fixed height but fill the width of the screen. Learn more
- Define a target window, which sets the target attribute of the ad's click-through link to tell the browser where to open the ad's landing page.
This selection follows the default target window set in the "Network settings" section of the Inventory tab. If the ad unit is in an app, the target window is ignored. For Android and iOS apps, ads load in a new, unnamed browser window.
- _top: The landing page will load in the full body of the window, breaking out of any framesets.
- _blank: The landing page will open in a new, unnamed window.
- Add optional features and settings to the ad unit as needed.
Placements: Click include next to one or more placement names to associate your new ad unit.
AdSense inventory settings: If AdSense is enabled to compete for this inventory, DFP displays "Enabled." Click the "override" link to choose your own AdSense properties or continue using your network's default AdSense inventory settings.
Ad unit frequency caps: Click Add a labeling rule to limit the number of impressions displayed to users for creatives that share the defined labels. Learn more
Refresh rate: For mobile app inventory, set a refresh rate to determine how often a new ad impression is generated. If you select Refresh rate in seconds, DFP will auto-populate a value of 60, which you can change to 30 - 120 seconds. Learn more
You can create multiple ad units at one time by uploading a CSV file into DoubleClick for Publishers. If you need to update existing ad units or create more than 1,000 ad units at one time, use the DFP API.
- In the "Ad units" section of the Inventory tab, click Bulk upload new ad units.
- 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 tables below. When you're done, save the CSV file using your file editor.
The sample CSV file contains fields and examples relevant to your network. Don't change the column order or the column headings. Any rows that begin with the pound (#) character are ignored when you upload the file.
Remove semicolon (;) from your file editor's list of delimiter or separator characters to ensure the sample file renders columns and values correctly.
- Click Choose File to find the CSV file you saved in step 2.
- 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.
- Click Confirm upload to create all of the ad units from your CSV file.
Columns in the sample CSV file
The values for each column must follow the same formatting rules as when you create a single ad unit. The "#Code" and "Name" columns are required, but all other values are optional. Refer to the previous section for the definitions of each ad unit setting.
Ad unit code.
Ad unit name.
List of ad unit sizes, in pixels, entered in
Use a standard AdSense ad unit size to enable an ad unit for AdSense. Otherwise, any size is acceptable.
|Description||Free-form ad unit description.|
List of placement names to be associated with this an ad unit, separated by semicolon. If a placement name does not currently exist in your network, DFP will automatically create a new placement and associate your ad unit.
The target window setting for an ad unit. Acceptable values include:
List of label IDs to be associated with this an ad unit, separated by semicolon.
|Enabled for AdSense||
Use hexidecimal (six-character) color code, without a pound sign.
The types of AdSense allowed, separated by comma. Acceptable values include:
To download a list of all ad units, click Download ad units in the "Ad units" section of the Inventory tab.