« Back

Seamless Integration of OpenX Ad Server in Liferay Portal – ForgeAds Publisher

General Blogs March 27, 2012 By Jonas Yuan

OpenX Source is an open-source and PHP-based advertising server, featuring an integrated banner management interface and tracking system for gathering statistics. It enables web site administrators to rotate banners from both in-house advertisement campaigns as well as from paid or third-party sources, such as Google's AdSense. It provides standard banner rotation, click tracking, zone-based ad selection, zone-based campaign targeting, direct ad selection, ad targeting (per browser, domain, language, etc.), ad capping and full Adobe Flash support, etc. Refer to http://www.openx.com/.

The following diagram shows the main terms used in the Ad server OpenX 2.8.

 

Ad server: Normally operated by a third party, an ad server delivers and tracks ads on websites. Ad servers perform a useful role in building trust between advertisers and publishers since the statistics they supply are likely to be free of spin.

Ad space: The area on a web page set aside for the display of ads.

Ad units: These refer to the different types of ads which appear online, including banners, interstitials, pop-ups, skyscrapers and text links.

Affiliate marketing: An advertising system based on the CPA (Cost Per Action) payment method, where websites display advertisers' banners for free but receive payment when registrations or sales result from click throughs.

AIDA: Attention, Interest, Desire and Action - a simple marketing acronym that describes the supposed path to successful selling.

Banner: This is an ad that appears on a web page which is typically hyperlinked to an advertiser's website. Banners can be images (GIF, JPEG, PNG), JavaScript programs or multimedia objects (Flash, Java, Shockwave etc.).

Campaign: Refers to an advertising project in its entirety, from conception through creation and buying to tracking and final analysis.

For more online terms, refer to online-advertising-terms.

In general, there are three main parts that OpenX Ad server provides.

  1. Inventory - banners management
  2. Delivery – ads publishing
  3. Statistics – ads tracking and reporting

This article is going to address an extension for part 2 – seamless integration of OpenX Ad Server in Liferay Portal 6, implemented as a portlet plugin called ForgeAds Publisher.

This plugin has been released for different versions of Liferay Portal such as 6.0 CE/EE and 6.1 CE/EE. If needed, it can run in other Liferay version like 5.2 and 5.1 with some additional customization.

Integration Overview

The following diagram depicts an integration overview.

On the Ad server side, it includes, but is not limited to, inventory management, user & role management, AIDA management, etc. On the portal side, the involved components cover user and role management, auditing, reporting and ads publisher.

The integration approach

The integration is configurable as follows

## Oracle 10g, 11g
#jdbc.mdb.driverClassName=oracle.jdbc.driver.OracleDriver
#jdbc.mdb.url=jdbc:oracle:thin:@localhost:1521:XE
#jdbc.mdb.username=pradm
#jdbc.mdb.password=pradm
#jdbc.mdb.liferay.pool.provider=dbcp
 
## MySQL
jdbc.mdb.driverClassName=com.mysql.jdbc.Driver
jdbc.mdb.url=jdbc:mysql://108.227.160.137:3306/openx_2880?zeroDateTimeBehavior=convertToNull&useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false
jdbc.mdb.username=openx
jdbc.mdb.password=openx
 
## OpenX ad server settings
openx.ad.server.url=http://ads.forgelife.net
openx.ad.server.contextpath=/openx/www
openx.ad.server.delivery.ck=/delivery/ck.php?
openx.ad.server.delivery.ai=/delivery/ai.php?
openx.ad.server.image.contextpath=/images/
 
## OpenX content types
openx.ad.server.content.types=html,jpeg,png,gif,txt

As shown above, it supports all major relational databases like Oracle and MySQL and can link to any OpenX Ad Server.

The Ad server and Liferay Portal with ForgeAds Publisher can be installed on the same server (with different port numbers) or two different servers.

ForgeAds Publisher

ForegeAds Publisher has the following features:

1) Publishing ads with Liferay comments and ratting

2)  Sharing the Ad to any web page through the typical Liferay Portal Sharing feature

 3) Flexible search capabilities for ForgeAds Publisher administrator.

