This post assumes you have purchased and installed RevMax 3 for OpenX 2.6 .If not you can get more information and purchase it here.

Navigating to RevMax Ad Packages

Open a browser and log into your OpenX install and switch to Administrator.
Click the RevMax tab at the top right of screen.

Next click the Ad Packages tab to open the ad packages list screen. Here you can explorer already created packages, add a new advertising package, edit an existing one, or delete a no longer used one.

From the Ad Packages list screen click on “Add Package”. This will open the below screen to create your first advertising package within Openx.

Configuring The Ad Package.

You must first have some idea as to what type of advertising package you would like to sell or ad space you would like to rent.
Lets go over the settings.
a) Selling: Would you like to sell Ad Views (cpm), Ad Clicks (cpc), or rent a tenancy ? Select accordingly from the drop down list.
b) Package Description: This will be shown on the drop down select list on the advertisers signup screen if made public later in settings. If you are selling 10,000 adviews as a leader board on domain.com then enter in something like 10,000 LeaderBoard Adviews at domain.com.
This field combined with the later discussed “make public” field is handy for creating ad packages across a network of sites.
c) Duration: Enter in here the amount of ad views, ad clicks or the actual time as in subscription. Example if selling 10,000 ad views enter 10000 notice no comma. If selling a subscription simply enter UNLIMITED, or 30 days etc.
d) Cost: Enter in here the amount you would like to collect using paypal for this ad package. Enter numbers like 100.00, do not enter in $ or other signs like “,”.
e) Auto Zone ID: Use this field if you would like to link an advertiser campaign to a specific publishers zone within OpenX. Notice the scrolling iframe to the right. Here you can scroll and find a zone id easily without clicking back and fourth through OpenX. The iframe list the zone id number (to be used) the zone description you have entered when creating the zone within OpenX, and the size of the created zone. This feature is extremely useful when selling ad space across a network of sites. For instance a package for domainb.comcom’s leader board can be easily linked here.
f) Auto Zone: Select yes or no to allow advertisers banner to be automatically attached to a specific zone. This is useful if you are renting a spot 160X600 on the index page and you have a zone created within openx for this. Create a package named 160X600 skyscraper etc, and link the package to this zone. the advertiser will not be able to show a banner unless it meets the zone requirements (160X600), as he has no permissions within OpenX to link banners to another zone.
g) Priority Level: You can choose to set a higher priority for paid campaigns here. Keep in mind that high priority campaigns will override any lower level campaigns that may already be active. A high setting number here may deactivate lower priority existing campaigns, once the advertiser or you have added a banner to the campaign.
h) Weight: If you chose to leave the priority setting at the default of “0″ above you can enter in a higher weight here if necessary. For example if your “house” campaigns are at a weight of 1 then a setting of 2 here will give this advertisers campaign a higher weight and more exposure, yet the house campaigns will still receive exposure.
g) Make Package Public: Here you can decide if you would like the created package to be shown on the advertisers sign up screen if using the included sign up form.

This may be used in a number of ways. example a: If you are selling ad space on domain b and you do not wish the package available on domain a then set to no. you can then create a link to another sign up page for this specific package. simply go to the existing sign up form, view source , save as filename.html, and edit the available packages list to include the desired package description and package id number. You can then use this form to post to domaina.com/clients/clients.php and the user will be forwarded directly to paypal for payment.
You may also create a totally custom form or button for this package, as long as all the required information is passed to clients.php . If you do not desire all the information, then simply include null values in hidden fields within your new form. Be aware that all information gathered by clients.php is used within OpenX. Example: If you decided not to use clients domain url. The url is set as the campaign name within OpenX by RevMax so you would then have campaigns named “NULL”.

This post assumes you have downloaded RevMax 3 and unzipped it to your local computer.
If you do not have RevMax you may get more information and purchase it here.

