Welcome to Ezoic's guide to the Key Values app! This article will walk you through the process of using the Key Values app to set specific targeting parameters for your direct ad orders. If you have direct agreements with advertisers that are tied to particular pages or sets of pages, this app is an invaluable tool. You'll learn about key value pairs, how to set up keys and values, and how to create optional rules to fine-tune your ad placements. Let's get started on optimizing your ad targeting with the Key Values app!

1. Install the Key Value app from the Ezoic platform. Navigate to EzoicAds > Ad Positions > Advanced > Key Value Settings > Turn On.

2. Hit 'Add Key'.

3. Decide on the type of key to use: tags, custom tags, or calls to .setTargeting(). Select the key type using the drop-down menu.

4. For Ezoic-generated meta tags, insert the required value and add the tag to the page.

5. In the table, specify the Key Name field (DFP key name) and the Element Name (corresponding tag in your source code).

6. Add the values for the keys. Enter each value on a new line, with an optional human-readable label.

7. (Optional) Create rules to control which ad placements to show or hide based on Key/Value parameters:

a. Go to Ezoic Ads > Ad Positions > Advanced > Key Value Settings and click on 'Settings'.

b. Click the "Rules" > "Create New Rule" button.

c. Select the keys and values that will trigger the rule.

d. Assign the rules to the Ad Placeholders you want to control:

d1. Choose the Ad Placeholder and go to the edit form.

d2. Go to 'Settings' and select 'Apply' to apply the rule.

d3. Alternatively, go to your placeholder list, select the edit option, navigate to the Key Value Rules section, and select which rule(s) to apply.

8. Once your keys, values, and rules (if any) are set up, the corresponding ad slot will be included/excluded based on your rules. The system will call setTargeting (key, value) on that page with the Key Name and Value of the triggered key.

Common issues users might encounter when using the Key Values app and their respective solutions are:

1. Keys Not Displaying Ads as Expected:
   • Issue: Ads are not showing up for specific keys.
   • Solution: Ensure that you have correctly set up your keys and values. Double-check that the key names match exactly with the corresponding tags in your source code. Verify that the tags are properly embedded on the pages you're targeting.
2. Incorrect Ad Placements:
   • Issue: Ads are appearing in places where they shouldn't.
   • Solution: Review the rules you have set up for your ad placements. Make sure that the rules are correctly applied to the relevant placeholders. Check the combination type selection to ensure that the rule conditions are correctly configured to show or hide ads based on the key/value pairs.
3. Values Not Recognized:
   • Issue: The values entered do not seem to be recognized by the system.
   • Solution: Confirm that all values have been entered correctly, one per line, with an optional human-readable label. Ensure that there are no typos and that each value corresponds accurately to the set keys.
4. Difficulty in Creating Rules:
   • Issue: Problems when trying to create or apply rules.
   • Solution: Follow the steps carefully to create a new rule by going to EzoicAds > Ad Positions > Advanced > Key Value Settings > Settings > Create New Rule. Make sure to select the correct keys and values that should trigger the rule. Save the rule setup and apply it to the appropriate Ad Placeholders. If issues persist, consider re-creating the rule or consulting the support documentation for more detailed guidance.
5. Placeholder Rules Not Applying:
   • Issue: Rules are not being applied to placeholders as expected.
   • Solution: After creating and saving the rules, ensure that you have navigated to the placeholder list and selected the edit option for the specific placeholder. Verify that the Key Value Rules section reflects the correct rule(s) you intend to apply to that placeholder. Reapply the rules if necessary.

If these steps do not resolve your issue, consider reaching out to Ezoic Support for further assistance.

If you need further assistance with the Key Values app, please log in via https://support.ezoic.com/ to make use of our dedicated resources for support. We're here to help!