Omnistar Affiliate Software

You can use the Omnistar (OSI) Affiliate Software with the WordPress Shopping Cart plugin using the Affiliates & Tracking extension plugin and the instructions in this documentation.

This document will help you to set everything up from beginning to end in order to track both clicks and sales into your Omnistar (OSI) Affiliate Software through your WordPress site.

Requirements

The following things are required before you continue through the instructions:

• WordPress Shopping Cart plugin
• Affiliates & Tracking extension plugin
• Omnistar (OSI) Affiliate Software account

Get The Tracking Codes

Go to your Omnistar Affiliate Software admin panel. The URL to the panel will be given to you by Omnistar Affiliate Software when you sign up with them. The URL Is something like: https://xxxxxx.myomnistar.com/admin/

Then go to Getting Started > Easy Setup Wizard and click the “I want to get the code to insert on my landing and thank you pages” link to continue. A new tab/window will open with further information.

There are 2 sets of code which you’ll need to copy. The first code is the click tracking code which will display in all pages of your site to track incoming clicks from your affiliates to your site. The second code is the sales tracking code which will be executed upon a successful purchase by a client/customer on your site to record a sale through Omnistar Affiliate Software.

1. Get the Click Tracking Code

Under “Step 1. Add code to your landing pages” of the Omnistar Affiliate Software Easy System Integration Wizard, you’ll see a box/textarea which has Javascript code in it.

Click the “Select All” button and then right-click and select “Copy” to copy the code. Put this code somewhere in a text file or some place where you can access it later in this documentation.

This is the clicks tracking code which goes into every page of your website to track incoming clicks from the links of your affiliates to your website. This code will track that.

2. Get the Sales Tracking Code

Under “Step 2. Choose your shopping cart or gateway” of the Omnistar Affiliate Software Easy System Integration Wizard, you’ll see a drop down menu where you can select “General“.

Then you’ll see another box/textarea appearing with Javascript code in it. Again, click the “Select All” and right-click and select “Copy” to put the code into your clipboard. Again, put this code somewhere in a text file or some place so that you can use it later in this documentation.

This is the sales tracking code which will be used specifically when an order on your site has been completed. The code will be executed to notify your Omnistar Affiliate Software account that a sale has been made and Omnistar Affiliate Software will determine if the client/customer came from an affiliate, assign the commission, etc.

Configure Tracking

Go to your WordPress installation and navigate to Checkout > Configuration > Tracking (tab) in the Shopping Cart plugin where you will configure the clicks and sales tracking codes.

1. Configure Clicks Tracking Code

In the “Clicks Tracking (Incoming Referrals)” box you can now configure the clicks tracking code.

Select “Javascript” as the “Type of Code“.

Now get your clicks tracking code which you previously saved from Omnistar Affiliate Software in Step 1 and paste it into the “Clicks Tracking Code” box. Once you’ve pasted it, remove the SCRIPT tags around the code. There is a tag at the start and a closing tag at the end, remove both so that your code in the box looks like the image above.

The code will look like this:

document.write(unescape("%3Cscript id='omniaff_o789258' src='" + (("https:" == document.location.protocol) ? "https://" : "http://") + "tribulant.myomnistar.com/track.js' type='text/javascript'%3E%3C/script%3E"));

Please note in the above code that certain values will be unique to your Omnistar Affiliate Software account so don’t use the code above just as is, it is just an example.

That’s it, let’s move to the sales tracking code now.

2. Configure Sales Tracking Code

In the “Sales Tracking (Sales Conversion)” box, you can now configure the sales tracking code.

First select “HTML Code” for the “Type of Code” setting.

Now get the sales tracking code which you previously saved from Omnistar Affiliate Software in Step 2 above and paste it into the “Sales Tracking Code” box.

Remove all the Javascript code completely and the DIV at the end of the code, leaving just the iFrame HTML code. Then remove the onload attribute from the iFrame element as well, leaving you with a clean iFrame and just HTML.

After the amount= put the tag {affiliates_ordertotal} and after the transaction= put the tag {affiliates_orderid} so that the total and the ID of the order can be sent through to Omnistar Affiliate Software.

The code should look like this:

<iframe src="https://tribulant.myomnistar.com/salejs.php?amount={affiliates_ordertotal}&transaction={affiliates_orderid}" alt="" id=IF width=50 height=50 border="0" frameborder="0">

Please note that the code above is just an example and for reference purposes. The actual URL of the src attribute will be different in your code.