Difference between revisions of "NATS4 Affiliates Admin"

From TMM Wiki
Jump to navigationJump to search
 
(33 intermediate revisions by 4 users not shown)
Line 3: Line 3:
 
}}
 
}}
  
The Affiliates Admin lets you manage your affiliates.
+
The Affiliates Admin is a group of features in [[NATS4]] that allow you to manage your affiliates, view their statistics, edit their permissions and details, and get other essential information.
  
[[File:Affiliates-admin.png|450 px|Affiliates Admin]]
+
[[File:AffiliateAdmin-41.png|650 px|The NATS4 Affiliates Admin]]
  
The top search box lets you find specific affiliates.  After you find affiliates, the Affiliates list shows information about each matching affiliate.  Left of each Affiliate is a checkbox and an Icon.  Mark the checkbox for several affiliates, scroll to the bottom of the page, and use the Perform Action drop-down to manage each marked affiliate at the same time.  Click the icon to edit the affiliate's account access permissions -- for more information about affiliate access permissions, see the Access Permissions section below. 
+
== Searching For Affiliates ==
  
[[File:Affiliate-permissions.png|450 px|Edit Affiliate Permissions]]
+
At the top of the Affiliates Admin main page, you will see an "Affiliate Search" box, which allows you to find specific affiliates by using a variety of search parameters. As of [[NATS]] version 4.0.74.1, the Affiliates Admin now offers Basic and Advanced search forms. The basic form allows you to search by Username, E-Mail, Affiliate ID, and Status (active, banned, disabled, etc.). The Advanced Search Form offers a wide variety of parameters to search by, allowing you to make more specific search parameters. These categories include:
  
Right of each affiliate are several action Icons.
+
* '''Account Info''' - Search by basic affiliate information, such as username, e-mail, real name, ICQ, AIM, address, etc.
 +
* '''Linked Accounts''' - Search by referring affiliate, referrer ID, and account rep.
 +
* '''Payment Details''' - Search by minimum payout, [[Pay Via Types|PayVia type]], or PayVia info.
 +
* '''Statistics for (period)''' - Sort statistics by time periods, such as last period, this period, this year, etc. Search by raw hits, unique hits, join hits, join submits, joins, and ratio. You can specify your search by "Less Than" or "At Least".
 +
* '''Access Details''' - Search by join IP, join date, last login IP, and last login date.
 +
* '''Limitations''' - Only search for specific account type, whether an account is in-house, and choose how many affiliates to display per page.  
  
* The Affiliate Overview Icon shows the affiliate's account information
+
[[File:Advanced-Affiliate-Search-41.png|450px|NATS4 Advanced Affiliate Search]]
* The Override icon lets you overrides as that affiliate. For more details, see the Override section below
 
* The Edit Affiliate Details icon lets you change the affiliate's account details page
 
* The Affiliate Statistics icon takes you to the affiliate's statistics page
 
* The Affiliate Documents icon lets you upload documents for affiliates.  For more information, see the Affiliate Documents section below.
 
* The Add Manual Sale icon adds a manual sale.  For more details, see the Manual Sale section below
 
* The Add Manual Invoice icon adds a manual invoice.  For more details, see the [[NATS4 Manual Invoice|Manual Invoice article]]
 
* The Edit Affiliate Admin Settings icon lets you change several special settings.  For more details, see the Affiliate Admin Settings section below
 
* The Change Affiliate Password icon changes the affiliate's password
 
* The Change Affiliate Status icon lets you Disable or Ban affiliates.  For more details, see the Disabling and Banning Affiliates section below
 
* The Delete Affiliate icon deletes the affiliate's account
 
  
Note: NATS hides icons which can't be used for specific affiliates.
+
You can also get a complete CSV Dump of affiliate data by clicking the "Full CSV Dump" button in the Affiliate Search box at the top of the page. As of version 4.0.74.1, [[NATS4]] also offers an "E-mail Dump" feature. This will obtain only dumps of affiliates' e-mail addresses, an additional dump statistic, through the affiliate search table.
  
== Affiliate Admin Settings ==
+
== The Affiliates Table ==
Use the Affiliate Admin Settings to customize specific affiliates.
+
 
 +
The Affiliates Table can be found below the "Affiliate Search" box on the Affiliates Admin main page. This contains information regarding every affiliate you have in your [[NATS]] system, including:
 +
 
 +
* '''Username''' - Displays the username of the affiliate, and the status of their account (active, disabled, banned)
 +
* '''Real Name (Country)/E-Mail''' - Displays the real name of the affiliate, along with their country and the e-mail address they used to register
 +
* '''Joined/Last Login''' - Displays the time and date the member joined, as well as their last login
 +
 
 +
[[File:Affiliates table.PNG|450px|The NATS Affiliates Table]]
 +
 
 +
At the bottom of the Affiliates Table, you will find a drop-down menu that allows you to perform batch actions on affiliates. You can perform these batch actions by selecting them with the checkboxes to the left of each affiliate name, and using the available drop-down menu. Through the drop-down menu, you can:
 +
 
 +
* '''Delete''' - Removes the selected affiliates from list of available affiliates.
 +
* '''Restore (Delete)''' - Restores a deleted affiliate to your "Affiliates" list. This functionality will be added to later versions of [[NATS4]].
 +
* '''Remove Account Rep''' - Removes the selected affiliate(s) from their current [[NATS4_Account_Representatives|account representative]].
 +
* '''Assign Account Rep''' - Allows you to assign an [[NATS4_Account_Representatives|Account Representative]] to a chosen affiliate. This action cannot be performed as a batch action.
 +
* '''Assign Referrer''' - Allows you to assign an affiliate as a referrer for another affiliate. This action cannot be performed as a batch action.
 +
 
 +
