CasperVend 2/Affiliates: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
 
(65 intermediate revisions by 4 users not shown)
Line 2: Line 2:
   |__TOC__
   |__TOC__
   |}
   |}
 
[[File:German_flag.gif]] [[CasperVend 2/Affiliates/DE | Schaue hier in Deutsch!]]
== '''<span style="color:#00528c">Affiliate Setup</span>''' ==
= '''<span style="color:#00528c">Setting Up Affiliate Vendors</span>''' =
These instructions assume you've already set up your products and profiles. If you have not, please see the '''[[CasperVend_2/Setup | full manual instructions]]''' FIRST before proceeding with this page.


It is '''very helpful''' to include your store name, and the percentage (%) amount in the name of the vendors. This information reminds the affiliate know how much the vendors give them when they look at them in inventory, and the store the vendors came from.
Ideally, your item pictures should also have your store logo/name ON the product pictures in case a customer of your affiliate wants to track down your shop to see your full product line!
=== Where's the Affiliate Pack? ===
----
Because each 2.x regular vendor can also function as an affiliate vendor, there is no separate affiliate pack anymore for the 2.x versions.  
Because each 2.x regular vendor can also function as an affiliate vendor, there is no separate affiliate pack anymore for the 2.x versions.  
   
These instructions assume you've already set up your products and profiles. If you have not, please see the [[CasperVend_2/Setup]] instructions FIRST before proceeding with these.
It is *very helpful* to include your store name, and the percentage (%) amount in the name of the vendor. This information reminds the affiliate know how much the vendors give them, and the store the vendors came from.
Ideally, your item pictures should have your store logo ON the product pictures in case a '''customer of your affiliate''' wants to track down your shop to see your full product line!
      
      
<ol>
<ol>
Line 23: Line 23:
<li> Take the vendor, box it up and either sell it or pass it out. All done!</li>
<li> Take the vendor, box it up and either sell it or pass it out. All done!</li>
</ol>
</ol>
   
=== Can I Use Free Vendors As Affiliates? ===
== '''<span style="color:#00528c">Affiliate Control Panel</span>''' ==
----
Affiliates now have their own control panel for affiliate vendors they have rezzed out. To access the menu, affiliates touch the main panel on the vendor to get the popup menu and choose "Affiliate", then "Control Panel".
Yes, free vendors can be set up to be affiliate vendors just as easily as the premium/paid vendors can.
[[File:Affiliate_Control_Panel.png|200px|thumb||right|Image of affiliate control pane. Click for larger versionl]]
 
=== Vendor Permissions ===
----
Because CasperVend has transaction verification, it is absolutely safe to leave your affiliate vendors with "Modify" permissions - this allows the affiliate to resize the vendors as needed to fit the available space. Leaving vendors in a large size, and unmodifiable, means that limits the affiliate's ability to set the vendors out in rental spaces, if the space is too small. This in turn limits exposure to YOUR products.
 
No-transfer is often used, but that is entirely up to you.
 
=== No Need To Input Affiliate Merchant Name ===
----
Inputting names is '''only''' required when setting up a '''profit share''' - that's different from setting up affiliate vendors.
 
You simply set up the affiliate vendors and either hand them out or sell them. When the affiliate merchant rezzes out the vendors, they will appear on your vendor list, in a separate "affiliate vendors" section at the bottom of the page.
 
The website tracks which merchant the vendor came from (you) and if the current owner is not you, then the affiliate vendor behavior goes into effect automatically.


==== Control Panel Information ====
=== "Take a Copy" grid-based quirk ===
The control panel shows some basic info about the settings on that particular vendor:
----
<ol>
There's a quirk with using "Take Copy" with rental units and vendors, that you should be aware of.
<li>The creator of the products in that vendor</li>
<li>The commission rate</li>
<li>The sim/region the vendor is located in, along with a map of the region
<li>Whether self sales are allowed</li>
<li>Whether self gifting is allowed</li>
</ol>


==== Control Panel Options ====
Because the server is unaware of this copy being made, the copy that ends up in your inventory is LINKED to the one that is still rezzed, and is NOT a proper copy.
<ol>
<li>Security lock - keeps the vendor locked at or over the percentage rate at the time the page is viewed. Allows the affiliate to prevent merchants from doing "bait and switch", promising one commission rate and then changing it to another lower one later.</li>
<li>Discounts - Allows affiliate to sacrifice all or part of their commission to provide a discount to the customer - the customer is refunded the difference. Only happens when the commission is legitimately earned - self sales may not be counted, depending on merchant's options.</li>
<li> Stats - On the left side is a stats button, allowing affiliates to see ALL of their affiliate sales from all caspervend vendors at any time!</li>
</ol>


== '''<span style="color:#00528c">Affiliate Commission Charts</span>''' ==
If you then modify the one that's still rezzed, the copy that you took *will change too*.
The CasperTech affiliate fee comes out of the initial sale amount on the affiliate vendor. Out of every L$100 sale, this fee is L$2, which leaves L$98 that then gets split between the affiliate, you, and any possible profit sharing partners.
   
If you want your affiliates to get the FULL percentage you told them they would get, then you need to do some basic math - the formula is:
   
:: '''''(percentage) divided by 98, then multiplied by 100'''''
               
A table of some of these percentages is here:


::{| class="wikitable"
To avoid this, TAKE into inventory and then REZ the copy. This will create a proper copy with its own unique UUID.
|-
! &nbsp;Give affiliate this:&nbsp; !! &nbsp;By setting it to this:&nbsp;
|- align="center"
| 10% || 10.2%
|- align="center"
| 15% || 15.3%
|- align="center"
| 20% || 20.4%
|- align="center"
| 25% || 25.5%
|- align="center"
| 30% || 30.6%
|- align="center"
| 35% || 35.7%
|- align="center"
| 40% || 40.8%
|- align="center"
| 45% || 45.9%
|-align="center"
| 50% || 51%
|}


== '''<span style="color:#00528c">Getting Affiliates to Update</span>''' ==
= '''<span style="color:#00528c">Keeping Affiliates Updated</span>''' =
To update your Affiliate vendors, you can do one of the following:
To update your Affiliate vendors, you can do one of the following:


Line 83: Line 57:
:# Use the UpgradeBee
:# Use the UpgradeBee
:# Pick them up  
:# Pick them up  
:# Ship them out
:# Ship them out via the "updates" tab in CasperVend


: '''Or....'''
: '''Or....'''
Line 89: Line 63:
:# Send the UpgradeBee to each of your affiliates
:# Send the UpgradeBee to each of your affiliates


The first method is actually the '''recommended''' way, even though it's more of a hassle for you, the merchant.  
The first method is actually the '''recommended''' way, even though it's more of a hassle for you, the merchant. You will always need the '''CURRENT''' UpgradeBee to upgrade vendors to the current version. Packing an old UpgradeBee in the box with affiliate vendors will not upgrade vendors to a newer version of the script than what the UpgradeBee has (because the then-current vendor script is packed IN the UpgradeBee).
 
=== Encouraging Affiliates to Stay Updated ===
----


There's four big reasons why just sending the UpgradeBee to your affiliates isn't as effective:  
There's four big reasons why just sending the UpgradeBee to your affiliates isn't as effective:  
Line 97: Line 74:
:# If you never update your original pack, you'll still be shipping out OLD vendors in the future.  
:# If you never update your original pack, you'll still be shipping out OLD vendors in the future.  


You always need the '''CURRENT''' UpgradeBee to upgrade vendors to the current version. Packing an old UpgradeBee in the box with affiliate vendors will not upgrade vendors to a newer version of the script than what the UpgradeBee has.
'''One way to motivate your affiliates:'''  
----
:# Put all NEW affiliate vendors in a new affiliate profile with all the products
:# Set the OLDER profile to just one "product" with a display texture that tells them to update their vendors.
 
'''Using an update script'''
----
You may use the CasperUpdate script in order to prompt your affiliates to update their vendors. See the '''[[CasperUpdate | CasperUpdate]]''' page for details on how to set this up - just be aware that there may still be some affiliates who won't update, especially if they don't log in very often.
 
= '''<span style="color:#00528c">Information For YOUR Affiliates</span>''' =
Affiliates now have their own control panel for affiliate vendors they have rezzed out. To access the menu, affiliates touch the main panel on the vendor to get the popup menu and choose "Affiliate", then "Control Panel".
 
Your affiliates may be pointed to the '''[[CasperVend_2/Affiliate_Information | Affiliate Information]]''' page for information '''they''' need in order to use their new affiliate vendors.


One way to motivate your affiliates:
= '''<span style="color:#00528c">Finding Your List of Affiliate Vendors</span>''' =
:# Put all NEW affiliate vendors in a new profile with all the products
:# Set the OLD profile to just one "product" with a display texture that tells them to update their vendors.


== '''<span style="color:#00528c">Affiliate Vendor Permissions</span>''' ==
:# Log in to your CasperVend
Because CasperVend has transaction verification, it is quite safe to leave your affiliate vendors with "Modify" permissions - this allows the affiliate to resize the vendors as needed to fit the available space. Leaving vendors in a large size, and unmodifiable, means that limits the affiliate's ability to set the vendors out in rental spaces, if the space is too small. This in turn limits exposure to YOUR products.
:# Click your "Vendor" tab/button on the left hand side
:# On the resulting "Vendors" page, use the link for "Affiliate Network" as shown below


No-transfer is often recommended, but that is entirely up to you.
<blockquote>
{|
|
[[File:Affiliate_tab.jpg|||left|Image showing where to click to see your list of affiliates]]
|
|}
</blockquote>


== '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' ==
= '''<span style="color:#00528c">Fees & Commissions </span>''' =
=== When Does A Vendor Become An Affiliate Vendor? ===
----
From a CasperVend shipping crate that YOU own, vendors are regular vendors as long as they stay in your possession.
 
If you transfer copies from the original purchaser avatar to another avatar - doesn't matter whether the other avatar is an alt or someone else's avatar completely - it is then treated as an affiliate vendor, and subject to affiliate vendor fees.
 
The system has no way to tell whether the person behind "Avatar Account 1" is the same person that's behind "Avatar Account 2".
 
=== Commission Payments Note ===
----
Commission payments can come from ANY CasperVend device (this is a time-saving measure) - not always the expected one. So you may see a payment commission coming from, for example, what appears to be a vendor that only sells freebies or demos.
 
=== Affiliate Fees Are Per-Vendor Only ===
----
Affiliate fees are set '''only''' on a per-vendor basis. This means that if you're using a multi-product vendor with a profile, that '''everything''' in that vendor is set to that affiliate percentage. If you want to have some products giving one percentage, and certain products another, then you need to set them up in two different vendors, with a different profile for each.
 
=== CasperTech Fees ===
----
The CasperTech affiliate fee comes out of the initial sale amount on the affiliate vendor.
 
: '''FREE VENDORS:''' <br />Out of every L$100 sale, this fee is L$5, which leaves L$95 that then gets split between the affiliate, you, and any possible profit sharing partners.


: '''Q. I'm getting a <span style="color:#990000;">''"The server reported a failure. I'm going to try again in 2 minutes (or touch to try again now)"''</span> message and the vendor won't start up...
:: '''A.''' You have an old 1.x vendor. These were [[CasperVend_v1 | decommissioned in May 2013]]. You need to replace the vendor with one from an updated pack. (Or, if you got an affiliate pack, you need to tell the merchant that their vendors are too old.)


