ePublishing Knowledge BaseContinuumAdvertising(GAM) Google Ads Manager - Key-value Ads Targeting Implementation

(GAM) Google Ads Manager - Key-value Ads Targeting Implementation

Why Key Value Targeting?

Setting your site up with the ability to deliver specific ads is a powerful tool. Using Key-value targeting is a sophisticated tool to directly control which ads are delivered on specific pages, such as a topic page. 

Standard Key-values Supported for Targeting

  • id - This allows targeting on page id (Example: /articles/id-seo-friendly-url = id). 
  • keyword -  This allows targeting based on keywords assigned to content (Example: /keywords/food = food). 
  • page_name - This allows targeting based on the the page name which is the end of the URL. (Example: https://demo.epublishing.com/topics/144-career-advice would have a page_name value of “114-career-advice”).
  • page_type - This allows targeting based on the type of interior page such as a topic landing page, articles, or gallery.
  • reg_user (true or false) -  This allows targeting based on whether or not a user is logged in.
  • search_terms - This allows targeting based on search terms and is typically only populated on search results pages.
  • tags - This allows targeting based on tags (taxonomy tags).
  • taxonomy - This allows targeting based on taxonomy name (value is typically identical to tags). 
  • taxonomy_id - This allows targeting based on the taxonomy id (Example: /topics/114-career-advice = 114). 
  • url - This allows targeting based on the URL.

GAM (Google Ads Manager) the Initial Setup of Key-values:

Go to https://admanager.google.com  with login credentials for your site.

Follow the steps below:

  1. Click Inventory in the left side bar menu:
  1. Click Key-values to access the Key-values screen. 
  1. Click the New Key button on the Key-values screen. 

Enter Key-value* information based on the parameters necessary for that Key-value, then click the Save button.

Example: url has the following parameters:

  1. Name = url
  2. Display name = url
  3. Value type = Predefined
  4. Report on values = Include values in reporting

Note: Click the ‘New Values’ button to add a new value, a pop-out window will open where you can enter your new value, in this example we use /topics/114. Be sure to click Save when you are done.

In order for targeting to work, you can only setup the key-values listed at top of this KB article. 

For Google Ads Manager - Line Item Targeting

Once your desired Key-values are set up you can use them to deliver ads via Line Items.

Select the Line items option under the Delivery Menu

Click the Line Item link from the list of ‘Line Items’ you have previously created (Example: Feb 2019 Targeting Demo)

Once you have the Line Item open that you want to update with Key-value targeting, scroll down the page to the ‘Add targeting’ section.   Select Custom Targeting from the list of targeting options then expand the section by clicking the drop down arrow. 

Click the ‘Select’ drop down 

Select the Key-value you wish to use (Example: url)

Select the relationship type (Example: is any of)

Select the value its desired value (Example: /topics/143-hr-strategies). 

Be sure to click the Save button to save your changes.

Note: Your new Key-value will appear when it is saved properly (Example Above: url (url) is any of  /topics/143-hr-strategies).

To make your Ads to appear exclusively in one Line Item and NOT others, you will need to add the opposing expression to the remaining Line Items in your order.

Under Add Targeting section for ALL other Line Items, go to Custom Targeting

Add the opposite expression (is none of) click Save (Example: url (url) is not /topics/143-hr-strategies)

Be sure that your Ad Units and Orders are set up appropriately, a Knowledge Base article on how to do that is here.

Important Note: Find the key-values for a given page on your site by using your browsers Development Tools ‘Inspect Element’ or ‘Inspect’ Option and going to the ‘Console’ Tab.

You simply go to the page you want to see the key-values for, right click and select Inspect. Then click on the 'Console' tab. 

Firefox Example:

Chrome Example: