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 3 key/value pairs that can be queried in GAM.

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

Overview of Admiral’s 3 Key-Value pairs

• admiral-engaged: Revenue and impressions with this key set originated from an Ad Block Recovery engagement. Visitors with this key set saw an Admiral Engage with an active adblocker and subsequently disabled their adblocker within 30 days.
• admiral-extended: Revenue and impressions with this key set originated from an Exit Recovery engagement. Visitors with this key set saw an Admiral Engage in an elevated exit probability moment and subsequently continued consuming content within that browsing session.
• admiral-proxied: Revenue and impressions with this key set were facilitated through Admiral Proxy.

How to set up in Google Ad Manager with Custom Dimensions

In the steps below, we’ll cover the setup for the admiral-engaged KVP. Repeat the steps for each of the three KVPs listed above.

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 of configuration settings
   
   
4. Save. The KVP is now available to be used in reporting.

Screenshot of successfully configured key-value

Additional documentation on how to set up KVPs in GAM can be found here: https://support.google.com/admanager/answer/188092?hl=en

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 of custom criteria filter

Creating the Admiral Key-Value Report

In the steps below, we’ll cover the setup for the admiral-engaged KVP. Repeat the steps for each of the three KVPs listed at the top of this article.

1. Log into your Google Ad Manager account.
2. Click Reporting >> Interactive 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.
   
   
   
4. Set the following for the report Dimensions:
   Date
   Ad unit (Top level)
   Admiral Recovered Impression custom dimension
   
   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 billing@getadmiral.com
8. Click Save.

If you have any questions or would like assistance, please reach out to customerlove@getadmiral.com.

Frequency Asked Questions?

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

Yes, the KV needs to be set up 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.