Report on targeting keys

When reporting on key-value delivery for an order or line item, use targeted impression metrics, such as "Ad server targeted impressions." Otherwise, all key-values present on the matching request will be returned.

Note that key-values appear in Data Transfer reports independent of the "Reportable" setting of a key, as long as the key is added in Ad Manager. 

Jump to a section of the article:

• Reporting options
• Set up keys for reporting
• Report on keys
• View a key’s change history
• Exclude a key from reporting

Reporting options

There are three ways to report on the keys:

• Key-values dimension: Use the "Key-values" dimension to report on all keys. When you use the Key-values dimension, an overlap can occur which may be associated with multiple keys and values.
• Custom dimensions: This is a dimension category that contains frequently used predefined keys. You can select the keys you want to report on. Data is displayed in reports for custom dimensions only if the custom dimension key's predefined value was explicitly included in the request. Only impressions recorded after adding a custom dimension are included in reports that use the custom dimension. Review limits for Custom dimensions.
• Enhanced key-values: This is a dimension category that contains all key-values marked as "Add key as Enhanced key-values dimension” in a key’s settings. As with Custom dimensions, you can select the keys you want to report on in this category in your report; however, all of the allowable 200 targeting keys and 100,000 values per key can be used. Learn more about network limits.

Set up keys for reporting

Before you can report on key-values, you have to set up the keys. When you make a key reportable:

• Undefined values won't appear in reporting, even if their key is reportable. The values must be defined first.
• Reports covering dates before a key is added to reporting won't display data for the key.
• All values defined for that key are also included in reports from that time forward.

You can report on an existing key-value or a new key-value, as long as it’s set up for reporting. After you set them up for reporting, their "Reportable" status changes to "On." 

Only targeting keys marked "Reportable" are available for inclusion in your report.

To set up a key for reporting:

1. Sign in to Google Ad Manager.
2. Click Inventory, and then Key-values. 
3. Create a new key-value, or click an existing key-value.
   Learn more about creating key-values.
4. Under "Settings," locate the reporting section.
5. Select an option for key-value reporting:
   • To make Enhanced key-values reportable, next to "Add key as Enhanced key-values dimension," check the box. Note that this option is only applicable to networks with Enhanced key-values enabled. When Enhanced key-values are enabled for the network, all keys are included by default. Selecting this option does not impact the inclusion of the key as a “Key-values” dimension or "Custom" dimension.
     Note: By default, your key-values are reported as Enhanced key-values. To remove key-values, in your key value configuration, uncheck the box for "Add key as Enhanced key-value dimension."
   • To make the "Key-values" dimension reportable, next to "Additional reporting options," click and select Include values in the Key-values dimension. 
   • To make Custom dimensions reportable, next to "Additional reporting options," click  and select Include values in the Key-values dimension & add key as custom dimension.
6. Make your other selections to set up the key-value and click Save.
   On the "Key-values" page, the "Reportable" column shows "On" if the key is enabled for reporting. Reportable custom dimensions are indicated as "Custom dimension."  

Report on keys

1. Sign in to Google Ad Manager.
2. Click Reporting and then Interactive reports.  
3. Create a new report or open an existing report. 
   Learn more about creating a report.
4. Choose an option:
   • To report on the "Key-values" dimension, click Select dimensions and metrics, then select Key-values from the menu.
     
   • To report on "Enhanced key-value dimensions," click View all, then Dimensions, and then select keys under the  "Enhanced key-value dimensions" category.
   • To report on "Custom dimensions," click View all, then Dimensions, and then select keys under the "Custom dimensions" category.

View a key’s change history

You can check when a key was set to be custom, reportable, or not reportable.

To view change history:

1. Sign in to Google Ad Manager..
2. Click Inventory, and then Key-values.
3. Click the name of a key.
4. In the top-right corner, click .

Exclude a key from reporting

1. Sign in to Google Ad Manager.
2. Click Inventory, and then Key-values. 
3. Click the name of a key.
4. Next to "Add key as Enhanced key-values dimension," uncheck the box
   This option is only applicable to networks with Enhanced key-values enabled.
5. Under "Additional reporting options," select Do not include values in the Key-values dimension.
6. Click Save.
   On the "Key-values" page, the value in the "Reportable" column changes to "Off."

Related article

• Access Premium reporting