Set up Key-value targeting

Learn how to configure your website to pass key-values to Holid.io

Key-values help Holid.io target specific subpages of your website with certain advertising content. You can also set up key-values for your own use, for example if you want to target your own ads via Holid.io. We recommend to both set Subpage specific key-values of your entire website, but as well to set more detailed Publisher-specific key-values. 

Implementing Key-values

In order to implement the key-value pairs, you need to first create an object named holid_keyvalues and populate it like this:

<script> 
var holid_keyvalues = {
  aKeyValue: "",
  anotherKeyValue: "",
  aThirdKeyValue: "",
};
</script>

A key-value pair is a combination of a name and value. In the below example, the name subpageContext has a value of Sports, while the key-value name subpageContext2 has a key-value value of Fotball. 

Adjust the key-value name and value to reflect either the requirements of a Subpage key-value setup or a Publisher-specific key-value setup.

The below example is to be set dynamically by you or your developer:

<script> 
var holid_keyvalues = {
  subpageContext: "Sports",
  subpageContext2: "Fotball",
};
</script>

Note: If you do not have a value to set, skip setting that property completely
That is, if subpageContext2 is missing, just create:

<script> 
var holid_keyvalues = {
  subpageContext: "Sports",
};
</script>

Subpage key-values

You can choose from a number of different key-values to be set on separate subpages. Setting this requires accuracy and logics that you or your developer have to create to divide the certain key-value pairs to certain subpages.

Holid.io is prepared to receive Subpage Key-values for tier_one_kv and tier_two_kv names only, as well as only receiving the values of both key-value names according to the below two lists of Tier One and Tier Two categories.

After consulting your developer on how to build the logic of dividing key-value code for each subpage, you set the key-values as below, for example:

<script> 
var holid_keyvalues = {
  tier_one_kv: "Automotive",
  tier_two_kv: "Auto Parts",
};
</script>

The Tier One categories are the following:

The Tier Two categories that you can set are mentioned here.

Publisher-specific Key-values

In the above example we set Tier One category to Automotive and Tier Two category to Auto Parts. Since you are publisher with detailed contexts of your website, it makes sense to get even more in to depth, and for example set a certain Car Brand as a third key-value. Since there are vast differences of the need of this between publishers, Holid.io requires you as a publisher to  inform us of the information you are sending, so that we can set this up on our end.

What you decide to set as key-values depend on your site and your context. We can be in assistance of deciding this with you.

You set it as the above examples, with your own key-value names and values. For a site showing average salary data based on a certain job title, the key-value names and values can be:

<script> 
var holid_keyvalues = {
  jobTitle: "Receptionist",
  avgSalaryUsd: "1000",
};
</script>

Reach out to us via the support-form on Holid.io and let us know which key-values you have set.