Search
Paste from Microsoft Word
Undo
Redo
Foreground Color
Background Color
Insert Hyperlink
Insert Image
Insert Table
Absolute
Special Characters
Insert Line
Remove Formatting
View /Edit HTML Source
Affiliate marketing is a system of revenue sharing between a merchant (website) and an advertiser (the affiliate). This system allows the merchant to recruit or signup affiliates/advertisers to advertise their products and/or services in return for a commission on sales sold by that affiliate.
Normally, this type of marketing works by having the merchant website create an affiliate program that affiliate members can join. Upon joining, the affiliate is given a unique website URL to promote that merchant's products and/or services. By promoting this link, any referrals that click on this unique link are tracked. When the referring customer buys from the merchant, the affiliate member is given a commission for that referring sale.
Merchants can pay affiliates in many different ways. These include pay-per-sale, pay-per-lead, or pay-per-click. This depends entirely on the merchant website and how they want to reward their affiliate members.
JROX.COM Affiliate Manager, also known as JAM, is an affiliate and membership management system. This system allows you to recruit, manage, and build an army of online affiliates that can help promote your products and services throughout the Internet.
What is an Affiliate?
An affiliate can be described as a 'virtual salesperson', one that can help refer new customers to your online business in exchange for a commission when sales are generated. This affiliate can come in the form of a website owner, another internet business, or an Internet webmaster.
Where does JAM come in?
JAM can be used to help you recruit and manage these affiliates as well as give them exclusive access to marketing and promotional tools to promote your business. These tools have unique tracking codes that your affiliate can use so that any referring customer that they send to you, they will get the proper commission for it.
JAM will help you manage most of the aspects of your affiliate marketing strategy from signup, to member management, to payment of affiliates, and to keeping proper records of commissions. It will also manage your affiliate marketing tools such as banner ads, text links, email ads, and so forth that you will assign to each affiliate to help you promote your Internet business.
JROX.COM Affiliate Manager allows you to manage and administer every facet of your affiliate program. It has rich and extensive features that allow you to efficiently administer all of your affiliates as well as the commissions that they generate.
To begin the administration tasks of managing your affiliates using JAM, here is a quick rundown of the main navigation and sections of JAM:
Affiliates
Commissions
Reports
Marketing
Programs
Settings
Some of these site map links have drop-down menus to make it even easier to access specific functions, such as Affiliates>Edit / Delete Affiliates.
JAM has a great feature in its bookmarks module. By using the bookmarking feature, you can save and bookmark any page on JAM so you can easily get to it from any page on the site, without having to click back to it too many times.
The bookmarks module is located on the upper right of the screen.
Create a Bookmark
To create a bookmark, click on the Star Icon to launch the bookmark window:
Accessing Bookmarks
To access your bookmarks, click on the View Bookmarks link and a drop-down list will appear, listing the 10 most recent bookmarks you have.
Deleting Bookmarks
To delete a bookmark, click on the View Bookmarks link and select Manage Bookmarks from the drop-down menu. You will now have all your bookmarks listed, and you can delete one by clicking on the Delete Icon.
You can also assign your affiliates to specific affiliate groups for better management and emailing.
Affiliate Groups are used to help segment your affiliate members for mass emailing, group commissions, and exclusive access to downloadable files.
Here are a few examples of what to use affiliate groups for:
Creating Affiliate Groups
To create affiliate groups, go to Settings > Affiliate Settings > Add Group.
Assigning To Groups
To assign affiliates to certain groups, follow these steps:
Viewing Group Members
To view group members, select the View By Group drop down menu near the bottom of Affiliates > Edit / Delete Affilates
Sometimes, certain affiliates have different requirements and different options than other affiliates. JAM allows for a number of custom options to be set for individual affiliates.
Custom Payout
This option can be set if you want this affiliate to have a different minimum payout balance than the one you set in Settings > Payment Settings.
For example, an affiliate does not want to get paid until his balance reaches $500, but your default minimum balance is $100. You can enable the Custom Payout option in the Affiliate Details and set the number for it to 500. This way, when you click on the Pay Affiliates link and view affiliates with minimum balances, this affiliate will not appear until his custom payout amount has been reached.
Custom Commissions Per Program Per Level
JAM allows you to create custom commissions for an affiliate for each of your programs different levels.
For example, if you normally pay affiliates a 10% commission for Program 1 and 15% commission for Program 2, but want to pay this affiliate 15% on Program 1 and 25% on Program 2, just click on the Create Custom Commissions link in their Affiliate Details and fill in the custom commissions amounts for each of your programs for this affiliate. Make sure you set it to Enable so that the system knows that this affiliate requires a custom amount when a commission is generated for that particular program.
You can specify custom amounts for those programs that have multiple levels as well.
Custom URL
This option allows you to point your affiliates to a specific URL of your choice, instead of the default product URL that you set in the Products Area.
Custom ID (For Offline Marketing)
This is used in conjunction with the Offline Marketing Module for setting up offline codes. You can change this to any alphanumeric phrase that you want.
To delete an existing affiliate, click on the Edit / Delete Affiliates from the drop down menu and click on the Delete Button to delete an affiliate.
*Remember, deleting an affiliate that has existing commissions, payments, or traffic data will erase all of that existing data as well. If you want to keep an existing affiliate's records, you can just change that affiliiate's status to Inactive, so that person no longer can login or use his/her account.
The built-in email function of JAM allows you to keep in touch with all of your affiliates by sending them the latest updates and news regarding your program and services. You can send a broadcast email to any of your affiliates manually, or schedule them on a specific date.
Broadcast Email
To send a broadcast email to your affiliate members, click on Email Affiliates on the main drop down menu.
Send an Email to One Affiliate Member
You can also send a single email to any affiliate member by clicking on the email icon in the Account Details page for each affiliate.
Email Format - Send your email either in HTML, Text, or both. Sending both types means it will automatically select between Text or HTML depending on what your affiliate member's email reader can view.
Send Email To - Select which affiliate groups to send to. This option is only available when sending a broadcast email.
Schedule Email - Select whether to schedule the email to be sent now, or sometime in the future.
Subject - Enter the subject of your email message
Custom Tags - Custom tags are used to automatically represent your affiliates' information details. For instance, the custom tag: %%%USERNAME%%% represents the current affiliate's username. You can use these tags in your messages to represent your affiliate members info in your emails. Some of the custom tags you can use are:
- %%%USERNAME%%% - Username Variable
- %%%FIRST_NAME%%% - First Name Variable
- %%%LAST_NAME%%% - Last Name Variable
- %%%AFFILIATE_URL%%% - Affiliate URL Variable
*Certain tags are only available to use for certain templates. Please use the drop down custom tag menu to see what choices are available for that email or template.
HTML Editor
The HTML Editor can be used to format your email messages in HTML format. For more information on the HTML Editor and its settings, click here
Once you're done, just click on Send Email Message to send your email.
*All emails that are sent "now" are first queued and are automatically sent via the cron job on the next scheduled interval, usually 10 or 15 minutes.
System Templates
System Templates can also be used to create email templates that are used often. This allows you to quickly send an email to your affiliates without having to rewrite it every time. For more on system templates, click here.
The Data Export function allows you export data directly from your JAM database. You can export Affiliates, Commissions and Events.
Export Formats can be: Tab Separated, Comma Separated, or Excel-Format.
Data Export can be run by clicking Settings>Data Export.
To generate the export, click on Export Data once you've chosen your export options.
You can add affiliates into JAM using two methods. First, you can use the signup form or add them manually in the admin area by clicking on Affiliates > Add New Affiliate
The only required fields when adding affiliates are First Name, Last Name, Email Address, and whatever fields you set in Settings > Signup Settings
JAM allows you to import your affiliate members directly into the database via a tab-separated or comma-separated file.
To import your members, follow these steps:
The only required columns for import are first name, last name, and email address. All other columns are optional. Only .txt or .csv file extensions allowed.
Click on Settings > Import / Export > Click Here to Import Data.
The HTML Editor is a feature in JAM that allows you to add /edit/ and create HTML-based templates and ads easily, with very minimal HTML knowledge.
The HTML Editor is available to use if you use the following browsers:
Internet Explorer 5.5 and up
Netscape / Firefox 1.0 and up
The icons in the HTML Editor can do the following:
|
Preview |
|
|
Search |
|
|
Paste from Microsoft Word |
|
|
Undo |
|
|
Redo |
|
|
Foreground Color |
|
|
Background Color |
|
|
Insert Hyperlink |
|
|
Insert Image |
|
|
Insert Table |
|
|
Absolute |
|
|
Special Characters |
|
|
Insert Line |
|
|
Remove Formatting |
|
|
View /Edit HTML Source |
The Pay Affiliates function is used to record payments to your affiliates.
Once an affiliate has reached the minimum required balance set in Settings > Payment Settings, they will automatically appear in the Pay Affiliates section.
There are several options for paying affiliates, depending on your chosen payment options. Here are some examples:
Print Payment Invoices
Pay via Paypal Email Address
Pay via Paypal Mass Payment option
Print Payment Invoices
You can 
print out payment invoices for each of your affiliates if you want. This can be used to accompany the check payment you will be sending to them.
Customizing Payment Invoices
You can customize the payment invoice template by opening and editing the following file to suit your needs:
admin/includes/html/themes/templates/forms/form_admin_pay_affiliates_invoice.php
Pay via Paypal Email Address
You can pay your affiliate directly if they have a paypal email address set. By clicking the 
Paypal icon in the list, you can send a Paypal payment directly.
Pay via Paypal Mass Payment
If you have a number of paypal payments to make, you can use the Paypal Mass Payment option to upload payments to Paypal using a tab-delimited file. To generate this file, check all of the Paypal users you have on the list and select Paypal Mass Payment on the drop-down menu near the bottom of the list.
When you generate the Paypal Mass Payment file, you will download a tab-delimited file which you can then upload directly to Paypal to pay your affiliates quickly.
*Other Mass Payment options are available, such as SafePay, AlertPay, and Moneybookers Mass Payment Files.
How to Pay Affiliates
JAM has a specific method in paying affiliates. Follow these steps to properly pay affiliate members their commissions.
Login to JAM and click on Edit / Delete Commissions.
If you have any Pending commissions, review them first and make sure they are all valid. If they're all good to go, scroll down to the bottom of the screen, and select Unpaid in the Mark Checked As drop down menu. Select the checkbox for all those commissions you want to update.
If you have the Alert Affiliate on Commission Generated option set in Settings > Affiliate Settings, an email will be sent to each affiliate notifying them of the commission.
Before you pay affiliates, you now will have to set any commissions that are not yet approved to Approved status. Those that are still not approved are marked with the following icon: 
All approved commissions will be marked with this icon: 
Select all the commissions you want to approve for payment in the Edit / Delete Commissions page.
Once you have approved commissions, you now can proceed to the Affiliates > Pay Affiliates section to generate invoices or download the Mass Payment file. You can also pay affiliates manually using direct payment option or creating an invoice for printing here.
Once you've finished paying affiliates, in the Pay Affiliates screen, scroll down to the bottom to the Mark Checked For drop down menu and select the method you have paid affiliates with. From there, check all the affiliates you have paid in the right hand side checkboxes and click Go.
You have now recorded successful payments for your affiliate members.
You can view all Payment History by clicking on the Payment History link in Commissions > Payment History.
The Search Affiliates function allows you to search your Affiliate Members' information based on a select criteria.
To search affiliates, click on the Search Affiliates link on the main drop-down menu.
You can search affiliates using the following search categories:
Username
First Name
Last Name
Primary Email
Website
Address
City
State
Country
After executing the search query, all matching search terms are displayed in row function.
To view your existing affiliates, click on the Edit / Delete Affiliates drop down menu.
To edit an affiliate, click on the Edit Affiliate button
To integrate the Automatic Signup Module with 1ShoppingCart, follow these instructions:
Login to JAM. Click on Settings > Signup Settings.
To enable the Automatic Signup Module, set the Enable Automatic Signup Module to Enable.
Enter a Secret Word for the Auto Signup Secret Word field. This is used to ensure that your automatic signups come from a trusted application.
Click Edit Settings to save the form.
Now, you will have to open up and edit a few files. First, open up /plugins/signup_automation/external/plugin.autosignup.php.
Scroll to the section that says //SET JAM VARIABLES.
Edit the following section with your Auto Signup Secret Word and the full URL to your affiliates directory:
$JAM_Secret = "secret_word"; //SET THIS VARIABLE TO ENABLE SECURITY CHECK OF AUTOSIGNUP
$JAM_Affiliate_URL = "http://www.domain.com/affiliates"; //DO NOT ADD TRAILING SLASH
Save the file.
Now, you will need to edit your thank you page. Make sure this is in .php format.
//BLOCK FOR JAM-ASM MODULE INTEGRATION
$JAM_Aff_Directory = '/home/username/public_html/affiliates_directory';
$JAM_ASM_Type = '1shoppingcart';
require $JAM_Aff_Directory . '/plugins/signup_automation/external/plugin.autosignup.php';
//END JAM-ASM MODULE INTEGRATION
You will need to change /home/username/public_html/affiliates_directory to point to your affiliates directory.
Save the file.
Now, run a test transaction in 1ShoppingCart.
Once you've created it, login to JAM and verify that the new affiliate exists.
When all is working, you will now have JAM automatically signing up your customers as new affiliates as well.
To integrate the Automatic Signup Module with 2Checkout, follow these instructions:
Login to JAM. Click on Settings > Signup Settings.
To enable the Automatic Signup Module, set the Enable Automatic Signup Module to Enable.
Enter a Secret Word for the Auto Signup Secret Word field. This is used to ensure that your automatic signups come from a trusted application.
Click Edit Settings to save the form.
Now, you will have to open up and edit a few files. First, open up /plugins/signup_automation/external/plugin.autosignup.php.
Scroll to the section that says //SET JAM VARIABLES.
Edit the following section with your Auto Signup Secret Word and the full URL to your affiliates directory:
$JAM_Secret = "secret_word"; //SET THIS VARIABLE TO ENABLE SECURITY CHECK OF AUTOSIGNUP
$JAM_Affiliate_URL = "http://www.domain.com/affiliates"; //DO NOT ADD TRAILING SLASH
Save the file.
Now, you will need to edit your thank you page. Make sure this is in .php format.
//BLOCK FOR JAM-ASM MODULE INTEGRATION
$JAM_Aff_Directory = '/home/username/public_html/affiliates_directory';
$JAM_ASM_Type = '2checkout';
require $JAM_Aff_Directory . '/plugins/signup_automation/external/plugin.autosignup.php';
//END JAM-ASM MODULE INTEGRATION
You will need to change /home/username/public_html/affiliates_directory to point to your affiliates directory.
Save the file.
Now, run a test transaction in 1ShoppingCart.
Once you've created it, login to JAM and verify that the new affiliate exists.
When all is working, you will now have JAM automatically signing up your customers as new affiliates as well.
Login to JAM. Click on Settings > Signup Settings.
To enable the Automatic Signup Module, set the Enable Automatic Signup Module to Enable.
Enter a Secret Word for the Auto Signup Secret Word field. This is used to ensure that your automatic signups come from a trusted application.
Click Edit Settings to save the form.
Now, you will have to open up and edit a few files. First, open up /plugins/signup_automation/external/plugin.autosignup.php.
Scroll to the section that says //SET JAM VARIABLES.
Edit the following section with your Auto Signup Secret Word and the full URL to your affiliates directory:
$JAM_Secret = "secret_word"; //SET THIS VARIABLE TO ENABLE SECURITY CHECK OF AUTOSIGNUP
$JAM_Affiliate_URL = "http://www.domain.com/affiliates"; //DO NOT ADD TRAILING SLASH
Save the file.
Now, open up your /plugins/payments/alertpay/plugin_alertpay_payments.php file.
Scroll down to this line and add the following snippet of code:
if ($_POST['ap_status'] == 'Success')
{
require "../../../sale.php";
//BLOCK FOR JAM-ASM MODULE INTEGRATION
$JAM_Aff_Directory = '/home/username/public_html/affiliates_directory';
$JAM_ASM_Type = 'alertpay';
require $JAM_Aff_Directory . '/plugins/signup_automation/external/plugin.autosignup.php';
//END JAM-ASM MODULE INTEGRATION
You will need to change /home/username/public_html/affiliates_directory to point to your affiliates directory.
Save the file.
Now, run a test transaction in AlertPay.
Once you've created it, login to JAM and verify that the new affiliate exists.
When all is working, you will now have JAM automatically signing up your customers as new affiliates as well.
To integrate the ASM with aMember, follow these instructions:
You now have JAM integrated into aMember for Automatic Signups.
Login to your Authorize.Net account.
Click on Settings > Silent Post URL
Enter the following URL String: http://www.domain.com/affiliates/plugins/signup_automation/external/authorize_net/autosignup.form.php
Change the www.domain.com/affiliates to your JAM installation URL.
Click Submit.
Login to JAM. Click on Settings > Signup Settings.
To enable the Automatic Signup Module, set the Enable Automatic Signup Module to Enable.
Enter a Secret Word for the Auto Signup Secret Word field. This is used to ensure that your automatic signups come from a trusted application.
Click Edit Settings to save the form.
Now, you will have to open up and edit a few files. First, open up /plugins/signup_automation/external/plugin.autosignup.php.
Scroll to the section that says //SET JAM VARIABLES.
Edit the following section with your Auto Signup Secret Word and the full URL to your affiliates directory:
$JAM_Secret = "secret_word"; //SET THIS VARIABLE TO ENABLE SECURITY CHECK OF AUTOSIGNUP
$JAM_Affiliate_URL = "http://www.domain.com/affiliates"; //DO NOT ADD TRAILING SLASH
Save the file.
Now, you will need to edit the /plugins/signup_automation/external/authorize_net/autosignup.form.php.
//SET AUTHORIZE.NET HASH
$auth_secret = "yoursecrethash";
$auth_login = "yourauthlogin";
//BLOCK FOR JAM-ASM MODULE INTEGRATION
$JAM_Aff_Directory = '/home/username/public_html/affiliates_directory';
$JAM_ASM_Type = 'authorize_net';
require $JAM_Aff_Directory . '/plugins/signup_automation/external/plugin.autosignup.php';
//END JAM-ASM MODULE INTEGRATION
You will need to change /home/username/public_html/affiliates_directory to point to your affiliates directory.
Save the file.
Now, run a test transaction in Author.
Once you've created it, login to JAM and verify that the new affiliate exists.
When all is working, you will now have JAM automatically signing up your customers as new affiliates as well.
Installation Notes:
JAM will only create the affiliate if at least the following data values are present in your Authorize.Net transaction:
To integrate the Automatic Signup Module with CubeCart, follow these instructions:
Login to JAM. Click on Settings > Signup Settings.
To enable the Automatic Signup Module, set the Enable Automatic Signup Module to Enable.
Enter a Secret Word for the Auto Signup Secret Word field. This is used to ensure that your automatic signups come from a trusted application.
Click Edit Settings to save the form.
Now, you will have to open up and edit a few files. First, open up /plugins/signup_automation/external/plugin.autosignup.php.
Scroll to the section that says //SET JAM VARIABLES.
Edit the following section with your Auto Signup Secret Word and the full URL to your affiliates directory:
$JAM_Secret = "secret_word"; //SET THIS VARIABLE TO ENABLE SECURITY CHECK OF AUTOSIGNUP
$JAM_Affiliate_URL = "http://www.domain.com/affiliates"; //DO NOT ADD TRAILING SLASH
Save the file.
Now, you will need to open up the includes/content/reg.inc.php file in your CubeCart folder and add the following code block:
$record["phone"] = $db->mySQLSafe($_POST['phone']);
$record["mobile"] = $db->mySQLSafe($_POST['mobile']);
$record["regTime"] = $db->mySQLSafe(time());
$record["ipAddress"] = $db->mySQLSafe($_SERVER['REMOTE_ADDR']);
//BLOCK FOR JAM-ASM MODULE INTEGRATION
$JAM_Country_Query = $db->select("SELECT * FROM ".$glob['dbprefix']."CubeCart_iso_countries WHERE (id = ".$db->mySQLSafe($_POST['country']).")");
$JAM_CCountry = $JAM_Country_Query[0]['iso'];
$JAM_Aff_Directory = '/home/USERNAME/public_html/affiliates';
$JAM_ASM_Type = 'cubecart';
$JAM_Program_ID = '1';
include $JAM_Aff_Directory . '/plugins/signup_automation/external/plugin.autosignup.php';
//END JAM-ASM MODULE INTEGRATION
You will need to change /home/USERNAME/public_html/affiliates to point to your affiliates directory.
Save the file.
Now, run a test transaction in CubeCart.
Once you've created it, login to JAM and verify that the new affiliate exists.
When all is working, you will now have JAM automatically signing up your customers as new affiliates as well.
*Currently, JAM can integrate ASM with Mal's E-Commerce using the standard Paypal Payment Option Only with a Return Link Web Page Setup.
To integrate the Automatic Signup Module with Mal's E-Commerce, follow these instructions:
Login to JAM. Click on Settings > Signup Settings.
To enable the Automatic Signup Module, set the Enable Automatic Signup Module to Enable.
Enter a Secret Word for the Auto Signup Secret Word field. This is used to ensure that your automatic signups come from a trusted application.
Click Edit Settings to save the form.
Now, you will have to open up and edit a few files. First, open up /plugins/signup_automation/external/plugin.autosignup.php.
Scroll to the section that says //SET JAM VARIABLES.
Edit the following section with your Auto Signup Secret Word and the full URL to your affiliates directory:
$JAM_Secret = "secret_word"; //SET THIS VARIABLE TO ENABLE SECURITY CHECK OF AUTOSIGNUP
$JAM_Affiliate_URL = "http://www.domain.com/affiliates"; //DO NOT ADD TRAILING SLASH
Save the file.
Now, you will need to edit your Mal's E-Commerce Return Link web page. On the very last line of your page, copy and paste the following php code:
//BLOCK FOR JAM-ASM MODULE INTEGRATION
$JAM_Aff_Directory = '/home/username/public_html/affiliates_directory';
$JAM_ASM_Type = 'mals_ecommerce;
require $JAM_Aff_Directory . '/plugins/signup_automation/external/plugin.autosignup.php';
//END JAM-ASM MODULE INTEGRATION
You will need to change /home/username/public_html/affiliates_directory to point to your affiliates directory.
Save the file. Now, run a test transaction in Mals. Once you've created it, login to JAM and verify that the new affiliate exists. When all is working, you will now have JAM automatically signing up your customers as new affiliates as well.
Login to JAM. Click on Settings > Signup Settings.
To enable the Automatic Signup Module, set the Enable Automatic Signup Module to Enable.
Enter a Secret Word for the Auto Signup Secret Word field. This is used to ensure that your automatic signups come from a trusted application.
Click Edit Settings to save the form.
Now, you will have to open up and edit a few files. First, open up /plugins/signup_automation/external/plugin.autosignup.php.
Scroll to the section that says //SET JAM VARIABLES.
Edit the following section with your Auto Signup Secret Word and the full URL to your affiliates directory:
$JAM_Secret = "secret_word"; //SET THIS VARIABLE TO ENABLE SECURITY CHECK OF AUTOSIGNUP
$JAM_Affiliate_URL = "http://www.domain.com/affiliates"; //DO NOT ADD TRAILING SLASH
Save the file.
Now, you will need to open up the include/misc/mod_orderwiz/wizard_submit_process.case.inc.php
// $invoice_id
// $order_totals['sub_total']
// $order_totals['pre_tax']
// $order_totals['tax_due']
// $order_totals['post_tax']
?>
</td>
</tr>
REMOVE THIS LINE WHEN ACTIVE -->
<?php
//BLOCK FOR JAM-ASM MODULE INTEGRATION
$JAM_Aff_Directory = '/home/username/public_html/affiliates_directory';
$JAM_ASM_Type = 'modernbill';
require $JAM_Aff_Directory . '/plugins/signup_automation/external/plugin.autosignup.php';
//END JAM-ASM MODULE INTEGRATION
?>
// +----------------------------------------------+
// | GENERIC AFFILIATE BLOCK - STOP
// +----------------------------------------------+
You will need to change /home/username/public_html/affiliates_directory to point to your affiliates directory.
Save the file.
Now, run a test transaction in ModernBill.
Once you've created it, login to JAM and verify that the new affiliate exists.
When all is working, you will now have JAM automatically signing up your customers as new affiliates as well.
To integrate the Automatic Signup Module with OSCommerce Shopping Cart, follow these instructions:
Login to JAM. Click on Settings > Signup Settings.
To enable the Automatic Signup Module, set the Enable Automatic Signup Module to Enable.
Enter a Secret Word for the Auto Signup Secret Word field. This is used to ensure that your automatic signups come from a trusted application.
Click Edit Settings to save the form.
Now, you will have to open up and edit a few files. First, open up /plugins/signup_automation/external/plugin.autosignup.php.
Scroll to the section that says //SET JAM VARIABLES.
Edit the following section with your Auto Signup Secret Word and the full URL to your affiliates directory:
$JAM_Secret = "secret_word"; //SET THIS VARIABLE TO ENABLE SECURITY CHECK OF AUTOSIGNUP
$JAM_Affiliate_URL = "http://www.domain.com/affiliates"; //DO NOT ADD TRAILING SLASH
Save the file.
Now, you will need to edit some files in OSCommerce. Open up the file create_account.php. Scroll down to the following section and make these changes:
if (SESSION_RECREATE == 'True') {
tep_session_recreate();
}
$customer_first_name = $firstname;
$customer_default_address_id = $address_id;
$customer_country_id = $country;
$customer_zone_id = $zone_id;
tep_session_register('customer_id');
tep_session_register('customer_first_name');
tep_session_register('customer_default_address_id');
tep_session_register('customer_country_id');
tep_session_register('customer_zone_id');
//BLOCK FOR JAM-ASM MODULE INTEGRATION
$JAM_Aff_Directory = '/home/username/public_html/affiliates_directory';
$JAM_ASM_Type = 'oscommerce';
require $JAM_Aff_Directory . '/plugins/signup_automation/external/plugin.autosignup.php';
//END JAM-ASM MODULE INTEGRATION
// restore cart contents
$cart->restore_contents();
You will need to change /home/username/public_html/affiliates_directory to point to your affiliates directory.
Save the file.
Now, create a test account in OSCommerce.
Once you've created it, login to JAM and verify that the new affiliate exists.
When all is working, you will now have JAM automatically signing up your customers as new affiliates as well.
To integrate the Automatic Signup Module with Paypal, follow these instructions:
Login to JAM. Click on Settings > Signup Settings.
To enable the Automatic Signup Module, set the Enable Automatic Signup Module to Enable.
Enter a Secret Word for the Auto Signup Secret Word field. This is used to ensure that your automatic signups come from a trusted application.
Click Edit Settings to save the form.
Now, you will have to open up and edit a few files. First, open up /plugins/signup_automation/external/plugin.autosignup.php.
Scroll to the section that says //SET JAM VARIABLES.
Edit the following section with your Auto Signup Secret Word and the full URL to your affiliates directory:
$JAM_Secret = "secret_word"; //SET THIS VARIABLE TO ENABLE SECURITY CHECK OF AUTOSIGNUP
$JAM_Affiliate_URL = "http://www.domain.com/affiliates"; //DO NOT ADD TRAILING SLASH
Save the file.
Now, you will need to edit your /plugins/payments/paypal/plugin_paypal_payments.php. Scroll down to the following area, and add the ASM module integration code:
if (!empty($custom_mid))
{
if (!empty($_POST['payment_status']) AND $_POST['payment_status'] == 'Completed')
{
require "../../../sale.php";
//BLOCK FOR JAM-ASM MODULE INTEGRATION
$JAM_Aff_Directory = '/home/username/public_html/affiliates_directory';
$JAM_ASM_Type = 'paypal';
require $JAM_Aff_Directory . '/plugins/signup_automation/external/plugin.autosignup.php';
//END JAM-ASM MODULE INTEGRATION
}
}
You will need to change /home/username/public_html/affiliates_directory to point to your affiliates directory.
Save the file.
Now, run a test transaction in Paypal.
Once you've created it, login to JAM and verify that the new affiliate exists.
When all is working, you will now have JAM automatically signing up your customers as new affiliates as well.
To integrate the Automatic Signup Module with SafePay Solutions, follow these instructions:
Login to JAM. Click on Settings > Signup Settings.
To enable the Automatic Signup Module, set the Enable Automatic Signup Module to Enable.
Enter a Secret Word for the Auto Signup Secret Word field. This is used to ensure that your automatic signups come from a trusted application.
Click Edit Settings to save the form.
Now, you will have to open up and edit a few files. First, open up /plugins/signup_automation/external/plugin.autosignup.php.
Scroll to the section that says //SET JAM VARIABLES.
Edit the following section with your Auto Signup Secret Word and the full URL to your affiliates directory:
$JAM_Secret = "secret_word"; //SET THIS VARIABLE TO ENABLE SECURITY CHECK OF AUTOSIGNUP
$JAM_Affiliate_URL = "http://www.domain.com/affiliates"; //DO NOT ADD TRAILING SLASH
Save the file.
Now, you will need to edit your thank you page. Make sure it is a .php file.
//BLOCK FOR JAM-ASM MODULE INTEGRATION
$JAM_Aff_Directory = '/home/username/public_html/affiliates_directory';
$JAM_ASM_Type = 'safepay;
require $JAM_Aff_Directory . '/plugins/signup_automation/external/plugin.autosignup.php';
//END JAM-ASM MODULE INTEGRATION
You will need to change /home/username/public_html/affiliates_directory to point to your affiliates directory.
Save the file.
Now, run a test transaction in SafePay Solutions.
Once you've created it, login to JAM and verify that the new affiliate exists.
When all is working, you will now have JAM automatically signing up your customers as new affiliates as well.
Module Activation Instructions:
From inside your admin area, click on the 'Utilities' tab and click on 'Custom Modules'. Once there, click on the 'Add
New Module' and choose 'jam_affiliate' from the dropdown selector. Follow the instructions at the bottom of the screen
to activate the module. Once complete, click on the quick link on the left menu that will now appear after you have
activated the module.
Three items to setup:
Path to sale: ex: http://yoursite.com/affiliates/sale.php
Enable Auto-Signup: [ yes / no ]
Folder Path to Install: ex: /home/youruser/public_html/affiliates
After those items are filled in, select the products that you will permit affiliate commissions to be paid out on and
click the 'save configuration' button. Once saved, you will not be tracking sales referred to your website made through
the WHM.AutoPilot V3 system.
Now, you will have to open up /plugins/signup_automation/external/plugin.autosignup.php in your JAM affiliates folder.
Scroll to the section that says //SET JAM VARIABLES.
Edit the following section with your Auto Signup Secret Word and the full URL to your affiliates directory:
$JAM_Secret = "secret_word"; //SET THIS VARIABLE TO ENABLE SECURITY CHECK OF AUTOSIGNUP
$JAM_Affiliate_URL = "http://www.domain.com/affiliates"; //DO NOT ADD TRAILING SLASH
Save the file.
Login to JAM. Click on Settings > Signup Settings.
To enable the Automatic Signup Module, set the Enable Automatic Signup Module to Enable.
Enter a Secret Word for the Auto Signup Secret Word field. This is used to ensure that your automatic signups come from a trusted application.
Click Edit Settings to save the form.
Now, you will have to open up and edit a few files. First, open up /plugins/signup_automation/external/plugin.autosignup.php.
Scroll to the section that says //SET JAM VARIABLES.
Edit the following section with your Auto Signup Secret Word and the full URL to your affiliates directory:
$JAM_Secret = "secret_word"; //SET THIS VARIABLE TO ENABLE SECURITY CHECK OF AUTOSIGNUP
$JAM_Affiliate_URL = "http://www.domain.com/affiliates"; //DO NOT ADD TRAILING SLASH
Save the file.
Now, you will need to edit some files in ZenCart. Open up the file includes/templates/template_name/checkout_success/tpl_footer.php. Scroll down to the following section and make these changes. template_name refers to the zencart template folder you are using
*For ZenCart 1.3.0 and above:
$group_pricing_amount = $JAM->fields['value'];
break;
}
$JAM->MoveNext();
}
//BLOCK FOR JAM-ASM MODULE INTEGRATION
$JAM_Aff_Directory = '/home/username/public_html/affiliates_directory';
$JAM_ASM_Type = 'zencart';
require $JAM_Aff_Directory . '/plugins/signup_automation/external/plugin.autosignup.php';
//END JAM-ASM MODULE INTEGRATION
$commissionable_order = ($order_subtotal - $coupon_amount - $group_pricing_amount);
$commissionable_order = number_format($commissionable_order,2,'.','');
echo "<script language=\"JavaScript\" type=\"text/javascript\" src=\"http://www.yourdomain.com/affiliates/sale.php?amount=$commissionable_order&trans_id=$orders_id\"></script></td></tr>
</table>";
You will need to change /home/username/public_html/affiliates_directory to point to your affiliates directory.
Save the file.
Now, create a test account in Zencart AND order an item from the store AND complete check out..
Once you've created it, login to JAM and verify that the new affiliate exists.
When all is working, you will now have JAM automatically signing up your customers as new affiliates as well.
Login to JAM. Click on Settings > Signup Settings.
To enable the Automatic Signup Module, set the Enable Automatic Signup Module to Enable.
Enter a Secret Word for the Auto Signup Secret Word field. This is used to ensure that your automatic signups come from a trusted application.
Click Edit Settings to save the form.
Now, you will have to open up and edit a few files. First, open up /plugins/signup_automation/external/plugin.autosignup.php.
Scroll to the section that says //SET JAM VARIABLES.
Edit the following section with your Auto Signup Secret Word and the full URL to your affiliates directory:
$JAM_Secret = "secret_word"; //SET THIS VARIABLE TO ENABLE SECURITY CHECK OF AUTOSIGNUP
$JAM_Affiliate_URL = "http://www.domain.com/affiliates"; //DO NOT ADD TRAILING SLASH
Save the file.
Now, you will need to open up the /app-modernbill-order/include/lib-action/shopping/ProcessCartCheckout.php.
Add the integration code according to the following text in bold:
$this->smartyVars["transaction"]["secondary"][0]["form"] = (array)$this->smartyVars["transaction"]["secondary"][0]["form"];
$this->smartyVars["transaction"]["secondary"][0]["link"] = (array)$this->smartyVars["transaction"]["secondary"][0]["link"];
$this->smartyVars["transaction"]["secondary"][0]["linkurl"] = (array)$this->smartyVars["transaction"]["secondary"][0]["linkurl"];
//BLOCK FOR JAM-ASM MODULE INTEGRATION
$JAM_Aff_Directory = '/home/username/public_html/affiliates_directory';
$JAM_ASM_Type = 'modernbill5';
require $JAM_Aff_Directory . '/plugins/signup_automation/external/plugin.autosignup.php';
//END JAM-ASM MODULE INTEGRATION
$j = file_get_contents("http://www.domain.com/affiliates/sale.php?amount=".$this->smartyVars["invoiceInfo"]["invoiceAmount"]."&trans_id=".$this->smartyVars["invoiceInfo"]["invoiceNumber"]."&custom_mid=".$_COOKIE['jrox']);
} else {
$this->smartyVars["transaction"] = correctArray($result["mbapi"][0]["results"][0]["transaction"][0]);
$this->addTemplate("shopping/CheckoutFailure", $this->smartyVars);
You will need to change /home/username/public_html/affiliates_directory to point to your affiliates directory.
Save the file.
Now, run a test transaction in ModernBill.
Once you've created it, login to JAM and verify that the new affiliate exists.
When all is working, you will now have JAM automatically signing up your customers as new affiliates as well.
JAM allows you to create your own custom Automatic Signup Module for integration into your web applications.
To do this, follow these steps:
The Automatic Signup Module allows you to integrate JAM into your existing ECommerce Applications or Shopping Carts to allow for the automatic affiliate account creation in JAM. This works well if you'd like your customers or members to have an affiliate account automatically setup for them upon their payment or registration with your web site or shopping cart. There will be no need to re-register for an affiliate membership, as the Automatic Signup Module will do that for them instantly.
ASM Examples and Benefits
Automatically Build Your Affiliate Network
For example, you have an Internet Store running on OSCommerce Shopping Cart. If you wanted to use the Automatic Signup Module in JAM, all you have to do is enable it in the Signup Settings, and insert two lines of code in a file in OSCommerce. From there, everytime you have a new customer that registers during the payment process or creates an account in OSCommerce, his / her details will also be created in JAM, along with all of their personal information.
Use JAM Tools to Build and Connect with Customers
JAM has some great tools that will help you stay in touch with your customers even more. For instance, if your current shopping cart does not have any means to send out newsletters, you can use JAM to do that, since JAM has its own built-in HTML editor for sending out emails, both in Text or HTML format.
Give Your New Customers More Incentives
By automatically creating an affiliate account for your customers, they can in turn start making some extra money by referring new customers to you. And since they have already bought from you, they know that your company has good products and services that they can easily promote to their friends and colleagues.
PHP Curl Functions - In order to use the JAM Automatic Signup Module, you must have Curl compiled into PHP. Curl will be used to connect with JAM in order to send the affiliate details automatically. To verify if Curl is installed, you can create a small test.php file, and enter the following code in it:
<?php phpinfo(); ?>
Upload this to your web server and view it in your browser. Scroll down until you find a reference to Curl being installed.
Turn Off Affiliate Verification - This is optional, but you may have to turn off the Require Admin Approval on Signup and the Require Affiliate Confirmation via Email setting in the Signup Settings. This allows for a more seamless integration without having to hassle your new customers for affiliate approval.
Affiliate Program Notice - You may want to make your customers aware that they are now your affiliate members as well. This will work well for helping to promote more of your products and services, since they have already bought from you and you have gained their trust. Now, they can easily refer more of their friends and colleagues while earning a commission from you. We suggest tailoring your Affiliate Welcome Email to reflect this.
Plugins for Automatic Signup Module
We are currently developing a number of plugins for the Automatic Signup Module. Here are the ones that are currently available:
To add a new commission, click on the Commissions drop-down menu and select Add Commission.
Add Commission Details:
calendar icon to select a date.You can also assign your affiliates to specific affiliate groups for better management and emailing.
Affiliate Groups are used to help segment your affiliate members for mass emailing, group commissions, and exclusive access to downloadable files.
Here are a few examples of what to use affiliate groups for:
Creating Affiliate Groups
To create affiliate groups, go to Settings > Affiliate Settings > Add Group.
Assigning To Groups
To assign affiliates to certain groups, follow these steps:
Viewing Group Members
To view group members, select the View By Group drop down menu near the bottom of Affiliates > Edit / Delete Affilates
JAM includes an Automatic Refund Module that can be integrated into your shopping cart to automatically update the commissions in your JAM database. This script can be included into your refund payment process, similar to the sale.php file when generating commissions.
ARM Features and Benefits:
The Automatic Refund Module can automatically refund any affiliate commissions made if you have refunded a sale from one of your customers.
If you already paid the affiliate, the Automatic Refund Module will debit their affiliate account for the commission amount you paid, and will be deducted on their next affiliate pay schedule.
If you haven't paid out the commission yet and it exists in the database, you can automatically do 1 of 3 things:
- Delete the existing commission and send an email alert
- Set the commission to pending and send and email alert
- Email the Administrator only
Using JAM-ARM will help you especially if you have a good number of returns or chargebacks and don't want to have to hunt through the commission table just to refund the commission associated with that refund / chargeback.
Automatic Refund Module Integration with Paypal or StormPay
JAM is already setup to automatically process your Paypal or StormPay refunds in conjunction with any affiliate commissions you may have with that payment. This works great if you want to be able to automatically refund any commissions generated from Paypal or StormPay sales that you refunded.
To setup the Automatic Refund Module for Paypal or StormPay Payments, follow these steps:
Login to your JAM Admin Panel
Click on Settings > Payment Settings, and scroll down to the Automatic Refund Module section.
Select Enable for the Enable Automatic Refund Module option
Enter the secret word for processing refunds. This adds a layer of security when processing refunds. This can only be letters or numbers.
Select how you want to process pending or unpaid refunds. The setting Refund Status for Pending or Unpaid Commissions has 3 options:
- Delete and Alert - This will delete any pending or unpaid commissions affiliated with the Paypal Transaction ID.
- Set to Pending and Alert - This will set the commission back to pending status if its status is unpaid.
- Email Alert Only - This will only alert you if a Paypal Commission has been refunded. No action will be taken on the affiliate commissions.
Click Edit Settings.
Now open up the file /plugins/paymetns/plugin_paypal_payments.php in your affiliates directory. For StormPay, open the /plugins/payments/stormpay/plugin_stormpay_payments.php file.
Scroll down the file to the following code, and update the line with your secret word:
|
|
|
//-----------------------------------------------------// // ENABLE SECRET VARIABLE FOR AUTOMATIC REFUND MODULE // //-----------------------------------------------------// // If you want to enable the Automatic Refund Module, // // just uncomment and change the secret variable below // //-----------------------------------------------------// //$secret = "secret"; |
|
|
Save the file.
Now, run a test transaction that will generate a commission.
Once the commission has been generated, refund it via your Paypal or StormPay Account.
Once the Paypal or StormPay payment has been refunded, check your primary administrator's email for the refund alert as well as the corresponding commission in the JAM system.
Custom Automatic Refund Module Integration
*This option requires some advanced skills in php and website configurations. If you are not familiar with php, please do not try this, or consult your system administrator for help. We also offer services for custom configuration, so please contact us for pricing and availability.
To integrate the Automatic Refund Module, it must meet the following requirements:
You must be using unique transaction IDs for payments. This is usually the norm for most payment processors.
You must know how refunds are created in your shopping cart or payment system.
You must be able to pass the Transaction ID variable and the Transaction ID variable must always be unique.
The refund.php file must be able to read the Transaction ID variable. For example, through a $_GET or $_POST variable.
To setup the Automatic Refund Module, follow these steps:
Login to your JAM Admin Panel
Click on Settings > Payment Settings, and scroll down to the Automatic Refund Module section.
Select Enable for the Enable Automatic Refund Module option
Enter the secret word for processing refunds. This adds a layer of security when processing refunds. This can only be letters or numbers.
Select how you want to process pending or unpaid refunds. The setting Refund Status for Pending or Unpaid Commissions has 3 options:
- Delete and Alert - This will delete any pending or unpaid commissions affiliated with the Paypal Transaction ID.
- Set to Pending and Alert - This will set the commission back to pending status if its status is unpaid.
- Email Alert Only - This will only alert you if a Paypal Commission has been refunded. No action will be taken on the affiliate commissions.
Click Edit Settings, then go back to Settings > Payment Settings to get the integration code.
Scroll back down to the Automatic Refund Module section, and you should now have the integraton code setup.
Copy the integration code. Make sure to change the TRANSACTION_ID_VARIABLE_OF_REFUND to the transaction ID variable used by your ecommerce application or shopping cart.
Make sure to change the path to refund.php to point properly to your affiliates directory.
Now open up your shopping cart / payment processor's script that does the payment refunds.
Include the integration code into your payment refund script.
You can also redirect your refunds via a URL, so if you can point to the refund.php file with the Transaction ID as a $_GET variable, you can process the refund via an HTTP GET request, similar to browsing a website.
For example: http://www.yourdomain.com/refund.php?transaction_id=12345789&secret=yoursecretcode.
To do this you must set the TRANSACTION_ID_VARIABLE_OF_REFUND to the $_GET variable that you are passing, which should be set to the transaction ID, like this:
$transaction_id = $_GET['transaction_id_variable'];
$secret = $_GET['secret'];
If you'd like some help on integration, please make sure to visit our Customer Forums at http;//forums.jrox.com
To view your existing commissions, click on the Commissions drop-down menu and select Edit / Delete Commissions
To delete a commission, click on the 
Delete icon to delete the commission.
*Please remember that deleting a commission that has been paid does not automatically update the amount paid for the affiliate that generated that commission.
The Data Export function allows you export data directly from your JAM database. You can export Affiliates, Commissions and Events.
Export Formats can be: Tab Separated, Comma Separated, or Excel-Format.
Data Export can be run by clicking Settings>Data Export.
To generate the export, click on Export Data once you've chosen your export options.
If you want to change the default currency used when paying affiliates for Paypal, you can change it by opening up the /includes/config.php file, and editing this line:
define("PAYPAL_CURRENCY_CODE", "USD");
JAM allows you to manage refunds and chargebacks as well. For instance, if one of your customers requests a refund from you, but you already paid your affiliate the commission, you can refund that commission in JAM.
Refunding a Commission
To refund a commission that has already been paid, just click on the Refund Commission button when editing commissions and it will mark that commission as refunded. It will also create a new commission that will deduct the commission amount from future payments to the affiliate. This new commission will be in a negative amount.
Setting Up the Automatic Refund Module (ARM)
The Automatic Refund Module allows you to integrate your System Refund Process with JAM. To set up the Auto Refund feature, click here
The Pay Affiliates function is used to record payments to your affiliates.
Once an affiliate has reached the minimum required balance set in Settings > Payment Settings, they will automatically appear in the Pay Affiliates section.
There are several options for paying affiliates, depending on your chosen payment options. Here are some examples:
Print Payment Invoices
Pay via Paypal Email Address
Pay via Paypal Mass Payment option
Print Payment Invoices
You can print out payment invoices for each of your affiliates if you want. This can be used to accompany the check payment you will be sending to them.
Customizing Payment Invoices
You can customize the payment invoice template by opening and editing the following file to suit your needs:
admin/includes/html/themes/templates/forms/form_admin_pay_affiliates_invoice.php
Pay via Paypal Email Address
You can pay your affiliate directly if they have a paypal email address set. By clicking the Paypal icon in the list, you can send a Paypal payment directly.
Pay via Paypal Mass Payment
If you have a number of paypal payments to make, you can use the Paypal Mass Payment option to upload payments to Paypal using a tab-delimited file. To generate this file, check all of the Paypal users you have on the list and select Paypal Mass Payment on the drop-down menu near the bottom of the list.
When you generate the Paypal Mass Payment file, you will download a tab-delimited file which you can then upload directly to Paypal to pay your affiliates quickly.
*Other Mass Payment options are available, such as SafePay, AlertPay, and Moneybookers Mass Payment Files.
How to Pay Affiliates
JAM has a specific method in paying affiliates. Follow these steps to properly pay affiliate members their commissions.
Login to JAM and click on Edit / Delete Commissions.
If you have any Pending commissions, review them first and make sure they are all valid. If they're all good to go, scroll down to the bottom of the screen, and select Unpaid in the Mark Checked As drop down menu. Select the checkbox for all those commissions you want to update.
If you have the Alert Affiliate on Commission Generated option set in Settings > Affiliate Settings, an email will be sent to each affiliate notifying them of the commission.
Before you pay affiliates, you now will have to set any commissions that are not yet approved to Approved status. Those that are still not approved are marked with the following icon: All approved commissions will be marked with this icon:
Select all the commissions you want to approve for payment in the Edit / Delete Commissions page.
Once you have approved commissions, you now can proceed to the Affiliates > Pay Affiliates section to generate invoices or download the Mass Payment file. You can also pay affiliates manually using direct payment option or creating an invoice for printing here.
Once you've finished paying affiliates, in the Pay Affiliates screen, scroll down to the bottom to the Mark Checked For drop down menu and select the method you have paid affiliates with. From there, check all the affiliates you have paid in the right hand side checkboxes and click Go.
You have now recorded successful payments for your affiliate members.
You can view all Payment History by clicking on the Payment History link in Commissions > Payment History.
The Search Commissions function allows you to search your Affiliate Commissions based on two sets of criteria, Status and Term.
Search Commissions by Date and by Status
Just enter the Start Date for when commissions were generated and the End date. Select what commission status you want to search for: All, Pending, Unpaid, Or Paid.
Search Commisisons By Term
You can search commissions using the following search categories:
Transaction ID
Commission Amount
Sale Amount
After executing the search query, all matching search terms are displayed in row function
To enable the forced matrix option in JAM, do the following:
To setup the commission levels and payouts for each of your affiliate programs, you need to do the following:
Go to Programs > Edit for your selected affiliate program. The following fields are used for setting up your commission structure.
To view your existing commissions, click on the Commissions drop-down menu and select Edit / Delete Commissions
To edit a particular commission, click on the 
Edit icon to edit the commission.
JROX.COM Affiliate Manager allows you to create a custom commission structure with multiple levels and a forced matrix option. You can have up to 10 commission levels and a maximum matrix width of 5 members.
What is Forced Matrix System?
A Forced Matrix is a system where there is a limit to the number of referrals any affiliate member can refer . For example, if you set the matrix width to be 4, an affiliate member (Affiliate 1) can refer a maximum number of 4 people. Any future referrals will automatically be placed below one of the 4 members he referred right below him, forcing the matrix to fill up, up to the number of commission levels you have specified.
Setting up Multiple Commission Levels and / or Enabling the Forced Matrix
To enable the forced matrix option, click on Settings>System Settings.
To enable the number of commission levels, click Programs > Edit Program for the program you want to specify the commission levels for. Under the Commissions Per Level heading, you can select how many levels you want your commission structure to be, as well as enable / disable the forced matrix option and matrix width.
*You should only change these settings once per installation. Once you've set these options, do not change them, or any future commission calculations for your downline will not work properly. So make sure to plan out what commission structure you want for your sites, so that you don't have to make any changes again in the future.
Downline tools allow your affiliates to view and/or email their entire downline. This is only available if you have a multi-level commission structure setup for your affiliate program. For instance, if you setup your afffiliate program to have 5 levels, the affiliate on levels 1 - 4 can view and/or email their downline (up to level 5), if you enable it.
View Downline option:
Click on Settings>Affiliate Settings. Select Yes on the Allow Members to View Downline option to enable
*This option can take up a lot of load on your system if you have a lot of affiliate members with downlines. Please make sure you have adequate computing power if you want to have thousands of affiliate members with this option set.
Email Downline option:
Click on Settings>Affiliate Settings. Select Yes on the Allow Members to Email Downline option to enable
By enabling this option, your members will not have access to their downline members' information, such as email address, username and such. They can only send them an email and the system will do the custom tag replacement for them.
Enable Member HTML Editor
You can give your members access to the built-in HTML editor if you want them to send emails to their downlines in HTML format. To enable this feature, click on Settings>Affiliate Settings, and select Yes on the Enable Member HTML Editor option.
*This option can take up a lot of load your system if you have a lot of affiliate members with downlines. Please make sure you have adequate computing power if you want to have thousands of affiliate members with this option set.
Show Downline Names
If you want your sponsors to see their sub affiliates' names, you can enable this option in Settings > Affiliate Settings
Show Downline Email Addresses
With this option enabled, your sponsors will see their sub affiliates' email addresses, and be able to contact them via a regular mailto: link
JAM has a website replication feature that you can use for creating static websites for affiliates.
To enable the website replication feature, follow these steps:
The Ad Tracker option allows your affiliate members to append custom tracking codes onto their affiliate links to help them track each and every ad that they place to promote your product. This helps in finding out which ads are working best for them as well as which ones are a waste of time.
To enable ad trackers, click on the Settings>Affiliate Settings and select Yes for the Allow Ad Tracker Links option.
To use it, all your affiliates have to do is append the tracking name to the link they want to track, for example:
http://www.yourdomain.com/affiliates/jrox.php?id=1000_tlid_8_1_ADTRACKER
ADTRACKER can be anything they want, as long as it is no more than 10 letters or numbers long, and is preceded with an underscore '_'. This will help them keep track of how well each ad is doing.
The Tell-a-Friend marketing tool gives your affiliates the option to send a custom message to up to 10 of their friends/colleagues regarding your affiliate products and services. When this option is enabled, your affiliates will see a Tell Your Friends About Us section in their Affiliate Tools area after logging in. They can then type in up to 10 people's email addresses as well as a short note about your products and services.
To enable the Tell-a-Friend tool, click on Settings>Affiliate Settings, and select Yes on the Enable the Tell-a-Friend Tool option.
Tell-a-Friend Email Template
You can customize the email template that goes out to your affiliate's friends by going to the Email Templates section and editing the Affiliate - Tell a Friend Email Template.
For more on templates, visit our Email Templates section.
JAM collects statistics for 6 of your online marketing tools. These include:
The statistics for these tools can be viewed by going to Reports and selecting the drop down menu under Marketing Reports for that particular marketing tool
Additionally, JAM collects the number of impressions and clicks for the following tools:
These stats are viewable by clicking on Marketing > Edit under the tool selected. JAM also calculates the click-through rate (CTR), total sales and total commissions generated for each of those tools.
The Affiliate Follow-Up Module allows you to create follow-up email messages that are sent to your affiliates on predetermined intervals. This is similar to an autoresponse follow up message that is sent one at a time, separated by a number of days that you specify.
Setting up follow-up messages are great especially if you want to send some email correspondence to your new affiliates.
This shows your new members that you are serious about getting them to make money not just for you, but for themselves as well.
Here are some examples of what the follow-up module can do for you:
Follow-Up with preset emails to see how your affiliates are doing
Automatically send preset emails to introduce new affiliate tools or marketing strategies.
According to Wikipedia:
Click-through rate or CTR is a way of measuring the success of an online advertising campaign. A CTR is obtained by dividing the number of users who clicked on an ad on a web page by the number of times the ad was delivered (impressions). For example, if your banner ad was delivered 100 times (impressions delivered) and 1 person clicked on it (clicks recorded), then the resulting CTR would be 1%.
Banner ad click-through rates have fallen over time, often measuring significantly less than 1%. By selecting an appropriate advertising site with high affinity (e.g. a movie magazine for a movie advertisement), the same banner can achieve a substantially higher click-through rate. Personalized ads, unusual formats, and more obtrusive ads typically have higher click-through rates than standard banner ads.
CTR is most commonly defined as number of clicks divided by number of impressions and generally not in terms of number of persons who clicked. This is an important difference because if one person clicks 10 times on the same advertisement instead of once then the CTR would increase in the earlier definition but would stay the same in term of later definition.
You can add an unlimited number of articles that your members can publish on their site to promote your products and services.
To add a new article, follow these steps:
* When creating the article, make sure to use the Custom Tags available in the HTML Editor to represent certain information on the article, such as the affiliate URL, or Name. You will need these so that when an affiliate copies and pastes this article on their site, their affiliate links would have been automatically generated for them already.
According to Wikipedia:
Click-through rate or CTR is a way of measuring the success of an online advertising campaign. A CTR is obtained by dividing the number of users who clicked on an ad on a web page by the number of times the ad was delivered (impressions). For example, if your banner ad was delivered 100 times (impressions delivered) and 1 person clicked on it (clicks recorded), then the resulting CTR would be 1%.
Banner ad click-through rates have fallen over time, often measuring significantly less than 1%. By selecting an appropriate advertising site with high affinity (e.g. a movie magazine for a movie advertisement), the same banner can achieve a substantially higher click-through rate. Personalized ads, unusual formats, and more obtrusive ads typically have higher click-through rates than standard banner ads.
CTR is most commonly defined as number of clicks divided by number of impressions and generally not in terms of number of persons who clicked. This is an important difference because if one person clicks 10 times on the same advertisement instead of once then the CTR would increase in the earlier definition but would stay the same in term of later definition.
You can add an unlimited number of Banners that your members can publish on their site to promote your products and services.
* Only .gif, .jpeg, or .swf (flash) banners are allowed to be used in JAM.
To add a new Banner, follow these steps:
You can also upload Flash banners. However, Flash banners cannot be stored in the
database.
To use Flash banners, you must make sure that when you create your Flash banner,
the hyperlink action in flash points to an external URL like this:
on (release) {
affiliate_link = JROX_URL;
getURL(affiliate_link, "_blank");
}
You can now add flash-banners to your program.
According to Wikipedia:
Click-through rate or CTR is a way of measuring the success of an online advertising campaign. A CTR is obtained by dividing the number of users who clicked on an ad on a web page by the number of times the ad was delivered (impressions). For example, if your banner ad was delivered 100 times (impressions delivered) and 1 person clicked on it (clicks recorded), then the resulting CTR would be 1%.
Banner ad click-through rates have fallen over time, often measuring significantly less than 1%. By selecting an appropriate advertising site with high affinity (e.g. a movie magazine for a movie advertisement), the same banner can achieve a substantially higher click-through rate. Personalized ads, unusual formats, and more obtrusive ads typically have higher click-through rates than standard banner ads.
CTR is most commonly defined as number of clicks divided by number of impressions and generally not in terms of number of persons who clicked. This is an important difference because if one person clicks 10 times on the same advertisement instead of once then the CTR would increase in the earlier definition but would stay the same in term of later definition.
You can add an unlimited number of Email Ads that your members can publish on their site to promote your products and services.
To add a new Email Ads, follow these steps:
* When creating the Email Ad, make sure to use the Custom Tags available in the HTML Editor to represent certain information on the Email Ad, such as the affiliate URL, or Name. You will need these so that when an affiliate copies and pastes this Email Ads on their site, their affiliate links would have been automatically generated for them already.
According to Wikipedia:
Click-through rate or CTR is a way of measuring the success of an online advertising campaign. A CTR is obtained by dividing the number of users who clicked on an ad on a web page by the number of times the ad was delivered (impressions). For example, if your banner ad was delivered 100 times (impressions delivered) and 1 person clicked on it (clicks recorded), then the resulting CTR would be 1%.
Banner ad click-through rates have fallen over time, often measuring significantly less than 1%. By selecting an appropriate advertising site with high affinity (e.g. a movie magazine for a movie advertisement), the same banner can achieve a substantially higher click-through rate. Personalized ads, unusual formats, and more obtrusive ads typically have higher click-through rates than standard banner ads.
CTR is most commonly defined as number of clicks divided by number of impressions and generally not in terms of number of persons who clicked. This is an important difference because if one person clicks 10 times on the same advertisement instead of once then the CTR would increase in the earlier definition but would stay the same in term of later definition.
JAM can setup up to 20 follow up messages, separated by as many days as you need it to.
This is done in Settings > Email Templates
You can create up to 20 follow-up messages to automatically send to your affiliate members.
* This option requires you to have the CRON job setup and running. If the cron does not run, your messages will not be sent. Click here for more information on setting up the required CRON job.
Setting up the Affiliate Follow-Up Module
To setup the Affiliate Follow-Up Module, follow these steps:
Click on Settings > Marketing Settings > Enable Follow Ups Option and set this to Enable
Click on Settings > Email Templates > Add Follow Up near the bottom of the page, under the Follow Up Templates section.
In the Add New Template area, go ahead and fill in the appropriate fields:
Select Email Type - Select HTML, Text, or Bothz
Email Template Name - Enter a friendly name for your email follow up.From Name - Enter the from name that will appear when this email is sent out.
From Email Address - Enter the from email address that will appear when this email is sent out.
Email Subject - Enter the subject for this email follow up.
Email Template Message - Enter the HTML and /or Text Content of your Follow Up.
Click on Save Email Template to save this email follow up.
Repeat these steps for all of your follow up messages, up to a maximum of 20 follow ups.
Once you've finished adding your follow up templates, go back to Settings > Email Templates and scroll down to the Follow Ups section. Here you will edit the sequence of your follow ups as well as the number of days each follow will wait before being sent. *Make sure to keep the sequence numbers in numerical order, (for example 1,2,3,4,5,6,7,8,910) as JAM calculates the next follow up sequence according to the next sequence number.
Once you're done updating the sequence of your follow ups, just click on Update Follow-Up Sequence and you should be set. The next time an affiliate signs up for your program, they will automatically be queued for the first follow up message to be sent on the day set for it.
The Affiliate Follow-Up Module allows you to create follow-up email messages that are sent to your affiliates on predetermined intervals. This is similar to an autoresponse follow up message that is sent one at a time, separated by a number of days that you specify.
Setting up follow-up messages are great especially if you want to send some email correspondence to your new affiliates.
This shows your new members that you are serious about getting them to make money not just for you, but for themselves as well.
Here are some examples of what the follow-up module can do for you:
Follow-Up with preset emails to see how your affiliates are doing
Automatically send preset emails to introduce new affiliate tools or marketing strategies.
You can add an unlimited number of Hover Ads that your members can publish on their site to promote your products and services.
To add a new Hover Ads, follow these steps:
* When creating the Hover Ad, make sure to use the Custom Tags available in the HTML Editor to represent certain information on the Hover Ads, such as the affiliate URL, or Name. You will need these so that when an affiliate copies and pastes this Hover Ads on their site, their affiliate links would have been automatically generated for them already.
According to Wikipedia:
Click-through rate or CTR is a way of measuring the success of an online advertising campaign. A CTR is obtained by dividing the number of users who clicked on an ad on a web page by the number of times the ad was delivered (impressions). For example, if your banner ad was delivered 100 times (impressions delivered) and 1 person clicked on it (clicks recorded), then the resulting CTR would be 1%.
Banner ad click-through rates have fallen over time, often measuring significantly less than 1%. By selecting an appropriate advertising site with high affinity (e.g. a movie magazine for a movie advertisement), the same banner can achieve a substantially higher click-through rate. Personalized ads, unusual formats, and more obtrusive ads typically have higher click-through rates than standard banner ads.
CTR is most commonly defined as number of clicks divided by number of impressions and generally not in terms of number of persons who clicked. This is an important difference because if one person clicks 10 times on the same advertisement instead of once then the CTR would increase in the earlier definition but would stay the same in term of later definition.
The Data Export function allows you export data directly from your JAM database. You can export Affiliates, Commissions and Events.
Export Formats can be: Tab Separated, Comma Separated, or Excel-Format.
Data Export can be run by clicking Settings>Data Export.
To generate the export, click on Export Data once you've chosen your export options.
The Offline Marketing Module is meant for those who want to utilize JAM to build an affiliate network offline. This module can be used to create offline codes that designate an offline marketing code along with a custom affiliate ID that you can use to track the referral of offline affiliates.
For example:
You have a number of offline salespeople who want to give out flyers or coupons to potential customers. You can use JAM to create the offline codes necessary to print on these flyers/coupons that are handed out to each salesperson. When a customer comes into your store to redeem the flyer/coupon that was handed to them by your salesperson, the salesperson's offline code will be printed on there. From there, you can login to JAM and redeem this code to give that salesperson the commission he has generated.
To enable the Offline Marketing Module, follow these steps:
Click on Settings > Marketing Settings. Scroll down to the area on Offline Marketing.
In the Enable Offline Marketing option, select Enable
In the Offline Prefix section, you can enter a unique phrase for each of your offline marketing campaigns separated by a comma. You can use this to specify different offline marketing campaigns, for instance, different flyers, coupon codes, etc. This will need to be present before the affiliate's custom ID when you redeem the offline codes for commissions.
For example: if you have an offline prefix of shoppermag that you will use to identify a certain flyer you give out, this will be appended to the affiliate's custom ID like this: shoppermag-affuser1, where shoppermag is the offline prefix and affuser1 is the affiliate's custom ID.
In the text area for Offline Prefix, type in shoppermag,coupon1,coupon2 to have 3 different offline marketing campaigns.
The affiliate's custom ID can be found when you view his/her details, under Custom ID.
In the Offline Separator option, select the separator you want to use to separate the offline prefix from the affiliate's custom ID. You can select dash, underscore, slash, colon, dot, or pound.
For example, if you select underscore, your offline code will look like this: shoppermag_affuser1.
Once you are done, just click on Edit Settings to save.
Download Affiliate Custom IDs for Printing
Once you have enabled the Offline Marketing settings, you can export and download your affiliate's custom IDs by going to Settings > Data Export
In the Data to Export list, select Affiliates.
You can sort this by Custom ID if you want by selecting Custom ID in the Sort By menu.
We suggest downloading it in Excel Spreadsheet format under the Export Format menu, so that you can just open it up in Microsoft Excel and remove any unnecessary columns that you don't need.
You can now just prepend your offline prefixes to each of your affiliates' custom IDs for marketing offline.
Redeem Offline Codes
To redeem offline codes, click on Marketing > Redeem Offline Marketing Codes.
Select the product group you are redeeming the codes for.
Enter the sale amount for each code. If the sale amount is the same for multiple offline codes, you can enter up to 10 offline codes for redemption. Remember, the sale amount is for each sale per offline code, not the total amount of sales for all offline codes.
The offline codes should be in the format:
offlineprefixofflineseparatoraffiliatecustomID
For example: shoppermag-affuser1 where shoppermag is the offline prefix, - (or dash) is the offline separator, and affuser1 is the affiliate's custom ID.
Once you have redeemed your codes, a new commission will be generated for each affiliate as well as any one in their downline.
To setup a one-time offer for your programs, follow these steps:
When creating a one-time offer, make sure you create two links:
A One-Time Offer is precisely what the words mean, a "one time offer". This feature allows you to give your new affilate members an exclusive , "one time offer", after they sign up. This can be anything from an exclusive deal on a product, a discount, a coupon, or anything that you want to offer your members.
The catch here is that they need to take advantage of that exclusive deal right then and now, or once they click on the next page, they cannot go back to that page again. This can work well if you want to give your users an exclusive deal when they first sign up
JAM has a website replication feature that you can use for creating static websites for affiliates.
To enable the website replication feature, follow these steps:
JAM allows you to have up to 5 custom fields that can be used for anything you want on your web page. In this example, you can set one of the custom fields to a URL of an image for your affiliate.
For instance, you can set the first custom field value to your affiliate's image:
http://www.domain.com/affiliateimage.gif
In your replicated.html template, you can then set it like this:
<img src="%%%CUSTOM_FIELD_1%%%" />
When the replicated website gets created, it will show the following link, and the image for your affiliate:
<img src="http://www.domain.com/affiliateimage.gif" />
If you use the Replicated Website Option in JAM, you can point your regular affiliate links automatically to your affiliate's replicated web page.
To do this, follow these steps:
A replicated website is basically a website template that gets copied to be used by someone. Most of the time, that website template has information that gets changed with unique information for the user of the site, such as links, URLs, names, etc. This makes the replicated website unique to that user.
JAM allows you to create replicated sites for your users to use, so that they can promote those sites as if it were really theirs.
For more information on the website replication feature, click here.
You can add an unlimited number of Text Ads that your members can publish on their site to promote your products and services.
To add a new Text Ads, follow these steps:
* When creating the Text Ad, make sure to use the Custom Tags available in the HTML Editor to represent certain information on the Text Ads, such as the affiliate URL, or Name. You will need these so that when an affiliate copies and pastes this Text Ads on their site, their affiliate links would have been automatically generated for them already.
According to Wikipedia:
Click-through rate or CTR is a way of measuring the success of an online advertising campaign. A CTR is obtained by dividing the number of users who clicked on an ad on a web page by the number of times the ad was delivered (impressions). For example, if your banner ad was delivered 100 times (impressions delivered) and 1 person clicked on it (clicks recorded), then the resulting CTR would be 1%.
Banner ad click-through rates have fallen over time, often measuring significantly less than 1%. By selecting an appropriate advertising site with high affinity (e.g. a movie magazine for a movie advertisement), the same banner can achieve a substantially higher click-through rate. Personalized ads, unusual formats, and more obtrusive ads typically have higher click-through rates than standard banner ads.
CTR is most commonly defined as number of clicks divided by number of impressions and generally not in terms of number of persons who clicked. This is an important difference because if one person clicks 10 times on the same advertisement instead of once then the CTR would increase in the earlier definition but would stay the same in term of later definition.
You can add an unlimited number of Text Links that your members can publish on their site to promote your products and services.
To add a new Text Link, follow these steps:
According to Wikipedia:
Click-through rate or CTR is a way of measuring the success of an online advertising campaign. A CTR is obtained by dividing the number of users who clicked on an ad on a web page by the number of times the ad was delivered (impressions). For example, if your banner ad was delivered 100 times (impressions delivered) and 1 person clicked on it (clicks recorded), then the resulting CTR would be 1%.
Banner ad click-through rates have fallen over time, often measuring significantly less than 1%. By selecting an appropriate advertising site with high affinity (e.g. a movie magazine for a movie advertisement), the same banner can achieve a substantially higher click-through rate. Personalized ads, unusual formats, and more obtrusive ads typically have higher click-through rates than standard banner ads.
CTR is most commonly defined as number of clicks divided by number of impressions and generally not in terms of number of persons who clicked. This is an important difference because if one person clicks 10 times on the same advertisement instead of once then the CTR would increase in the earlier definition but would stay the same in term of later definition.
In JAM versions 1.6.2 and higher, you have the option to create Viral PDFs that can have your affiliate's links embedded dynamically. This allows your affiliates to distribute your PDF ebooks all across the Internet, and still get credit for any sales that get generated from it.
Please remember, this is not an HTML to PDF converter. Only certain formatting codes are allowed when creating your PDF content.
These instructions will help you to create and format your first Viral PDF correctly.
Generating your PDF Content
The PDF Text Area is where you type or paste in your PDF content. The allowed Custom Tags are the tags you use for dynamically placing your affiliate member's info into the PDF when they download it.
For example, if you type in %%%FIRST_NAME%%% in the PDF Text Area, this will be changed to your affiliate's first name when they download the PDF.
Some formatting codes are available on the tool bar right above the PDF Text area such as B for Bold, I for Italic, and U for Underline. Other commands are:
*There is currently no support for HTML conversion or embedded images.
For other settings such as editing the default font used, you can open up the /plugins/tools/Viral_PDFs/tool.template.values.php
You can also add an extra page right after the PDF cover page by adding your text in /plugins/tools/Viral_PDFs/custom/custom.pdf.text.php. This will be good for things such as copyright info or introduction.
JAM allows you to create different and customizable members' areas for each of your affiliate programs. JAM supports a complete redirect to a different URL after login, custom content publishing for each program, your own HTML custom section, or the default members' main menu icons.
Custom URL Redirect after Login
You can create your own affiliate members' area by setting a different URL After Login option in your Program's Settings. If you set this to a different URL, we recommend securing those pages using JAM's copy and paste authentication header for your web pages.
More information and instructions on using JAM's Authentication Module can be found here
Adding a new downloadable file is easy in JAM. Just follow these steps:
*Remember, the link can only be used when an affiliate member is logged into JAM. If they are not logged into JAM, clicking on the download link will not work.
JAM allows you to charge membership fees for your programs.
To enable this feature, follow these steps:
The next time you have an affiliate signup, they will either have the option to pay for your membership program or will be required to pay for it.
JAM allows you to create your own custom payment processors, provided you have advanced knowledge of PHP and web application programming.
*This is for advanced users only, if you do not know how to create and edit PHP scripts, we strongly advise you against creating your own payment processor and consult a web developer.
JAM allows you to import your affiliate members directly into the database via a tab-separated or comma-separated file.
To import your members, follow these steps:
The only required columns for import are first name, last name, and email address. All other columns are optional. Only .txt or .csv file extensions allowed.
Click on Settings > Import / Export > Click Here to Import Data.
You can password-protect a web page using the JAM authentication module by following these steps:
* This option is only available on JAM 1.6.2 and higher.
If you use the membership payment option in JAM, you can automatically get inactive or expired users to reactivate their account by sending them to the following link:
http://www.domain.com/affiliates/prupgrade.php?req=payment
Make sure to point it to your JAM installation. This page will require your member to enter their email address on file, and they will then be presented with your payment options.
Once payment is done, their account will automatically get reactivated.
To allow custom affiliate programs just do the following:
Disable the Showcase Multiple Programs option in Settings > System Settings.
Gather the IDs for all of your programs you want to have separate logins for.
Append the program ID to your affiliate members area, like this:
http://www.yourdomain.com/affiliates/?pid=2
http://www.yourdomain.com/affiliates/?pid=3
http://www.yourdomain.com/affiliates/?pid=4
(If you use se-friendly URLs, this becomes http://www.yourdomain.com/affiliates/program/4)
Substitute the pid variable for the variable of your program IDs.
You now have custom affiliate programs with custom affiliate commissions, marketing tools, and stats.
* If you don't want affiliates logging into other affiliate programs, just make sure to set the Force Member Login option for the program that they initially signup for, and this will restrict them to only being able to login to the affiliate program that they signed up for.
For instructions on how to protect a separate folder using the JAM Authentication Module, view the following document:
http://jam.jrox.com/docs/index.php?article=73#separatefolder
JAM allows you to set certain security restrictions for downloadable files. These include:
* When a user tries to access a downloadable file, and you have upgrade options enabled for that program or group, the user will automatically be presented with an option to upgrade for a fee. This makes it automatic for your users to upgrade and get the downloadable files from you easily.
JAM has an available Authentication Module if you want to utilize JAM's authentication and membership management features. This module can be used to create your own custom secure web pages on a totally separate folder from JAM.
By using this module, you have endless possibilities in creating membership sites, affiliate programs, or custom secured content
You can quickly secure php web pages just by copying and pasting a small file on the top line of each web page.
For instance, you created a web page that you only want members to be able to access, just append the following to the top of that page, like this:
<?php
########################################
## PASSWORD PROTECT CERTAIN WEB PAGES ##
########################################
error_reporting(0);
//SET THE HOME DIRECTORY TO YOUR AFFILIATES FOLDER
$JAM_Directory = '/home/USERNAME/public_html/affiliates';
require_once ($JAM_Directory.'/includes/common.php');
require_once ($JAM_Directory.'/includes/mod/mod_members.php');
Login_Check();
?>
Just change the /home/USERNAME/public_html/affiliates to point to your JAM directory.
You now have that web page protected and all users will have to login through the JAM login form to get access to it.
An example of this is available in the /plugins/misc/secure_page.php file.
Examples for using the Authentication Module
Affiliate or Membership Site on a Separate but Secured Web Page
JAM can create a membership area for you that uses the Authentication Module that secures the web pages. To do this, do the following:
Create a new Program in JAM. Fill in all the fields, and set the URL to Redirect to After Login to the web page you have secured.
Optionally set the URL Redirect to After Signup to any page you want.
Set the Force Member Login to only allow signups to be able to login to this program
Open up your membership web page for editing and add the authentication code to the very top of your web page.
Add the authentication code to all the web pages you want to secure.
Securing a separate folder using the Authentication Module
* this might be a bit advanced for some users
Alternatively, if your web host supports it, you can protect an entire folder without having to add the authentication code on each and every page that is in that folder. This makes it easier to protect any and all files in that folder.
To do this, follow these steps:
JAM allows you to have any type of downloadable file, as long as it can either be stored on your web hosting account or accessible via a URL from JAM.
These files can be any of the following:
By having this option, you can protect your downloadable files by using JAM as the necessary login authentication before giving access to them.
To add new programs to JAM, click on Programs > Add New Program and fill in the details.
Add New Program:
Program Status - Set this program as active / inactive. By setting this to inactive, your affiliates will not see any of the tools when they login to this affiliate program
Program Name - Name of your program
Program Description - Short description of your program
Optional Program Image - Upload an optional image to represent your program. The image must be less than 500 KB and between 110 x 110 in size.
URL to Redirect To - Enter the full URL of the website you want this program to redirect to.
Program Type - Select whether this program is Pay-Per-Click or Pay-Per-Sale
Default Member Site Theme - Select what theme to use for this Program
PPC Interval Type - If you select Pay-Per-Click, you can set whether to only allow payments on unique referrals (using IP Addresses), or allow clicks to be paid after a certain amount of time has elapsed, for instance, after 1 month.
*Make sure this URL points to a domain where your Affiliate Program is installed. If not, you will have to enable the Append Cookie to URL option and set the cookies separately.
Total Impressions for CPM - Use only if you've set the program to use a CPM Program Type. Enter how many impressions an affiliate must get first before being issued a commission.
Commission Type - Set this program as having flat or percentage-based commissions.
Set New Commissions To - Set new commissions to either Pending or Unpaid. Setting it to Pending will give you time to check the commission if you want, because it will stay hidden from your affiliates until you approve it.
Auto-Approve Commissions After - You can auto-approve commissions after a certain time. This is a great feature for you so that you don't have to always check which pending commissions are needed to be approved.
URL to Redirect to After Signup - You can se this field to be any valid web page that you want to redirect users to after they have signed up for your program. This is where they will go after filling out and submitting your signup form for this program. Each program can have different URLs to Redirect to After Signup.
URL to Redirect to After Login - You can set this field to be any valid web page that you want to redirect users to after they have logged into JAM. This option is particularly useful if you want to use JAM's Authentication Module and redirect users to a custom web page. Each program can have different URLs to Redirect to After Login.
* The default would be to go to the members area, which is set to http://www.yourdomain.com/affiliates/members/ Change yourdomain.com to point to your domain name and affiliates to point to your affiliates directory.
URL to Redirect to After Sale - If you are using URL Redirect as your primary system integration, enter a valid URL here to send your customers to after completing the sale
Enable Create Account Link - This option shows/hides the Create Account link in the member's login form. If you charge your members a fee first before signing up, then you should disable this option
Automatically Assign To Group - This option only appears if you have setup groups and would like any new member who signs up for this program to be automatically added to the selected group
Enable Member Main Menu - You can disable the default main menu when affiliates login to the members area. This is useful if you want to use the Content Publisher to create a custom members home page for this program.
Force Member Login - When this option is enabled, an affiliate will be restricted to only being able to login to this program which he is assigned to. He will not be able to login to any other programs you offer.
Select Signup Form Type - Select whether to use the default signup form, which separates the personal information from the user account information, or the Single inline form, where all fields are listed in one table. You can also select the aweber form, which integrates directly with aweber.
Commission Levels - Select the number of levels you want to have for this program. The maximum is 10.
Commission Frequency - Select the amount of time commissions for this product should recur.
Commissions Per Level - Enter the commission amounts for each level set. Commission levels for your program are set in System Settings.
*For percent-based commissions, make sure to enter the decimal equivalent for it. For instance, a 50% commission should be input as .50, its decimal equivalent.
Program Notes - Enter any miscellaneous notes you may have for this program.
To delete a program, click on the Delete button for the program you want.
*You cannot delete the first program in the system. This is the default product for the entire system.
*If you delete a program which already has marketing tools and data asssociated to it, it will also delete all of these. Please make sure this is what you want before deleting an active program. You can also set the program to inactive to stop promoting it with your affiliates.
Here are instructions on setting up a pay-per-lead campaign:
To allow custom affiliate programs just do the following:
Disable the Showcase Multiple Programs option in Settings > System Settings.
Gather the IDs for all of your programs you want to have separate logins for.
Append the program ID to your affiliate members area, like this:
http://www.yourdomain.com/affiliates/?pid=2
http://www.yourdomain.com/affiliates/?pid=3
http://www.yourdomain.com/affiliates/?pid=4
(If you use se-friendly URLs, this becomes http://www.yourdomain.com/affiliates/program/4)
Substitute the pid variable for the variable of your program IDs.
You now have custom affiliate programs with custom affiliate commissions, marketing tools, and stats.
* If you don't want affiliates logging into other affiliate programs, just make sure to set the Force Member Login option for the program that they initially signup for, and this will restrict them to only being able to login to the affiliate program that they signed up for.
JAM allows you to automatically allow your members to upgrade from one program to another program that you charge payments for. For example, if you have one membership program that affiliates can join for free, but also have a second program that you require a membership fee to join.
To enable this option, follow these steps:
With JROX.COM Affiliate Manager, you can create unlimited affiliate and/or membership programs with customized commission structures for each program.
This means, you can have multiple programs with a custom commission structure for each program. Each program can have their own unique content, welcome email, and payout structures. You can even have sites that are completely different from each other, allowing you to create custom membership programs for different sets of affiliate members.
JAM allows you to have two options when creating multiple affiliate programs or membership sites:
Private Affiliate Network (Showcase Multiple Programs)
With this option ,you can showcase all the different affiliate programs to your members when they login to their members' area.
In this case, all of your affiliates login to the same members area and get the promotion tools for each program via a drop down menu in the Affiliate Tools section. This allows them to promote any and all of your programs with unique affiliate tracking links.
To use this option, make sure you set the Showcase Multiple Programs option in Settings > System Settings to Enable
Unique Affiliate or Membership Program
JAM also allows you to create multiple affiliate programs or membership sites that are completely separate from each other.
To set this option, make sure you set the Showcase Multiple Programs option in Settings > System Settings to Disable
When you use this option, you can create multiple programs by clicking on the Add Program link in the Programs section.
You can view how well each program is doing by clicking on the Stats link for each program. Here, a graphical representation will show you how well each product is generating commissions for you.
The Reports module for JROX.COM Affiliate Manager is an extensive collection of graphs, statistics and reports on how well each facet of your affiliate program is doing. This feature will help you analyze how well your affiliates are doing, how much commissions each of your products are generating, how much traffic you are seeing, and so much more.
Here is a list of the reports you can generate with the Reports Module:
Affiliate Signups Per Day - Last 7 Days
Commissions Generated Per Day - Last 7 Days
Total Commissions - By Month
Total Commissions - By Year
Monthly Commission Analysis
Clicks / Sales /Commissions Comparison
Top Performing Affiliates - By Clicks
Top Performing Affiliates - By Commissions
Top Performing Affiliates - By Sales
Total Affiliate Signups - By Month
Total Affiliate Signups - By Year
View Website Referrers - in list format
Total Affiliate Clicks - By Month
Total Affiliate Clicks - By Year
Total Banner Clicks - By Month
Total Banner Clicks - By Year
Total Text Link Clicks - By Month
Total Text Link Clicks - By Year
Total Text Ad Clicks - By Month
Total Text Ad Clicks - By Year
Total Hover Ad Clicks - By Month
Total Hover Ad Clicks - By Year
Total Email Ad Clicks - By Month
Total Email Ad Clicks - By Year
Top Referring Websites by Commissions - By Month
Top Referring Websites by Commissions - By Year
Top Referring Websites by Sales - By Month
Top Referring Websites by Sales - By Year
Top Referring Websites by Clicks - By Month
Top Referring Websites by Clicks - By Year
Affiliate Clicks Per Affiliate - By Month
Affiliate Clicks Per Affiliate - By Year
Affiliate Commissions Per Affiliate - By Month
Affiliate Commissions Per Affiliate - By Year
Commissions Per Product - By Month
Commissions Per Product - By Year
JAM collects statistics for 6 of your online marketing tools. These include:
The statistics for these tools can be viewed by going to Reports and selecting the drop down menu under Marketing Reports for that particular marketing tool
Additionally, JAM collects the number of impressions and clicks for the following tools:
These stats are viewable by clicking on Marketing > Edit under the tool selected. JAM also calculates the click-through rate (CTR), total sales and total commissions generated for each of those tools.
You can view how well each program is doing by clicking on the Stats link for each program. Here, a graphical representation will show you how well each product is generating commissions for you.
The Data Export function allows you export data directly from your JAM database. You can export Affiliates, Commissions and Events.
Export Formats can be: Tab Separated, Comma Separated, or Excel-Format.
Data Export can be run by clicking Settings>Data Export.
To generate the export, click on Export Data once you've chosen your export options.
To move JAM from one server to another, follow these instructions:
JAM supports the daily, weekly, or monthly automatic database backup of JAM.
*Your web server must support the "exec" command in PHP. If you do not know if your site supports this, please ask your webhost or systems administrator.
To set this up, follow these steps:
Make sure to change yourdomain.com/your_affiliate_directory to point to your JAM installation directory and the cron_password to reflect the cron password in your includes/config.php file on this line:
define("JAM_CRON_JOB_PASSWORD", "cron_password");
If your web host does not support the /usr/bin/wget command, try these other ones:
php -q /home/username/public_html/affiliates/includes/backupdb.php pw=cron_password
/usr/bin/lynx-protected -accept_all_cookies http://www.yourdomain.com/your_affiliate_directory/includes/backupdb.php?pw=cron_password
The Events Viewer function of JAM allows you to record all the events that occur within your Affiliate Program. Once enabled, you can log five types of events:
Admin Events - Events generated by Administrative actions.
Affiliate Events - Events generated by your affiliates.
Commission Events - Events generated that are related to Commissions.
Security Events - Events related to security issues such as failed logins.
System Events - Events generated by the system, such as management tasks, cron tasks, etc.
Events are also logged by priority. You can view event priorities as Normal, Warning, High.
Normal - Information only events
Warning - Possible issue that may need to be looked at.
High - Errors have been generated. Please analyze.
Enabling Events Logging
To enable / disable the events viewer, click Settings > Security Settings, select Enable / Disable on the Enable Events Logging option.
Enable / Disable Certain Events
You can also enable / disable certain event types. To do so, uncheck which event type you do not want to log in the Security Settings section.
Prune Events After - Select how long events are kept in the database before they are pruned / deleted.
JROX.COM Affiliate Manager currently requires the following system components:
PHP version 4.3 or greater
PHP safe_mode set to Off
MySQL Database version 4 and up
Curl + SSL option compiled into PHP.
Access to sendmail or an SMTP server for emailing functions
Ability to setup CRON jobs or scheduled tasks
Ability to load Ioncube Loaders
For the JAM Admin Area, you are recommended to use Internet Explorer 6 and higher or Firefox 1 and higher as your Internet browsers.
Notes:
For Curl, you must have it enabled with SSL. To find out if you have Curl enabled with SSL, create a test.php file and in it, type:
<?php phpinfo(); ?>
This will show your current php configuration. Scroll down to an area that says:
|
CURL Support |
enabled |
|
CURL Information |
libcurl/7.12.1 OpenSSL/0.9.7a zlib/1.2.1.2 libidn/0.5.6 |
If your phpinfo says that your CURL Support has something along the lines of OpenSSL/0.9.7a, then you should have SSL enabled for CURL.
*JAM has not been thoroughly tested using PHP on Windows/IIS. Theoretically, it should run, but this configuration is currently not supported.
Installation of JAM can be completed in a few easy steps. This guide will show you how to install the software successfully on your server.
* JAM is not supported when run on the Windows Operating System
Database Creation - MySQL Database
*JROX.COM Affiliate Manager requires access to a MySQL Database Server
Before beginning the Installation, you must first login to your web hosting account or server and create a new MySQL database for this application. You may also use the PHPMyAdmin tool to create a new database via a simple web interface. Otherwise, please consult your server documentation on how to create one.
You can also create the MySQL Database using the command line. If you have access to the command line, type in the following commands:
mysql - u username -p
CREATE DATABASE jrox_affiliates;
You now have your database created. You may proceed with the installation.
Make sure to have your database access details on hand before beginning the installation.
JAM Installer (Windows-based PCs Only)
Enter your FTP details:
FTP Address: ftp.yourdomain.com
FTP Username: ftp_username
FTP Password: ftp_password
Installation Directory: the directory you want to run JAM from. Normally set to "affiliates".
Install Folder: the folder you want to install JAM in. Normally, "/home/public_html" or "/home/www"
Install Location URL: http://www.yourdomain.com
Click Next and Install and it will start uploading your files to your server.
Once you've finished uploading the files, click Finish. This will automatically open a browser window to the web-based portion of the setup. Just follow all the onscreen instructions to continue.
Once you are done, you will need to delete the install.php file before logging in.
Manual FTP Upload
Once you have finished the installation, make sure to go through each of these steps to configure JAM properly.
Your Default Program URLs
Default Admin Login URL:
http://www.DOMAIN.COM/AFFILIATES/admin/
Default Affiliate Members Login URL:
http://www.DOMAIN.COM/AFFILIATES/
Default Affiliate Members Signup Page URL:
http://www.DOMAIN.COM/AFFILIATES/?req=newaccount&pid=1
* Just change the DOMAIN.COM/AFFILIATES to point to your JAM installation
Configure all of your System Settings
Edit Program Settings
Edit System Email Templates
Add New Marketing Tools
Edit Members Area Theme, Header and Footer
Edit Your TOS and Program Description
Configure Scheduled CRON Tasks
Integrate JAM into your Website / Application
Run Initial Tests
If you are having issues installing or running JAM, please check the following:
Upgrading Instructions for JAM 1.5.x - BACKUP YOUR DATA!!!
*Before anything, you must first backup both your JAM installation directory and your JAM database. We are not responsible for any issues or errors that may arise from you upgrading, so make sure you backup your data first.
Upgrade Steps
Upgrading from JAM 1.2
Again, make sure to FIRST BACKUP ALL DATA, including database and files in case you run into any issues.
If you are using custom commissions for any of your affiliates, you will need to reinput these as those values are not carried over during the upgrade.
Again, make sure to FIRST BACKUP ALL DATA, including database and files in case you run into any issues.
You can add an unlimited number of Banners that your members can publish on their site to promote your products and services.
* Only .gif, .jpeg, or .swf (flash) banners are allowed to be used in JAM.
To add a new Banner, follow these steps:
To add a new commission, click on the Commissions drop-down menu and select Add Commission.
Add Commission Details:
calendar icon to select a date.To add new programs to JAM, click on Programs > Add New Program and fill in the details.
Add New Program:
Program Status - Set this program as active / inactive. By setting this to inactive, your affiliates will not see any of the tools when they login to this affiliate program
Program Name - Name of your program
Program Description - Short description of your program
Optional Program Image - Upload an optional image to represent your program. The image must be less than 500 KB and between 110 x 110 in size.
URL to Redirect To - Enter the full URL of the website you want this program to redirect to.
Program Type - Select whether this program is Pay-Per-Click or Pay-Per-Sale
Default Member Site Theme - Select what theme to use for this Program
PPC Interval Type - If you select Pay-Per-Click, you can set whether to only allow payments on unique referrals (using IP Addresses), or allow clicks to be paid after a certain amount of time has elapsed, for instance, after 1 month.
*Make sure this URL points to a domain where your Affiliate Program is installed. If not, you will have to enable the Append Cookie to URL option and set the cookies separately.
Total Impressions for CPM - Use only if you've set the program to use a CPM Program Type. Enter how many impressions an affiliate must get first before being issued a commission.
Commission Type - Set this program as having flat or percentage-based commissions.
Set New Commissions To - Set new commissions to either Pending or Unpaid. Setting it to Pending will give you time to check the commission if you want, because it will stay hidden from your affiliates until you approve it.
Auto-Approve Commissions After - You can auto-approve commissions after a certain time. This is a great feature for you so that you don't have to always check which pending commissions are needed to be approved.
URL to Redirect to After Signup - You can se this field to be any valid web page that you want to redirect users to after they have signed up for your program. This is where they will go after filling out and submitting your signup form for this program. Each program can have different URLs to Redirect to After Signup.
URL to Redirect to After Login - You can set this field to be any valid web page that you want to redirect users to after they have logged into JAM. This option is particularly useful if you want to use JAM's Authentication Module and redirect users to a custom web page. Each program can have different URLs to Redirect to After Login.
* The default would be to go to the members area, which is set to http://www.yourdomain.com/affiliates/members/ Change yourdomain.com to point to your domain name and affiliates to point to your affiliates directory.
URL to Redirect to After Sale - If you are using URL Redirect as your primary system integration, enter a valid URL here to send your customers to after completing the sale
Enable Create Account Link - This option shows/hides the Create Account link in the member's login form. If you charge your members a fee first before signing up, then you should disable this option
Automatically Assign To Group - This option only appears if you have setup groups and would like any new member who signs up for this program to be automatically added to the selected group
Enable Member Main Menu - You can disable the default main menu when affiliates login to the members area. This is useful if you want to use the Content Publisher to create a custom members home page for this program.
Force Member Login - When this option is enabled, an affiliate will be restricted to only being able to login to this program which he is assigned to. He will not be able to login to any other programs you offer.
Select Signup Form Type - Select whether to use the default signup form, which separates the personal information from the user account information, or the Single inline form, where all fields are listed in one table. You can also select the aweber form, which integrates directly with aweber.
Commission Levels - Select the number of levels you want to have for this program. The maximum is 10.
Commission Frequency - Select the amount of time commissions for this product should recur.
Commissions Per Level - Enter the commission amounts for each level set. Commission levels for your program are set in System Settings.
*For percent-based commissions, make sure to enter the decimal equivalent for it. For instance, a 50% commission should be input as .50, its decimal equivalent.
Program Notes - Enter any miscellaneous notes you may have for this program.
You can also upload Flash banners. However, Flash banners cannot be stored in the
database.
To use Flash banners, you must make sure that when you create your Flash banner,
the hyperlink action in flash points to an external URL like this:
on (release) {
affiliate_link = JROX_URL;
getURL(affiliate_link, "_blank");
}
You can now add flash-banners to your program.
You can add affiliates into JAM using two methods. First, you can use the signup form or add them manually in the admin area by clicking on Affiliates > Add New Affiliate
The only required fields when adding affiliates are First Name, Last Name, Email Address, and whatever fields you set in Settings > Signup Settings
JAM allows you to have up to 5 custom fields that can be used for anything you want on your web page. In this example, you can set one of the custom fields to a URL of an image for your affiliate.
For instance, you can set the first custom field value to your affiliate's image:
http://www.domain.com/affiliateimage.gif
In your replicated.html template, you can then set it like this:
<img src="%%%CUSTOM_FIELD_1%%%" />
When the replicated website gets created, it will show the following link, and the image for your affiliate:
<img src="http://www.domain.com/affiliateimage.gif" />
JAM has the option to let your affiliate members point their affiliate links to any page on your site.
To do this, follow these steps:
*If you will allow them to redirect to web pages that have variables in the URL, then you need to replace every & symbol with its encoded counterpart %26. For example, if your URL is like this:
http://www.domain.com/store/index.php?id=1&category=4&product=5
You will need to tell your affiliates to link to it like this:
http://www.domain.com/affiliates/jrox.php?id=1000&jxURL=http://www.domain.com/store/index.php?id=1%26category=4%26product=5
If you want to change the folder where you installed JAM, follow these steps:
you can change the folder name in /includes/config.php, under
define("HOME_BASE_DIRECTORY", "/home/username/public_html/affiliates");
//ENTER THE NAME OF YOUR AFFILIATE PROGRAM DIRECTORY
//DO NOT INCLUDE A TRAILING SLASH
define("HOME_BASE_AFFILIATE_DIRECTORY", "/affiliates");
you can then edit the URL to Redirect to, URL to Redirec to after signup, and URL to redirect to After Login in Programs > Edit Program
If you want to change the default currency used when paying affiliates for Paypal, you can change it by opening up the /includes/config.php file, and editing this line:
define("PAYPAL_CURRENCY_CODE", "USD");
If you are moving JAM to a different domain, and need to change the domain name associated with it, follow these steps:
* This option is only available on JAM 1.6.2 and higher
JAM allows you to rename the jrox.php file to your own custom file. To do this follow these directions:
JAM allows you to charge membership fees for your programs.
To enable this feature, follow these steps:
The next time you have an affiliate signup, they will either have the option to pay for your membership program or will be required to pay for it.
JAM allows you to create your own custom Automatic Signup Module for integration into your web applications.
To do this, follow these steps:
JAM allows you to create your own custom payment processors, provided you have advanced knowledge of PHP and web application programming.
*This is for advanced users only, if you do not know how to create and edit PHP scripts, we strongly advise you against creating your own payment processor and consult a web developer.
If you want to print out the affiliate payment invoices generated by JAM and want to customize, you can do so using the following steps:
You can hide this by editing the style.css file for your selected theme. The stylesheet is located here:
/affiliates/includes/html/themes/default/style.css
Change default to point to your selected theme.
find the line that says copyright_1. On this line, add the last line:
text-align: center;
margin:auto;
font-family: Arial, Helvetica, sans-serif;
font-size: 10px;
color: #666666;
text-decoration: none;
bottom: auto;
visibility:hidden;
Save the style.css and upload it back
This will only work if you have a license with JAM
If you want to add your own copyright information, you will need to edit the footer template itself. For information on this, click here
JAM allows you to import your affiliate members directly into the database via a tab-separated or comma-separated file.
To import your members, follow these steps:
The only required columns for import are first name, last name, and email address. All other columns are optional. Only .txt or .csv file extensions allowed.
Click on Settings > Import / Export > Click Here to Import Data.
To move JAM from one server to another, follow these instructions:
You can password-protect a web page using the JAM authentication module by following these steps:
If you use the Replicated Website Option in JAM, you can point your regular affiliate links automatically to your affiliate's replicated web page.
To do this, follow these steps:
For URLs that have variables, such as shopping cart products, you will need to edit the URL so that JAM can redirect it properly.
For example, if your URL is similar to this, or it has the ampersand (&) in it:
http://www.domain.com/store/index.php?main_page=product_info&products_id=76
JAM allows you to redirect potentially new affiliates using an affiliate link. All you have to do is append the signup variable to your affiliate link, like this:
http://www.DOMAIN.COM/AFFILIATES/jrox.php?id=1000&signup=1
This will automatically send anyone who clicks this link to the signup form page instead of the URL To Redirect To Page.
If you want new affiliates to signup for a different program, just set the signup variable to the program ID you want them to signup to. For example, if you want them to signup for program ID #3, then set that as the signup value:
http://www.DOMAIN.COM/AFFILIATES/jrox.php?id=1000&signup=3
If you want your affiliates to send their new recruits directly to the affiliate program's description page while still getting credit for it, do the following:
On their affiliate link, just append the following value to their affiliate link
http://www.domain.com/affiliates/jrox.php?id=1000&desc=1
Where the 1 is the program ID you want them to go to.
If you want your affiliates to send their new recruits directly to the affiliate's signup page while still getting credit for it, do the following:
On their affiliate link, just append the following value to their affiliate link
http://www.domain.com/affiliates/jrox.php?id=1000&signup=1
Where the 1 is the program ID you want them to signup to.
If you want to set a random affiliate cookie on your web page when no affiliate cookie is set, you can use the following JavaScript and insert it on your selected web page:
<script language="JavaScript" type="text/javascript" src=http://www.yourdomain.com/your_affiliate_directory/randomaff.php></script>
This will set a randomly selected affiliate on your web page when no affiliate cookie has been set.
If you want to set the affiliate cookie on a separate web page automatically without having to redirect the user with an affiliate link, you can set the affiliate cookie on that page using JavaScript.
This is useful for things such as the replicated web page, so that the affiliate cookie gets set automatically when a visitor visits the web site. This means that the visitor does not necessarily have to click on an affiliate link for them to be tracked.
To set this up, follow these steps:
Here are instructions on setting up a pay-per-lead campaign:
JAM allows you to automatically allow your members to upgrade from one program to another program that you charge payments for. For example, if you have one membership program that affiliates can join for free, but also have a second program that you require a membership fee to join.
To enable this option, follow these steps:
Once you have finished the installation, make sure to go through each of these steps to configure JAM properly.
Your Default Program URLs
Default Admin Login URL:
http://www.DOMAIN.COM/AFFILIATES/admin/
Default Affiliate Members Login URL:
http://www.DOMAIN.COM/AFFILIATES/
Default Affiliate Members Signup Page URL:
http://www.DOMAIN.COM/AFFILIATES/?req=newaccount&pid=1
* Just change the DOMAIN.COM/AFFILIATES to point to your JAM installation
Configure all of your System Settings
Edit Program Settings
Edit System Email Templates
Add New Marketing Tools
Edit Members Area Theme, Header and Footer
Edit Your TOS and Program Description
Configure Scheduled CRON Tasks
Integrate JAM into your Website / Application
Run Initial Tests
If you are having issues installing or running JAM, please check the following:
The Ioncube version of JAM comes with ioncube loaders for linux only. If you are on a different system, such as FreeBSD, CentOS, or Windows, you will need to download the ioncube loaders for these operating systems, and upload them into the ioncube folder in JAM.
To download new ioncube loaders, visit the ioncube site:
http://www.ioncube.com/loaders.php
If your mass emails are not being sent, you need to doublecheck a few things:
To check if the password is correct, try running the cron.php file directly in your web browser:
http://www.domain.com/affiliates/includes/cron.php?pw=CRON_PASSWORD
If this works, then check your cron job to make sure it is running. Ask your web host to make sure your cron job command works and is correct.
JAM allows you to turn on advanced error logging to see if there are any errors in your JAM installation.
Turn on Error Logging
This will display any possible error messages you are having in your browser.
Open up the /includes/config.php file and set this option to "true":
//MYSQL ERROR AND DEBUGGING INFORMATION
//ONLY SET TO "true" IF YOU ARE HAVING ERRORS IN YOUR INSTALLATION
define("DEBUG_ADVANCED_ERROR", false);
Sending errors to your email
JAM can also send you error logs to a specified email address. Open up the /includes/config.php file.
//ONLY SET TO "true" IF YOU WANT THE DEBUGGING INFO EMAILED TO YOU. BE CAREFUL WITH THIS ONE, IT MAY FLOOD YOU WITH EMAILS
define("DEBUG_EMAIL", false);
//EMAIL ADDRESS TO SEND DEBUGGING INFORMATION TO
define("DEBUG_EMAIL_TO", "you@yourdomain.com");
//EMAIL ADDRESS THAT DEBUGGING INFORMATION IS SENT FROM
define("DEBUG_EMAIL_FROM", "error@@yourdomain.com");
*Be careful when using the email logging, as this can flood your email address. Make sure to only use it for a short period of time for debugging.
No Errors Showing
If no errors still show when you enable the error logging option in the config.php file, it is possible that your PHP configuration is set to not display any errors by default. You can change this by doing the following:
The Events Viewer function of JAM allows you to record all the events that occur within your Affiliate Program. Once enabled, you can log five types of events:
Admin Events - Events generated by Administrative actions.
Affiliate Events - Events generated by your affiliates.
Commission Events - Events generated that are related to Commissions.
Security Events - Events related to security issues such as failed logins.
System Events - Events generated by the system, such as management tasks, cron tasks, etc.
Events are also logged by priority. You can view event priorities as Normal, Warning, High.
Normal - Information only events
Warning - Possible issue that may need to be looked at.
High - Errors have been generated. Please analyze.
Enabling Events Logging
To enable / disable the events viewer, click Settings > Security Settings, select Enable / Disable on the Enable Events Logging option.
Enable / Disable Certain Events
You can also enable / disable certain event types. To do so, uncheck which event type you do not want to log in the Security Settings section.
Prune Events After - Select how long events are kept in the database before they are pruned / deleted.
JAM offers 3 different tracking options: cookies, sessions and IP addresses.
You can change the currency symbol in JAM by doing the following:
To change the number format, do the following:
On the signup form, there is a preset default country selected. If you want to change this to a different country, please follow these steps:
By default, JAM uses non-persistent connections to connect to the MySQL Database. If for some reason, you want to use persistent connections, follow these steps:
JAM allows you to use SSL for the Members Area, the Admin Area, or the Affiliate Links.
To use SSL security, you must have a valid SSL certificate. If you don't have one, please ask your web host.
To enable SSL, follow these steps:
JAM allows you to redirect potentially new affiliates using an affiliate link. All you have to do is append the signup variable to your affiliate link, like this:
http://www.DOMAIN.COM/AFFILIATES/jrox.php?id=1000&signup=1
This will automatically send anyone who clicks this link to the signup form page instead of the URL To Redirect To Page.
If you want new affiliates to signup for a different program, just set the signup variable to the program ID you want them to signup to. For example, if you want them to signup for program ID #3, then set that as the signup value:
http://www.DOMAIN.COM/AFFILIATES/jrox.php?id=1000&signup=3
The HTML Editor is a feature in JAM that allows you to add /edit/ and create HTML-based templates and ads easily, with very minimal HTML knowledge.
The HTML Editor is available to use if you use the following browsers:
Internet Explorer 5.5 and up
Netscape / Firefox 1.0 and up
The icons in the HTML Editor can do the following:
|
Preview |
|
|
Search |
|
|
Paste from Microsoft Word |
|
|
Undo |
|
|
Redo |
|
|
Foreground Color |
|
|
Background Color |
|
|
Insert Hyperlink |
|
|
Insert Image |
|
|
Insert Table |
|
|
Absolute |
|
|
Special Characters |
|
|
Insert Line |
|
|
Remove Formatting |
|
|
View /Edit HTML Source |
To enable the forced matrix option in JAM, do the following:
JROX.COM Affiliate Manager allows you to create a custom commission structure with multiple levels and a forced matrix option. You can have up to 10 commission levels and a maximum matrix width of 5 members.
What is Forced Matrix System?
A Forced Matrix is a system where there is a limit to the number of referrals any affiliate member can refer . For example, if you set the matrix width to be 4, an affiliate member (Affiliate 1) can refer a maximum number of 4 people. Any future referrals will automatically be placed below one of the 4 members he referred right below him, forcing the matrix to fill up, up to the number of commission levels you have specified.
Setting up Multiple Commission Levels and / or Enabling the Forced Matrix
To enable the forced matrix option, click on Settings>System Settings.
To enable the number of commission levels, click Programs > Edit Program for the program you want to specify the commission levels for. Under the Commissions Per Level heading, you can select how many levels you want your commission structure to be, as well as enable / disable the forced matrix option and matrix width.
*You should only change these settings once per installation. Once you've set these options, do not change them, or any future commission calculations for your downline will not work properly. So make sure to plan out what commission structure you want for your sites, so that you don't have to make any changes again in the future.
Adding custom content in JAM is quite easy. Just follow these steps:
Here's a short description of all fields:
Add Custom Content:
When you're done creating your content, just make sure to select Yes in the Enable section on the top right corner of the form, and hit Submit. This will automatically be available in your affiliate members area once you link to it.
You can add/edit your Members Area Main Menu easily. Just follow these steps:
Here's a short description of all fields:
Terms of Service Content Pages:
When you're done editing, just hit Submit.
* This content will show up on the very first page of your affiliate members area main menu.
You can edit your Affiliate Program Description Page easily. Just follow these steps:
Here's a short description of all fields:
Program URL - This is the URL of the program description page. You can link to this from your main home page.
Terms of Service Content Pages:
When you're done editing, just hit Submit.
You can edit your Terms of Service or User Agreement easily. Just follow these steps:
Here's a short description of all fields:
TOS URL - This is the URL of the terms of service for the selected program
Terms of Service Content Pages:
When you're done editing your terms of service file, just hit Submit. This will automatically be updated to have your own custom terms of service agreement.
To setup a one-time offer for your programs, follow these steps:
When creating a one-time offer, make sure you create two links:
JAM allows you to have a content dropdown menu in your affiliate members area, so that they can easily select the web pages from one location.
To enable this option, follow these steps:
JAM allows you to add any extra html or php pages from a specified folder outside of JAM to the content dropdown menu. This is optional, but can work great if you publish other static pages in a different folder, and want your members to easily access it.
To enable this option, follow these steps:
* JAM will use the page's file name as the title to show on the content drop down, so you may want to rename the files something that is relevant to its content.
For instructions on how to protect a separate folder using the JAM Authentication Module, view the following document:
http://jam.jrox.com/docs/index.php?article=73#separatefolder
JAM has an available Authentication Module if you want to utilize JAM's authentication and membership management features. This module can be used to create your own custom secure web pages on a totally separate folder from JAM.
By using this module, you have endless possibilities in creating membership sites, affiliate programs, or custom secured content
You can quickly secure php web pages just by copying and pasting a small file on the top line of each web page.
For instance, you created a web page that you only want members to be able to access, just append the following to the top of that page, like this:
<?php
########################################
## PASSWORD PROTECT CERTAIN WEB PAGES ##
########################################
error_reporting(0);
//SET THE HOME DIRECTORY TO YOUR AFFILIATES FOLDER
$JAM_Directory = '/home/USERNAME/public_html/affiliates';
require_once ($JAM_Directory.'/includes/common.php');
require_once ($JAM_Directory.'/includes/mod/mod_members.php');
Login_Check();
?>
Just change the /home/USERNAME/public_html/affiliates to point to your JAM directory.
You now have that web page protected and all users will have to login through the JAM login form to get access to it.
An example of this is available in the /plugins/misc/secure_page.php file.
Examples for using the Authentication Module
Affiliate or Membership Site on a Separate but Secured Web Page
JAM can create a membership area for you that uses the Authentication Module that secures the web pages. To do this, do the following:
Create a new Program in JAM. Fill in all the fields, and set the URL to Redirect to After Login to the web page you have secured.
Optionally set the URL Redirect to After Signup to any page you want.
Set the Force Member Login to only allow signups to be able to login to this program
Open up your membership web page for editing and add the authentication code to the very top of your web page.
Add the authentication code to all the web pages you want to secure.
Securing a separate folder using the Authentication Module
* this might be a bit advanced for some users
Alternatively, if your web host supports it, you can protect an entire folder without having to add the authentication code on each and every page that is in that folder. This makes it easier to protect any and all files in that folder.
To do this, follow these steps:
The Content Publisher allows you to create your own custom content pages, as well as edit content on other parts of JAM, such as the affiliate members' main menu, terms of service, and affiliate program descriptions.
By using the Content Publisher, you will be able to use a built-in HTML editor to publish new content on your membership areas without having to create or upload separate HTML pages.
Here are the content pages you can create/edit in JAM:
Adding a new downloadable file is easy in JAM. Just follow these steps:
*Remember, the link can only be used when an affiliate member is logged into JAM. If they are not logged into JAM, clicking on the download link will not work.
JAM allows you to set certain security restrictions for downloadable files. These include:
* When a user tries to access a downloadable file, and you have upgrade options enabled for that program or group, the user will automatically be presented with an option to upgrade for a fee. This makes it automatic for your users to upgrade and get the downloadable files from you easily.
JAM allows you to have any type of downloadable file, as long as it can either be stored on your web hosting account or accessible via a URL from JAM.
These files can be any of the following:
By having this option, you can protect your downloadable files by using JAM as the necessary login authentication before giving access to them.
JAM allows you to receive membership payments via Paypal.
To charge members a fee for your program, follow these steps:
* Make sure to enable the Instant Payment Notification (IPN) option in your Paypal > Profile > Instant Payment Notification and Preferences.
You now have JAM configured to accept payment via Paypal after a new affiliate/member signs up.
A Commission Payment Module is used by the affiliate administrator to pay affiliates for commissions generated. For example, you can use the Paypal Commission Payment Module to generate a Paypal Mass Payment File for paying affiliate commissions.
The current commission payment modules availabe are:
A Membership Payment Module is used by JAM to allow the affiliate administrator to charge a membership fee for joining the program. These payment modules can be used to charge potential members a one-time, monthly, quarterly, semi-annually, or annually payment.
By charging members a fee, you can charge members access to membership programs, exclusive group downloads, or higher commission payouts.
The current Membership Payment Modules available are:
There is an option to create custom commission amounts. For example, you can pay a percentage of 10% as set within the Programs area of JAM, and still add $2.00 to each commission when it is calculated. This is done by editing a file called custom.comm.php, inside the /includes folder.
You have now created a custom commission amount.
JAM allows you to pay your affiliates via AlertPay.
You can pay affiliates via an online direct AlertPay payment, or by generating a AlertPay Mass Payment File.
To pay affiliates via AlertPay, follow these steps:
JAM allows you to pay your affiliates via Check or Other Payment.
To pay affiliates via Check, follow these steps:
JAM allows you to pay your affiliates via E-Gold.
You can pay affiliates via an online direct E-Gold payment.
To pay affiliates via E-Gold, follow these steps:
JAM allows you to pay your affiliates via Moneybookers.
You can pay affiliates via an online direct Moneybookers payment, or by generating a Moneybookers Mass Payment File.
To pay affiliates via Moneybookers, follow these steps:
JAM allows you to pay your affiliates via Paypal.
You can pay affiliates via an online direct Paypal payment, or by generating a Paypal Mass Payment File.
To pay affiliates via Paypal, follow these steps:
JAM allows you to pay your affiliates via SafePay.
You can pay affiliates via an online direct SafePay payment, or by generating a SafePay Mass Payment File.
To pay affiliates via SafePay, follow these steps:
JAM allows you to pay your affiliates via Stormpay.
You can pay affiliates via an online direct Stormpay payment, or by generating a Stormpay Mass Payment File.
To pay affiliates via Stormpay, follow these steps:
A Commission Payment Module is used by the affiliate administrator to pay affiliates for commissions generated. For example, you can use the Paypal Commission Payment Module to generate a Paypal Mass Payment File for paying affiliate commissions.
The current commission payment modules availabe are:
JAM allows you to charge membership fees for your programs.
To enable this feature, follow these steps:
The next time you have an affiliate signup, they will either have the option to pay for your membership program or will be required to pay for it.
JAM allows you to receive membership payments via 2Checkout.
To charge members a fee for your program, follow these steps:
You now have JAM configured to accept payment via 2Checkout after a new affiliate/member signs up.
JAM allows you to accept Payments for Membership via AlertPay.
To enable this option, follow these directions:
*If you want to charge a trial amount for AlertPay, you will need to manually edit the /plugins/processors/AlertPay/processor.template.form.php file.
JAM allows you to receive membership payments via Authorize.Net.
To charge members a fee for your program, follow these steps:
You now have JAM configured to accept payment via Authorize.Net after a new affiliate/member signs up.
JAM allows you to receive membership payments via E-Gold.
To charge members a fee for your program, follow these steps:
You now have JAM configured to accept payment via E-Gold after a new affiliate/member signs up.
JAM allows you to receive membership payments via Linkpoint Central.
To charge members a fee for your program, follow these steps:
You now have JAM configured to accept payment via Linkpoint Central after a new affiliate/member signs up.
JAM allows you to receive membership payments via Moneybookers.
To charge members a fee for your program, follow these steps:
You now have JAM configured to accept payment via Moneybookers after a new affiliate/member signs up.
JAM allows you to receive membership payments via Paypal.
To charge members a fee for your program, follow these steps:
* Make sure to enable the Instant Payment Notification (IPN) option in your Paypal > Profile > Instant Payment Notification and Preferences.
You now have JAM configured to accept payment via Paypal after a new affiliate/member signs up.
JAM allows you to receive membership payments via SafePay Solutions.
To charge members a fee for your program, follow these steps:
You now have JAM configured to accept payment via SafePay Solutions after a new affiliate/member signs up.
A Membership Payment Module is used by JAM to allow the affiliate administrator to charge a membership fee for joining the program. These payment modules can be used to charge potential members a one-time, monthly, quarterly, semi-annually, or annually payment.
By charging members a fee, you can charge members access to membership programs, exclusive group downloads, or higher commission payouts.
The current Membership Payment Modules available are:
JAM uses signup modules to process any extra tasks after an affiliate signs up. These tasks can range from adding the user to an external autoresponder, or creating an account on a different application. These signup modules are used to extend JAM even further so as to provide you with as much flexibility as possible.
Optional Signup modules are located in Settings > Signup Settings > Optional Signup Modules. You can configure these for use by clicking on their link and filling in the required fields.
Current Signup Modules available in JAM are:
AutoresponsePlus is a third-party autoresponder system that can integrate into JAM. JAM can be configured to automatically send form data to AutoresponsePlus so that the affiliate signup is subscribed to a given mailing list. This can work well if you want to use AutoresponsePlus to send your affiliates a sequence of messages, or subscribe them to a newsletter / mailing list.
* Make sure you have a valid installation of AutoresponsePlus. If you don't, and want to use this application, you will need to purchase one and install it first.
To configure AutoresponsePlus with JAM, follow these steps:
You now have AutoresponsePlus integrated into JAM. The next time someon signs up for your program, they will automatically be subscribed to the given mailing list in AutoresponsePlus as well.
Aweber is a third-party autoresponder service that can be integrated into JAM. JAM can be configured to automatically send form data to Aweber so that the affiliate signup is subscribed to a given mailing list. This can work well if you want to use Aweber to send your affiliates a sequence of messages, or subscribe them to a newsletter / mailing list.
* Make sure you have a valid subscription to Aweber. If you don't, and want to use the Aweber service, you will need to subscribe to their service first.
To configure Aweber with JAM, follow these steps:
You now have Aweber integrated into JAM. The next time someone signs up for your program, they will first be redirected to Aweber to submit the mailing list data, then redirected back to JAM to continue the signup process.
ListMailPro is a third-party autoresponder system that can integrate into JAM. JAM can be configured to automatically send form data to ListMailPro so that the affiliate signup is subscribed to a given mailing list. This can work well if you want to use ListMailPro to send your affiliates a sequence of messages, or subscribe them to a newsletter / mailing list.
* Make sure you have a valid installation of ListMailPro. If you don't, and want to use this application, you will need to purchase one and install it first.
To configure ListMailPro with JAM, follow these steps:
You now have ListMailPro integrated into JAM. The next time someon signs up for your program, they will automatically be subscribed to the given mailing list in ListMailPro as well.
ResponseMagic is a third-party autoresponder system that can integrate into JAM. JAM can be configured to automatically send form data to ResponseMagic so that the affiliate signup is subscribed to a given mailing list. This can work well if you want to use ResponseMagic to send your affiliates a sequence of messages, or subscribe them to a newsletter / mailing list.
* Make sure you have a valid subscription to ResponseMagic. If you don't, and want to use it, you will need to subscribe with them first.
To configure ResponseMagic with JAM, follow these steps:
You now have ResponseMagic integrated into JAM. The next time someon signs up for your program, they will automatically be subscribed to the given mailing list in ResponseMagic as well.
JAM can be integrated into a third-party autoresponder when an affiliate signs up. This can work well if you have you own mailing list software you want to use to send emails to your affiliates, or possibly subscribe them to a sequential autoresponder for timed To enable integration with a third party autoresponder:
First, get the signup form code from your autoresponder service. This is normally the HTML signup form code that is used to subscribe prospects via an HTML form. Here's an example:
$email_values = array
(
//THESE ARE THE NAME-VALUE PAIRS THAT YOU NEED TO SUBSCRIBE TO YOUR EXTERNAL AUTORESPONDER
"fname" => $F_First_Name,
"lname" => $F_Last_Name,
"email" => $F_Primary_Email,
"list" => $listcode,
);
Save the file and test it by signing up an affiliate in JAM.
JAM allows you to have up to 25 different administrators to access and manage your affiliate program.
Adding Administrators
To add new administrators, go to Settings>Admin Settings, and click on Add New Administrator.
Create a New Administrator Details:
Change Admin Password:
Viewing and Editing Administrators
To view all of your administators, click on Settings > Admin Settings
To edit an administrator, click on the Edit icon on the administator list.
Deleting an Administrator
To delete an administrator, click on the Administator's username and click on the Delete button.
Here is a brief description for each field:
Affiliate Member Settings:
Affiliate Groups
The current licensing structure for JAM allows everyone to use it for free. The only restriction in the free version is that the number of affiliates are limited to a total of 50.
Once you have reached the limit of 50, you can no longer add or signup anymore affiliates.
To view the license information for your site, click on Settings > License Information inside your JAM admin area.
Purchase a License
To purchase a license, click on the Click Here To Upgrade link on the heading section of the Free Edition of JAM,or click on to Settings > License Information > Buy License.
This will launch a new website, where you can purchase a license for your copy of JAM.
Once you've finished payment, input the license key into the licensing information section of JAM.
The Marketing Settings section of your JAM installation handles all the marketing configuration. Here, you can enable / disable certain marketing tools, or redirect your affiliates to a custom marketing URL if you so desire.
To access this section, click on Settings > Marketing Settings.
Marketing Tools Settings:
The Payment Settings section handles all payment-relates settings for JAM.
To edit your payment settings, click on Settings>Payment Settings.
Payment Settings:
Membership Payment Settings:
The payment modules listed in this section are used for membership payment management. If you want to charge members a fee, you can configure one of these payment modules to require payment after signup before being granted access to your program.
Current payment modules included in JAM are:
To configure a membership payment module, just click on the payment processor of your choice to launch its configuration options.
Automatic Refund Module (ARM):
The Automatic Refund Module allows you to integrate your existing ECommerce Application or Shopping Cart Refund Process to automatically do affiliate refunds in JAM. This gives you the option to automatically refund any affiliate commission that you already paid to an affiliate due to a customer refund or chargeback. The refund is automatically generated and reflected in the Affiliate's commission payments. For more information on the Automatic Refund Module and how to set it up, click here.
* This option currently only works with Paypal IPN and StormPay IPN
The Security Settings section handles all the logging and security features of your JAM installation.
To edit your security settings, click on Settings>Security Settings.
Security Settings:
The Signup Settings section involves configuring your Affiliate Signup Form.
To edit signup settings, click on System > Signup Settings.
Affiliate Signup Form Settings:
Require Admin Approval on Signup - If you want to manually approve all affiliate signups, enable it here.
Require Affiliate Confirmation via Email - To require confirmation from your affiliates via email after signing up, enable it here.
Enable Automatic Signup Module - If you want to use and integrate the JAM Automatic Signup Module with your shopping cart, enable this option.
Auto Signup Secret Word - This is used in conjunction with the Automatic Signup Module.
* For more information on the JAM Automatic Signup Module, click here
Custom Form Fields:
Show Sponsor on Signup Form - If you want to show the affiliate sponsor on the signup form, enable it here.
Require Sponsor on Signup - If you want to make sure all affiliate signups have sponsor, enable it here.
Require Company on Signup Form - Set the Company field to be hidden, optional or mandatory when an affiliate signs up.
Require Address 1 on Signup Form - Set the Address 1 field to be hidden, optional or mandatory when an affiliate signs up.
Require Address 2 on Signup Form - Set the Address 2 field to be hidden, optional or mandatory when an affiliate signs up.
Require City on Signup Form - Set the City field to be hidden, optional or mandatory when an affiliate signs up.
Require State on Signup Form - Set the State field to be hidden, optional or mandatory when an affiliate signs up.
Require Country on Signup Form - Set the Country field to be hidden, optional or mandatory when an affiliate signs up.
Require Zip / Postal Code on Signup Form - Set the Zip / Postal Code field to be hidden, optional or mandatory when an affiliate signs up.
Require Phone on Signup Form - Set the Phone field to be hidden, optional or mandatory when an affiliate signs up.
Require Fax on Signup Form - Set the Fax field to be hidden, optional or mandatory when an affiliate signs up.
Require Check Name on Signup Form - Set the Check Name to be hidden, optional or mandatory when an affiliate signs up.
Require Username on Signup Form - Set the Username field to be hidden, optional or mandatory when an affiliate signs up.
Require Password on Signup Form - Set the Password field to be hidden, optional or mandatory when an affiliate signs up.
Require Website URL on Signup Form -To require a website URL upon affiliate signup, enable it here.
Require Paypal Email on Signup Form - If you require your affiliates to have a paypal account upon signup, enable it here.
Require Stormpay ID on Signup Form - If you require your affiliates to have a stormpay account upon signup, enable it here.
Require SafePay ID on Signup Form - If you require your affiliates to have a safepay account upon signup, enable it here.
Require Moneybookers ID on Signup Form - If you require your affiliates to have a moneybookers account upon signup, enable it here.
Require Alertpay ID on Signup Form - If you require your affiliates to have an alertpay account upon signup, enable it here.
Require Egold ID on Signup Form - If you require your affiliates to have an e-gold account upon signup, enable it here.
Require Bank Transfer on Signup Form - If you require your affiliates to have their bank transfer or wire transfer information upon signup, enable it here.
Require SSN / Tax ID on Signup Form - If you require your affiliates to have their SSN or Tax ID upon signup, enable it here.
Mark TOS as checked or hidden - Make the Term of Service check box hidden, unchecked, or automaticall checked.
Show Payment Options on Signup Form - If you want your new signups to select which payment option to use, you can set this to Yes
* You can enable up to 5 separate custom form fields of your choice. Once enabled, these fields will show up on your affiliate signup form
Enable Custom Field 1 - If you have custom fields for entry on the signup form, enable this option.
Custom Field 1 Name - If you enable the custom field 1, enter the name of the field here.
Enable Custom Field 2 - If you have custom fields for entry on the signup form, enable this option.
Custom Field 2 Name - If you enable the custom field 2, enter the name of the field here.
Enable Custom Field 3 - If you have custom fields for entry on the signup form, enable this option.
Custom Field 3 Name - If you enable the custom field 3, enter the name of the field here.
Enable Custom Field 4 - If you have custom fields for entry on the signup form, enable this option.
Custom Field 4 Name - If you enable the custom field 4, enter the name of the field here.
Enable Custom Field 5 - If you have custom fields for entry on the signup form, enable this option.
Custom Field 5 Name - If you enable the custom field 5, enter the name of the field here.
Enable Custom HTML on Form - If you want to display your own custom html code at the bottom of the signup page, you can enable it here.
Custom HTML Code - Type in your custom html code here. No PHP code.
Optional Signup Modules:
The modules listed here are used during the affiliate signup process. Things such as external autoreponders can be setup here.
The current signup modules available for JAM are:
If you want to use any of these modules, just click on the signup module of your choice and enter the stated values.
The System Settings section handles the general system settings of your JAM installation.
To edit your system settings, click on Settings > System Settings.
Here is a brief description for each field:
System Settings:
Commission Settings:
Affiliate Cookie and Commission Timer Settings
Cookie Tracking - This option will always be enabled and JAM will always try to set a cookie when an affiliate link is clicked as well as read an existing cookie when processing a commissions.
IP Address Tracking - If there is no cookie available and this option is enabled, JAM will try to match the current user's IP address to your list of IP addresses in the JAM database and credit the affiliate listed in that row with the commission.
Session Tracking - When you enable this option, JAM will set PHP session variables for affiliate tracking during the affiliate's visit. If the customer buys during that time, the affiliate who referred that customer will get the sale. Session tracking is limited to the current session of the customer.
http://www.domain.com/index.php?jrox=1000-Unknown-1
*If you want to use JAM's tracking abilities on a different domain, you will have to enable this option and use one of the following methods to set the affiliate cookie in the domain other than where JAM is installed:
For php, you could use something like this, input on the very first line of your web page:
PHP Pages:
=============================
<?php
if (!empty($_GET['jrox']))
{
$cookie_expires = 1 * 60 * 60 * 24 * 365;
$cookie_domain = '.your_domain.com'; //DON'T FORGET THE . (dot) before the domain
setcookie("jrox", $_GET['jrox'], time()+$cookie_expires,"/", $cookie_domain);
}
?>
This will set the same cookie that your affiliate uses on the different domain, so they can get credited the commission later.
Change your_domain.com to the current domain name it is redirected to.
You can change the cookie expiration time by changing the 1 to whatever number you want, then the 365 can be changed to represent the following:
1 = day
7 = week
30 = month
365 = year
JavaScript Code:
=============================
If you don't use .php pages, try this:
In between <head> </head> tags of your web page, insert the following JavaScript:
<script type="text/javascript">
function Set_Cookie( name, value, expires, path, domain, secure ) {
var today = new Date();
today.setTime( today.getTime() );
if ( expires )
{
expires = expires * 1000 * 60 * 60 * 24;
}
var expires_date = new Date( today.getTime() + (expires) );
document.cookie = name + "=" +escape( value ) +
( ( expires ) ? ";expires=" + expires_date.toGMTString() : "" ) +
( ( path ) ? ";path=" + path : "" ) +
( ( domain ) ? ";domain=" + domain : "" ) +
( ( secure ) ? ";secure" : "" );
}
function GetJAMVariable(variable) {
var query = window.location.search.substring(1);
var vars = query.split("&");
for (var z=0; z<vars.length; z++) {
var pair1 = vars[z].split("=");
if (pair1[0] == variable) {
Set_Cookie( 'jrox', pair1[1], 365, '/', '', '' );
}
}
}
</script>
Then right after the <body> tag:
<script>
GetJAMVariable("jrox");
</script>
You can change 365 to however many days you want to set the affiliate cookie to last.
This method may be a bit advanced, if you need help, just post a new topic in the JAM Support Forum, and we'll gladly help.
You can create custom email templates that you can use over and over again for emailing to your affiliates. To do this, you can create your own custom email templates by clicking on Settings > Email Templates, Add New Template
Add New Template:
Once you've created the template, it will automatically appear in the Load a Custom Template drop-down list in Email Affiliates section.
JAM has a number of options when sending out emails in JAM. These settings only need to be edited if the default installation of JAM does not work. Please test your JAM application first before having to edit these settings.
To edit the email sending options, follow these steps:
Follow Up Email Templates are used when you want to utilize the follow-up sequence tool in JAM. This allows you to send timed emails to your new members separated by a number of days that you specify.
JAM allows you to schedule up to 20 Follow-Up messages that can go out to your members separated by the number of days that you set.
This works great for sending your members training tools or affiliate promotion ideas in an automated fashion.
These templates are completely customizable by you, so that it reflects your company image.
For more information on the Affiliate Follow-Up Module, click here
To edit your Follow Up Email Templates, You first need to enable this option in Settings > Marketing Settings > Enable Follow Ups, then click on Settings>Email Templates, and click Add Follow Up in the Follow Up Templates section to start adding new Follow Up Templates.
Edit Email Template:
*Don't forget to include the custom tags for each Follow Up Email Template
The HTML Editor is a feature in JAM that allows you to add /edit/ and create HTML-based templates and ads easily, with very minimal HTML knowledge.
The HTML Editor is available to use if you use the following browsers:
Internet Explorer 5.5 and up
Netscape / Firefox 1.0 and up
The icons in the HTML Editor can do the following:
|
Preview |
|
|
Search |
|
|
Paste from Microsoft Word |
|
|
Undo |
|
|
Redo |
|
|
Foreground Color |
|
|
Background Color |
|
|
Insert Hyperlink |
|
|
Insert Image |
|
|
Insert Table |
|
|
Absolute |
|
|
Special Characters |
|
|
Insert Line |
|
|
Remove Formatting |
|
|
View /Edit HTML Source |
You can create up to 20 follow-up messages to automatically send to your affiliate members.
* This option requires you to have the CRON job setup and running. If the cron does not run, your messages will not be sent. Click here for more information on setting up the required CRON job.
Setting up the Affiliate Follow-Up Module
To setup the Affiliate Follow-Up Module, follow these steps:
Click on Settings > Marketing Settings > Enable Follow Ups Option and set this to Enable
Click on Settings > Email Templates > Add Follow Up near the bottom of the page, under the Follow Up Templates section.
In the Add New Template area, go ahead and fill in the appropriate fields:
Select Email Type - Select HTML, Text, or Bothz
Email Template Name - Enter a friendly name for your email follow up.From Name - Enter the from name that will appear when this email is sent out.
From Email Address - Enter the from email address that will appear when this email is sent out.
Email Subject - Enter the subject for this email follow up.
Email Template Message - Enter the HTML and /or Text Content of your Follow Up.
Click on Save Email Template to save this email follow up.
Repeat these steps for all of your follow up messages, up to a maximum of 20 follow ups.
Once you've finished adding your follow up templates, go back to Settings > Email Templates and scroll down to the Follow Ups section. Here you will edit the sequence of your follow ups as well as the number of days each follow will wait before being sent. *Make sure to keep the sequence numbers in numerical order, (for example 1,2,3,4,5,6,7,8,910) as JAM calculates the next follow up sequence according to the next sequence number.
Once you're done updating the sequence of your follow ups, just click on Update Follow-Up Sequence and you should be set. The next time an affiliate signs up for your program, they will automatically be queued for the first follow up message to be sent on the day set for it.
System Email Templates are email templates used for certain emailing functions of JAM. For instance, the Affiliate - Password Reset Template is the email template used when your affiliates request a password reset.
These templates are completely customizable by you, so that it reflects your company image.
To edit your System Email Templates, click on Settings>Email Templates, and select the System Email Template to edit.
Edit Email Template:
Welcome Email Templates are email templates that go out after an affiliate / member signs up with you. This is used to introduce your website / business to the new member, along with any user details that they need to know, like affiliate URL, username, password, and so forth.
Each Welcome Email is linked to a Program that you have created in JAM. For example, the first Welcome Email Template is used for the default program in JAM, so all users who sign up for this program will receive this Welcome Email Template.
These templates are completely customizable by you, so that it reflects your company image.
To edit your Welcome Email Templates, click on Settings>Email Templates, and select the System Email Template to edit.
Edit Email Template:
*Don't forget to include the custom tags for each Follow Up Email Template
JAM supports the daily, weekly, or monthly automatic database backup of JAM.
*Your web server must support the "exec" command in PHP. If you do not know if your site supports this, please ask your webhost or systems administrator.
To set this up, follow these steps:
Make sure to change yourdomain.com/your_affiliate_directory to point to your JAM installation directory and the cron_password to reflect the cron password in your includes/config.php file on this line:
define("JAM_CRON_JOB_PASSWORD", "cron_password");
If your web host does not support the /usr/bin/wget command, try these other ones:
php -q /home/username/public_html/affiliates/includes/backupdb.php pw=cron_password
/usr/bin/lynx-protected -accept_all_cookies http://www.yourdomain.com/your_affiliate_directory/includes/backupdb.php?pw=cron_password
JAM requires at least one cron job to run every 10 minutes. If your host cannot run it every 10 minutes, then you can run it every 15 or 30 minutes, although we recommend it to be 10.
*Make sure that the CRON job is scheduled to run at the 10 minute interval of the clock, such as 1:00, 1:10, 1:20, 1:30, 1:40, 1:50
This is the required CRON job you need to run every 10 minutes:
/usr/bin/wget -O - http://www.yourdomain.com/your_affiliate_directory/includes/cron.php?pw=cron_password
Make sure to change yourdomain.com/your_affiliate_directory to point to your JAM installation directory and the cron_password to reflect the cron password in your includes/config.php file on this line:
define("JAM_CRON_JOB_PASSWORD", "cron_password");
If your web host does not support the /usr/bin/wget command, try these other ones:
php -q /home/username/public_html/affiliates/includes/cron.php pw=cron_password
/usr/bin/lynx-protected -accept_all_cookies http://www.yourdomain.com/your_affiliate_directory/includes/cron.php?pw=cron_password
JAM also has other optional cron jobs that you may want to enable. These include the affiliate report alerts and automatic database backups
JAM supports the automatic sending of affiliate statistics and reports via email. This is setup via a cron job setting.
To set this up, follow these steps:
Make sure to change yourdomain.com/your_affiliate_directory to point to your JAM installation directory and the cron_password to reflect the cron password in your includes/config.php file on this line:
define("JAM_CRON_JOB_PASSWORD", "cron_password");
If your web host does not support the /usr/bin/wget command, try these other ones:
php -q /home/username/public_html/affiliates/includes/affreports.php pw=cron_password
/usr/bin/lynx-protected -accept_all_cookies http://www.yourdomain.com/your_affiliate_directory/includes/affreports.php?pw=cron_password
A CRON job, also known as a scheduled task, is a process that your web server/computer runs at preset intervals. This operation usually does things such as process management tasks, update data, or do backup at the preset time that it is configured to do so.
Here are some examples of what a CRON job does:
JAM requires the use of CRON jobs to run its daily management tasks and to setup recurring commissions, if any. Please check to make sure your web host supports CRON or some other sort of task scheduler whereby you can run a specific program at least every 30 minutes.
If you plan to use the Payment Invoices feature to print out invoices for paying your affiliates, you can customize it by opening and editing the the following template file:
admin/includes/html/themes/theme_name/templates/forms/form_admin_pay_affiliates_invoice.php
*Change theme_name to the name of the theme you are currently using.
You can now edit the file as you see fit. Just make sure to keep the PHP Variables intact if you want it to auto-generate the data for you before printing it.
You can edit the included language files in JAM by going to the following folder:
/includes/lang/LANGUAGE/index.php
LANGUAGE is the name of the language you want to edit.
One language file is used for both the admin and members area.
Current language files available in JAM are:
You can add your own language file as well. For instructions on how to do this, click here
If you want to change the folder where you installed JAM, follow these steps:
you can change the folder name in /includes/config.php, under
define("HOME_BASE_DIRECTORY", "/home/username/public_html/affiliates");
//ENTER THE NAME OF YOUR AFFILIATE PROGRAM DIRECTORY
//DO NOT INCLUDE A TRAILING SLASH
define("HOME_BASE_AFFILIATE_DIRECTORY", "/affiliates");
you can then edit the URL to Redirect to, URL to Redirec to after signup, and URL to redirect to After Login in Programs > Edit Program
The Affiliate Members Area can be customized to fit your style. Currently, there are eight included themes that you can quickly use for your members area:
Default
Darknight
Simplelight
Redeye
Smooth
Greenland
Blackice
xblue
These can be changed by going to Programs > Edit Program > Default Member Site Theme in the Admin Area.
Adding a Custom Theme
You can also add your own custom theme just by copying the same file structure as one of the themes above, and uploading to the /includes/html/themes folder with a unique name.
To add a custom theme, follow these steps:
JAM allows you to append certain member information to the following affiliate links for further processing or use:
You can use the following variables for appending to the URL:
Here's an example of how you could use this:
You want to send your affiliate's first name, last name and username to your web page after signing up. Your URL to Redirect After Signup is set at http://www.domain.com/web1.php. To append this data so that it is accessible on that page as variables, change your URL to Redirect to After Signup to this:
http://www.domain.com/web1.php?fname=%%%FIRST_NAME%%%&lname=%%%LAST_NAME%%%&uname=%%%USERNAME%%%
Now, when an affiliate signs up, they will be redirected to this link but their first name, last name, and username will be available for use as $_GET variables, like this:
http://www.domain.com/web1.php?fname=Joe&lname=Test&uname=joetest
You can now manipulate these variables for you to use on your pages as you see fit.
*Security Note - Make sure you only send out data that is relevant to your needs. Do not append data that may compromise your members account or privacy.
To have the little help icon in both the Admin area and Members area point to a custom support page, open up the includes/config.php and edit the following lines with the full URL of the support pages:
//HELP URL SETTINGS
define("ADMIN_HELP_URL", "http://jam.jrox.com/userguide/admin/"); //URL TO LAUNCH THE ADMIN HELP GUIDE
define("MEMBER_HELP_URL", "http://jam.jrox.com/userguide/member/"); //URL TO LAUNCH THE MEMBER HELP GUIDE
JAM has the option to let your affiliate members point their affiliate links to any page on your site.
To do this, follow these steps:
*If you will allow them to redirect to web pages that have variables in the URL, then you need to replace every & symbol with its encoded counterpart %26. For example, if your URL is like this:
http://www.domain.com/store/index.php?id=1&category=4&product=5
You will need to tell your affiliates to link to it like this:
http://www.domain.com/affiliates/jrox.php?id=1000&jxURL=http://www.domain.com/store/index.php?id=1%26category=4%26product=5
* This option is only available on JAM 1.6.2 and higher
JAM allows you to rename the jrox.php file to your own custom file. To do this follow these directions:
If you use the Replicated Website Option in JAM, you can point your regular affiliate links automatically to your affiliate's replicated web page.
To do this, follow these steps:
For URLs that have variables, such as shopping cart products, you will need to edit the URL so that JAM can redirect it properly.
For example, if your URL is similar to this, or it has the ampersand (&) in it:
http://www.domain.com/store/index.php?main_page=product_info&products_id=76
If you want to set the affiliate cookie on a separate web page automatically without having to redirect the user with an affiliate link, you can set the affiliate cookie on that page using JavaScript.
This is useful for things such as the replicated web page, so that the affiliate cookie gets set automatically when a visitor visits the web site. This means that the visitor does not necessarily have to click on an affiliate link for them to be tracked.
To set this up, follow these steps:
JAM supports a number of different types of affiliate links.
Alternatively, JAM also supports affiliate usernames in the URL instead of the affiliate ID:
Finally, JAM allows you to encrypt affiliate links:
For instructions on how to setup search-engine-friendly URLs, click here
For instructions on how to setup dynamic subdomain URLs, click here
Sometimes, you may have an affiliate that requires a special web page you need to point to.
JAM gives you the option of customizing where a particular affiliate's link will point to. This option gives you a way for certain affiliates to point to a particular website, instead of the default web page that you've specified in a product group or marketing tool. By enabling this option, all URLs will be overridden and the affiliate's link will go directly to the site you specify.
To enable custom affiliate urls:
Go to the Affiliate you want to edit by clicking on Affiliates > Edit / Delete Affiliates on the Main Menu
Click on the Edit icon to edit the affiliate.
Scroll down to the option that says Use Custom URL > Select Enable
Type in the URL you want this particular affiliate's link to be redirected to in the Custom Affiliate URL field.
Click Save Member Details.
Your affiliate's link will now be redirected to the custom URL specified every time.
*Setting up dynamic subdomains takes a bit of technical expertise. If you are not familiar with editing your server configuration files, please do not attempt this or at least consult your system administrator first.
Dynamic Subdomain Affiliate Link Requirements:
Access to your DNS records
You will need to be able to edit your DNS or name server records to enable dynamic subdomains.
Access to your Apache Web Server Configuration File
You will need to be able to edit your Apache's httpd.conf file to enable dynamic subdomains.
Steps to Enable Dynamic Subdomain Affiliate Links:
Your home page must be in php, such as index.php
Edit Your Name Server / DNS Records - You will need to enter a wildcard subdomain entry for your DNS records. If you use BIND as your name server, it would go as the last line on your DNS record as follows: @ IN SOA ns1.jrox.com. admin.jrox.com. (
4 ; serial
8H ; refresh
2H ; retry
2W ; expire
1D ; default_ttl
)
IN A 192.168.1.233
IN NS ns1.jrox.com.
IN NS ns2.jrox.com.
www IN A 192.168.1.233
* IN A 192.168.1.233
Edit Your Apache httpd.conf file - You will need to edit your httpd.conf file and add a ServerAlias entry near the bottom of your Virtual Host record as follows:
<VirtualHost 255.255.255.0>
DocumentRoot /home/username/public_html
ServerName www.domain.com
ServerAlias domain.com
ServerAlias *.domain.com
</VirtualHost>
Verify that mod_rewrite is enabled in Apache - To enable the search-engine friendly affiliate links, you must have mod_rewrite enabled in Apache. To verify this, ask your systems administrator.
Enable Dynamic Subdomain Links option - To enable / disable dynamic subdomain affiliate links, click on Settings>Affiliate Settings, select Dynamic on the Select Affiliate Links To Use option.
List and Reserve all of your current subdomains - You will need to get a list of the subdomains you currently use now, and type those into the Subdomain List, under Settings>Affiliate Settings, so that it is not used. Type it in comma separated format, as follows: www,ftp,mail,webmaster
Reserve the "id" folder name - You will need to use the folder name id for redirecting dynamic subdomain links, so don't use that for anything else.
Upload / Edit .htaccess file - You must also upload and/or edit a .htaccess file into your root web directory. There is a sample .htaccess file included with your program, which is located in the /docs folder, named "htaccess2.txt". You can just upload this file into your affiliates directory and rename it to ".htaccess". Make sure you are not overwriting any other .htaccess files in your hosting directory. If you are already using a .htaccess file, make sure to append the following line to the end of your .htaccess file:
RewriteRule ^id/(.+)$ /index.php?id=$1 [l,nc]
Update your index.php Home Page - Once you have finished making the previous configuration changes, you will need to edit your index.php home page, (This page is Your Own Home Page, not any page within your affiliate directory) and add the following lines to the very top of your home page:
<?php
include 'PATH_TO_YOUR_AFFILIATE_DIRECTORY/dynamic.php';
?>
* Change PATH_TO_YOUR_AFFILIATE_DIRECTORY to point to your existing affiliate directory
Test Your Links - Test your Affiliate Links to make sure they are redirecting properly.
Search- Engine Affiliate Link Requirements:
Verify that mod_rewrite is enabled in Apache
To enable the search-engine friendly affiliate links, you must have mod_rewrite enabled in Apache. To verify this, ask your systems administrator.
Reserve the "id" folder name
You will need to use the folder name id for redirecting se-friendly links, so don't use that for anything else.
Enable SE-Friendly Links option
To enable / disable se-friendly affiliate links, click on Settings > Affiliate Settings, select SE-Friendly on the Select Affiliate Links To Use option.
Upload / Edit .htaccess file
You must also upload and/or edit a .htaccess file into your /affiliates directory. There is a sample .htaccess file included with your program, which is located in your affiliates folder, named htaccess.txt. You can just rename it to ".htaccess". Make sure you are not overwriting any other .htaccess files in your hosting directory. If you are already using a .htaccess file, make sure to append the following line to the end of your .htaccess file:
RewriteRule ^id/(.+)$ jrox.php?id=$1 [l,nc]
If you'd like to showcase your affiliate's name or their ID code on your web pages, you need to insert the following JavaScript where you want their Name / ID to appear.
To view an affiliate's full name:
<script language="JavaScript" type="text/javascript" src="http://www.yourdomain.com/your_affiliate_directory/showaff.php?id=fname"></script>
To view an affiliate's username:
<script language="JavaScript" type="text/javascript" src="http://www.yourdomain.com/your_affiliate_directory/showaff.php?id=name"></script>
To view an affiliate's website URL:
<script language="JavaScript" type="text/javascript" src="http://www.yourdomain.com/your_affiliate_directory/showaff.php?id=website"></script>
To view an affiliate's custom ID:
<script language="JavaScript" type="text/javascript" src="http://www.yourdomain.com/your_affiliate_directory/showaff.php?id=customid"></script>
To view an affiliate's ID Number:
<script language="JavaScript" type="text/javascript" src="http://www.yourdomain.com/your_affiliate_directory/showaff.php"></script>
*Change yourdomain.com to your domain name and your_affiliate_directory to the name of your affiliate directory.
JAM allows you to use usernames instead of IDs when affiliate links are generated.
To do this, follow these steps.
JAM allows you to add new language files quite easily.
First, you need to translate one of the included language files to your chosen language. These are located in:
/includes/lang/LANGUAGE/index.php
LANGUAGE is the name of the language available.
Once you've finished translating it, just name upload it to a new language folder in /includes/lang/NEW_LANGUAGE/index.php
NEW_LANGUAGE is the name of your new language file
Once it is uploaded, you can go to Settings > System Settings > Default Site Language and it will be available as a drop down option. It will also be available as an option in the Language Selector, if you have this enabled.
You can edit the included language files in JAM by going to the following folder:
/includes/lang/LANGUAGE/index.php
LANGUAGE is the name of the language you want to edit.
One language file is used for both the admin and members area.
Current language files available in JAM are:
You can add your own language file as well. For instructions on how to do this, click here
Adding custom content in JAM is quite easy. Just follow these steps:
Here's a short description of all fields:
Add Custom Content:
When you're done creating your content, just make sure to select Yes in the Enable section on the top right corner of the form, and hit Submit. This will automatically be available in your affiliate members area once you link to it.
You can add/edit your Members Area Main Menu easily. Just follow these steps:
Here's a short description of all fields:
Terms of Service Content Pages:
When you're done editing, just hit Submit.
* This content will show up on the very first page of your affiliate members area main menu.
To Add a Custom HTML Section to the Member's Area Main Menu:
includes/html/templates/custom/template_member_custom_section_home.php.CUSTOM
Edit this file as you see fit, save it as template_member_custom_section_home1.php, and upload it into the custom directory. You will now have a customized section in your affiliate members area without having to edit any other template file.
To Add a Custom HTML Section to the Member's Area Affiliate Tools Page:
includes/html/templates/custom/template_member_custom_section_tools.php.CUSTOM
Edit this file as you see fit, save it as template_member_custom_section_tools1.php, and upload it into the custom directory. You will now have a customized section in your affiliate tools area without having to edit any other template file. By doing this, you can post affiliate downloads, papers, PDFs for your affiliates to view.
To Add Custom