Manage video content metadata

Some video features might not be enabled for your network. To learn more, contact your account manager.

Keys and values set up in your content management system (CMS) are available to map in Ad Manager after your video content is ingested. Once mapped and enabled, they are available to target as key-values or to target in content bundles. Enabled keys and their mapped values are available in reporting.

Requirements and recommendations for Ad Manager keys

  • Keys used for mapping must be set up as predefined.

  • Key-values must adhere to system limits and key-value format requirements.
  • Certain keys are blacklisted and should not be used with with Ad Manager. See list of blacklisted keys.
  • One key can map to multiple metadata keys. One key-value can map to multiple metadata key-values. However, the reverse is not possible—one metadata key can not be mapped to multiple keys.
  • For ease of reporting, use separate keys for general line item targeting and for mapped metadata targeting.
Avoid blacklisted keys

The following keys are blacklisted and should not be used with Ad Manager.

  • filesize
  • framerate
  • longdescription
  • pubdate
  • title
  • url
  • author
  • copyright
  • description
  • generator
  • published
  • type
  • updated
  • uploaded
  • videoid
  • creationdate
  • lastmodified
  • linkurl
  • broadcast_date_next
  • broadcast_date_previous
  • end_date_act
  • end_date_app
  • end_date_au
  • end_date_nsw
  • end_date_nt
  • end_date_qld
  • end_date_sa
  • end_date_tas
  • end_date_vic
  • end_date_wa
  • expiry_date
  • start_date_act
  • start_date_app
  • start_date_au
  • start_date_nsw
  • start_date_nt
  • start_date_qld
  • start_date_sa
  • start_date_tas
  • start_date_vic
  • start_date_wa
  • episode_name
  • sitecore_processed
  • episode_crid_id
  • web_content_url
  • clip_title
  • description
  • uploadedat
  • updatedat
  • width
  • height
  • size
 

To access and map your metadata as keys:

  1. Sign in to Google Ad Manager.
  2. Click Video and then Metadata.

The keys listed under the "CMS key" column are populated from your ingested video content. They are not targetable until they are mapped and enabled.

The metadata page is locked, by default. The locked view displays your enabled keys. To view all keys, edit, enable, or disable keys, change Locked to Editable.

Enable or disable a CMS key or metadata value

On the editable metadata page, enable Icon for targetable CMS key or disable Icon for non-targetable CMS key any CMS key, or click the key name to view, enable, or disable its metadata values.

CMS keys and metadata values are automatically enabled when you edit and save. If they do not adhere to key‑value format requirements, they remain disabled.

To disable a CMS key, all values need to be unmapped. To do this, click the key name, remove any items in the mapped value list, and click Save. When no values are mapped to a key, it can be disabled.

Edit and map CMS keys

When you edit a CMS key, the revised name is displayed in the Ad Manager targeting picker and in reports as a key-value. For example, if you map a CMS key from "duration" to "length", the "length" key becomes available to target as a key-value and can be reported on.

All keys must be unmapped prior to editing.

To edit an enabled CMS key:

  1. Sign in to Google Ad Manager.
  2. Click Video and then Metadata and then the pencil icon next to the key to open the "Key mapping" window.

    Disabled CMS keys need to be enabled to edit or map.

  3. Enter the name of the key and click Save. Keys are not case sensitive.

Edited CMS keys display as the original, followed by the edited in parenthesis. For example "duration (length)".

Edit and map metadata values

When you edit a metadata value, the revised value is displayed in the Ad Manager targeting picker and in reports as a key-value. For example, if you edit a metadata value from "movies" to "films", the "films" value becomes available to target as a key-value and can be reported on.

  1. Sign in to Google Ad Manager.
  2. Click Video and then Metadata and then the CMS key whose values you want to edit or enable.
  3. To edit an enabled metadata value, click the pencil icon next to the value to open the "Value mapping" window.

    Disabled values need to be enabled to edit.

  4. Type the name of the value and click Save. Values are not case sensitive.

Click Map values on page to enable all values shown at once. Since Ad Manager allows you to see up to 100 values on a single page, you can enable up to 100 values. When enabling in bulk, you may find it helpful to filter values on a page. For example, you could filter by sports, and then enable only those values.

Edited values display as the original followed by the edited in parenthesis. For example, "movies (films)".

Report on video content metadata

CMS metadata key-values need to be targeted in a line item before they can show in reporting.

You can run a report on video content metadata once you have at least one key enabled, mapped, and targeted in a line item. To get started:

  1. Sign in to Google Ad Manager.
  2. Create a report and choose the "Historical" report type.
  3. Select your dimension(s) and include at least one of the following:

    Metadata key: Displays metrics for the keys you mapped to video content. Metrics shown per key are an aggregate of all values assigned to that key. There is no limit to the number of keys displayed in a report.

    This dimension is in the process of being deprecated. If it's unavailable for your network, you should use the "CMS metadata key" dimension instead.

    Content metadata: Displays metrics for content metadata values whose keys are enabled and mapped. Each dimension under "content metadata" is a metadata key. When you choose a dimension, the report displays the metrics for all the values assigned to that key.

    This dimension is in the process of being deprecated. If it's unavailable for your network, you should use the "CMS metadata" dimension instead.

While there is no limit on available keys you can report on, there is a limit of 10 dimensions per report.

 

Learn how to map and target numeric key types.

Was this helpful?
How can we improve it?