:'''Q. Help! My affiliate is hopping mad because an item was purchased off the affiliate vendor and they didn't get their commission - it sent the entire balance to me! '''
: '''PREMIUM / PAID VENDORS:''' <br />Out of every L$100 sale, this fee is L$2, which leaves L$98 that then gets split between the affiliate, you, and any possible profit sharing partners.
::'''A1.''' The most likely cause of this is:
::: 1) You have blocked the discount on affiliate self-sales, AND
::: 2) The affiliate either purchased directly, or was the recipient of someone else's purchase
:: When in doubt, check both your SL Transaction history (to verify payment was made as stated) AND your CasperVend Statistics (See who bought it vs. who received it)   
:: '''A2.''' Also verify that there IS an affiliate percentage set on the vendor.
   
: '''Q. Can a customer user my gift cards to purchase products through my affiliate's vendors, or will they only work on my own vendors? '''
:: '''A1.''' They can use gift cards on affiliate vendors, but nothing will be paid to the affiliate unless extra is paid on top of the gift card value. So if the product costs L$200, and the gift card only has L$100, the extra L$100 is will count towards the shares and payments set on the vendor and/or product.
:: This means if the gift card value is equal to OR GREATER THAN the value of the product, there will be NO affiliate share paid.
:: '''A2.''' You can disable use of gift cards on a per-vendor basis if you wish, that option is available on the vendor configuration page. It is recommended that - if you want to take advantage of this - that you do so BEFORE passing out the vendor.
           