RevMax is encoded with Ioncube and will require ioncube loaders installed on your server to function. If you arent sure you can download the Helper.zip file and upload to your server for more information and or installing the loaders. Indepth instructions on installing ioncube loaders can be found here.

Installation

1) Open a ftp client such as wsftp or other and sync the downloaded files and your OpenX installation on your server.
2) Upload all files in the directories as shown in the install package in binary mode.The files are encrypted using Ioncube loaders and will not run in ascii mode.

It is safe to highlight all files and folders as shown above and transfer contents without transferring each individual file.

3) Navigate in a web browser to yourdomain /openxfolder/ installsql and run the script there named revmax.db.installer.php. This will install the required tables for RevMax to operate.
a) If you would prefer to verify and or change the table names to be inserted into your OpenX database, open the file “db.mysql.sql” and edit if needed. You may then use the install script or copy and paste the sql into your phpmyadmin screen or other mysql admin.

Logging In to Set Up RevMax

4) Log into your Openx 2.6 Installation. And switch to administrator mode. You will not be able to view or modify RevMax settings while working in default, or other manager mode.

You will then be able to see the RevMax tab at the top right of your admin screen.

Click the RevMax tab to navigate to RevMax. There you will see a RevMax updates page, with news of any product updates, and 4 new RevMax tabs, entitled “RevMax Settings”, “Ad Packages”, Discount Coupons” , and “Payment Reports”.

RevMax Configuration

5) Click the “RevMax Settings” tab to get started configuring RevMax. Here you will find two links labeled RevMax “Database Settings” and “Paypal Settings”.

Configuring The Database

6) Click the “RevMax Database settings” link to configure the RevMax database.
While here you will need to tell RevMax what the table names are that it will be working with. The default installed tables are listed to the left. It is safe to simply copy and paste the names into the settings boxes unless you have chosen to rename the tables after installing them. Remember to enter in any new table names you may choose later.
Hint: Your config file must be writable to add RevMax database and paypal settings.

7) Once you have entered the database table names, click “Revmax Settings” tab again and choose the “paypal Settings” link. From this screen you can enter in your paypal settings as outlined below.

Configuring Paypal IPn Payments

a) Paypal email : This is the email where you will accept paypal payments recieved by RevMax.
b) Payment Admin eMail: The email address you would like script notifications sent to.
c) Paypal Url: You may set this to www.paypal.com or www.sandbox.paypal.com or other testing domain / script. The https: is handled within RevMax leave it out.
d) Paypal IPN Script URL: The paypal script is located within the clients folder. depending on your Openx install it may be yourdomain.com/openx/clients/paypal.php or yourdomain.com/clients/paypal.php, or other.
e) Paypal Return URL Location: This is the url that a user will return to after clicking return to merchant at paypal. You may set this to your openX admin folder or create a page in another location, giving clients more information and or a log in link. You may also use a custom script at this location as paypal will post back the information it received.
f) Cancel Payment Return Url: Enter in here the url you would like the customer to be returned to if the payment was canceled.
g) Client Log In URL: This is the client log in url sent in the customers welcome email. You can simply set this to /www/admin/ for instant login after payment, and banner upload if using the banner upload mod.
h) Payment Currency: Set htis to the currency you will be accepting USD for united states dollars.
Note: Language location in (i) must match or you will recieve errors.

Other Available Currency settings:
• AUD Australian Dollar: $12,500.00 AUD maximum per transaction
• CAD Canadian Dollar: $12,500.00 CAD maximum per transaction
• EUR Euro: €8,000.00 EUR maximum per transaction
• GBP Pound Sterling: £5,500.00 GBP maximum per transaction
• JPY Japanese Yen: ¥1 million JPY maximum per transaction
• USD U.S. Dollar: $10,000.00 USD maximum per transaction
• NZD New Zealand Dollar, 15,000 NZD maximum per transaction
• CHF Swiss Franc, 13,000 CHF maximum per transaction
• HKD Hong Kong dollar, 80,000 HKD maximum per transaction
• SGD Singapore Dollar, 16,000 SGD maximum per transaction
• SEK Swedish Krona, 80,000 SEK maximum per transaction
• DKK Danish Krone, 60,000 DKK maximum per transaction
• PLN Polish Zloty, 32,000 PLN maximum per transaction
• NOK Norwegian Krone, 70,000 maximum per transaction
• HUF Hungarian Forint, 2,000,000 maximum per transaction
• CZK Czech Koruna, 240,000 maximum per transaction

