Introduction:

ValidClick SearchLinks ad units are designed to help you present contextually relevant hyperlinked keywords in a variety of formats and sizes to your users. When your users click on a keyword, they're taken to a landing page that hosts ValidClick PPC ads.  When a user clicks on one of those ads, we share that revenue with you. There are two types of units: Keyword Links and Editorial Links.

How SearchLinks are implemented: 

There are two key parts of a SearchLinks implementation. We can work with you to customize each of these. 

1. The Ad Unit: This is the code that serves the ad content and keywords. 

2. The Landing Page: This is where the PPC ads actually show. 

How to Implement Editorial Ad Units: 

Like our standard Java Script implementation, our Editorial units consist of two pieces...the master script and individual blocks to call ads. The latter blocks serve to take all of the input variables for the ad units. The master script does all of the behind-the-scenes work to call and serve the ads. When you are approved and ready to go, your account manager will send you your specific code to implement. It will look a lot like the below: 

1.  The Editorial Tag: This is the code that instructs the master script where to place the ad block on the page. This contains the a.) publisher affiliate ID used to track your revenue and b.) a numerical ID which represents your unique data category.

<vc:editorial 
data-affId='1' 
data-category='123456-123456'
data-type='ed2s'
data-height='710px' 
data-width='100%'>
</vc:editorial>

2. The Master Script: This is a single line of JavaScript that needs to be placed after every other ValidClick tag on the page. The best place to put this is just above the "</body>" tag. Here's an example:

<script src="http://feed.validclick.com/js/validclick-master.js"></script>

The Keyword Ad Unit Code: 

Like our Editorial ad units  the Keyword units consist of two pieces...if you have the master script in place it will work for both Editorial and Keyword units. Again, here, the latter block serves to take all of the input variables for the ad units. The master script does all of the behind the scenes work to call and serve the ads. When you are approved and ready to go, your account manager will send you your specific code for implementing. There are more variables for the Keyword ad units.

Keyword Unit Variables:

  • Required Variables
    • data-affid: Publisher affiliate id. 
    • data-landingPage: URL of the landing page to send clicks
    • data-term: Seed term to use when retrieving dynamic from our keyword service OR data-keywords: A static list of comma separated terms to display based on your own content targeting.
    • data-stylesheet: URL of a stylesheet to apply to the iframe containing the d2s unit.
    • data-triggerText: Text of the trigger label  (e.g. Related ads:)
  • Optional Variables: KeywordLinks offer flexible sizing. By default you can shape the units based on defining their dimensions. 
    • data-height:  Height of the containing iframe
    • data-width: Width of the containing iframe
    • data-termCount: Maximum number of terms to display. Defaults to "5".
    • data-randomize: If set to "yes", the unit will display terms in a random order.
    • data-target: If set to "new" clicks will be opened in a new window.
  • Logging Options:
    • data-impressionBeacon: URL to call when the SearchLinks unit displays with information on the unit. 
    • data-clickBeacon: URL to call when a user clicks a term.
    • data-beaconKeyword: Parameter name assigned to the keyword in each beacon.
    • data-beaconAffId: Parameter name assigned to the affiliate id in the beacons.
    • data-beaconPlacement: Beacon parameter name indicating the 1-indexed position of a clicked term.
    • data-beaconServeUrl:  Beacon parameter name of the url of the parent page serving the unit.
    • data-wildcard1: A url parameter specified to be pulled from the serving page's url and inserted along with it's value into the beacons.
    • data-wildcard2: A second parameter to be pulled from the serve url and inserted into the beacons.
    • data-impressionCallback: A javascript function to call when a unit is displayed. The sole argument will contain information about the unit.
    • {keywordValue: '',      // Term displayed
    • affidValue:'',          // AffId used
    • refValue:'',            // Referring url
    • beaconUrl: '',          // Impression Beacon url
    • serveUrlValue: '',      // Serve Url
    • pubBeacon1Value: '',    // Value of url parameter for wildcard 1
    • pubBeacon2Value: '',    // Value of url parameter for wildcard 2
    • termCount: 0}           // Number of Terms displayed
    • data-clickCallback: A javascript function to call when a user clicks a term. One Object argument will be provided containing information about the unit.
    • {beaconUrl: '',         // Url of the click beacon
    • keywordValue: '',       // Term displayed
    • affidValue: '',         // Affiliate Id used
    • refValue: '',           // Referring Url
    • placementValue: '',     // 1-indexed position of the term clicked
    • pubBeacon1Value: '',    // Value of url parameter for wildcard 1
    • pubBeacon2Value: '',    // Value of url parameter for wildcard 2
    • serveUrlValue: ''}      // Serve Url

 

Have any questions? 

We are here to help. Send us an email at inquiry@validclick.com and our team will get back to you.