:: '''Q. Where do I put the NAME of the affiliate? '''
::: '''A1.''' The affiliate is automatically the next owner of the vendor AFTER YOU. You don't need to set it to a particular avatar name.
::: '''A2.''' The website tracks who the vendor came from (you) and if the current owner is not you, then the affiliate behavior is automatically in effect.  


:: '''Q.Do I have to make a new affiliate vendor each time I take on a new affiliate person or affiliate location? '''
=== Commission Chart ===
::: '''A.''' No, you can reuse ones you've already made (just make sure the vendor script is up to date.)
----
   
If you want your affiliates to get the FULL percentage after the sale that you told them they would get, then you need to do some basic math - the formula is:
:: '''Q. One of my affiliates got paid for items, but the pay split did not happen and the customer didn't get their purchase. '''
   
::: '''A.''' Most likely reason: Scripts are off in the sim or the parcel the vendor is rezzed on, and/or vendor is not set to correct land group (This will prevent correct operation of scripts if the land is set to only allow group scripts to run)
:: '''''For 2% Fee: (percentage) divided by 98, then multiplied by 100'''''
           
:: '''''For 5% fee: (percentage) divided by 95, then multiplied by 100'''''
: '''Q. My affiliates are paying the commission / share splits twice'''
:: '''A.''' Most likely reason: Commission / profit sharing was set on both the individual product AND the overall vendor(s).     
:: ...Setting a commission / profit share on the product itself will send a commission from the sale of that product, anywhere you have a vendor for it on the grid, to the designated person(s). It doesn't matter what sim the vendor is on if the share is set on a particular product.     
:: ...Setting a commission on the vendor sends commission from sales generated by THAT SPECIFIC vendor - not all vendors with that product - across the entire grid. (This is what most people prefer when they set up affiliate networks.) 
:: Thus, setting commission on both product AND the vendor means the affiliate pays the share twice - which *sometimes* can lead to them paying more than the product was sold for!
                  
                  
: '''Q. Is it possible to set a group discount with an affiliate vendor? '''
A table of some of these percentages is here:
:: '''A1.''' Yes, group discount capability is enabled with 2.x vendors. Just remember that what group the vendor gives a discount to is ENTIRELY dependent on what group it is rezzed under. This is an LSL limitation.  
 
::{| class="wikitable"
|-
! &nbsp;To give affiliate this:&nbsp; !! &nbsp;Set it to this (2% fee):&nbsp; !! &nbsp;Set it to this (5% fee) &nbsp;
|- align="center"
| 10% || 10.2% || 10.5%
|- align="center"
| 15% || 15.3% || 15.8%
|- align="center"
| 20% || 20.4% || 21.1%
|- align="center"
| 25% || 25.5% || 26.3%
|- align="center"
| 30% || 30.6% || 31.6%
|- align="center"
| 35% || 35.7% || 36.8%
|- align="center"
| 40% || 40.8% || 42.1%
|- align="center"
| 45% || 45.9% || 47.3%
|-align="center"
| 50% || 51% || 54.7%
|}
 
=== Default Fee Processing Order - AFTER 12 March, 2012 ===
----
: On 12 March, 2012, a change was made to the default order, in order to pay the affiliates BEFORE the partner splits. Any vendors created after this point, will have this new order by default.  
              
              
: '''Q. What is the order fees and discounts are applied in? '''
: For any 2.x affiliates *already* created (and especially already in use) BEFORE this date, this is available ONLY via a tick box option on the website, to avoid disturbing any setup  where it's important (to the merchant) that the affiliates get paid AFTER the profit sharing, for consistency. 
:: '''A1.''' The fees / discounts for 2.x vendors prior to 12 March, 2012 happen in this order. Remember that *all* 2.x affiliate vendors incur the affiliate vendor fee, regardless of network size. This fee is necessary to keep the servers running and maintained, because affiliate networks can generate substantially more web traffic than ones only in merchant shops.
       