Basic search by keyword:

Advanced search:

4) Synchronization with OpenX Ad Server automatically on Liferay ForgeAds Publisher configuration page

 

Live demo

Demo server (Liferay portal 6.1 GA1): http://ads.forgelife.net:8090
Demo account: demo@forgelife.com/ForgeAds

OpenX Test server (OpenX 2.8.8): http://openx.forgelife.net/openx
Admin account: openx/openx - You are the openx Ad server admin, so please do not change admin password and permissions. smiley

Download URL

6.1 CE / EE

6.0.6 CE and 6.0 EE

5.2 CE / EE

5.1 CE / EE

Threaded Replies Author Date
Very good!! Sohui Gu April 7, 2012 6:41 PM
Hi Jonas, Really Nice!! It's the source code... Denis Signoretto July 13, 2012 8:25 AM
Hi, I need the source code too. It is... Kolcza Gyozo August 14, 2012 11:20 PM
@Denis @Gyozo, The source code is not... Jonas Yuan September 21, 2012 9:20 AM
Hi Jonas, Not able to login using the... Praveen Singh Bais February 6, 2014 11:56 PM
Hi Jonas, Not able to login using the... Praveen Singh Bais February 6, 2014 11:56 PM
[...] Introduction There are a few existing... Anonymous February 8, 2013 4:08 PM
It looks like the open source OpenX ad server... Gib Veconi February 13, 2014 2:38 PM
Hi Gib, Thanks for the info, we are using... Praveen Singh Bais February 13, 2014 10:05 PM
Hello Jonas, the URLs for ForgeAds plugin... P F February 16, 2015 8:23 AM

Posted on 4/7/12 6:41 PM.
Hi Jonas,

Really Nice!! It's the source code of portlets available?

thanks,
Denis.
Posted on 7/13/12 8:25 AM.
Hi,

I need the source code too. It is available?

Best Regards,
Gyozo
Posted on 8/14/12 11:20 PM.
@Denis @Gyozo,

The source code is not available for now. It would be available in the near future.
Posted on 9/21/12 9:20 AM in reply to Kolcza Gyozo.
[...] Introduction There are a few existing eCommerce solutions available like Magento, KonaKart, SoftSlate ecommerce, Apache OFBiz (ecommerce capabilities), Broadleaf ecommerce, etc. When developers... [...] Read More
Posted on 2/8/13 4:08 PM.
Hi Jonas,

Not able to login using the credentials in the http://openx.forgelife.net/openx. Can you please check.

Regards,
Praveen
Posted on 2/6/14 11:56 PM in reply to Jonas Yuan.
Hi Jonas,

Not able to login using the credentials in the http://openx.forgelife.net/openx. Can you please check.

Regards,
Praveen
Posted on 2/6/14 11:56 PM in reply to Jonas Yuan.
It looks like the open source OpenX ad server is now Revive Adserver. Are your Liferay plugins still supported and compatible with Revive?
Posted on 2/13/14 2:38 PM.
Hi Gib,

Thanks for the info, we are using Liferay 6.1.2 GA3 version. I have couple of queries here :

1. Will the same ForgeAd plugin work for Revive Ad Server as well ? Wondering because I could not find anything in the web. Please help if you have any resource.

2. Are the integration steps different for Revive with Liferay ??

Regards,
Praveen
Posted on 2/13/14 10:05 PM in reply to Gib Veconi.
Hello Jonas,

the URLs for ForgeAds plugin portlets you list in section "Download URL" are not valid anymore.

The page http://www.forgelife.com/products#product-232819 also does not point to a WAR or portlets.
The page http://www.forgelife.com/hr_HR/web/guestold/wiki/-/wiki/Main/ForgeAds+Installati­on does not mention where to get the WAR or portlets.

The URLs http://liferay.cignex.com/ad_server/ad_services.war and http://forgelife.net/portal/6.1/forgeads/ are also not valid anymore.

Where to get the portlets you write about?

Than you,

Veronym
Posted on 2/16/15 8:23 AM.