User Tools

Site Tools


Sidebar

magento_2:affiliate_pro

Affiliate Pro

Backend

Configuration

Go to System ⇒ Configurations ⇒ Mage World ⇒ Affiliate (or Affiliate Pro ⇒ Configurations) to configure the module.

General Settings

  • In Enable Affiliate Pro, choose “Yes” to enable the module, choose “No” to disable it.

New Affiliate

  • In Auto sign up new registered customers to Affiliate Program, if you choose “Yes”, the affiliate registration form will not be shown on “Create account” (registration) page, new customer will be assigned as an affiliate automatically. To disable this feature, choose “No”.
  • In Extend default customer registration form to allow sign up box for Affiliate program, choose “Yes” to change the default registration form. A new Affiliate signup will be shown on the Registration Page. If there are already other extension overwriting the registration page, please be aware of conflict possibilities. To disable this feature, choose “No”.

  • In Enable customer to voluntarily sign up for affiliate program on default customer registration form, select among three options: Disable, Enable, signup checkbox; Enable, signup form.

  • In Auto approve Affiliate registration, choose “Yes” to automatically approve the affiliate registration. In case you select “No”, go to Affiliate Pro⇒Manage Members⇒ Pending Members to approve the registration manually.
  • In Assign affiliate to group when registration auto-approved, select a group. If affiliate registrations are automatically approved, the affiliates will belong to the group that you assign here.
  • In Length of the manual referral code (set # of characters), specify the number of characters of referral code.

Customers

  • In Show manual affiliate referral code field on extended customer registration form, choose “Yes” to display the referral code box on new account registration page (not for affiliate registration). To disable this feature, choose “No”.
  • In Extend shopping cart page to allow Affiliates to enter credit, choose “Yes” to overwrite the shopping cart page. Otherwise, choose “No”.

  • In Show manual referral code block on extended shopping cart page, select “Yes” to allow customers to insert the referral code at shopping cart page. To disable this feature, choose “No”.
  • In Reassign customer to new affiliate when they use new manual referral code, if you choose “Yes”, when a customer enters a new referral code, the system will change the parent affiliate of this customer to a new Affiliate who has that new referral code and update referral information. Otherwise, choose “No”.
  • In Do not display 'Share this page' link on following pages, list the page that you don’t want customers to share. The selected page will not have the Share this page option in the footer.

Manage Affiliate Commission and Customer Discount

  • In Program Executing Priority, choose one of 3 options: By maximum commission, By maximum discount, By priority. Please be aware that only 1 Affiliate program will take effect if purchased product belongs to 2 or more programs
  • In Calculate affiliate Discount with Tax. Choose “Yes” for customers to get Discount with Base Price of Product incl Tax. Selecting “No” means that customers get Discount with Base Price of Product excl Tax. (Only use with Discount by Percent which setup in Programs)
  • In Calculate affiliate commission, choose between Before discount and After discount. This feature allows you to calculate affiliate discount and commission before or after Magento default discount.
  • In Include taxes when calculating Affiliate commission, choose “Yes” if you want to count affiliate commission and discount with tax. Otherwise, choose “No”.
  • In Apply discount and commission for affiliates when they purchase themselves, choose “Yes” to allow affiliates to receive discount and commission when they purchase products from store. Otherwise, choose “No”.

  • In Add commission to account balance when order status is, select an order status. When an order reaches that status, the commission will be added to Affiliate account balance. The Default is “Complete”
  • In Auto-subtract commission in case of customer refund, select “Yes” to automatically subtract commission when the order is refunded. Otherwise, select “No”.
  • In Reverse commission from account balance when order status is, select an order status. Then, when the order within affiliate commission is changed to this status, the system will automatically subtract commission that has been added before from affiliate balance.
  • In Hold commission in a number of days, assign the number of days to hold back affiliate’s commission.
  • In Commission for referral visitor, you can set the amount of commission for referral visitor. For example: Affiliate A will get commission, if any visitor access the store via A’s Affiliate link.
  • In Commission for referral sign-up, you can set the amount of commission for referral sign-up. When a visitor goes to your store and sign-up an account via the link of Affiliate A then Affiliate A will get commission.
  • In Commission for referral subscribe, set the amount of commission for referral subscription (signup for newsletter).

Manage Affiliate Withdrawal Requests

  • In Enable Affiliate Withdrawal, select “Yes” to enable affiliate withdrawal. Otherwise, select “No”.
  • In Payment Method, click on “Add payment method” to add payment methods on your site, fill in information for Payment Method Code (paypal, moneybookers, banktransfer,check), Payment Method Title, Payment Processing Fee. In the Payment Processing Fee, insert an amount of money as the Payment Processing Fee for every withdrawal (X: fixed fee amount or Y%: by percentage of withdraw amount). For each payment method, admin can set different payment processing fee. In the Enable Frontend field, select ‘Yes’ to show or select ‘No’ to hide the payment method on the frontend.

  • In Minimum Withdrawal Amount and Maximum Withdrawal Amount, fill in the minimum and maximum amount of money which affiliates can withdraw.
  • In Withdrawal Period, choose a time period for withdrawal either weekly or monthly.
  • In Withdrawal processing day: It will show up the weekly day or monthly dates for selecting, depending in your option in the above Withdrawal Period. This is applied for automatic withdrawal option.

Affiliate- Customer Invitation

  • In Use Affiliate's email address when sending invitations to friends in 'My invitations' or with link on product and category pages, select “Yes” to show affiliate emails when an affiliate sends an invitation to friends. If you choose “No”, the system will use the value of the Email Sender (who reply emails will be sent to if affiliate does NOT use own email return address above) field.
  • In Email Template For Recipients, you can manage email templates which are used by an affiliate to invite friends.
  • In 'Referred but unregistered Customer' Cookie to expire in (set # of days), fill in a number of days. This will be the valid period of referral links. The period starts from the time that a customer clicks on the referral link. When an affiliate invites a customer and this customer clicks on the referral link, in the valid period, he/she will be recorded as referred by this affiliate for next visits or purchases.

Affiliate- Widget

  • In Widget width, enter the width of Widget
  • In Widget title, enter the title for widget, the title will be shown on widget at the frontend.
  • In Widget product quantity, specify the quantity of products displayed on widget.

Affiliate- Paypal

In this section, you will enter the information about Paypal Bussiness. When an affiliate requests withdrawal by Paypal method, he/she can withdraw from this Paypal account.

  • In Enable Automatic Withdraw By Paypal: choose “Yes” to enable this feature, otherwise choose “No”.
  • Enter the information of Paypal including API Username, API Password, API Signature, API Endpoint, Paypal Notification Subject, Paypal Notification Note.

  • In Paypal Balance Minimum, enter a minimum balance. When the balance is lower than this number, an email will be sent to the email in bellow setting.
  • In Notification Email When Paypal Account Balance Is Low, choose an email to receive notification when Paypal Balance is lower than the minimum number.

Admin Email Notification Template

In Admin Notification Template, you can manage notification emails for the administrations.

  • In Email Sender (who reply emails will be sent to), choose an email sender.
  • In Notify Admin when New Affiliate signs up, select to get notifications of new affiliate.
  • In Send New Affiliate Request To:, fill in email addresses separated by coma.

Affiliate Email Notification Templates

These fields allow the admin to choose email senders and email templates for referral. Sample templates are available (choose default ones).

You can view and edit sample templates by going to app\locale\en_US\template\email\mw_affiliate

The affiliate system will notify Affiliate members about account status

The affiliate system will notify Affiliate members about balance changes, withdrawals and programs.

Manage Affiliates

To manage affiliate members, please go to Affiliate Pro ⇒ Manage Affiliate This menu includes 5 sections: Active Affiliate, Pending Affiliates, Manage Affiliate Groups, Manage Websites and All customers.

Active Affiliates

All active affiliates will be listed under Active Affiliates section. Please click on each affiliate to view details. The administrator can lock affiliate accounts here by disabling it via action box. If an affiliate account is locked, he will no longer receive commission and discount as well as use affiliate functions till this account is unlocked.

View an active affiliate

After clicking on the detail affiliate page, under Affiliate Information, you can find all information of that affiliates such as general, credit balance, history of credit, invitation, withdrawal, and so on.

In General Information, the information of affiliate account, payment method, referral code, affiliate parent, payment method, withdrawal notice email, withdrawal method and reports current balance, total amount of received commission and total amount paid out are stored.

Manual Adjustment/Payout

In Manual Adjustment section, admin can add or subtract affiliate balance manually. In Manual Payout, enter an amount of money. This amount will be taken as a completed withdrawal of the affiliate. This feature is used when admins wants to pay directly for the affiliate and the system will update affiliate’s current balance and the Total Paid Out field in the General Information tab.

Transaction History tab shows a list which includes the information of Transaction Time, Type of Transactions, Transaction Detail, Amount (Add or subtract credit for each event) and Balance.

Invitation History shows details about Invitation Time, Customer Email Address, IP Address, Status (type of referral).

Withdrawal History show transactions of withdrawal including Withdrawal Time, Withdrawal Amount, Payment Processing Fee, Net Amount (After calculating payment processing fee) and Status (pending or complete). For each withdrawal transaction, you can use Actions box to change its status.

Commission History tab lists all transactions related to affiliate’s commission.

In Affiliate Programs, all programs that affiliate joined in will be shown, however only 1 affiliate program with highest priority is applied for this affiliate.

Affiliate Websites shows the information of Affiliate’s website.

Affiliate Network lists all sub-levels of Affiliate.

Pending Affiliates

If you do not select automatically approve the affiliate registration (in Configuration), when a customer signs up for the affiliate system, his/her information will be listed in this page. Then, the administrator can choose to approve or not pending members by selecting members and changing their status at the Actions box (from Pending to Approved or Not Approved).

Manage Affiliate Groups

In this section, you will have all the affiliate group listed. Admin can Delete group(s) via Action box or Export group to CSV.

To add a new group, follow as below:

After clicking on Add Group, you will see the affiliate group information page with 3 sections: general information, programs and members.

  • In General information

In Group Name, write a name for the group.

In Maximum number of days affiliate will earn commission from new referral, set a number of days you want.

In Maximum numbers of orders affiliate will earn commission from new referral, specify a number of orders. Insert 0 if there is no limitation.

In Maximum commission affiliate will earn from each referral, specify an amount of money. Insert 0 if there is no limitation. For example, if you choose $50, consider the case that Affiliate A invites customer B. The customer B places orders that brings the affiliate A an amount of commission. If this amount reaches $50, the Affiliate A will not receive any more commission from customer B’s next orders.

  • In Programs: Assign available programs for the group.

  • In Members: Pick members for the group.

Manage Websites

Under this section, you can see details about all affiliate websites including: Customer Email, Website and Status.

Via Action box, you can Delete or Change Status (Verified or Not Verified). Moreover, all websites can be Exported to CSV or XML

All Customers

Customers section list all customers on your site. You can change the affiliate parent here, applying for both general customers and affiliates. Select customers, choose to Change Affiliate parent at the Actions box, insert the affiliate parent’s email to the Affiliate parent field, and click Submit.

Note that: If you enable the Reassign affiliate when customer enters new referral code field (in configuration), from the frontend page, when an affiliate inserts a new referral code at the shopping cart page, his affiliate parent will be updated.

Moreover, all customers can be Exported to CSV or XML

Manage Withdrawals

To manage affiliate withdrawals, please go to Affiliate Pro ⇒ Manage Withdrawals This menu includes 2 sections: All Withdrawals, Pending Withdrawals.

Pending Withdrawals

At this sections, all details of pending withdrawals are shown. They are: Affiliate Account, Payment Method, Payment Email, Withdrawal Time, Withdrawal Amount, Payment Processing Fee, Net Amount and Status

Admis can Change Status of withdrawals (Canceled or Complete) via Actions box and Export to CSV or XML all withdrawals.

All Withdrawals

At this sections, all details of pending withdrawals are shown. They are: Affiliate Account, Payment Method, Payment Email, Withdrawal Time, Withdrawal Amount, Payment Processing Fee, Net Amount and Status

View All Transactions

To manage transactions, please go to Affiliate Pro ⇒ View All Transactions This menu includes 2 sections: Commision History, Transaction History.

Commision History

At this sections, Affiliate commission and discount statistics are shown. They are: Transaction Time, Commission Type, Affiliate Account, Affiliate Commission, Customer Discount, Purchase Total, Detail, Status.

Click on View to see details

Admis can Change Status of commission of orders (commission status, not related to the order status) via Actions box or via CSV

Transaction History

The Transaction History lists all information that relates to balance change (including Time, Affiliate Email, Transaction Type, Amount, Balance).

Manage Programs

To manage programs, please go to Affiliate Pro ⇒ Manage Programs ⇒ Manage Programs

In Manage Programs section, you are able to create marketing campaigns that decide the commission and discount rule.

To add a new program, click on Add Program. After that, set up more details of the program: general information, conditions, actions, assigned Affiliate groups and program transactions as follow:

  • Program Details

In Notify affiliate via email, tick on the checkbox to notify affiliates of the program. Specify Program Name, Description, Store view, Priority for the program.

In Status, select Enabled to activate the program.

In Start Date and End Date, choose the active time for the program. The system will auto-close the program when it reaches the expiration date.

In Total Members, the number of affiliates of the program will be shown.

The Total Commission shows the total amount of the commission.

  • In Conditions, you can set rules for the program, which is the same as Magento shopping cart rules.

  • In Affiliate Commission/ Customer Discount, define commission and discount for the program.

In Affiliate Commission, fill in a commision amount for affiliates (if referred customer meets program conditions). The format is x or y% (x - fixed commission amount/ y% - percent of product value) separate multi-level marketing with commas for each level (ex 10%, 5%, 1 etc.)

In Referred Customer Discount for Subsequent Purchases, fill in an amount. To change discounts (fixed amount 'x' or percentage 'y%') for subsequent customer orders, separate discounts with commas in field. Last figure will apply for all subsequent purchases. Ex 10%,5,0 for 10% discount on 1st purchase, $5 discount on 2nd purchase and no discount on subsequent purchases (until expiration date set in Affiliate Group detail)

Under Affiliate will earn commission on individual cart items if they meet the following conditions, you can specify more conditions. In this case, the items in shopping cart have to satisfy conditions at Conditions section and this option.

  • In Add Group, assign the program to specific affiliate groups. Hit Reset filter and select groups.

  • Program Transaction displays a list of transaction information: transaction time, product name, affiliate account (who received commission), order number, product value, product commission, discount and status. If the status is complete, the commission will be added to the affiliate balance.

Manage Banners

To manage banners, please go to Affiliate Pro ⇒ Manage Programs ⇒ Manage Banners. A banner can be visible on specific store views, assigned to specific links and affiliate groups.

To add a new banner, click on Add Banner. After that, set up more details of the banner: Title, Link, Image, Width, Height. Admin also have to assign specific Store views, Affiliate groups and Members to the banner.

Report

To view Affiliate statics, please follow Affiliate Pro ⇒ Affiliate Report. This including 4 sections: Overview, Affiliate Invitation, Affiliate Sales, Affiliate Website(s).

Overview

Under Date Range dropdown, you can choose a time range to view the report among: Last 24h, Last week, Last month, Last 7 days, Last 30 days or Custom.

  • Line Chart shows total sales that are generated by Affiliates, total commission of Affiliates and total amount of discount in the chosen time range.
  • Sales by Programs (Pie Chart) presents percentages of sales by each affiliate program in chosen time range.
  • Commission by Programs (Pie Chart) presents percentages of commission by each affiliate program in chosen time range (for the type of commission come from referrals such as: referral visitor, referral sign-up, referral subscribe, those type of commission will belong to non-program group)
  • Statistics box on the right side shows: Total sales, total orders, total commission, total withdrawals (withdrawal status is complete), total withdrawal fees, total transactions, average commission per order, average commission per affiliate, average order value and total affiliate.
  • Top Affiliate by Sales box on the right side shows 10 top affiliates who have highest sales.

Affiliate Invitation

  • In the From and To fields, use the calendar to specify the time range for report data aggregating.
  • Select type of showing by Day, Month, or Year in dropdown of the Show By field.
  • Click on the Refresh button to view details information about Affiliate Account, # of clicks, # of New accounts, # of purchases and Website
  • Select the CSV or Excel option and click on the Export button to export the report information, in the Export to field.

Affiliate Sales

  • In the From and To fields, use the calendar to specify the time range for report data aggregating.
  • Select type of showing by Day, Month, or Year in dropdown of the Show By field.
  • Click on the Refresh button to view details information about Affiliate Account, # of customers referred, # of order, # of sales items, Total Sales, Total Commission, Total Customer Discount
  • Select the CSV or Excel option and click on the Export button to export the report information in the Export to field.

Affiliate Websites

  • In the From and To fields, use the calendar to specify the time range for report data aggregating.
  • Select type of showing by Day, Month, or Year in dropdown of the Show By field.
  • Click on the Refresh button to view details information about Affiliate website, # of clicks, # of new accounts, # of purchases
  • Select the CSV or Excel option and click on the Export button to export the report information in the Export to field.

Frontend

My Affiliate Acount

When a customer have had affiliate account on your site, after logging in, he will see My Affiliate Account tab at My Account.

The My Affiliate Account page at the frontend has ten tabs: My Account Info, My Transaction History, My Commission History, My Withdrawal Request, My Invitations, My Affiliate Banners, My Affiliate Programs, My Affiliate Network, My Affiliate Websites and My Affiliate Report. Please follow the next part to view the details of these tabs.

Acount Info

  • At this section, affiliate can select Payment Method, Withdrawal Notification Email, Auto or Manual Withdrawal, An Account Balance for Autopayment
  • In Reserve Level, affiliates choose an amount of money that they wish to always be remained in their account. This field is not required and its value depends on each customer.

Transaction History

Here, affiliate can view Current Balance and Transaction History

Commission History

A full detailed showing of all Commission is presented. Affiliate can see Commission Type, Commission, Customer Discount, Detail, Status.

Withdrawal Request

An affiliate member can choose to make withdrawals automatically or manually. In case of manual withdrawals, affiliate can fill in withdrawal requests here.

Invitations

There are various ways for affiliates to send invitations to your store.

Each affiliate will have their own Referral Code and Referral Links. Moreover, they can Invite Friends via Email or social sharing.

Here, a report on invitation history will be displayed with numbers of clicks, sign-up, subscribes and purchases.

Affiliate Banners

Banners set up and assigned by admins will be displayed here for affiliates. They can place the banner links at their websites, blog, etc… to get referrals.

Affiliate Programs

An affiliate can see the programs he/she belongs to at a glance and how much commission he receives from each referred purchase.

Affiliate Networks

If there are sub-levels of affiliate, it will be shown here.

Affiliate Websites

Affiliates can manage all of their affiliate websites. Here, they can Add New Website and verify with Verification Key or Verification File

Affiliate Report

Affiliate can select different time ranges at the Date range box to view reports:

  • Line chart shows total sales (include sales from their purchases and their referred customer’s purchases) and total commission in chosen time range.
  • My commission sources (Pie Chart) presents percentages of each commission source in chosen time range: commission from my purchases is commission from affiliate’s purchases; commission from my group sales is commission from referred customers’ purchases; commission from other sources is commission from referral visitor, referral sign-up and referral subscribe.
  • My commission by programs (Pie Chart) presents percentages of commission by each affiliate program in chosen time range (for the type of commission come from referrals including referral visitor, referral sign-up and referral subscribe, those types of commission will belongs to non-program group)
  • Affiliates can also view their total purchases, total orders (only from their own purchases) and their total commission, total affiliate network in chosen time range at this page.
magento_2/affiliate_pro.txt · Last modified: 2018/05/25 05:34 by blanka