::: Customer discounts:
:::: 1) Customer discounts (i.e., if they got to a certain spending level)
:::: 2) Customer balances (i.e., spend x, get y store credit type balance)
::: CasperTech Fees, if applicable
:::: 3) Is it a free vendor? Then the free vendor fee applies. (5%)
:::: 4) Is it an affiliate vendor? Then the affiliate vendor fee applies.
::::* Free vendors: 5% affiliate fee
::::* Premium / Fatpack vendors: 2% affiliate fee
::: Partner Splits, if applicable
:::: 5) Vendor profit shares
:::: 6) Product profit shares, if applicable
::: Affiliate Gets
::::7) Affiliate commission
:::You
::::8) Whatever is left
              
              
::: For example, If you.....
: Remember that *all* 2.x affiliate vendors incur the affiliate vendor fee, regardless of network size. This fee is necessary to keep the servers running and maintained, because affiliate networks can potentially generate substantially more web traffic than ones only in merchant shops.  
::::* Have a profit split with a partner @ 50/50
::::* Give out a (premium) affiliate vendor where product(s) are subject to that split
::::* Set affiliate commission at 10%
               
::: Then what happens is:
::::* Sell product A at L$100
::::* CasperTech fee of L$2, leaving L$98
::::* Partner split of 50% - L$49 - leaving L$49
::::* Affiliate split of 10% - L$5 (rounding up from 4.9) - leaving L$44
::::* You get L$44
                   
:: '''A2.''' On 12 March, 2012, a change was made to the default order, in order to pay the affiliates BEFORE the partner splits. Any vendors created after this point, will have this new order by default.  
              
              
:: For any 2.x affiliates *already* created (and especially already in use), this is available ONLY via a tick box option on the website, to avoid disturbing any setup  where it's important (to the merchant) that the affiliates get paid AFTER the profit sharing, for consistency. 
: The fees / discounts for 2.x vendors created ON or AFTER on 12 March, 2012 happen in this order:  
           
:: Remember that *all* 2.x affiliate vendors incur the affiliate vendor fee, regardless of network size. This fee is necessary to keep the servers running and maintained, because affiliate networks can generate substantially more web traffic than ones only in merchant shops.
           
:: The fees / discounts for 2.x vendors created ON or AFTER on 12 March, 2012 happen in this order:  
          
          
::: Customer discounts:
: '''Customer discounts'''
:::: 1) Customer discounts (i.e., if they got to a certain spending level)
:: 1) Customer discounts (i.e., if they got to a certain spending level)
:::: 2) Customer balances (i.e., spend x, get y store credit type balance)
:: 2) Customer balances (i.e., spend x, get y loyalty rewards type balance)
::: CasperTech Fees, if applicable
: '''CasperTech Fees, if applicable'''
:::: 3) Is it a free vendor? Then the free vendor fee applies.
:: 3) Is it a free vendor? Then the free vendor fee applies.
:::: 4) Is it an affiliate vendor? Then the affiliate vendor fee applies.
:: 4) Is it an affiliate vendor? Then the affiliate vendor fee applies.
::: Affiliate Gets
: '''Affiliate Gets'''
:::: 5) Affiliate commission  
:: 5) Affiliate commission  
::: Partner Splits, if applicable
: '''Partner Splits, if applicable'''
:::: 6) Vendor profit shares
:: 6) Vendor profit shares
:::: 7) Product profit shares, if applicable
:: 7) Product profit shares, if applicable
::: You
: '''You'''
:::: 8) Whatever is left
:: 8) Whatever is left
   
   
::: For example, If you.....  
::: For example, If you.....  
Line 209: Line 196:
::::* You get L$44
::::* You get L$44


== '''<span style="color:#00528c">Not What You Were Looking For?</span>''' ==
=== Default Fee Processing Order - BEFORE 12 March, 2012 ===
----
The fees / discounts for 2.x vendors prior to 12 March, 2012 happen in this order. Remember that *all* 2.x affiliate vendors incur the affiliate vendor fee, regardless of network size. This fee is necessary to keep the servers running and maintained, because affiliate networks can potentially generate substantially more web traffic than ones only in merchant shops.
       
