Difference between revisions of "X-Cart:Affiliate"

From X-Cart 4 Classic
Jump to: navigation, search
(Improving User Experience)
(Managing Affiliate Programs)
Line 207: Line 207:
 
|}
 
|}
  
==Managing Affiliate Programs==
+
==Managing Affiliate Partners==
  
===Managing Affiliate Partners===
+
===Creating Partner Accounts===
  
====Creating Partner Accounts====
+
===Approving and Declining Partner Applications===
  
====Approving and Declining Partner Applications====
+
===Assigning Affiliate Plan to Partner===
  
====Assigning Affiliate Plan to Partner====
+
==Managing Affiliate Plans and Commissions==
  
===Managing Affiliate Plans and Commissions===
+
===Creating Affiliate Plans===
  
====Creating Affiliate Plans====
+
===Setting up Plan's Commission===
  
====Setting up Plan's Commission====
+
===Setting up Plan's Multi-tier Commission===
  
====Setting up Plan's Multi-tier Commission====
+
===Assigning Affiliate Plan to Partner===
  
====Assigning Affiliate Plan to Partner====
+
==Handling Banners==
  
===Handling Banners===
+
===Handling Generic Banners===
  
====Handling Generic Banners====
+
===Handling Specific Banners===
  
====Handling Specific Banners====
+
==Tracking Advertising Campaigns==
  
===Tracking Advertising Campaigns===
+
==Controlling Commission Payments==
  
===Controlling Commission Payments===
+
===Managing Partner Accounts===
  
====Managing Partner Accounts====
+
===Managing Partner Orders===
  
====Managing Partner Orders====
+
=== Uploading Payment Info ===
  
====Uploading Payment Info====
+
==Affiliate Statistics==
  
===Affiliate Statistics===
+
===Banners Statistics===
  
====Banners Statistics====
+
===Referred Sales Statistics===
  
====Referred Sales Statistics====
+
===Top Performers Statistics===
  
====Top Performers Statistics====
+
===Multi-tier Affiliates Statistics===
  
====Multi-tier Affiliates Statistics====
+
=== Advertising Campaigns Statistics ===
 
 
====Advertising Campaigns Statistics====
 
  
 
[[Category:X-Cart user manual]]
 
[[Category:X-Cart user manual]]
 
[[Category:X-Cart modules]]
 
[[Category:X-Cart modules]]

Revision as of 13:52, 25 January 2010

Overview

X-Affiliate enables you to launch a full-featured affiliate program in your store, which can help you advertise your store and the products you sell. When the affiliate program works, your store takes the main advantage of the Internet marketing, which is to distribute information to global audience at comparatively low price: You promote your store not only with the help of your store management team, but also through a network of your affiliates who get commission for the sales they promote. This will certainly make your online business more competitive.

With X-Affiliate you can manage your partners' accounts, calculate and track partner commission, create affiliate banners and links, collect versatile affiliate statistics, build a multi-level marketing system and even take closer control of third-party advertising campaigns in which your online store may take part.

The key X-Affiliate features are:

  • Unlimited number of affiliate partners of different levels.
  • Unlimited number of affiliate plans.
  • Ability to setup product- and category-based commission.
  • Full control of your partners' commission.
  • Control of third-party advertising programs.
  • Adjustable email notification.

How X-Affiliate works

In general, the idea of how the affiliate program built with X-Affiliate should work is as follows: The store administrator creates an affiliate plan and defines the rules on how to calculate commission for the plan, then the administrator creates a number of affiliate banners and allows new affiliates to register. A new affiliate partner gets registered in the affiliate program, subscribes to the affiliate plan and gets access to the special interface where the partner can generate the codes for the affiliate banners created by the store administrator. The partner then includes the banners into third-party resources on the Internet, companion websites, newsletters, forum signatures, bulletin boards, etc. When a new buyer comes to the store through a banner placed by the partner, the partner receives a percentage of the store's earning according to the rules in the affiliate plan which the partner is subscribed to. The commission goes to the partner's account automatically. The administrator then pays the commission to the partner in any preferable manner - X-Cart and X-Affiliate do not interfere with payment process in any way. After the partner commission has been paid off, the administrator should mark it as paid.