i) Seller Language Location: Set this to match your accepted currency and language. Usually abbreviated, if paypal currency = GBP then language location would be GB.

Subscription Recurring Values
a) Subscription billing cycle: If renting ad space by the month set to 1, you may also sell ad spaces for increments like 6 months.
b) Subscription billing Unit: W= Weeks, M= Months, Y= Years. Enter in here the cycle you will be using. Example renting ad space for 2 weeks would be billing cycle = 2 unit = W.
c) Subscription recurring: 1 = Yes to recur 0 = no not recur bill the client.
d) Re bill re attempt: 1 = Yes 0 = No to force retry on failed subscriptions.
Enable Paypal Payments
Check the box to enable RevMax to accept paypal payments, before clicking submit.

You should now have RevMax configured to accept Paypal payments for OpenX 2.6. Stay tuned for next post entitled configuring ad packages and discount coupons. If you do not have RevMax you may get more information and purchase it here.

See also: Installing and configuring the included advertiser banner upload mod for OpenX 2.6 And configuring ad packages within Openx here.

We have decided with such a huge demand for such a mod that perhaps it was time to release a version that did not require the purchase of RevMax or our prior plug-in for OpenAds 2. This page details where to get the mod, installation, it’s features, configuration, and actions.

First if you do not have the mod already simply stop by here and add it to your cart and check out. you will have instant download access after payment.

Installation

The next step as found in the install.txt is to either make a back up of the files you are to replace, or rename them for future reference.

Upload the included files into your OpenX admin directory. If your openx 2.6 install is at yourdomain.com/openx/ then the correct path to upload the included files to would be yourdomain.com/openx/www/admin/.

Once you have uploaded the modified files you will need to log in to OpenX as the default manager.

You will then need to make a decision as to what types of files and storage you would like to allow your advertisers to use.

Admin Configuration

Defining file (banner) storage:
Switch to administrator account.
Click “my Account” > click “global settings” > pull down list to “banner storage settings”.

Advertiser banner upload permissions:
OpenX Log in, switch to default manager account.
Click the “inventory” tab at the top center.
This should open up “advertisers and campaigns” screen.

If you do not yet have a advertiser to configure click “add advertiser” and configure a new advertiser account. Return to the “advertisers and campaigns” screen

Click the advertisers name and the advertiser properties screen will appear.
Click “User access”.

If you have not yet enabled an advertiser to log in to this account then take a moment to add a user account here by clicking “add user” and return to the “user access” screen.

Click “permissions” to the right of the advertisers name you would like to enable banner uploads for.
This will open the “user properties” screen.

Check the box entitled “Allow this user to modify his own banners “.
Click save changes.

Warnings:
Any advertiser you may have already added and have checked this box for will now have permission to upload banners to their account. Take a moment to review your already configured advertiser accounts to ensure you do not enable permissions that you would not wish.

Advertisers perspective

After deciding what types of banner storage to allow for your advertisers, and adding the permissions to the advertiser account the advertisers will be able to add banners using that storage method as shown below from the advertisers perspective.
Add banner link:

Upload banner screen:

Permissions error:
By unchecking “Allow this user to modify his own banners” the advertiser will no longer have permission to modify existing banners and will receive a permissions error screen as below when attempting the actions of upload and or modify.

Get the advertiser banner upload mod for Openx 2.6

You can stop by here to purchase the banner upload mod for OpenX 2.6