: '''Customer discounts'''
:: 1) Customer discounts (i.e., if they got to a certain spending level)
:: 2) Customer balances (i.e., spend x, get y loyalty rewards type balance)
: '''CasperTech Fees, if applicable''
:: 3) Is it a free vendor? Then the free vendor fee applies. (5%)
:: 4) Is it an affiliate vendor? Then the affiliate vendor fee applies.
::* Free vendors: 5% affiliate fee
::* Premium / Fatpack vendors: 2% affiliate fee
: '''Partner Splits, if applicable'''
:: 5) Vendor profit shares
:: 6) Product profit shares, if applicable
: '''Affiliate Gets'''
::7) Affiliate commission
:'''You'''
::8) Whatever is left
           
: For example, If you.....
::* Have a profit split with a partner @ 50/50
::* Give out a (premium) affiliate vendor where product(s) are subject to that split
::* Set affiliate commission at 10%
               
: Then what happens is:
::* Sell product A at L$100
::* CasperTech fee of L$2, leaving L$98
::* Partner split of 50% - L$49 - leaving L$49
::* Affiliate split of 10% - L$5 (rounding up from 4.9) - leaving L$44
::* You get L$44
 
= '''<span style="color:#00528c">Affiliate Vendor Options </span>''' =
=== Self-Sale Options ===
----
By default, CasperVend allows affiliates to purchase from affiliate vendors they have rezzed out AND allows them to get the discount from such sales.
 
On the [https://caspervend.casperdns.com/index.php Overview] page in CasperVend, towards the bottom, is a block of "Your account options".
 
If you do NOT want the affiliate to be able to get the discount from affiliate self-sales, then toggle the '''''"Block affiliate discounts for self-sales"''''' option to '''"yes"'''.
 
If you do NOT want them to be able to buy from their affiliate vendor at all, then toggle the '''''"Block affiliate self-sales"''''' option to '''"yes"'''.
 
(As FYI, the typical configuration is often block the discount, but allow the sales. After all, a sale is a sale...)
 
A check is made for BOTH of these options against both the purchaser AND recipient names.
 
=== Affiliate Bans ===
----
You, as the original merchant, can ban an individual from your affiliate network - use the appropriate "ban" link in the affiliate vendor list. All V2 vendors will then refuse payments made to those vendors.
 
You are also able to delete the existing vendors of a banned affiliate from list at the bottom of the vendors page.
 
In addition, any newly-rezzed vendors that are rezzed by a banned affiliate will automatically de-rez, preventing them from just rezzing new ones to get more sales.
 
=== Unbanning An Affiliate ===
----
# Scroll down to the bottom of the vendors list
# Look for the section called "Banned Affiliates"
# Find the name you want to UNban
# Use the Unban option
 
= '''<span style="color:#00528c">No HoloVend Affiliates</span>''' =
The reason HoloVend is not allowed to be an affiliate is because you need to put your demo products IN the HoloVendor.
 
'''Workaround:''' Set up the HoloVend yourself at the potential affiliate's location, and set a profit share at that location to that person.
 
= '''<span style="color:#00528c">Affiliate Missing Commission On Sale?</span>''' =
The most likely cause of non-payment of commission on an affiliate sale are these:


If this doesn't answer the "How do I...?" question you have, perhaps you need the page on [[CasperVend_2/Profit_Sharing | profit sharing]] instead?  
# You have blocked the discount on affiliate self sales '''AND''' the affiliate was either purchasing directly '''OR''' was the recipient of someone else's purchase.
# The vendor never got an affiliate percentage set during the setup. (Rez a copy of that vendor out and check its configuration page.)
 
When in doubt, check both your SL transaction history (to verify payment was made as stated by the affiliate) '''AND''' your CasperVend statistics (to see who bought vs. who received the product.)
 
The name check is made against both purchaser AND receiver of a product.
 
(Note: If an affiliate has been banned, transactions won't process through those vendors '''at all''', so there won't even be a payment to worry about having a commission from.)
 
= '''<span style="color:#00528c">Why Is There An Affiliate Fee?</span>''' =
To help support the CasperVend network - the servers do cost money to run, and affiliate networks from popular merchants tend to be huge, putting extra load on the servers with all the transactions.
 
= '''<span style="color:#00528c">Error Messages</span>''' =
  '''CasperVend System: Your transaction ''((transaction ID string))'' is currently suspended and cannot complete because 'Pay: Insufficient funds to complete transaction.'''
Coming via an affiliate vendor, this means the affiliate doesn't have enough L$ to send the merchant the money. This error goes to both the originating merchant, AND the affiliate, but the affiliate is the one that needs to fix the problem.
 
=== Affiliate vendors unexpectedly changing products ===
---
Per Casper:
 
  When you take a copy of a vendor and rez it again, it simply copies data over from the original.
  So if you change the original, any newly rezzed copies will also change.
 
Any copies of vendors that are '''already''' rezzed out when you change the original, should not change. But if the affiliate/franchisee rezzes new copies, the new copies will be affected.
 
= '''<span style="color:#00528c">Not What You Were Looking For?</span>''' =
If this doesn't answer the "How do I...?" question you have, perhaps you need the page on '''[[CasperVend_2/Profit_Sharing | profit sharing]]''' instead?
 
= '''<span style="color:#00528c">FAQ/Troubleshooting</span>''' =
: '''Q. I'm getting a <span style="color:#990000;">''"The server reported a failure. I'm going to try again in 2 minutes (or touch to try again now)"''</span> message and the vendor won't start up...
:: '''A.''' You have an old 1.x vendor. These were '''[[CasperVend_v1 | decommissioned in May 2013.]]''' You need to replace the vendor with one from an updated pack. (Or, if you got an affiliate pack, you need to tell the merchant that their vendors are too old, and/or get new ones from that merchant.)
 
:'''Q. I'm testing some affiliate vendors, and the transaction keeps getting hung on the affiliate commission and not going through.
::'''A.''' If you are using gift cards, you need to have one of YOUR regular vendors out as well, because the affiliate commission is routed through one of your instore vendors, not the vendor used as the affiliate.
 
: '''Q. Can a customer user my gift cards to purchase products through my affiliate's vendors, or will they only work on my own vendors? '''
:: '''A1.''' They can use gift cards on affiliate vendors, but nothing will be paid to the affiliate unless extra is paid on top of the gift card value. So if the product costs L$200, and the gift card only has L$100, the extra L$100 is will count towards the shares and payments set on the vendor and/or product.
:: This means if the gift card value is equal to OR GREATER THAN the value of the product, there will be NO affiliate share paid.
:: '''A2.''' You can disable use of gift cards on a per-vendor basis if you wish, that option is available on the vendor configuration page. It is recommended that - if you want to take advantage of this - that you do so BEFORE passing out the vendor.
           