Since X-Affiliate is an add-on module, it can be used together with the X-Cart shopping cart only. When the module is installed and activated, it adds a number of new controls to the X-Cart Admin area and a new user interface, Partner area, and introduces a new type of user, Partner.

New controls in the Admin area allow the store administrator to manage all the aspects of the affiliate program. The majority of controls can be accessed through the special menu Affiliates, which is shown in the picture below. Other controls introduced by X-Affiliate are smoothly built into the basic X-Cart controls.

X-affiliate admin 01.gif

Partner area is a special password-protected user interface with the URL like www.example.com/xcart/partner/ where www.example.com/xcart/ is the URL to where X-Cart is installed. The Partner area is used by your affiliates to access different resources, including codes of affiliate banners and links, sales statistics, payment details, etc. To access the Partner area one must be a registered member of your affiliate program. The Partner area is shown in the picture below.

X-affiliate admin 02.gif

Partner is a user who registered to participate in your affiliate program. A partner can log in to the personal account in the Partner area, get assigned to an affiliate plan and earn commission for promoting your products, and even recruit his or her own affiliates and receive a part of their earnings if they promote a sale as well. The number of partners of all levels is unlimited.

System requirements

To be able to successfully install and use X-Affiliate you must have a working copy of X-Cart Gold or X-Cart Pro already installed on your server. Make sure that the version of the module is the same as the version of the installed copy of X-Cart.

Note: If you do not remember the version of the installed copy of X-Cart, find it in the Summary/Environment info section of the X-Cart Admin area (Administration menu -> Summary).

Installing X-Affiliate

Installation

The instructions on how to install the X-Affiliate add-on module are the same both for X-Cart Gold and X-Cart Pro.

To install the module:

1. Obtain a distribution package for the X-Affiliate add-on module by downloading it from the File Area section of your X-Cart Account. The distribution package you need is contained in the archive file xaff-x.y.z.tgz where x, y and z are the version numbers of the module. Make sure the version of the module is the same as the version of the installed copy of X-Cart.

2. Put the distribution package to the X-Cart root directory on your server or hosting account.

  • If you use a Windows-based server, or a UNIX-based server without terminal access:
a) Decompress the archive with the X-Affiliate distribution package to a directory on your system using your favorite compression program (WinZIP or any other archiver with support for TAR files).
b) Use an FTP client to upload all the files contained in the archive (retaining the directory structure) to the X-Cart root directory on your server or your hosting account.
  • If you use a UNIX-based server with terminal access:
a) Use an FTP client to upload the archive with the distribution package to the X-Cart root directory on your server or your hosting account.
b) Decompress the package using the following commands.
tar -xzvf xaff-x.y.z.tgz
Important: Make sure you keep the directory structure while unpacking and uploading the distribution package, otherwise some necessary files can be overwritten!

3. In a web browser, run the installation script http://<YOUR_XCART_DOMAIN>/install-xaom.php replacing the variable <YOUR_XCART_DOMAIN> with the true name of the domain where X-Cart is installed.

4. Enter the Auth code, accept the License Agreement and click the Next button.

Note: The Auth code is a random code that was generated after you installed your copy of X-Cart. If you do not remember the Auth code, find it in the Summary section of the X-Cart Admin area (Administration menu->Summary) before the License info subsection. Another way to know the code is to retrieve the value of the variable $installation_auth_code from the file <xcart_dir>include/install.php .

5. The installation script copies the files and activates the module. Click the Next button to continue the installation.

6. The installation script generates a new system fingerprint. Click the Next button to complete the installation.

7. Use the ADMINISTRATOR AREA link to log in to the Admin area.

Uninstalling X-Affiliate

The instructions on how to uninstall the X-Affiliate add-on module are the same both for X-Cart Gold and X-Cart Pro.

To uninstall the X-Affiliate add-on module:

1. In a web browser, run the installation script http://www.example.com/install-xaom.php replacing "www.example.com" with the true name of the domain where X-Cart is installed.

