How do I set up the Admiral Key-Value pair in my Google Ad Manager account?

In order to give publishers deeper insight into recovered revenue, we set a key/value pair that can be queried in GAM.

Using an Acceptable Ads vendor? You will need to implement this report as well. 

About the admiral-engaged key-value

Revenue and impressions with the admiral-engaged key set have been recovered via the Engage product. To generate impressions with the admiral-engaged key/value set, a visitor must have seen the Admiral Engage with an active adblocker and subsequently disable their adblocker within 30 days.

If the Admiral script installed on your property does not contain "-engaged" you'll need to replace it with the install script that is in your property's Install tab. 

Not sure? Email and we'll be happy to help.

How to set up in Google Ad Manager with Custom Dimensions

  1. Under Inventory >> Key-values, click New key-value.
  2. Configure the Settings as such:
    Name: admiral-engaged
    Display Name: Admiral Recovered Impression
    Type: Predefined
    Reporting: Include values in reporting & add key as custom dimension
  3. In the Targeting Values section, click New values. Use true as the targeting value.
    Screenshot 2023-12-12 at 1.00.39 PM
    Screenshot of configuration settings

  4. Save. The KVP is now available to be used in reporting.

admiral-engaged key-value pair configured in Google Ad ManagerScreenshot of successfully configured key-value

Additional documentation on how to set up KVPs in GAM can be found here:

Admiral takes care of adding the KVPs to your ad calls, so you can ignore that portion of Google's documentation.

Once this configuration is complete, future data will be queryable by adding this custom criteria filter to your queries:

Screenshot 2024-01-30 at 10.39.54 PM

Screenshot of custom criteria filter

Creating the Admiral Key-Value Report

  1. Log into your Google Ad Manager account.
  2. Click Reporting >> Reports >> New report
  3. Use the below information to configure the report:
    Report type: Historical
    Report Name: Admiral Recovered Impressions
    Date Range: Dynamic, Last Month
    Table Structure: Flat
    Filters: Add your admiral-engaged custom dimension here.
    Screenshot 2023-12-12 at 1.15.31 PM

  4. Set the following for the report Dimensions:
    Ad unit (Top level)
    Admiral Recovered Impression custom dimension
    Screenshot 2024-01-30 at 10.41.59 PM
    Screenshot of Dimensions
  5. Under Metrics, select the following:
    1. Total impressions
    2. Total CPM and CPC Revenue
    3. Total average eCPM
  6. Under Scheduling and permissions
    1. Generate report
      1. Run report: Monthly
      2. Starts on: first day of the following month
      3. Click Apply
  7. Schedule report to send monthly to
  8. Click Save.

Frequency Asked Questions?

Q. Can I set the Admiral KV up as a Custom Dimension?

Yes, the KV needs to be setup as a Custom Dimension.

Q. I'm using an Acceptable Ads vendor. Will my report be accurate? 

To exclude Acceptable Ads, you will need to implement this report as well. 


Something missing from this article? Email and our team can provide additional help.