In some cases there is a need to pass custom data from the pages where the ads are being displayed to the advertisers' landing pages.

To do so, the following setup is required:

Publisher setup

The Invocation Codes, which are provided to the Publisher contain special placeholders for Custom Parameters - supp_custom_params. For example:

<!– BEGIN TAG – DO NOT MODIFY –> <script type="text/javascript"> //<![CDATA[ supp_key = "72c6fe61b1a4b1118bcd67e21e99b1c0"; supp_channel = ""; supp_code_format = "ads-sync.js"; supp_click = ""; supp_custom_params = {}; //]]> </script> <!– END TAG –>

The supp_custom_params should be populated with the required Custom Parameters and their values. I.e., if it is needed to pass the 'age' and 'size' parameters, the Invocation Code should be:

<!– BEGIN TAG – DO NOT MODIFY –> <script type="text/javascript"> //<![CDATA[ supp_key = "72c6fe61b1a4b1118bcd67e21e99b1c0"; supp_channel = ""; supp_code_format = "ads-sync.js"; supp_click = ""; supp_custom_params = {age:"value1", size:"value2"}; //]]> </script> <!– END TAG –>

The way to generate and pass the values for the Custom Parameters ('value1' and 'value2' in the example above) is left on Publishers' consideration.

Advertiser setup

As an Advertiser, follow these steps to receive the parameters passed from the Publishers:

  1. Log into your network account and go to the Advertisers tab.
  2. Navigate to the Advertiser > Campaign > Banner.
  3. Add ?parameter1=$$CUSTOM_PARAM(name)$$&parameter2=$$CUSTOM_PARAM(name)$$ to Advertiser's landing page URL field.
    • Any other names can be used instead of 'parameter1' and 'parameter2'.
    • 'name' in the $$CUSTOM_PARAM(name)$$ string should be replaced exactly with the parameters that are passed by the Publisher. For the example above (age and size), the URL would be:
    • https://epom.com/?parameter1=$$CUSTOM_PARAM(age)$$&parameter2=$$CUSTOM_PARAM(size)$$
  4. Click Save.

To check if everything is working properly, visit the Publisher's page and click the Banner. You should be redirected to the landing page, where the $$CUSTOM_PARAM(name)$$ macros will be replaced with the actual values. For our example, it would be:

Passing Custom Parameters in Vast Tags

The whole process is exactly the same as for the regular Banners. The only difference is that the &cp.name=value&cp.name=value string should be used instead of ?parameter1=$$CUSTOM_PARAM(age)$$&parameter2=$$CUSTOM_PARAM(size)$$. For example:

http://www.epom.com/vast.xml?key=44ea95967ad82534e67aec7f04aee119&vastv=3.0&cp.age=value&cp.size=value


Need more help?

Should you require any additional help with our solutions, do not hesitate to contact Epom technical support at support@epom.com. Our support managers are dedicated to resolving any issues and providing you with solutions and support if you face difficulties or have questions.