2. Choose the Uninstall the module option, enter the Auth code, accept the License Agreement and click the Next button.

Note: The Auth code is a random code that was generated after you installed your copy of X-Cart. If you do not remember the Auth code, find it in the Summary section of the X-Cart Admin area (Administration menu->Summary) before the License info subsection. Another way to know the code is to retrieve the value of the variable $installation_auth_code from the file <xcart_dir>include/install.php .

3. After the installation script removes the module files and deactivates the module, click the Next button to complete the uninstallation.

4. At the Uninstallation complete screen, click the Next button to leave the Wizard.

Important: After you have uninstalled X-Affiliate, be sure to remove the module distribution package from your web directory.

Enabling

After you have installed the X-Affiliate add-on module, you need to enable it in the X-Cart Admin area. Otherwise you will not be able to use the module to launch an affiliate system in your store.

To enable the X-Affiliate add-on module:

  1. Log in to the X-Cart Admin area and go to the Modules section (Administration menu -> Modules).
  2. In the list of modules find the entry "Affiliate" and select the corresponding check box.
  3. Scroll down to the bottom of the page and click the Update button to apply the changes.
X-affiliate admin 03.gif

After you have updated the list of active modules, the Configure link will appear next to the module name, meaning that the module is enabled. Use this link to go to the X-Affiliate configuration page and set up the module.

X-affiliate admin 04.gif

Configuring

To configure the module:

1. Log in to the X-Cart Admin area and go to the X-Affiliate settings page.

To reach the configuration page use one of the methods below.

  • Go to the section General settings/Affiliate (Settings menu -> General settings).
  • Go to the list of modules (Administration menu -> Modules) and click on the Configure link that corresponds to the entry "Affiliate".

You will see a box with a number of options and settings for the X-Affiliate module.

X-affiliate admin 05.gif

2. Adjust the module settings.

General Affiliate options

  • Keep partner cookies (days): Use this field to specify the number of days during which partner cookies must be kept on local computers of those visitors who came to your online store through an affiliate banner or link. This ensures that the system will count partner commission even if a referred buyer makes a purchase not on the first visit, but a few days later while the cookies are still kept on the buyer's local computer.
If you do not wish to save partner cookies on a buyer's local computer, leave the value of the field empty or equal to 0.
  • Allow partners to see order totals: Select this check box to allow your affiliate partners to see order totals in the Referred sales section of X-Cart Partner area.
  • Display banners in Admin area as IFRAME: Select this check box to display banners in the Admin area as HTML IFRAME.
  • Ask for partner ID on checkout: Select this check box to enable your customers to enter the ID of an affiliate partner who solicited the sale. Having this option enabled allows your affiliate partners to get a commission if a sale was solicited in an alternative way (e.g., a word of mouth), not a link or banner on a partner's website.
  • Show child affiliate names in partners' affiliate trees: Select the check box if you wish to allow your affiliate partners to see the names of their child affiliates in a personal branch of the store's multi-tier affiliate tree.

Registration

  • Enable partners to register: Select this check box to add the Register button to authorization page of the Partner area and allow everybody to register as affiliate partners. If you leave the check box unselected, your store visitors will not be able to register as affiliate partners, and only the store administrator will be able to create partner accounts.
Note: If you leave the check box unselected and choose to prohibit partners to register, the other registration-related options and controls will be disabled.
  • Moderated partner registration: When the check box is selected, every new partner account will be created with the pending status until the store administrator approves the account.
  • Link to Partner area on Customer area: Select this check box to display a link to the Partner area in the Customer area. It is useful to enable this option if you wish to make your affiliate program available to everybody who visits your store.

Email notifications

  • 'Partner profile is created' notification to profile owner: Select this option to send automatic email notifications to users who have been successfully registered as partners.
  • 'Partner account is approved' notification to partner: Select this option to send automatic email notifications to users whose accounts have been approved by the store administrator. Use this option when only moderated partner registration is enabled.
  • 'Partner account is declined' notification to partner: Select this option to send automatic email notifications to users whose accounts have been declined by the store administrator. Use this option when only moderated partner registration is enabled.

