Custom Targeting

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.

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.

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.

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

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.