Custom Targeting

Custom Targeting allows you to create unique and flexible targeting solutions based on your objectives.

With Custom Targeting you can define your own targeting criteria such as age, gender, content, etc. In this way, you can leverage your customer database improving the Conversion rates and serving the right ads for the needed customer groups.

To set up the Custom Targeting feature, please follow the steps bellow:

  1. Log into your network account and go to the Advertisers tab.
  2. To set Custom Targeting:
    • For the entire Campaign: navigate to an existing Advertiser > Campaign or add the new ones.
    • For a specific Banner: navigate to an existing Advertiser > Campaign > Banner or add new ones.
  3. Activate the Targeting pane from the right side panel and configure the Custom Targeting:
    • Choose the Custom Parameter type of Targeting.
    • Select the function: Expression, Value, One of or Substring.
    • Choose the necessary operation.
    • Fill in the Parameter name and its value.
    • Select either the Include or the Exclude option.

Custom Targeting Functions:

Expression sets a statement that determines the parameter and its condition. The $ sign should always be used before the parameter name (i.e.: $age).

Expression Parameter Syntaxis
  • The parameter name should start with a letter and consist of letters, numbers, and underscores. For example, $age_18, $size_5, etc.
  • Multiple Custom Parameters can be used together, separated by comma.
  • The following expressions cannot be used as Custom Parameters: key, tz, cIds.
  • Separators: '||' is recognised as 'or', '&&' stands for 'and'.
Expression Samples

Examples of the valid parameters with the values:

  • $size>12
  • $size==10 || $age<20
  • $size>=10 || $size<=20
  • ($size>10 && $age==20) || ($size==10 || $age<20)
  • $size==12 && $age<30
  • ($size>12 && $age<30) && ($size<500 && $age<400)

Value allows to set a condition with a mathematical operation of comparison. Operations equals/not equals can also be used for the text values. In this case, the text string will be compared to a Parameter's value. If it is exactly the same, the targeting will be passed.

One of strictly compares the list of comma-separated values to Parameter's value. If at least one of the list's elements is included in the Parameter's value, the targeting will be passed.

🚧

Note!

Please note that, unlike Substring, One Of performs strict comparison.
The targeting will be passed if only the specified characters are passed in the Parameter's value.
For example, when we have keywords 'air,fire' in our targeting rule, these values will pass the targeting: 'air', 'fire'. However, these values will not pass the targeting: 'airplane', '123fire321''

Substring compares the list of comma-separated values to Parameter's value. If one of the list's elements is included in the Parameter's value, the targeting will be passed.

🚧

Note!

Please note that Substring targeting passes the string that contains one of the comma-separated elements.
However, this string may contain more characters.
For example, when we have keyword 'air' in our targeting field, all of the following values will pass the targeting: 'air conditioning', 'clean air', 'airplane', '123hsairsjs8'

Custom Parameters in Invocation Codes

Whenever the Custom Parameters are to be used on a certain page, they should be added to the supp_custom_params line of the Invocation Code.

For example, for the following settings:

INCLUDE EXPRESSION $age>'20'
EXCLUDE VALUE direction EQUALS North-West
INCLUDE SUBSTRING goods CONTAINS Cheese, Salad, Fish, Butter

<ins> class="67536869" data-key="8c8f1d6f7e2e1910158e54fc9c735926" data-cp-age="21" data-cp-direction="North-West" 
data-cp-goods="Cheese, Salad, Fish, Butter"></ins>

<script> async defer src="//domain.com/b3a18f14.js"></script>
<!-- BEGIN TAG - DO NOT MODIFY -->
<script type="text/javascript">
 /*<![CDATA[*/

  supp_key = "90753ccb2860340d85e7ed09cda4c4f8";
  supp_channel = "";
  supp_code_format = "ads-sync.js";
  supp_click = "";
  supp_custom_params = {age: "21", direction:"North-West", goods:"Cheese, Salad, Fish, Butter"};

 /*]]>*/
</script>
<!-- END TAG -->
http://adshost2.com/vast.xml?key=71633f962a22781e647d8fbb90400ea2&cp.age=21&cp.size=40

📘

Note!

Please note that several values in Targeting are combined via OR rule for Include and via AND rule for Exclude.
The maximal length of value field for all three custom targeting types is 65,535 characters.

When the Placement is requested, Epom Ad Server will 'read' the Custom Targeting values and compare those with the required ones, thus displaying the ads only if they are met. So, for the example above:

  • epom_custom_params = {✘age: 9, ✘direction: North-West, ✘goods: Bread}; – ad will not be shown.
  • epom_custom_params = {age: 21, ✘direction: North-West, goods: Cheese}; – ad will not be shown.
  • epom_custom_params = {age: 45, direction: West, goods: Parmesan Cheese}; – ad will be displayed.
  • epom_custom_params = {age: 30, direction: East, ✘goods: Bread}; – ad will be displayed.
  • epom_custom_params = {✘age: 18, direction: South, goods: Butter}; – ad will be displayed.

– parameter value passes the requirement.

✘ – parameter value doesn't meet the requirement.