Custom fields

Custom fields are useful if you want users to enter information that isn't available in Ad Manager by default. For example, you might want traffickers to indicate a custom category or identifier for campaigns. You can then later report against the value indicated.  Custom fields can apply to orders, line items, creatives, proposals, and proposal line items.

We'll cover the following topics:

Create and manage custom fields

Custom fields can be found under Admin and then Global settings and then Custom fields.

You'll need to decide where you want the custom field to appear and what kind of input or value the custom field takes—number, text, toggle (yes or no), or a drop-down of values you define. When active, custom fields are show under the "Settings" tab of the page where you want them to appear.

  1. Sign in to Google Ad Manager.
  2. Click Admin and then Global settings and then Custom fields.
  3. Click New custom field.
  4. Enter a name for the custom field.
  5. Choose a location for the custom field. Location is the object type where you want the custom to be shown. You can assign up to 30 custom fields to each object type..
  6. (Optional) Enter a description of the custom field.
  7. Set the access level for Ad Manager users. All of your custom fields should be set to "Editable" unless you have special cases for third-party applications.
    • Editable: Users can edit and change values
    • Read-only: Users can view but not edit field
    • Hidden: Users can't view or edit

    If you change the level of access (in other words, from editable to hidden or read-only), any values that users entered are preserved and can be viewed in reports.

    Third-party applications and read-only or hidden custom fields

    Read-only or hidden custom fields are typically set via the Ad Manager API by third-party applications. Users of these third-party applications need to created or modify objects in Ad Manager and include information that isn't available in Ad Manager by default—for example, an ID that helps identify a campaign in the third-party application. The values of these custom fields are then visible to users in the Ad Manager user interface or in reports. All custom fields can be edited through the API, regardless of the access you set.

  8. Choose the custom field type.
    • Number: The value can be any number.
    • Toggle: The value is either Yes or No.
    • Text: The value can be any text string.
    • Drop-down: The value is chosen from a set of values that you enter. You can add up to 300 values once you've created and saved the custom field.
  9. If the custom field location is "Line item," choose whether this custom field should appear in order line item listings with the the "Show in table" toggle. 

Limitation when editing custom fields

You can make changes to custom fields once they're created, with some limitations.

Item Limitation
Location and type Location and type cannot be changed once the custom field has been saved.
Drop-down custom fields

If you've created options for a drop-down custom field, you can't change the custom field to another type.

If you change a drop-down option, the change will be reflected throughout Ad Manager, including reports for dates prior to the change.

Changes to access levels If you change a custom field to read-only or hidden, any values that have previously been set are retained. If you change the custom field back to a visible access level, you'll be able to see the previously set values again.

Report on custom fields

  1. Sign in to Google Ad Manager.

  2. Create a report.

  3. In the Dimensions selector, click "Custom dimensions."

  4. Select each custom field that you want to include in the report.

  5. Save and run the report. The report results now include data on the custom fields you selected.

Filters can also be used to refine report results based on custom fields. Learn how to filter in reporting

Was this helpful?
How can we improve it?