D2S Implementation Instructions

D2S Implementation Instructions

Introduction:

ValidClick SearchLinks offers a variety of keyword-based ad units that present contextually relevant hyperlinked keywords in a variety of formats and sizes to your users. By using keywords in this way we give you access to advertisers' search budgets on your content pages.

How the implementation works:

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

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

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

The D2S Ad Unit Code:

Like our standard Java Script implementation, the D2S unit consists of two pieces...the master script and a D2S block. 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.

D2S 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 terms from the feed.

OR

data-keywords - Static list of comma separated terms to display.

data-stylesheet - URL of a stylesheet to apply to the iframe containing the d2s unit.

data-triggerText - Text of the trigger label

Optional Variables

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 d2s 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 infomation 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

What it looks like:

How it works:

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

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

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

How to Implement:

Like our standard Java Script implementation, the ED2S unit consists of two pieces...the master script and a D2S block. 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 to implement. It will look a lot like the below:

1. The eD2S 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.

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: