Our Key Values app allows you to set specific targeting parameters for your Direct ad orders! If you are using DFP integration to connect with Ezoic and have a direct sale to an advertiser tied to a specific page or set of pages, then this is the app for you!

A key is an identifier used to extract information about the content on your page, which can be used to display content specific advertisements based on the tags present in your code. When the Ezoic systems see the tags you specify, they will output the appropriate .setTargeting() calls to target the ad slots based on your values. 

For example, if you were doing a new set of articles about the latest smartphone generation, you may want to sell the ad slots on those articles to a smartphone manufacturer. You could then use the Key/Value app to tell Ezoic which pages should display those ads, while other pages continue to use A.I to determine ad combinations based on user behaviors. So here you could have a tag identifying these articles in the smartphone category, like this:


<meta name="category" value="smartphone" /> 

You can create up to 6 unique keys and each key can have up to 1,000 predefined values.


Setting up Keys

Once you have installed the Key/Value app, your first step is to add keys. Each key corresponds to a group of possible values to be used to target ads. This could be an article category or sponsored page, or any number of other things.

First, you must decide which kind of key to use. We support <meta>  tags, custom <span>  tags, or calls to .setTargeting(). You can select a key type by using the drop down menu:




Note that in the table, the Key Name field is the key name from DFP that will tell it to serve the custom ads. The Element Name is the name or key of the tag we should look for on your site to trigger this key.


Adding Values

Once you have your keys set up, you need to tell us the possible values for those keys. Add all possible values, one per line, with an optional human-readable label.




Adding Rules (Optional)


Sometimes, you may want to always show or hide certain ad placements based on the Key/Value parameters. This can be accomplished via rules that are created to apply to placeholders in the Ad Tester app. 

When a rule condition is met on a page and you have applied a rule to one or more placeholders, our service will display or hide those specific placeholders depending on the “hide/display” setting you choose. A rule is a combination of key value pairs. Depending on your combination type selection, a rule can be satisfied when either all the added values are present or when at least one of the added values is present.

To create the rules, go to the Ad Tester app, and click on the like to “Add/Edit” Key Value Rules. Click the “Add New Rule” button and select the keys and values that should trigger this rule. Once you’ve set up how the rule should work, save it, and add any other rules you would like to use.




Finally, you need to assign the rules to the Ad Placements you’d like to control. Choose the Ad Placement and go to the edit form. Click on “Add Another Rule” in the Key/Value section, and then select the rule you would like to apply to this Ad Placement.





Once your keys and values are set up, when a user requests a page on your site that has tags matching one of the assigned rules, the corresponding ad slot will be included/excluded based on your rules (if any), and we will call setTargeting(key, value) on that page with the Key Name and Value of the triggered key.

And that’s it! If you have any questions about the Key Values App that hasn’t been answered here, please don’t hesitate to get in touch with us at support@ezoic.com