: '''Q.Do I have to make a new affiliate vendor each time I take on a new affiliate person or affiliate location? '''
:: '''A.''' No, you can reuse ones you've already made (just make sure the vendor script is up to date.)
      
      
&nbsp;
: '''Q. One of my affiliates got paid for items, but the pay split did not happen and the customer didn't get their purchase. '''
:: '''A.''' Most likely reason: Scripts are off in the sim or the parcel the vendor is rezzed on, and/or vendor is not set to correct land group (This will prevent correct operation of scripts if the land is set to only allow group scripts to run). 
           
: '''Q. My affiliates are paying the commission / share splits twice'''
:: '''A1.''' Profit splits and commissions should never pay more than the original purchase value.
:: '''A2.''' If your profit shares are paying twice, see the '''[[CasperVend_2/Profit_Sharing|profit sharing]]''' page for help.
               
: '''Q. Is it possible to set a group discount with an affiliate vendor? '''
:: '''A1.''' Yes, group discount capability is enabled with 2.x vendors. Just remember that what group the vendor gives a discount to is ENTIRELY dependent on what group it is rezzed under. This is an LSL limitation.

Latest revision as of 09:09, 15 February 2024

Schaue hier in Deutsch!

Setting Up Affiliate Vendors

These instructions assume you've already set up your products and profiles. If you have not, please see the full manual instructions FIRST before proceeding with this page.

It is very helpful to include your store name, and the percentage (%) amount in the name of the vendors. This information reminds the affiliate know how much the vendors give them when they look at them in inventory, and the store the vendors came from.

Ideally, your item pictures should also have your store logo/name ON the product pictures in case a customer of your affiliate wants to track down your shop to see your full product line!

Where's the Affiliate Pack?


Because each 2.x regular vendor can also function as an affiliate vendor, there is no separate affiliate pack anymore for the 2.x versions.

  1. Rez out the vendor
  2. Click the logo area in the bottom left. You'll get a popup box with the configuration URL.
  3. Click the button to go to the website and log in if necessary.
  4. Rename the vendor on the website - the vendor inworld will change it's name within a few seconds.
  5. Next to the "Affiliate" heading, set the percentage % amount, then click save on the same line. The website will give you a white popup saying "saved" but there is no inworld notification.
  6. Resize the vendor as desired.
  7. Set the perms on the vendor as desired.
  8. Take the vendor, box it up and either sell it or pass it out. All done!

Can I Use Free Vendors As Affiliates?


Yes, free vendors can be set up to be affiliate vendors just as easily as the premium/paid vendors can.

Vendor Permissions


Because CasperVend has transaction verification, it is absolutely safe to leave your affiliate vendors with "Modify" permissions - this allows the affiliate to resize the vendors as needed to fit the available space. Leaving vendors in a large size, and unmodifiable, means that limits the affiliate's ability to set the vendors out in rental spaces, if the space is too small. This in turn limits exposure to YOUR products.

No-transfer is often used, but that is entirely up to you.

No Need To Input Affiliate Merchant Name


Inputting names is only required when setting up a profit share - that's different from setting up affiliate vendors.

You simply set up the affiliate vendors and either hand them out or sell them. When the affiliate merchant rezzes out the vendors, they will appear on your vendor list, in a separate "affiliate vendors" section at the bottom of the page.

The website tracks which merchant the vendor came from (you) and if the current owner is not you, then the affiliate vendor behavior goes into effect automatically.

"Take a Copy" grid-based quirk


There's a quirk with using "Take Copy" with rental units and vendors, that you should be aware of.

Because the server is unaware of this copy being made, the copy that ends up in your inventory is LINKED to the one that is still rezzed, and is NOT a proper copy.

If you then modify the one that's still rezzed, the copy that you took *will change too*.

To avoid this, TAKE into inventory and then REZ the copy. This will create a proper copy with its own unique UUID.

Keeping Affiliates Updated

To update your Affiliate vendors, you can do one of the following:

  1. Rez each of your affiliate vendors
  2. Use the UpgradeBee
  3. Pick them up
  4. Ship them out via the "updates" tab in CasperVend
Or....
  1. Send the UpgradeBee to each of your affiliates

The first method is actually the recommended way, even though it's more of a hassle for you, the merchant. You will always need the CURRENT UpgradeBee to upgrade vendors to the current version. Packing an old UpgradeBee in the box with affiliate vendors will not upgrade vendors to a newer version of the script than what the UpgradeBee has (because the then-current vendor script is packed IN the UpgradeBee).

Encouraging Affiliates to Stay Updated


There's four big reasons why just sending the UpgradeBee to your affiliates isn't as effective:

  1. Affiliates simply don't bother to update
  2. If you ship vendors as no-modify, it won't work anyway
  3. If they "lock" their vendors, it won't work anyway
  4. If you never update your original pack, you'll still be shipping out OLD vendors in the future.

One way to motivate your affiliates:


  1. Put all NEW affiliate vendors in a new affiliate profile with all the products
  2. Set the OLDER profile to just one "product" with a display texture that tells them to update their vendors.

Using an update script


You may use the CasperUpdate script in order to prompt your affiliates to update their vendors. See the CasperUpdate page for details on how to set this up - just be aware that there may still be some affiliates who won't update, especially if they don't log in very often.

Information For YOUR Affiliates

Affiliates now have their own control panel for affiliate vendors they have rezzed out. To access the menu, affiliates touch the main panel on the vendor to get the popup menu and choose "Affiliate", then "Control Panel".