Click the Perform Action button to perform your specified action to your selected [[Ct#Affiliate|affiliates]].
 +
 
 +
You can also perform various actions to individual members by using the available Action Icons, detailed below.
 +
 
 +
== Affiliate Action Icons ==
 +
 
 +
To the right of each affiliate are several action icons, which allow you to perform certain tasks involving your affiliates.
 +
 
 +
* The '''Affiliate Overview''' Icon shows the affiliate's account information
 +
* The '''[[NATS4 Affiliate Override|Override]]''' icon lets you overrides as that affiliate.  For more details, please see our [[NATS4 Affiliate Override]] wiki article.
 +
* The '''Edit Affiliate Details''' icon lets you change the affiliate's account details page. This will override as the specified affiliate.
 +
* The '''Affiliate Statistics''' icon takes you to the affiliate's statistics page. This will override as the specified affiliate.
 +
* The '''Affiliate Documents''' icon lets you upload documents for affiliates.  For more information, see the Affiliate Documents section below.
 +
* The '''[[Add Manual Sale]]''' icon adds a manual sale.  For more details, please see our [[Add Manual Sale]] wiki article.
 +
* The '''Add Manual Invoice''' icon adds a manual invoice.  For more details, see the [[NATS4 Manual Invoice|Manual Invoice article]]
 +
* The '''[[NATS4 Affiliate Admin Settings|Edit Affiliate Admin Settings]]''' icon lets you change several special settings.  For more details, see our [[NATS4 Affiliate Admin Settings]] wiki article.
 +
* The '''Change Affiliate Password''' icon changes the affiliate's password
 +
* The '''[[Change Affiliate Status]]''' icon lets you Disable or Ban affiliates. For more information, please see our [[Change Affiliate Status]] wiki article.
 +
* The '''Change API Key''' icon changes the API key for the specified affiliate. For more information on API keys, please see our [[NATS4 API]] wiki article.
 +
* The '''Delete Affiliate''' icon deletes the affiliate's account
 +
 
 +
Note: NATS automatically hides icons that can't be used by certain affiliates.
  
* The Manual Invoice checkbox enables the Manual Invoice icon described above.  For more details, see the [[NATS4 Manual Invoice|Manual Invoice article]]
+
== Affiliate Access Permissions ==
  
== Overriding Affiliates ==
+
To edit affiliate access permissions, click the icon to the left of their account name. The Account Type drop-down menu on this page has six options ordered from least access to most access:
An override is an [[Common Terms#Admin (NATS)|admin's]] ability to temporarily become an existing [[Common Terms#Affiliate|affiliate]].
 
Overriding as an affiliate doesn't affect the administration interface.
 
Any changes made in the affiliate area change the affiliate's account.
 
  
== Access Permissions ==
+
* An Affiliate is a standard affiliate.
Click the icon left of a user's account name to go to the Account Access screen.  The Account Type drop-down on this page has six options ordered from least access to most access:
 
* An Affiliate is a common affiliate.
 
 
* An [[ct#Account Representative|Account Representative]] manages affiliates.  For more information, see the [[NATS4 Account Representatives|Account Representatives article]].
 
* An [[ct#Account Representative|Account Representative]] manages affiliates.  For more information, see the [[NATS4 Account Representatives|Account Representatives article]].
 
* A Site Partner shares site revenues and gets extra statistics.  For more information, see the [[NATS4 Site Partner|Site Partner article]].
 
* A Site Partner shares site revenues and gets extra statistics.  For more information, see the [[NATS4 Site Partner|Site Partner article]].
Line 45: Line 73:
 
* A TMMAdmin has full administrative access, but can only log in from the IP addresses specified by the TMM_ADMIN_IPS configuration option.  For more information, please see the [[NATS4 Configuration Options|Configuration Options article]]
 
* A TMMAdmin has full administrative access, but can only log in from the IP addresses specified by the TMM_ADMIN_IPS configuration option.  For more information, please see the [[NATS4 Configuration Options|Configuration Options article]]
 
* An Admin has full administrative access.  For more information, see the [[NATS4 Creating Admin Accounts|Admin Accounts article]]
 
* An Admin has full administrative access.  For more information, see the [[NATS4 Creating Admin Accounts|Admin Accounts article]]
 +
 +
For more information on the Affiliate Access Permissions feature, please see our [[NATS4 Affiliate Access Permissions]] wiki article.
  
 
== Affiliate Documents ==
 
== Affiliate Documents ==
NATS lets you upload and send documents to [[ct#Affiliate|affiliates]]. Go to the
+
 
[[Affiliates Admin]], find an affiliate, click Affiliate Documents
+
NATS lets you upload and send documents to [[ct#Affiliate|affiliates]]. To do so, go to the [[Affiliates Admin]], select the affiliate you want, and click the Affiliate Documents icon. Once you are on the Documents page, you can use the field there to upload and send documents to this affiliate-- existing documents will be listed on the page.
Use the field there to upload and send documents this affiliate; existing documents will be listed.
+
 
 +
[[File:Affiliates-Documents-41.png|450px|Uploading Documents in NATS]]
 +
 
 +
Before you can begin uploading documents for your [[Ct#Affiliate|affiliates]], you must first make allowances for file extensions and IPs in the [[NATS4 Configuration Admin|Configuration Admin]]. Go to the "Security" section of the [[NATS4 Configuration Admin|Configuration Admin]] and scroll down to the "Document Upload" settings. Here, you will find two configuration settings regarding document uploads:
 +
* '''DOCUMENTS_SECURE_EXT''' - Input what file extensions you wish to allow in a comma-separated list. For example: .doc,.txt,.docx
 +
* '''DOCUMENTS_SECURE_IPS''' - Input what IPs will be allowed to upload documents in a comma-separated list.
  
 
=== Example Documents ===
 
=== Example Documents ===
 +
 
* Uploading an image of the resellers W9 form
 
* Uploading an image of the resellers W9 form
 
* Uploading an image of documents pertaining to instant payments
 
* Uploading an image of documents pertaining to instant payments
  
== Manual Invoices ==
+
== Affiliate Admin Settings ==
You can give a one-time credit to an affiliate with a manual invoice.  The next time your store payments, you will pay the affiliate the extra amount you set.
 
'''Warning: after you make a manual invoice, you can not remove it.  You must pay the affiliate.'''
 
  
Go to Affiliate Admin, find the affiliate, and click the Edit Affiliate Admin Information icon. Enable the Manual Invoices check-box and click Save Changes.
+
Affiliate Admin Settings allows you to customize affiliates beyond the standard settings. Here you can manually mark In-House Accounts, indicate that certain documents have been received, set trust levels, and allow features like instant payments and manual invoices.
  
Return to the main Affiliate Admin, find the affiliate again, and click the new Add Manual Invoice icon.  Enter the amount to pay the affiliate and click Add Invoice.
+
For more information on Affiliate Admin Settings, please see our [[NATS4 Affiliate Admin Settings]] wiki article.
  
== Manual Sale ==
+
When you are done further configuring your [[Ct#Affiliate|affiliate]], click Save Changes.
To manually add a sale to an affiliate, go to the Affiliate's Admin, find the affiliate, and click the Add Manual Sale icon. Enter the manual sale details and click Add Manual Sale. '''Warning: you cannot remove a manual sale -- it's a real sale, and you must pay the affiliate for it.'''
 
  
== Disabling and Banning Affiliates ==
+
== Manual Invoices ==
A banned affiliate cannot login, all of their traffic is redirected to /spam.html on your linkdomain, and they are removed from the Payment Admin.
 
  
A disabled affiliate cannot login and is removed from the Payment Admin -- but their traffic is still tracked.
+
NATS allows you to give a one-time credit to an affiliate with a manual invoice. With this option, the affiliate will be paid the additional amount the next time you store payments.  
  
== Affiliate Start Page ==
+
'''Warning: after you make a manual invoice, you can not remove it; you must pay the affiliate.'''
To store a start page for an affiliate or administrator, put the following code in the template, members_header.
 
  
{if $is_startpage}Your Startpage{else}<a href="internal.php">Startpage</a>{/if}
+
To add a manual invoice, you must first enable them in the Affiliates Admin. Find the affiliate you wish to allow manual invoices for, and click the Edit Affiliate Admin Settings icon.
 +
Under "Main Settings", enable the Manual Invoices check-box and click Save Changes.
 +
<br>[[File:admin_actions.png]]
 +
<br>Once you have done this, return to the main Affiliate Admin, find the affiliate again, and click the new Add Manual Invoice icon.
  
 +
<br>[[File:admin_actions_invoices.png]]<br>
  
 +
Enter the amount to pay the affiliate and click Add Invoice.
 +
<br>[[File:manual_invoices_table.png]]<br>
  
 
[[Category:NATS4 Administrator Guide]]
 
[[Category:NATS4 Administrator Guide]]
 +
[[Category:NATS4 Affiliates Admin]]

Latest revision as of 23:44, 20 February 2018

NATS 4
Affiliates Admin
The Affiliates Admin
ID Numbers
Account Representatives
Affiliate Referrals
Affiliate Activation
Affiliate Access Permissions
Affiliate Admin Settings
Affiliate Overrides
Creating Admin Accounts
In-House Accounts
Affiliate-Specific Join Options and Payouts
Add Manual Sale
Manual Invoices
Affiliate Groups
Affiliate Documents
Change Affiliate Status
Members Admin
The Members Admin
View Member Details
Add Member
MySQL Auth
Mod Authn DB
Multisite Access
Member Logging
Member Password Retrieval
OpenID Connect
Mod Auth OpenIDC
ID Numbers

The Affiliates Admin is a group of features in NATS4 that allow you to manage your affiliates, view their statistics, edit their permissions and details, and get other essential information.

The NATS4 Affiliates Admin

Searching For Affiliates

At the top of the Affiliates Admin main page, you will see an "Affiliate Search" box, which allows you to find specific affiliates by using a variety of search parameters. As of NATS version 4.0.74.1, the Affiliates Admin now offers Basic and Advanced search forms. The basic form allows you to search by Username, E-Mail, Affiliate ID, and Status (active, banned, disabled, etc.). The Advanced Search Form offers a wide variety of parameters to search by, allowing you to make more specific search parameters. These categories include:

  • Account Info - Search by basic affiliate information, such as username, e-mail, real name, ICQ, AIM, address, etc.
  • Linked Accounts - Search by referring affiliate, referrer ID, and account rep.
  • Payment Details - Search by minimum payout, PayVia type, or PayVia info.
  • Statistics for (period) - Sort statistics by time periods, such as last period, this period, this year, etc. Search by raw hits, unique hits, join hits, join submits, joins, and ratio. You can specify your search by "Less Than" or "At Least".
  • Access Details - Search by join IP, join date, last login IP, and last login date.
  • Limitations - Only search for specific account type, whether an account is in-house, and choose how many affiliates to display per page.

NATS4 Advanced Affiliate Search

You can also get a complete CSV Dump of affiliate data by clicking the "Full CSV Dump" button in the Affiliate Search box at the top of the page. As of version 4.0.74.1, NATS4 also offers an "E-mail Dump" feature. This will obtain only dumps of affiliates' e-mail addresses, an additional dump statistic, through the affiliate search table.

The Affiliates Table

The Affiliates Table can be found below the "Affiliate Search" box on the Affiliates Admin main page. This contains information regarding every affiliate you have in your NATS system, including:

  • Username - Displays the username of the affiliate, and the status of their account (active, disabled, banned)
  • Real Name (Country)/E-Mail - Displays the real name of the affiliate, along with their country and the e-mail address they used to register
  • Joined/Last Login - Displays the time and date the member joined, as well as their last login

The NATS Affiliates Table

At the bottom of the Affiliates Table, you will find a drop-down menu that allows you to perform batch actions on affiliates. You can perform these batch actions by selecting them with the checkboxes to the left of each affiliate name, and using the available drop-down menu. Through the drop-down menu, you can:

  • Delete - Removes the selected affiliates from list of available affiliates.
  • Restore (Delete) - Restores a deleted affiliate to your "Affiliates" list. This functionality will be added to later versions of NATS4.
  • Remove Account Rep - Removes the selected affiliate(s) from their current account representative.
  • Assign Account Rep - Allows you to assign an Account Representative to a chosen affiliate. This action cannot be performed as a batch action.
  • Assign Referrer - Allows you to assign an affiliate as a referrer for another affiliate. This action cannot be performed as a batch action.

Click the Perform Action button to perform your specified action to your selected affiliates.

You can also perform various actions to individual members by using the available Action Icons, detailed below.

Affiliate Action Icons

To the right of each affiliate are several action icons, which allow you to perform certain tasks involving your affiliates.

  • The Affiliate Overview Icon shows the affiliate's account information
  • The Override icon lets you overrides as that affiliate. For more details, please see our NATS4 Affiliate Override wiki article.
  • The Edit Affiliate Details icon lets you change the affiliate's account details page. This will override as the specified affiliate.
  • The Affiliate Statistics icon takes you to the affiliate's statistics page. This will override as the specified affiliate.
  • The Affiliate Documents icon lets you upload documents for affiliates. For more information, see the Affiliate Documents section below.
  • The Add Manual Sale icon adds a manual sale. For more details, please see our Add Manual Sale wiki article.
  • The Add Manual Invoice icon adds a manual invoice. For more details, see the Manual Invoice article
  • The Edit Affiliate Admin Settings icon lets you change several special settings. For more details, see our NATS4 Affiliate Admin Settings wiki article.
  • The Change Affiliate Password icon changes the affiliate's password
  • The Change Affiliate Status icon lets you Disable or Ban affiliates. For more information, please see our Change Affiliate Status wiki article.
  • The Change API Key icon changes the API key for the specified affiliate. For more information on API keys, please see our NATS4 API wiki article.
  • The Delete Affiliate icon deletes the affiliate's account

Note: NATS automatically hides icons that can't be used by certain affiliates.

Affiliate Access Permissions

To edit affiliate access permissions, click the icon to the left of their account name. The Account Type drop-down menu on this page has six options ordered from least access to most access:

For more information on the Affiliate Access Permissions feature, please see our NATS4 Affiliate Access Permissions wiki article.

Affiliate Documents

NATS lets you upload and send documents to affiliates. To do so, go to the Affiliates Admin, select the affiliate you want, and click the Affiliate Documents icon. Once you are on the Documents page, you can use the field there to upload and send documents to this affiliate-- existing documents will be listed on the page.

Uploading Documents in NATS

Before you can begin uploading documents for your affiliates, you must first make allowances for file extensions and IPs in the Configuration Admin. Go to the "Security" section of the Configuration Admin and scroll down to the "Document Upload" settings. Here, you will find two configuration settings regarding document uploads:

  • DOCUMENTS_SECURE_EXT - Input what file extensions you wish to allow in a comma-separated list. For example: .doc,.txt,.docx
  • DOCUMENTS_SECURE_IPS - Input what IPs will be allowed to upload documents in a comma-separated list.

Example Documents

  • Uploading an image of the resellers W9 form
  • Uploading an image of documents pertaining to instant payments

Affiliate Admin Settings

Affiliate Admin Settings allows you to customize affiliates beyond the standard settings. Here you can manually mark In-House Accounts, indicate that certain documents have been received, set trust levels, and allow features like instant payments and manual invoices.

For more information on Affiliate Admin Settings, please see our NATS4 Affiliate Admin Settings wiki article.

When you are done further configuring your affiliate, click Save Changes.

Manual Invoices

NATS allows you to give a one-time credit to an affiliate with a manual invoice. With this option, the affiliate will be paid the additional amount the next time you store payments.

Warning: after you make a manual invoice, you can not remove it; you must pay the affiliate.

To add a manual invoice, you must first enable them in the Affiliates Admin. Find the affiliate you wish to allow manual invoices for, and click the Edit Affiliate Admin Settings icon. Under "Main Settings", enable the Manual Invoices check-box and click Save Changes.
Admin actions.png
Once you have done this, return to the main Affiliate Admin, find the affiliate again, and click the new Add Manual Invoice icon.


Admin actions invoices.png

Enter the amount to pay the affiliate and click Add Invoice.
Manual invoices table.png