3. Click the Save button to apply the changes.

Improving User Experience

Before you start building an affiliate program with the X-Affiliate module, remember to adjust some of the store settings, which will help you improve the user experience of your existing and prospective partners.

Partner profile

In X-Cart a user profile is a set of personal and business data for administrative use that is collected when a user gets registered in a store. The exact set of details you collect may vary depending on a user type: Customer, Administrator, Provider or Partner. For example, if you sell tangible products you need to collect customers' shipping addresses, but you are unlikely to need this info when it comes to registering affiliate partners. But at the same time you may need to collect some info that is specific to affiliate partners only. For this purpose you need to adjust the set of active and mandatory fields and, if necessary, add new fields to the partner profile/registration form.

To configure the partner profile/registration form:

  1. Log in to the Admin area and go to the section General settings/User Profiles options (Settings menu -> General settings).
  2. In the Partner column of the User Profiles options box select Active (included into the form) and Required (mandatory) fields.
  3. If necessary, use the Add new field subsection to add new fields to the form.
  4. Click the Save button to apply the changes.

Contact form

Similar to user profiles, contact forms are likely to consist of different fields depending on who is intended to submit a form and why. The contact form in the Partner area can be configured to collect only those details that you really need, and, if necessary, you can add new fields.

To configure the contact form in the Partner area:

  1. Log in to the Admin area and go to the section General settings/Contact us form options (Settings menu -> General settings).
  2. In the Partner column of the Contact us form options box select Active (included into the form) and Required (mandatory) fields.
  3. If necessary, use the Add new field subsection to add new fields to the form.
  4. Click the Save button to apply the changes.

Affiliate program description

Remember to place a description of your affiliate program and a message advertising your affiliate program somewhere on your website. For example, you can publish news using the News management section of the X-Cart Admin area and add a detailed description of the program as static content to the Help section of the Customer area. To add the necessary information to the Help section of the Customer area you can either edit the existing information pages "Privacy statement" and "Terms & Conditions" or create new static pages that will include the description.

For instructions on how to edit the text of the user interface and manage static content please refer to the respective sections of the X-Cart user manual, which is available online at http://www.x-cart.com/xcart_manual/online/ .

Email notifications

X-Affiliate can be set up to send email notifications to partners. If necessary, you can customize the default contents of the email messages by editing the respective templates. The table below reveals what templates use certain types of email messages.

Message Type Templates (plain text message) Templates (HTML message)
Partner profile is created
(notification to profile owner)
mail/signin_partner_notif.tpl
mail/mail_header.tpl
mail/profile_data.tpl
mail/signature.tpl
mail/signin_notification_subj.tpl
mail/html/signin_partner_notif.tpl
mail/html/mail_header.tpl
mail/html/profile_data.tpl
mail/html/signature.tpl
Partner account is approved
(notification to partner)
mail/partner_approved.tpl
mail/mail_header.tpl
mail/signature.tpl
mail/partner_approved_subj.tpl
mail/html/partner_approved.tpl
mail/html/mail_header.tpl
mail/html/signature.tpl
Partner account is declined
(notification to partner)
mail/partner_declined.tpl
mail/mail_header.tpl
mail/signature.tpl
mail/partner_declined_subj.tpl
mail/html/partner_declined.tpl
mail/html/mail_header.tpl
mail/html/signature.tpl

Managing Affiliate Partners

Creating Partner Accounts

Approving and Declining Partner Applications

Assigning Affiliate Plan to Partner

Managing Affiliate Plans and Commissions

Creating Affiliate Plans

Setting up Plan's Commission

Setting up Plan's Multi-tier Commission

Assigning Affiliate Plan to Partner

Handling Banners

Handling Generic Banners

Handling Specific Banners

Tracking Advertising Campaigns

Controlling Commission Payments

Managing Partner Accounts

Managing Partner Orders

Uploading Payment Info

Affiliate Statistics

Banners Statistics

Referred Sales Statistics

Top Performers Statistics

Multi-tier Affiliates Statistics

Advertising Campaigns Statistics