Your affiliates may be pointed to the Affiliate Information page for information they need in order to use their new affiliate vendors.

Finding Your List of Affiliate Vendors

  1. Log in to your CasperVend
  2. Click your "Vendor" tab/button on the left hand side
  3. On the resulting "Vendors" page, use the link for "Affiliate Network" as shown below
Image showing where to click to see your list of affiliates
Image showing where to click to see your list of affiliates

Fees & Commissions

When Does A Vendor Become An Affiliate Vendor?


From a CasperVend shipping crate that YOU own, vendors are regular vendors as long as they stay in your possession.

If you transfer copies from the original purchaser avatar to another avatar - doesn't matter whether the other avatar is an alt or someone else's avatar completely - it is then treated as an affiliate vendor, and subject to affiliate vendor fees.

The system has no way to tell whether the person behind "Avatar Account 1" is the same person that's behind "Avatar Account 2".

Commission Payments Note


Commission payments can come from ANY CasperVend device (this is a time-saving measure) - not always the expected one. So you may see a payment commission coming from, for example, what appears to be a vendor that only sells freebies or demos.

Affiliate Fees Are Per-Vendor Only


Affiliate fees are set only on a per-vendor basis. This means that if you're using a multi-product vendor with a profile, that everything in that vendor is set to that affiliate percentage. If you want to have some products giving one percentage, and certain products another, then you need to set them up in two different vendors, with a different profile for each.

CasperTech Fees


The CasperTech affiliate fee comes out of the initial sale amount on the affiliate vendor.

FREE VENDORS:
Out of every L$100 sale, this fee is L$5, which leaves L$95 that then gets split between the affiliate, you, and any possible profit sharing partners.


PREMIUM / PAID VENDORS:
Out of every L$100 sale, this fee is L$2, which leaves L$98 that then gets split between the affiliate, you, and any possible profit sharing partners.

Commission Chart


If you want your affiliates to get the FULL percentage after the sale that you told them they would get, then you need to do some basic math - the formula is:

For 2% Fee: (percentage) divided by 98, then multiplied by 100
For 5% fee: (percentage) divided by 95, then multiplied by 100

A table of some of these percentages is here:

 To give affiliate this:   Set it to this (2% fee):   Set it to this (5% fee)  
10% 10.2% 10.5%
15% 15.3% 15.8%
20% 20.4% 21.1%
25% 25.5% 26.3%
30% 30.6% 31.6%
35% 35.7% 36.8%
40% 40.8% 42.1%
45% 45.9% 47.3%
50% 51% 54.7%

Default Fee Processing Order - AFTER 12 March, 2012


On 12 March, 2012, a change was made to the default order, in order to pay the affiliates BEFORE the partner splits. Any vendors created after this point, will have this new order by default.
For any 2.x affiliates *already* created (and especially already in use) BEFORE this date, this is available ONLY via a tick box option on the website, to avoid disturbing any setup where it's important (to the merchant) that the affiliates get paid AFTER the profit sharing, for consistency.
Remember that *all* 2.x affiliate vendors incur the affiliate vendor fee, regardless of network size. This fee is necessary to keep the servers running and maintained, because affiliate networks can potentially generate substantially more web traffic than ones only in merchant shops.
The fees / discounts for 2.x vendors created ON or AFTER on 12 March, 2012 happen in this order:
Customer discounts
1) Customer discounts (i.e., if they got to a certain spending level)
2) Customer balances (i.e., spend x, get y loyalty rewards type balance)
CasperTech Fees, if applicable
3) Is it a free vendor? Then the free vendor fee applies.
4) Is it an affiliate vendor? Then the affiliate vendor fee applies.
Affiliate Gets
5) Affiliate commission
Partner Splits, if applicable
6) Vendor profit shares
7) Product profit shares, if applicable
You
8) Whatever is left
For example, If you.....
  • Have a profit split with a partner @ 50/50
  • Give out a (premium) affiliate vendor where product(s) are subject to that split
  • Set affiliate commission at 10%
Then what happens is:
  • Sell product A at L$100
  • CasperTech fee of L$2, leaving L$98
  • Affiliate split of 10% - L$10 (rounding up) - leaving L$88
  • Partner split of 50% - L$44 - leaving L$44
  • You get L$44

Default Fee Processing Order - BEFORE 12 March, 2012


The fees / discounts for 2.x vendors prior to 12 March, 2012 happen in this order. Remember that *all* 2.x affiliate vendors incur the affiliate vendor fee, regardless of network size. This fee is necessary to keep the servers running and maintained, because affiliate networks can potentially generate substantially more web traffic than ones only in merchant shops.

Customer discounts
1) Customer discounts (i.e., if they got to a certain spending level)
2) Customer balances (i.e., spend x, get y loyalty rewards type balance)
'CasperTech Fees, if applicable
3) Is it a free vendor? Then the free vendor fee applies. (5%)
4) Is it an affiliate vendor? Then the affiliate vendor fee applies.
  • Free vendors: 5% affiliate fee
  • Premium / Fatpack vendors: 2% affiliate fee
Partner Splits, if applicable
5) Vendor profit shares
6) Product profit shares, if applicable
Affiliate Gets
7) Affiliate commission
You
8) Whatever is left
For example, If you.....
  • Have a profit split with a partner @ 50/50
  • Give out a (premium) affiliate vendor where product(s) are subject to that split
  • Set affiliate commission at 10%
Then what happens is:
  • Sell product A at L$100
  • CasperTech fee of L$2, leaving L$98
  • Partner split of 50% - L$49 - leaving L$49
  • Affiliate split of 10% - L$5 (rounding up from 4.9) - leaving L$44
  • You get L$44

