How to include a PCAN ad on your web page

Introduction

This document describes how to add an advertisement from Alacra Premium Content Ad Network onto a web page. It assumes that you are familiar with basic HTML.

The PCAN Insertion Snippet

Once you register for PCAN, the "my account" page on alacrastore.com will include a link to a page in which you can customize the size and colors of your PCAN ads and obtain the necessary PCAN insertion snippet (example shown below). Then, all you need to do is find the place in your page where you want PCAN ads to appear and insert the snippet into your page there.

<div id="alacra_adsdiv">
	<div id="alacrastore_lnk"><b>Premium Content from <a href="http://www.alacrastore.com">Alacrastore.com</a></b></div>
	<script type="text/javascript"><!--
	alacra_ad_client = "97139";
	alacra_ad_width = 500;
	alacra_ad_height = 450;
	alacra_color_border = "FFFFFF";
	alacra_color_bg = "FFFFFF";
	alacra_color_alt = "EBEEF3";
	alacra_color_link = "0060C0";
	alacra_color_url = "0000FF";
	alacra_color_text = "000000";
	//--></script>
	<script type="text/javascript"
	  src="http://pcan.alacrastore.com/ad-script/pcan100">
	</script>
</div>

How PCAN works

The PCAN insertion snippet contains two <script> tags. The first <script> tag contains your ad parameters as global javascript variables. The second <script> tag references the master PCAN script at http://pcan.alacrastore.com/ad-script/pcan100.
The master PCAN script accesses the ad parameters via the global variables. It also reads the contents of the Location bar, plus certain other browser parameters and sizes. These all get combined into an ad request URL.
The master PCAN script then writes to your page using the document.write javascript function. It writes an <iframe> tag with height and width attributes matching your configured values, and a src attribute containing the ad request URL.
When the ad request URL in the <iframe> is accessed by the browser, HTML containing ads is returned.

PCAN Insertion Snippet Parameters

Parameter	Description
alacra_ad_client	This should be your affiliate ID, as provided by Alacra. Please make sure this is correct, or your ad clicks could be credited to someone else.
alacra_ad_width	Desired ad width, in pixels. The minimum value is 300 pixels. If you need something smaller, please contact us.
alacra_ad_height	Desired ad height, in pixels. The minimum value is 250 pixels. If you need something smaller, please contact us.
alacra_color_border	RGB color value for the ad border.
alacra_color_bg	RGB color value for the ad background - primary.
alacra_color_alt	RGB color value for the ad background - alternate. This can also be set to the same value as alacra_color_bg for non-alternating row colors.
alacra_color_link	RGB color value for the ad links.
alacra_color_url	RGB color value for the ad links when hovering over them.
alacra_color_text	RGB color value for the ad text.

Note on color values: PCAN color values are specified using the RGB color model, 24-bit representation as a 6-digit hexadecimal integer. See this wikipedia article for more information.

Example ad output

The above example will produce the following ad block:

Premium Content from Alacrastore.com