King installation guide for Web Products

You can see a test page at https://apps.facebook.com/mediabrix/test/lee/king

There are test ads targeted to this Ad Code for testing.

The MediaBrix Ad Code to be placed on the web page

<script type="text/javascript" src="https://mediabrix.hs.llnwd.net/o38/mediabrix.js"></script[b1] ]] ]]>

<script type="text/javascript">

var socialVars = {

"version" : "2.0",

"tag" : "https://ad.doubleclick.net/adj/mbrix.testpub_v1_4/method1;sz=650x500;pos=1;tile=1;",

“adInstance” : “[Publisher Defined Instance Name]”

}

</script>

Adjustable Variables

Publishers are able to communicate with MediaBrix products by defining variables in a socialVars object before the initialization of the MediaBrix Social Media ad and through the use of JavaScript callbacks. The socialVars object can have any name and does not need to persist after the ad call has been executed.

Variable	Description	Type	Value	Required?
version	Denotes the version of the MediaBrix Ad Code to help MediaBrix troubleshoot any issues	String	Version name (do not change)	required
tag	The URL for making the MediaBrix Social Media ad call	String	Included URL (do not change)/	required
adInstance	The name of the Mediabrix ad instance.	String	Ad Name (eg, “reward”)	required
uid	This is the string required by MediaBrix to pass back to the publisher for reward confirmation. This string requires a unique identifier for the user and any other parameters required by the publisher. The parameters should be pipe delimited. This variable needs to be dynamically created upon page load	String	[user unique id]\|[parameter 1]\|parameter 2]\|[parameter n]	required
top	Vertically positions the MediaBrix SocialMedia ad unit so it can be correctly positioned on your game or site. The default positioning of ads is 140 pixels from top margin	String	Number (eg, 140)	Optional
adVerification	This publisher function to call to confirm that there is a SocialViews ad and that will load the publisher’s tickler	Callback	Publisher’s Javascript function or “auto” to render the ad without a tickler	required
adClosed	This is a callback function that occurs when the ad unit is closed. Publishers can use this to implement some action after the ad unit closes	Callback	Publisher’s JavaScript function	Optional
rewardConfirmation	The publisher function to call when SocialViews confirms a reward to user. SocialViews makes a callback with unique ID set under account	Callback	Publisher’s JavaScript function	required
closeBtn	Determines whether or not to display the ad’s close button.	String	“none” if the close button should not be displayed	Optional
title	The title to display in the head of the SocialViews/Flex unit	String		Optional
confirmHeader	Header text to display on the confirmation rewards panel	String		Optional
confirmText	Body text to display on the confirmation rewards panel	String		Optional
iconURL	URL of an icon to display on the confirm reward panel URL(PNG @120x120)	String		Optional
rewardsBackgroundURL	URL of an image to display on the background of the confirm reward panel URL(PNG @644x449)	String		Optional

Where to place the Ad Code

The MediaBrix Ad Code is easy to install. Just add the entire chunk of code right after the opening body tag (just after <body>)

<HTML>

<HEAD>

//Publisher Code

</HEAD>

<BODY>

<script type="text/javascript" src="https://mediabrix.hs.llnwd.net/o38/mediabrix.js"></script>

<script type="text/javascript">

var socialVars = {

"version" : "2.0",

"tag" : "https://ad.doubleclick.net/adj/mbrix.testpub_v1_4/method1;sz=650x500;pos=1;tile=1;",

“adInstance” : “[Publisher Defined Instance Name]”,

"closeBtn" : "none",

"adVerification" : "auto",

}

</script>

//Publisher Code

</BODY>

</HTML>

Executing the Ad Call

Now that you are all set-up its time to execute the ad call. Unlike a display ad (ie, banner), which displays upon a web page load, the ad unit is designed to appear on a trigger. This trigger may be a user click, a transition in a game (e.g., level 1 to level 2) or can simply be a time-based trigger. The trigger will be executed by the following call:

loadMediaBrix(socialVars);

Example Methods for Executing the Call

HTML Link:

<a href=”javascript:;” onclick=” loadMediaBrix(socialVars);”>execute ad call</a>

JavaScript:

if ( gamelevel == ‘nextlevel’ ){

loadMediaBrix(socialVars);

}

</script>

ActionScript 2:

getURL(“javascript: loadMediaBrix(socialVars);”);

ActionScript 3:

ExternalInterface.addCallback("loadMediaBrix”,socialVars);