Installing Using RevMax for OpenX
Warning this information may be outdated. Please see the forum for up to date RevMax help and instructions. http://www.openxpayments.com.
Installing RevMax 4 for Openx 2.8
downloading Unpacking The Plug in:
Once you have purchased RevMax and downloaded it from the link in your payment email, rename the file RevMax-Package or similar as to easily identify the plugin later, then using any zip utility, unzip the package to a location that is easy to locate on your local machine. Once unzipped you will have a folder named “RevMax-Package” or the above chosen name, inside this folder you will find two more zip files, one named clients and one named RevMax.zip. (purchase)
Uploading Installing The RevMax Plugin
Using any ftp program or shell you can transfer the clinets.zip folder to your OpenX install path and unzip it there or unzip clients.zip on your local machine and upload. if your OpenX install is similar to mydomain.com/openx/ then the clients folder will be located at mydomain.com/openx/clients/. While there you may want to check the file and folder permissions and set folders 775 and files 644, or similar depending on your servers configuration.
Now log into your OpenX installation and switch to the administrator account, now switch to the plugins page.
Click the browse button and browse to the “RevMax-Package” folder on your local machine and find the file named RevMax.zip click on it then click install. RevMax 4plugin will then be installed on your server and you will now see a new tab, while logged in as admin, named RevMax.
Expanding Openx 2.8 Advertiser capabilities
RevMax 4 plugin for Openx 2.8 offers the admin an ability to sell or rent ad space on a website or a network of websites. Being equipped to accept Paypal authorixe.net, and WorldPay payments, and send custom emails it will require a bit of set up before a actual test or live transaction can take place. (purchase)
Configuring RevMax
On the OpenX plugins page you will now see a plugin labeled RevMax 4.0.1 beside the name you will note details, disable, and uninstall by clicking on details you are presented with licensing information and settings for RevMax and the group plugin settings for RevMax (paypal), authorize.net, WorldPay and Clients settings. You may also note you can create a backup of the RevMax tables at anytime. Once created you will find the backups named RM_tablename_date_here_ within your OpenX database. It is recommended you backup your data from time to time and before any upgrades or installations.
Configuring Authorize.net Payments
Click on authnet > settings.
authorize-net-settings
Here you can enter:
a) Authorize.net Login Id : This is the login id assigned by authorize.net
b) Transaction Key:
c) Test Mode :
d) Secret Hash Key:
e) Authorize.net URL: Enter https://test.authorize.net/gateway/transact.dll for test transactions.
f) Notify script Url: Url to the authnet.php file. http://www.domain.com/openx/clients/annotify.php
g) Enable Authorize.Net Payments: Check to enable authorize.net payments and show the processor on advertisers.php and clients reorder screens.
Configuring Paypal Payments & Subscriptions plugin
Click the settings link to the right of RevMax on the group settings page to open the paypal payments configuration. If you are not going to be using paypal, you may skip this step.
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.
a) Subscription recurring: Checked = Yes to recur Unchecked = no not recur bill the client.
b) Re bill re attempt: checked = Yes Unchecked = No to force retry on failed subscriptions.
Enable Paypal Payments:check the box to enable RevMax to accept paypal payments, before clicking submit.
Configuring WorldPay Payments Plugin
From the RevMax plugins group settings you may click on the link to the right of WorldPay entitled settings. From here you can configure Revmax to accept worldpay payments and their version of subscriptions futurepay. If you do not intend to use WorldPay you may skip this step.
a) Your Installation Id : This is the Installation Id assigned to you from WorldPay.
b) Payment Admin eMail: This is the email you would like to recieve purchase confirmations and reciepts to.
c) Worldpay Payment url : This is set to ( select.worldpay.com ) when live, do not enter http or ().
d) Worldpay Payment Testing : Enter 0 for live or 100 for testing
e) Worldpay Notify Script Url : wpnotify.php . You must set the correct url here for worldpay to notify RevMax of the purchase. enter in like: http://yourdomain.com/openx/clients/wpnotify.php
f) Worldpay Notify Script Password : Enter in the password chosen at worldpay for this instalation.
g) Log In url sent in client welcome email: Enter in the complete url to your OpenX admin screens like: http://www.yourdomain.com/openx/www/admin/
h) Payment Currency : (USD or other) please see paypal configuration for possible variables other than USD.
i) Payment Unit : The unit of the delay between creation and the first subscription payment.(1-day, 2-week, 3-month, 4-year)
J) Subscription billing cycle : (1-day, 2-week, 3-month, 4-year).
k) Number of subscription payments: Set to 0 or leave blank for unlimited. set to 12 to limit subscriptions to 1 year rebilling.
l) Enable WorldPay Payments : Check to enable WorldPay payments, unchecked is off and the worldpay logo and payment option will not be displayed on the signup forms or in the client reorder screens.
Switching to RevMax Plugin within OpenX
By clicking on the newly presented RevMax plugin tab the OpenX admin is taken first to the RevMax updates page. This page originates from btdsoft.com as a feed and will keep you informed as to the expansion and further development of RevMax. To limit the load on your resources this page is now cached on your server for seven days before it is loaded again from ours. If the feed is ever in error the page will simply provide a link back to the updates page at btdsoft.com. No RevMax pages either request information from your servers nor send any information to ours. (purchase)
RevMax Ad Packages OverView
By clicking the Ad Packages button to the left you are presented with a page where you can create, edit and view created ad packages. Once a ad package is created it will show here and depending on settings, in other areas.
ad-packages-overview
Creating Ad Packages within RevMax
By clicking the “ad package” link you are presented with a page to set up and configure your first ad package. The ad package defines what you are entitling the purchasing advertiser to, which can be as specific as 1 week leaderboard rotation on a single page or 100000 adviews across a network of sites.
ad-package-top
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)Subscription Billing Cycle:If subscription has been selected above this defines the billing cycle of this particular ad package, if renting for 1 week then set to 1 or 3 months set to 3 and likewise.
c)Subscription Billing Unit:If subscription has been selected above this defines the billing unit of this particular ad package, if renting for 1 week then set to W or 3 months set to M and Y being year(s) .
d) 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.
e) 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.
f) 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 “,”.
g) Auto Zone ID: Select one or more zones here from the list, that you would like to link an advertiser campaign to a specific publishers zone within OpenX. The iframe list the the zone description you have entered when creating the zone within OpenX. Check which zone or zones you would like the advertisers campaign linked to. This feature is extremely useful when selling ad space across a network of sites. For instance a package for domainb.com’s leader board can be easily linked here.
ad-packages-bottom
h) Auto Zone: Select yes or no to allow advertisers banner to be automatically attached to a specific, or multiple zones selected above. 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.
i)Companion Positioning:
Select on to enable companion positioning in campaign.
j) Priority Level: You can choose to set a higher priority for paid campaigns here,a priority of 5 will create a contract campaign and limit the adviews. 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.
j) 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, a weight of 5 will create a remnant campaign with no daily limit. 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.
k) 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”.
l)Available for reorder:
Select yes if you would like the ad package available on the advertisers > Resources> reorder screen within the clients area. This is available to sell existing clients more adviews, or adclicks, on existing campaigns. It is advisable to create 1 adviews reorder package and 1 adclicks reorder package to be shown on the clients screen.
Discount Coupons
Clicking the Discount Coupons link on the left RevMax menu opens the coupons overview page. Here you can add new discount coupons, edit or delet e existing coupons. Discounts are expressed as a percentage of 100 so .10 would be 10% off .20 would be 20% off and so on.
Paypal Payments
From this screen you have a view of the total payments to date and the ability to search payments on many given variables such as email, campaign id user id transaction id etc.
WorldPay Payments
From this screen you have a view of the total payments to date and the ability to search payments on many given variables such as email, campaign id user id transaction id etc.
Pending Publishers
You have the ability to enroll publishers accounts with RevMax After they submit the form you will recieve an email and then can make a determination on aproving the publisher. From this screen you can view edit and approve new publishers.
Approving Publishers
Here you have settings to further automate the approval process. You can automatically create new zones, chain the new publisher zones to existing ones, and set new publisher permissions. (purchase)
a) Check to create new publisher zones: When enabled you may select standard zone sizes below to create new publisher zones.
b) New publisher zones to create: Select one or all standard publisher zones to be created with the publishers approval.
c) Zone chaining Linking: If you have a default publisher you can set the zones here to chian to the new publisher so as to not have to link advertisers to the new publisher. Caution at last attempt OpenX did not support publisher stats for a chianed publisher. Alll stats default to the original chained publishers zones.
d) Select New Publishers Permissions: Here by checking you can enable a new publisher to Create New Accounts ,Modify His Own Zones , Define New Zones , Delete Existing Zones , Link Banners To Own Zones ,Generate Invocation Code. You may wish to only select “Generate Invocation Code” to further secure your installation.
e) Check to send custom email: If you wish to send this new publisher a custom email simply select here and enter custom text into the box below. When not selected the email will be sent using a template in /openx/www/admin/plugins/RevMax/tempaltes/Pwelcome.tpl Please see emails help.txt while in that folder for further email modifications.
Approved Publishers
From the approved publishers page you can view edit and delete publishers that have been approved with the RevMax system. Here you will have access to thier information such as email, telephone number address, and more all searchable.
Publishers Information
From this screen you have information on the enrolled publisher such as contact information, enrolement date and more. All thease fields are valid input for your signup forms. If unneeded simply leave out of sign up form. (purchase)
Comments
Advertisement