Affiliate Vendor Options

Self-Sale Options


By default, CasperVend allows affiliates to purchase from affiliate vendors they have rezzed out AND allows them to get the discount from such sales.

On the Overview page in CasperVend, towards the bottom, is a block of "Your account options".

If you do NOT want the affiliate to be able to get the discount from affiliate self-sales, then toggle the "Block affiliate discounts for self-sales" option to "yes".

If you do NOT want them to be able to buy from their affiliate vendor at all, then toggle the "Block affiliate self-sales" option to "yes".

(As FYI, the typical configuration is often block the discount, but allow the sales. After all, a sale is a sale...)

A check is made for BOTH of these options against both the purchaser AND recipient names.

Affiliate Bans


You, as the original merchant, can ban an individual from your affiliate network - use the appropriate "ban" link in the affiliate vendor list. All V2 vendors will then refuse payments made to those vendors.

You are also able to delete the existing vendors of a banned affiliate from list at the bottom of the vendors page.

In addition, any newly-rezzed vendors that are rezzed by a banned affiliate will automatically de-rez, preventing them from just rezzing new ones to get more sales.

Unbanning An Affiliate


  1. Scroll down to the bottom of the vendors list
  2. Look for the section called "Banned Affiliates"
  3. Find the name you want to UNban
  4. Use the Unban option

No HoloVend Affiliates

The reason HoloVend is not allowed to be an affiliate is because you need to put your demo products IN the HoloVendor.

Workaround: Set up the HoloVend yourself at the potential affiliate's location, and set a profit share at that location to that person.

Affiliate Missing Commission On Sale?

The most likely cause of non-payment of commission on an affiliate sale are these:

  1. You have blocked the discount on affiliate self sales AND the affiliate was either purchasing directly OR was the recipient of someone else's purchase.
  2. The vendor never got an affiliate percentage set during the setup. (Rez a copy of that vendor out and check its configuration page.)

When in doubt, check both your SL transaction history (to verify payment was made as stated by the affiliate) AND your CasperVend statistics (to see who bought vs. who received the product.)

The name check is made against both purchaser AND receiver of a product.

(Note: If an affiliate has been banned, transactions won't process through those vendors at all, so there won't even be a payment to worry about having a commission from.)

Why Is There An Affiliate Fee?

To help support the CasperVend network - the servers do cost money to run, and affiliate networks from popular merchants tend to be huge, putting extra load on the servers with all the transactions.

Error Messages

 CasperVend System: Your transaction ((transaction ID string)) is currently suspended and cannot complete because 'Pay: Insufficient funds to complete transaction.

Coming via an affiliate vendor, this means the affiliate doesn't have enough L$ to send the merchant the money. This error goes to both the originating merchant, AND the affiliate, but the affiliate is the one that needs to fix the problem.

Affiliate vendors unexpectedly changing products

--- Per Casper:

  When you take a copy of a vendor and rez it again, it simply copies data over from the original. 
  So if you change the original, any newly rezzed copies will also change. 

Any copies of vendors that are already rezzed out when you change the original, should not change. But if the affiliate/franchisee rezzes new copies, the new copies will be affected.

Not What You Were Looking For?

If this doesn't answer the "How do I...?" question you have, perhaps you need the page on profit sharing instead?

FAQ/Troubleshooting

Q. I'm getting a "The server reported a failure. I'm going to try again in 2 minutes (or touch to try again now)" message and the vendor won't start up...
A. You have an old 1.x vendor. These were decommissioned in May 2013. You need to replace the vendor with one from an updated pack. (Or, if you got an affiliate pack, you need to tell the merchant that their vendors are too old, and/or get new ones from that merchant.)
Q. I'm testing some affiliate vendors, and the transaction keeps getting hung on the affiliate commission and not going through.
A. If you are using gift cards, you need to have one of YOUR regular vendors out as well, because the affiliate commission is routed through one of your instore vendors, not the vendor used as the affiliate.
Q. Can a customer user my gift cards to purchase products through my affiliate's vendors, or will they only work on my own vendors?
A1. They can use gift cards on affiliate vendors, but nothing will be paid to the affiliate unless extra is paid on top of the gift card value. So if the product costs L$200, and the gift card only has L$100, the extra L$100 is will count towards the shares and payments set on the vendor and/or product.
This means if the gift card value is equal to OR GREATER THAN the value of the product, there will be NO affiliate share paid.
A2. You can disable use of gift cards on a per-vendor basis if you wish, that option is available on the vendor configuration page. It is recommended that - if you want to take advantage of this - that you do so BEFORE passing out the vendor.
Q.Do I have to make a new affiliate vendor each time I take on a new affiliate person or affiliate location?
A. No, you can reuse ones you've already made (just make sure the vendor script is up to date.)
Q. One of my affiliates got paid for items, but the pay split did not happen and the customer didn't get their purchase.
A. Most likely reason: Scripts are off in the sim or the parcel the vendor is rezzed on, and/or vendor is not set to correct land group (This will prevent correct operation of scripts if the land is set to only allow group scripts to run).
Q. My affiliates are paying the commission / share splits twice
A1. Profit splits and commissions should never pay more than the original purchase value.
A2. If your profit shares are paying twice, see the profit sharing page for help.
Q. Is it possible to set a group discount with an affiliate vendor?
A1. Yes, group discount capability is enabled with 2.x vendors. Just remember that what group the vendor gives a discount to is ENTIRELY dependent on what group it is rezzed under. This is an LSL limitation.