Welcome to the BSM Family!! - Secondlife Vendor System Users Manual.pdf · Networked Vending...

41
Welcome to the BSM Family!! I would like to welcome you to the Bejambled Sales Monitor Family. In the virtual reality world of Second Life, merchants such as yourself derive income by selling their creations or products to other players in exchange for some amount of the local currency (Lindens). What you sell is part of your sales and marketing plan. However how you sell, how you control and monitor your sales, and how you deliver the products are the parts of the process provided by BSM. In other words, BSM handles presentation of the product, collection of the money, delivery of the product and record keeping of all transactions. In one simple, easy-to-manage system, every step of the sales process is handled for you. We urge you, as the BSM user, to provide feedback to help improve the experience and make BSM a more effective system. Special Thanks Cory Hancroft BSM Creator

Transcript of Welcome to the BSM Family!! - Secondlife Vendor System Users Manual.pdf · Networked Vending...

Welcome to the BSM Family!!

I would like to welcome you to the Bejambled Sales Monitor Family. In the virtual reality world of Second Life, merchants

such as yourself derive income by selling their creations or products to other players in exchange for some amount of the local currency (Lindens). What you sell is part of your sales and marketing plan. However how you sell, how you control and monitor your sales, and how you deliver the products are the parts of the process provided by BSM. In other words, BSM handles presentation of the product, collection of the money, delivery of the product and record keeping of all transactions. In one simple, easy-to-manage system, every step of the sales process is handled for you.

We urge you, as the BSM user, to provide feedback to help improve the experience and make BSM a more effective system.

Special Thanks

Cory HancroftBSM Creator

Table of Contents

Chapter 1 - Features .............................................................................................4

Chapter 2 - Setup Instructions .............................................................................9

Chapter 3- Kiosk Operations .............................................................................22

Chapter 4 - HUD and Updates ...........................................................................27

Chapter 5 - Multi Panel Vendors .......................................................................29

Chapter 6 - Affiliate Vendors..............................................................................33

Chapter 7 - Release Notes .................................................................................36

This Page

Intentionally

Left Blank

Chapter 1

But what can BSM do?

Customer Reward ProgramThe Customer Rewards Program is a way for you to give back to your customers. The three different levels are the tiers based on the total amount that they have spent in your store. The more customers spend, the more they should get in return for being a valued customer. This will make giving back to them fully automated. After the customer reaches one of the tiers, they will be credited back to their store account the percentage of the amount spent on transactions after reaching that goal.

Store Sale SettingOne of the newest features to BSM is the ability to activate a store sale on all your vendors throughout the grid. This will save you hours when you need to run say a 25% Off sale gridwide. Setting up your store sales requires you to log into the BSM website and click on the “Store Sale Setting” link located on the left side menu. To start your sale, you will change this value to the percentage of the discount for the sale. Next cycle your vendors via the HUD. Thats it!

Fully Encrypted CommunicationsAll sales communications to and from webserver are placed into secure, encrypt-ed platform prior to transmitting.

XstreetSL PluginTrack your Xstreet sales right along with your standard BSM sales. With the XstreetSL plugin, you can setup split pays/distributions for the new Marketplace. Distributions are setup per product or straight across the Marketplace board. One login, one location. Split Pay OptionThe BSM system has a built-in split pay options with the ability to track seperate sales of products setup as split pay. This feature can be set either at the vendor or on the website login. Split pay can be set to split all vendor,

XstreetSL, and Marketplace sales by choosing options like all vendors, specific products, or specific regions. Splits can be used in conjunction with each other for precision payment splitting

Networked VendingNetworked vending utilizes the ability to place your products into a server and vend you products throughout the grid. The advantages of implementing a network system is that it allows for easy updates in all your vendors throughout the grid with a single change and have access to all your products in one central location.

Kiosk OperationsBSM includes a kiosk that will provide your customers with a portal to your store information. It allows your customers to view their past purchases, check their credit balance and redeliver items that you have authorized for redelivery. The BSM kiosk is not only for your customer’s use, but also a portal for the store owner to send product updates, notices, announcements and news. The kiosk is also the sending point for giftcards, updating your store logo and landmark, and a group inviter. It is truly a powerful tool for you to communicate with your cus-tomers.

Automatic RedeliveryThis allows for your products to be delivered even if the sim that holds your server goes offline. Once the sim returns, your customer will receive the product that they have purchased. This feature ensures that you deliver at the highest capable rate of success that networked vending allows.

GiftingIntegrated system to allow your customer to purchase a gift for other citizens. The system gives the giftbox to the person buying the gift and allows them to give the box personally to their gift recipient. Give the item when you are ready for them to receive it. Very Personable.

Store Credit/Gift CardsCustomers can purchase store credit or give gift cards. Credit system is all keyless based which requires the customers to never have to attach or wear card. Just buy the card and begin shopping. Cards work on any vendor that you have rezzed.

Affiliate Vendors

Create your own affiliate vendors to get your stuff seen. You control the percentage, sale price and texture in seconds. BSM does not use website forms to add products, instead products are trasmitted directly from your store vendors. No additional server needed. Products are sent to the webserver where your resellers can choose the products they want to sell. Your resellers can configure the vendors with a simple number. Designer has the authority to revoke the resellers permissions at anytime. Resellers have access to webstats and the ability to track history of their sales.

Web Sales StatsView unlimited sales history of all your locations. The web sales database provides numerous tools to organize your data and view reports that maximizes the effectiveness of you sales data. Reports includes breakdown of customers, products, locations and store/product profit averages.

Easy SetupSetup is as easy as rezzing a prim. Simple naming allows for quick setup without having to load vendors from a website. Vendors and servers are fully customizable and will easily convert your current system and be online with minimal down time.

Full Tech SupportTechnical Support is available from inworld or from the website. Support available for installations, features, recommendations, and feedback

Email/Inworld NotificationsReceive email notifications on all sales of your products to help you stay updated on your business activity.

Sales HUDProvides the ability to check your sales from anywhere on the grid at the convenience of a HUD. The HUD allows sales totals and has the ability to search your customers to track past transactions. The HUD gives you the flexibility to retrieve your sales data and the click of a button without interruption.

Product Info CardsAllows for an information notecard to be dropped into the vendor and dispense the card upon request from customers.

Automated UpdatesUpdates are made easy with the ability to update your server and vendors Live, directly from the HUD.

This Page

Intentionally

Left Blank

Chapter 2

Step By Step Setup Guide for BSM

The BSM system is a system that is composed of a server or group of servers, vendors, a kiosk and a HUD. Minimum requirements of running the system involves rezzing a server, placing your products in the server and configuring your vendors. There are many alternative configurations that may be used. For instance you can rez several servers in order to hold different categories of products, for instance a server for clothing, one for shoes, and one for texture packs. Its really just a matter of preference. I would recommend separating your items for the fact that it will take less time to sort through and improve speed when accessing you servers. So lets get to setting you up and making some sales.

!! ATTENTION !!Do not use the apostrophes, quotations or

ampersand in your setup configurations. Usealphanumeric symbols to prevent errors.

1) Unpack - Rez “BSM - Bejambled Sale Monitor x.x.xxx (Boxed)” and please make a note of this information as it will be used to log in to the website and view your sales stats and additional information. (See output in Fig. 2.1)

! Local Chat Message BSM - Bejambled Sale Monitor 1.2.018 (Boxed): Thank you for purchasing BSM. Your account has been create as follows: Username: FirstLast12345 Password: 1234567 Your webstats are now available at http://www.bejamble.net/sl/index.php IMPORTANT: Please login and change your password.

Figure 2.1

! Local Chat Message BSM Server: Updating Server... BSMServer:PrimaryServer:NewServerConfigured. Server Initialized.

Figure 2.4

2) Server Setup - Find a location to place your server, preferably not in your store in plain sight. This should be rezzed in your work area away from your vendors. Once you have rezzed your server, you will see a blue server rack with 2 servers in place. (Fig 2.2) Once your server is rezzed, touch both servers to activate and put them online. You will then see floating text saying the server name and version that is running. (Fig. 2.3) You will also be notified in local chat (Fig. 2.4)

IMPORTANT: The server “Description:“ field is the identifying name for the server and vendor to communicate. This is what the vendors will refer to when talking to the server. DO NOT USE the “&” symbol in your server description field.

Right click the upper server for the Pie menu and select Edit. Change the description field to something nice and short. This is the field that determines the communications link to the vendors. For this example, I used “BD11”. You can

Figure 2.2 Figure 2.3

Figure 2.5

change the server’s “Name:” field to anything you like, maybe something like clothes or shoes. Once you have your fields set you will need to “Touch” the server in order to reset and update the changes that you have made. Click on the contents tab and you will see a script called “BSM Server”. This is the location that all your products will be vended from. You will need to drop your products here. I have dropped a product called “Object” in the server for this example. (Fig 2.5). You are not required to reset the server after adding your items, only if you change the server name or description. In order to save time configuring your vendors, touch your server and click “Print Items”. This will display all the contents in local chat so that you can quickly

see what products you have loaded in each server. You will be requested permission to grant permission to take lindens from your account. This is needed for the split pay options that are set from the website. Denying this request will cause you server NOT to dispense items.

3) Vendor Setup - Rez a vendor from your inventory by placing “BSM Ven-dor x.x.xxx” on the ground. You will now need to change both the name and de-scription field on the vendor prim. It is necessary to make sure that these fields match exactly or you vendors will not work properly. The “Name:” field of the vendor is where the product name is listed. The format for this is “Vendor - [prod-uct name]“, that is the word “Vendor” space dash space followed by the product name. In our example in Fig 5, we are going to dispense the product called “Ob-ject”, so we need to set the vendor name field to “Vendor - Object”. The description field of the vendor is used to tell the server the price, which server to use and the split pay options. Each value will need to be separated by an “&” symbol. Split pay allows you to place a vendor in your store and give a spe-cific percentage of the sales to another avatar. Refer to Fig. 2.5 for this example. The formats for the vendor description field are as follows:

Standard Vendor (you will receive 100% of sales) BD11&199 [Server Name]&[Product Price] Server Name - this is from the exact Description Field entry of the server that is holding the product that is to be dispensed. Product Price - this is the price that the customer will pay for your product listed as the price in Linden dollars. NOTE: This will setup your vendor to give your product from server BD11 for a price of 199

Split Pay Vendor with storecards disabled (you will split profits with another avatar) BD11&199&SP&25&12d99d65-2c74-4cf1-b9cd-7f0a9bb84aec [Server Name]&[Product Price]&[SP]&[Percentage]&[UUID] Split Pay Vendor with storecards enabled (you will split profits with another avatar) BD11&199&SPGC&25&12d99d65-2c74-4cf1-b9cd-7f0a9bb84aec [Server Name]&[Product Price]&[SPGC]&[Percentage]&[UUID]

IMPORTANT: When SPGC is used, you will be required to pay your splitpay partner their percentage even when giftcards are used for the purchase.

Server Name - this is from the exact Description Field entry of the server that is holding the product that is to be dispensed. Product Price - this is the price that the customer will pay for your product listed as the price in Linden dollars. SP - activates split pay. Entry is set by “SP” only. Percentage - this will be the percentage of the sales that will go to the other party, entered as a whole number UUID - enter the UUID of the other party that will be receiving the split pay amount.

NOTE: This will setup your vendor to give your product from server BD11 for a price of 199 and give 25% of sales to BSM Core. The uuid listed is for BSM Core, make sure you change this.

Once you have your vendor configured to your requirements, “Touch” the vendor to reset and activate it with the new settings. Upon completion of this you will see the vendor spit out several lines of configuration in local chat. Fig 2.6 This will tell you the settings and configurations to confirm everything is set.

! Local Chat Message (Output for Standard Vendor)

Vendor-Object:Standbytoconfigureboard. Vendor - Object: Vendor price set to L$199. Vendor - Object: Object is set to dispense from Server BD11. Vendor - Object: Split Pay is not active. Vendor - Object: Your vender is running the most current version. Version 1.2.018 Vendor-Object:Configurationcomplete...vendorready.

! Local Chat Message (Output for Split Pay Vendor)

Vendor-Object:Standbytoconfigureboard. Vendor - Object: Vendor price set to L$199. Vendor - Object: Object is set to dispense from Server BD11. Vendor - Object: Split Pay activated with Cory Hancroft. Vendor - Object: Split Pay percentage set to 50% or L$99. Vendor - Object: Your vender is running the most current version. Version 1.2.018 Vendor-Object:Configurationcomplete...vendorready. ‘Vendor - Object’, an object owned by ‘BSM Core’, located in Reublin at 115.9, 210.5,35.4, has been granted permission to: Take Linden dollars (L$) from you.

Figure 2.6

To re-state your configuration of the server and vendor you will have the following: Server Name: Your choice, choose something descriptive Server Description: Something short that is easy to remember i.e. BD1, BD2 Vendor Name: Must match the product in the server. Vendor - [Product] Vendor Decription: Server Name & Price BD1&199 for standard vendor

The inventory of the server and vendor are as follows: Server: Server script and all the products you are going to dispense. Vendor: Vendor Script

The vendors can be setup in any manner you like. You are welcome to change any aspect of the vendors that is required to fit in your shop. You can place additional scripts into the vendor that rotates textures, changes textures, changes size. The vendors are fully customizable to fit your taste and mirror your shop feel.

4) Store Cards - Your store card server is the additional server that is in the rack. By default it is set to BSMGC, its your choice whether to leave it or change

Figure 2.7

it to something else. Inside the server’s inventory are 4 cards; GC100, GC250, GC500, and GC1000. Fig 2.7

These are the actual cards that will be given to your customers once a gift card/store card is purchased. The card’s only purpose is to give the customer’s balance and dispense a landmark, no sales/balance data is stored in the card’s inventory. You will need to remove the 4 cards from the BSMGC inventory and rez them to add a landmark to your store’s location. Inside the card you will find a script called, “Store Card Check Balance”. Once you have added your landmark in-side each of the 4 gift cards, place your uuid into the card description. Make sure to change the cards to NO MOD/NO TRANSFER. Replace the cards in the BSMGC’s inventory. Make sure to delete the old gift cards before you add the new cards into the server. Once complete, “Touch” the server to reset it and you will be ready.

Once you have your server set, go to the location that you will be selling

your store cards and rez the object called “Vendor - GC250”. This is a group of vendors that will dispense your cards. There is no setup required for these other than aligning them to your preference.

If you feel you would like to change the naming, refer to Fig 2.5 on the server/vendor setup. These are configured the same as a normal vendor, except that the scripts are different. These scripts are not interchangeable.

The gift card/store card vendors and gift cards are fully customizable. You can create your own card graphics and set your own prices. The PSD files are made available at www.bejamble.net, but require you to log in to have access to these files.

5) Giving Gift Cards - This feature will allow you, the owner, to give giftcards in bulk to your customers. Once setup, giftcard givers are given to the customer for them to rez. Once they rez the giftbox, a giftcard will be given to the person rezzing the gift and an giftcard account will be created or credited. Because no account information is held within the gift cards, you must use this procedure to credit the accounts instead of just giving a giftcard to your customers. Setup is very similiar to the setup of your vendors. You will need to have an object to place the gift giving script into. The first step to getting your gifts ready is to rez your gift box. Once you rez your object you will need to change

Gift card giver configuration

Gift card server

the name and the description just like you did in the vendor setup. The only difference is that

Figure 2.8

instead of vendor in the name, it should be gift. (See figure 2.8.) Setup is as follows:

Giftcard Giver Object’s Name Setup Gift - GC500 [Gift - ]&[Name of giftcard located in server]

Giftcard Giver Object’s Description Setup BSMGC&500 [Server Name]&[Gift Card Value]

The number that appears after the “&” symbol determines the value that will be credited to the recipient’s account. You will want to ensure that the value of the card that you are giving matches the giftcard that is located in the server. I would recommend creating a generic giftcard with no value listed on the graphic, just for this use.

Now that you have you object setup, change the persmissions of the object to NO COPY. This will prevent the transfer of the giftcard to other avatars. Be-fore you move the “Giftcard Giving - [YOUR NAME]” script into the contents, change the permissions of the script to NO COPY. Once the permissions are set, drag the script into the contents of the gift giving object.

Lastly, take the gift card giver into your inventory. This item is ready to be dispensed to anyone you like. This can be done by giving directly to avatars or sent through a mass sender.

6) Affiliate Vendor - Affiliate vendors are vendors that you can configure and give to other avatars to allow them to sell your products. BSM affiliate vendors were designed to require the least amount of effort for both sides of the configuration. A designer is able to setup a store of hundreds of vendors in just a few minutes. Likewise, configuration of vendors on the retailer’s side is very simple and requires just a single product code to configure. Retailers also have the ability to freely resize and manipulate the vendors to allow allow to to fit into any store. I recommend you setup your main store vendors prior to setting up the affiliates.

Preffered Method of Setup The preferred configuration of the products would be to use the main store standard vendors to upload the products. From a standard, touch the face of the vendor that contains the texture of the product you will be uploading. When the dialog menu appears, click “SendToWeb”. See, nothing to it. Continue through each vendor in your store that you would like to make available to your retailers. While you are performing these uploads, your products are being uploaded to the BSM website and will become visible under the MY PRODUCT CATALOG link. These products can be then assigned to categories to make them easily available when your retailers go to choose products. If by chance that you do not have a main store location with standard vendors, you can also rez a single affiliate vendor and configure each one, clicking “SendToWeb” after completion of each configuration. If you will be uploading in this fashion, you will need to set the the name of the vendor to the name of the product that you have loaded into the server. In the description field you will place the server name and price seperated by an & (amphersand) symbol. If you have all your main store setup with standard vendors, you can save time by not having to configure each product individually.

Configuration if main store vendors have not been setup: Affiliate Vendor Name Setup Nice Item [Name of product located in server]

Affiliate Vendor Description Setup BSMGC&500 [Server Name]&[Price of Product]

Once you have completed your product uploads, you will need to setup an affiliate vendor that you will send to your retailers. Please follow these instruction closely or your retailers will not be able to make copies of the vendor for other products. For this process you will need 4 items: a prim created by you COPY/NO TRANS, and affiliate script set to COPY/NO TRANS, the script named ~~ Affiliate Activation ~~, and an instruction card to tell your retailers how to configure and create a vendor. The prim that you create will be a vendor, so please set up the prim to appear like you would like it displayed. THE PRODUCT IMAGE WILL DISPLAY ON FACE 0. This face is the face of the prim that is facing up when a new prim is rezzed. Place all 4 of these items into a boxed pack to send. DO NOT ASSEMBLE THE VENDOR AND SEND IT TO THEM, they will not be able to modify the vendor to change products.

Feel free to include the following instructions in your affiliate pack to help the retailer configure the vendor:Notecard instructions for retailers:

FRANCHISER/RESELLER SETUP--------------------------------------SETUP FOR RESELLER/FRANCHISER1. Rez pack received from designer. (MAKE NOTE OF THE LOGIN INFORMATION FROM LOCAL CHAT)2. Open and copy to inventory.3. Rez object that was in step 2, this will be your vendor.4.Place“BSMAffiliate”scriptintorezzedprimfromstep3.5. Take object from step 4.6. THIS IS YOUR VENDOR FOR THIS AFFILIATE. FEEL FREE TO RENAME TO YOU PREFERRENCE SO THAT YOU KNOW WHOSE VENDOR THIS IS. EVERY DESIGNER HAS THEIR OWN SPECIFIC VENDOR.7.Rezvendoratwillandconfigureforproduct.

CONFIGURING VENDOR TO DISPENSE PRODUCTS1. Login to BSM website at http://www.bejamble.net2. Click“AFFILIATESFORSECONDLIFE”linkonmenu.3. Click“PRODUCTLISTS”.4. Find designer for the vendor you are setting up.5. Chooseaproducttoconfigurevendorfor.6. PlaceONLYProductCodeNumberintodescriptionfieldofvendor.7. Touchvendorandchoose“AdminReset”fromdialogmenu.8. Setup complete.

Once your retailer has rezzed the pack an account will be created for them to login to the BSM website. They must then rez your vendor prim and place the affiliate script into this prim in order to have a working vendor that is copy/mod. Once they place the script, their name will appear on your RETAILER LIST on the BSM website. You will need to set a commission percentage for each retailer prior to the vendor becoming operational.

Step by Step Affiliate Setup Overview 1) Upload Products 2) Send retailer a vendor pack 3) Set a commission percentage 4) Retailer configures vendors

7) XstreetSL Plugin - This plugin allows you to track your sales from XstreetSL.com on the bsm website located at www.bejamble.net. The biggest advantage to using the plugin is that it will allow you to give your customers credit while using the Customer Rewards Program. As of the time this manual was written, the new Marketplace website for Linden Labs did not allow distributions/split pays to be configured on their website. With this plugin, you will be allowed to configure these distributions to work properly. This will also allow you to track all of your XSL sales right along with your inworld sales.

Configuration of the plugin requires you to log into your xstreet account and assign which Magic Box will contain the plugin.1. Login to xstreetsl.com2. Goto Account Settings3. Goto “My ANS Preferences”4. Check the box that says, “Purchase, using the following method:”5. Ensure the “Second Life® Object:” is selected and choose the Magic Box that will hold your script.6. Check the box for “Allow me to Verify each Purchase notification”7. Return to Secondlife and drop the script into the Magic Box that you selected.8. Configuration Complete

Configuring Distributions/Split pay on XstreetSL/Marketplace SalesLogin to the BSM website and goto SPLIT PAY SETINGS. To configure the distribution, enter the avatar’s name that you will be splitting, the percentage that you will be giving them for the split pay. For XSL/Marketplace you will want to choose either by product or all sales. If you only want to give the distribution on a single product sold there, you will want to copy/paste the product name exactly as it appears on the listing. Select SPECIFIC PRODUCT from the drop down and paste the listing name in the field provided. If you will be setting a distribution to all listing on XstreetSL, you will want to select SPECIFIC SIM from the dropdown and enter “XstreetSL” into the field provide. Once you click Submit Split Pay, you will then need to activate the distributions in the list below. By default, all splitpays are set to inactive upon completion of entry.

8) Grid wide store sales - One of the newest features to BSM is the ability to activate a store sale on all your vendors throughout the grid. This will save you hours when you need to run say a 25% Off sale gridwide. Setting up your store sales requires you to log into the BSM website and click on the “Store Sale

Setting” link located on the left side menu. To start your sale, you will change this value to the percentage of the discount for the sale. For instance, if you are going to run a sale for 25% off, place 25 in the field below and hit submit. Once you set this value, you must return to your store locations and reset your vendors to start the sale. To do this, wear the HUD and click “Cycle All” button located in the Vendor Controls section. Make sure to goto your satellite locations as well and reset. Once your sale is complete, return to the website and set the value back to 0. This will turn off the sale. Once this is set, return again and reset your vendors via the HUD.

9) Customer Rewards Program - The Customer Rewards Program is a way for you to give back to your customers. The more customers spend, the more they should get in return for being a valued customer. This will make giving back to them fully automated. After the customer reaches one of the tiers, they will be credited back to their store account the percentage of the amount spent on transactions after reaching that goal. The higher the level, the larger the percentage. To give you an idea, my vendors are set for $1000L gets 5%, $2500L gets 7% and $5000L gets 10%.

Things to remember: - The tier levels are an accumulated total of all purchases - The percentage settings are not accumulated - Rewards are given on every purchase after reaching that level. - Default settings do not give rewards - Default settings do not give rewards on split pay and affiliate vendors

Once you have updated your vendors, settings changed here are done on the fly and are instant. Reward points are credited directly to the customer’s store cards.

10) BSMe - BSMe is a subscriber list for use with the kiosk. Currently, all customers that purchase from you will be automatically added to the exported list. Additionally, potential customers can add themselves to your subscriber. This is done through the BSME panel. You may rez a different panel in each store or location that your choose. There is no limit to the number of panels that you can place. Send of notices using the BSMe is done through the kiosk. Please see kiosk operations on page 25 of this manual for details on sending notices and product updates.

This Page

Intentionally

Left Blank

Chapter 3

Kiosk Operations

BSM includes a kiosk that will provide your customers with a portal to your store information. It allows your customers to view their past purchases,

check their credit balance and redeliver items that you have authorized for redelivery. The BSM kiosk is not only for your customer’s use, but also a portal for the store owner to send product updates, notices, announcements and news. The kiosk is also the sending point for giftcards, updating your store logo and landmark, and a group inviter. It is truly a powerful tool for you to communicate with your customers.

The buttons that are available to your customers are as follows:

Past Buys will provide a link that will remain active for 5 seconds. Once the link is click, the user will be routed to the website where ALL their past purchased will be listed. On this page they will have the option to have products redelivered inworld. Only

products that you have approved will be made available for redelivery. The link that is provided will only be able to be used one time. The page can not be refreshed or copy/pasted and used again. This is a security feature that only give the user one viewing. In order to view the page again, they must re-click the past buys button.

My Credit is similiar to the past buys button. This will provide the user with store credit balances at every location they hold store credit. Likewise of the past buys, the link will expire after 5 seconds and is a one time use link.

Join Group will display a link to join your group. The group is set by editing the kiosk and setting the group of the kiosk to the group that you would like the users to be able to join. This is set on the General Tab while in edit mode.

BSM Site will provide a link to the BSM website.

Cancel requires no explanation.

These 5 buttons explained will be displayed both for customers and also the kiosk owner. For the remaining features being explained, you must be the kiosk owner.

Update Logo is used for updating your store logo. This logo will be placed on the website randomly and appear on the kiosk main screen. In order to set the logo on the kiosk screen a logo MUST be uploaded through the kiosk. Upon clicking the button, you will be asked to CTRL-Drag your new logo onto the kiosk.

Update Landmark is used to upload your main store’s location. This will also be displayed along with your store logo at random. There will be more uses of both the logo and landmark in the future. Upon clicking the button, you will be asked to CTRL-Drag your new landmark onto the kiosk.

Note: For the update logo and landmark to work properly,you must not have any other landmarks or textures in the

inventory of the kiosk.

Send GC is used only for sending giftcards to your customers. In order for this feature to operate properly, 2 things are needed; the giftcards and the “!Giftcard List” notecard to be included into the kiosk’s contents.

Giftcards Setup: these giftcards are the same giftcards that are located in your giftcard server. Place your giftcard with the “Store Card Check Balancex.x.xxx” script included in the giftcard inventory. To restate this place the Store card check balance script into a giftcard and place it into the kiosk’s inventory. You must also place you UUID in the decription field of the giftcard.

Notecard Setup: once you open up the “!Giftcard List” notecard within the kiosk’s inventory you will see something like this:

// SET TO NAME OF ITEM TO GIVE CUSTOMER ////////////////////////////////////////////////////////// GIFTCARD_NAME=GC100 GIFTCARD_VALUE=100 ////////////////////////////////////////////////////////// // PASTE EXPORTED NAME LIST FROM BSM WEBSITE ////////////////////////////////////////////////////////// SEND=24d9dff6-cb48-44a8-8a7e-737a4e36e573,Cory Hancroft

DO NOT RENAME THIS CONFIGURATION CARD

The configuration setting are: GIFTCARD_NAME: The name of the giftcard from the kiosk inventory that you will be sending. GIFTCARD_VALUE: The value of the amount that you would like to give your customers.

Regardless of what the giftcard actually is, the value that you place in the giftcard_value field will be the amount that is credited.

Once you have the config card set properly, you will need to log into the BSM website and goto “Advanced Search”. Perform a search for the persons that will be receiving your giftcard. Once the results are displayed, click the “EXPORT RESULTS FOR KIOSK NOTECARD” link. This will format your notecard infomation so that it can be paste into the giftcard list config card. This will be pasted below the last set of /////////////’s. Once you have your card configured, save and close.

For the final step, click the kiosk and then click the “Send GC” button. You will be prompted with a confirmation button to send or cancel. If everything is set ready to go, hit Send. The kiosk will perform the send by crediting all the accounts and sending a giftcard to everyone on the list.

Send Notice is used only for sending items, notecards, landmarks, textures and messages to your customers. This can be used to send updates to products, important notices and promotional items.

I ADVISE NOT ABUSING THIS FEATURE. REMEMBER, YOUR CUSTOMERS DID NOT SIGN UP TO RECEIVE THESE MESSAGES, THEY JUST MADE PURCHASES IN YOUR STORE AND DOES NOT WARRANT YOU SPAMMING THEM TO DEATH. IF A CUSTOMER

REQUESTS YOU TAKE THEM OFF THE LIST, PLEASE REMEMBER TO REMOVE THEM FROM FURTHER MAILINGS. I WILL NOT BE

HELD RESPONSIBLE FOR NEGLECTING THIS.

Notecard Setup: once you open up the “!Notice List” notecard within the kiosk’s inventory you will see something like this:

// SET TO NAMES OF ITEMS TO GIVE CUSTOMER //IFARTICLEISNOTTOBESENTUSE“none”inthatcategory // KEEP MESSAGES SHORT TO PREVENT TRUNCATION ////////////////////////////////////////////////////////// NAME_ITEM=none NAME_NOTECARD=none NAME_TEXTURE=none NAME_LANDMARK=none NAME_ MESSAGE=Sending a test message. //PLACE YES IN THE FOLLOWING TO NOTIFY CUSTOMER OF THEIR CREDIT BALANCE SEND_CREDIT=YES ////////////////////////////////////////////////////////// // PASTE EXPORTED NAME LIST FROM BSM WEBSITE ////////////////////////////////////////////////////////// SEND=24d9dff6-cb48-44a8-8a7e-737a4e36e573,Cory Hancroft,0

The first 4 settings are for the items that will be sent in the notice. The names that are placed here must match exactly as the items that you place in the kiosk inventory. Place your items in the inventoy of the kiosk and then place the item name in place of “none”. If you are note going to be sending items of this type,

leave “none” in the config section for that type.

Name_message will be the message that will be sent along in chat with your items. Keep this short enough to ensure the entire message is sent.

If you would like to attach the customer’s credit balance along with the message, make sure “YES” is included after the SEND_CREDIT setting. This will attach each customers credit balance. Please dont forget to end your message with proper punctuation as the message will read as “By the way, you have $350 in creditatmystore.”

TYPES OF MAILING LISTSComplete list of recipientsThis type of notice would be for sending news, announcements and such. To get your complete mailing list, you will login to the BSM website. To obtain an entire list of all your customers, just click the “BSME EXPORT LIST” link on the main menu. This will format your notecard infomation so that it can be paste into the giftcard list config card. This will be pasted below the last set of /////////////’s. Once you have your card configured, save and close.

Specific group of recipients

Advanced search ONLY returns customers, not potential customers. If someone adds themselves by touch the BSMe panel and never makes a

purchase, they will not appear in this listing.

This refined search would be for sending product updates and other specifc groups. To get this mailing list, you will login to BSM and goto advanced search. Perform a search on the specifics that you are wishing to send the notice. Once the search completes, click the “EXPORT RESULTS FOR KIOSK NOTECARD” link. This will format your notecard infomation so that it can be paste into the giftcard list config card. This will be pasted below the last set of /////////////’s. Once you have your card configured, save and close.

For the final step, click the kiosk and then click the “Send Notice” button. You will be prompted with a confirmation button to send or cancel. If everything is set ready to go, hit Send. The kiosk will perform the send by sending all items that you have configured to each name on the list.

DO NOT RENAME THIS CONFIGURATION CARD

Chapter 4

Heads Up Display (HUD) and Updates

Bejambled Sales Monitor includes a HUD that is used for updates, quick sales totals, customer searches and password recovery. All features listed on the hud are also accessable through the website at http://www.bejamble.net/sl/

The HUD is comprised of 4 areas: Updates Center, Inworld Assets, Sales Activity, and Utilities & Tools

1) Updates Center - This section has 4 buttons: Servers, Vendors, Kiosks, and Cards. These buttons are reserved for performing updates on the correlating items. Clicking the button will start the update for all items of that type. You will notice that the color blinks red as each item is contacted. While the item is being updated, you will see messages in local chat that tells the status of the update.

The limitations of the updater is that you can only run updates on the sim that you are located on. For instance if you have vendors on 5 different sims, you will need to goto each sim and run the updates.

All updated will be sent through the HUD. When new updates are released, they will be sent directly to your account. Check the website for the most current versions.

NOTE: The kiosks button on the hud is currently not in use. Kiosks are being modified currently and are not in use.

2) Vendor Controls - This section is for resetting vendors and showing version numbers on the vendors. The “Show Ver” button will apply floating text showing the version number above every vendor. This will disappear after 10 seconds.

Figure 3.1

3) Inworld Assets - This section is reserved for displaying the locations of all items of clicked type. When the Servers button is clicked, a list of your currently rezzed servers will be displayed with SLURL’s for easy access.

4) Sales Activity - This section is for quick calculations of sales for given time. Full sales total gives the total value of all sales sold since you have started using BSM. The buttons 1, 7, 14, and 30 are for days. Clicking these buttons will display the value of all sales within that number of given days.

5) Utilities & Tools - The Utilities & Tools section has 3 buttons: Search Customer, Awaiting Delivery, and Change Password.

The search customer button is used to search for past purchases by a specific customer. A random code of 4 numbers will be give following a slash ie “/3423”. Enter the code with the slash followed by the customers name. The results will be displayed in local chat.

The awaiting delivery button shows a list of failed deliveries. A list will be displayed in local chat.

The change password button will allow user to change the password to your website login. Enter the code with slash followed by your new password.

Chapter 5

Multi Panel Display Vendors

Multi panel display vendors allow store owners to have more vendors within a limited prim space. Many malls and wall rentals only provide 20-30 prims which does not leave much room for your products. By using multi panel vendors, you can bring your entire store to even these limited resource locations. Vendors come in a wide array of arrangements, all of which are modifiable. In figure 5.1, the available panel arrangements are listed for use.

Figure 5.1

1.) Multi Panel Vendor SetupBasic setup for this style of vendors requires the a vendor, settings configured in the “Config” notecard, and a product list that is set in the “Products” notecard. These notecards are in the vendor contents folder upon rezzing the vendors. Contents of the vendors are as follows:

Main Panel - Notecard: “Config” - Notecard: “Products” - Script: “BSMMulti-Vendor” - Script: “Multi-Controllerxx”

Child Panels - Script: “PanelS01” (Each panel requires script in numerical order)

Navigation Buttons - Script: “Next/Prev”

Config NotecardThe “Config” notecard is used to select whether hover or floating text will be displayed and set the default texture for panels that contain no products.

HOVER_TEXT=yesMY_LOGO=1df71786-9b6d-0c5b-9e9b-4e0944035987

HOVER_TEXT is set by entering a “YES” or “NO”.MY_LOGO is the uuid for the texture that is to be displayed.

Products NotecardThe “Products” notecard is the list of products that will be vended from the multi panel vendors. Each line in the notecard signifies a different item. Items are setup just as the standard vendors were done in earlier chapters. Items are configured as follows:

Standard Item [IMG UUID]&Vendor - [ITEM NAME]&[SERVER]&[PRICE]& (note the amphersand on the end of the line)

Split Pay Item (Store Credit Disabled) [IMAGE UUID]&Vendor - [ITEM NAME]&[SERVER]&[PRICE]&SP&[PERCENTAGE PARTNER GETS]&[PARTNER UUID]&

Split Pay Item (Store Credit Permitted) [IMAGE UUID]&Vendor - [ITEM NAME]&[SERVER]&[PRICE]&SPGC&[PERCENTAGE PARTNER GETS]&[PARTNER UUID]&

Vendor configuration was covered in detail starting on page 12, if this is the first time seeing this configuration, please get full details in the previous section. Multi panel vendor setup can be time consuming to configure each item. Vendor versions 3.1.002 and later have been included with a button called “Get Config”. This button is used for exporting you vendor configurations for use in the multi panel vendors.

Exporting Product Configuration Line 1. Choose the standard single prim vendors to include in the multi panels. 2. Touch vendor and click “Get Config” button. 3. Copy output from local chat exactly as displayed. 4. Paste output into products notecard that is in multi panel vendors 5. Remember 1 item/line and leave no empty spaces after last product.

All vendor configurations will work with the exception of affiliate vendors. This will be released in the near future.

NOTE: Vendor must remain linked to function properly. If multi panel vendors are unlinked, they must be relinked in the following order 1- Select Navigation Button 2- Select side panels in reverse order 3- Select Main Panel 4- Hit CTRL-L

Note: if you are unsure the order of the child panels, check in the contents of the child panel, there will be a script with a number following “Panel S”. This is the order they should be selected, but remember in reverse order.

Chapter 6

Affiliate Vendors Affiliate vendors in BSM have recently been completely overhauled. They have been redesigned to allow easy setup, dynamic permissions, and excellent designer control. Affiliate products are submitted to the website via the standard vendor to reduce double entry of products. Once the products have been submitted, your resellers have the ability to browse your online catalog and choose which products they want to sell. The resellers also have the option of selecting the appropriate size fo vendor for its application. Configuration has been reduced to a single product code to provide fast configuration and limit errors.

Submitting Products to your online catalog You products are submitted to your online catalog via your standard store vendors. Once you have completed setting up your standard vendors, you will touch the face that holds your texture. Doing this will bring up the dialog menu where the “SendToWeb” button will be accessed. Selecting “SendToWeb” will transmit your product to your product catalog. Once the product has been submitted, you will receive a message in local chat notifying you that your product was completed successfully.

LOCAL CHAT OUTPUT Product has been entered and is ready for distribution. ------------------------------------------------------- BD - ZodiacPack BD99&699 5754 -------------------------------------------------------

Once your products have been submitted, your resellers will be able to browse you online catalog.

Creating your affiliate vendor This process will create the vendor that you will send to your resellers. Once this process is complete, you will have a Template Vendor that is full perm. This will allow your users to configure their vendors to sell their chosen products.

As painful as this may seem, you only need to perform this process 1 time.

NAVIGATION PRIM1. Create Prim2. Set prim to COPY, MOD, TRANSFER3. Set Texture to Blank4. Rename Object to “Navigation”5. Place “Navigation” Script into this Prim

PANEL PRIM6. Create Prim7. Set prim to COPY, MOD, TRANSFER8. Set Texture to Blank9. Rename Object to “Panel”10. Place “Panel Script” Script into this Prim

VENDOR PRIM11. Create Prim12. Set prim to COPY, MOD, TRANSFER13. Rename Object to something like “Cory Hancroft’s Vendor Template”14. Place “Products” and “Config” notecards and ALL scripts EXCEPT “Navigation”,” Panel Script”, and “Multi Rezzer” scripts into this Prim.15. Wait until all activity finishes, this may take a minute or so. Scripts will appear to be removing themselves. You can deselect the prim and give it a moment and then select it again. Once all activity finishes, goto next step.16. Edit object and goto Tools > Set Scripts to Not Running in Selection.17. Take “Navigation” prim from step 1 into inventory and place into inventory of this vendor prim.18. Take “Panel” prim from step 5 into inventory and place into inventory of this vendor prim.19. Edit the Products notecard and place a few of your product codes instead of mine.20. Place “Multi Rezzer” script into this vendor prim.21. Set Texture to Blank22. Finally, take new vendor into inventory for dispersal.

Packing Your Vendor For Distribution Once you have your template vendor created, you can now pack it for distribution. Create your boxed pack of how you would like to give your affiliate pack to your resellers. Feel free to include anything that you would like to send with your pack as far as store signs, information, TOS, or anything else you think they may need. The following is what you need to include for the affiliates to operate properly.

1. The Template vendor that you just completed creating. 2. Instructions on where to get the product codes. 3. ~~ Affiliate Activation ~~ script

Once you have packed your reseller kit, you can then freely distribute to your resellers. Once they rez your reseller kit, their account will be created on the BSM website. The reseller’s username and password will be displayed in local chat, make sure they make note of this.

By default, you will be required to authorize every reseller that is new. To do this you will need to login to the BSM website and click “RETAILER LIST” on the menu and set a commission percentage for the reseller. Next you will need to authorize the servers that they may use. This is done by going to “SERVER ACCESS MATRIX” and finding their name. Next to the name are the available servers holding products. By checking these boxes, it allows the reseller to see the products in that server.

Reseller Vendor Configuration The resellers are given a username and password to login to the website. Once they are logged into the BSM website, there is a link for “AFFILIATES FOR SECONDLIFE”. Next the resellers will continue to “PRODUCT LISTS”.This will display all available designers. They will find your name on the list and choose “View Products”. This will provide the reseller with a complete list of your authorized products. Listed will be the products with images, product name, price and the Product Code. This product code is the number that they will place in their vendors.

Once a template affiliate vendor has been rezzed, a message asking for permission to link and unlink prims in the linkset. Answer “Yes” to this message. Next, touch the vendor and a dialog menu will ask the type of vendor to produce.

Options will be Multi Reg, Multi Side, or Standard. If a standard vendor is chosen, a single panel will be created. Place the Product Code into the description field and touch vendor. Select “Admin Reset” from the dialog menu that appears. If you choose a Multi Panel vendor, the appropriate layout will be rezzed. Once this is complete, edit the product list notecard in its contents. In this notecard, place all desired product code on a seperate line. One item per line with no blank spaces. Once this notecard has been saved, touch the vendor and choose “Admin Reset”.

Chapter 5

Version Release Note

XstreetSL/Marketplace Plugin 3.2.002- Allows for distributions and split pays on xsl and marketplace sales.

Server 3.2.001- Multiple split pays added. Up to 5 additional split pays may be enabled

Kiosk 3.1.012- Past Buys and My Credit generate links stay active until another customer touches kiosk.- Group for “Join Group” is manually set on website profile link. If no group is set, kiosk uses group that kiosk belongs to.

Affiliate Single Panel Vendor 3.3.000- Complete overhaul of affiliate single panel vendors.- Resellers/Franchisers will choose products from the website that they would like to sell. They are given a login and will have access AFTER they rez one of your vendors. You must login as well to set a commission percentage before the vendors are placed in use by the franchiser.- Your products are uploaded to the website via the same bsm affiliate script as the retailers use.- Commission can be set independently from other resellers.- Only product code is required to configure vendor on reseller’s side. Retrieved from website.- See Manual for further details.

Vendor 3.2.001- Added “SendToWeb” button to upload products to the website for use in affili-ate vendors.

Server 3.2.00/Vendor 3.2.00/Giftcard 3.2.000- Security Update

Affiliate Vendors 3.1.005- Added Retailer login ability to BSM website for sales monitoring- Designers can disable or de-rez retailer vendors in the event of a fallout- Disabled ability of retailer to purchase product from their vendor- Logging of SLURL, vendor configuration, and owner added- Added 2% commission on affiliate sales: 1% from retailer and 1% from design-er.

Affiliate Vendors 3.1.003- Added multi panel vendors- Added affiliate vendors for standard and multi panel

Vendor 3.1.002/Giftcard 3.1.003- Added “Get Config” button to vendor admin side of the menu. Used for con-figuration in multi-panel vendors. (Coming Soon)- Extended the timer and set timer to display for payment to be received while gifting.

Kiosk 3.1.009- customers can view their past purchases, check their credit balance- redeliver of items- send product updates, notices, announcements and news- send giftcards- updating your store logo and landmark- group inviter

BSM 3.1.000 FULL UPGRADE- Complete communications overhaul. Converted all communications to and from the website to a fully encrypted comms channel.- Set option for split pay to allow/disable store card use.- Store cards no longer show credit at all locations, only card’s store credit.- Customizable Gift boxes are now available. Giftboxes can be vended from your servers.

Server 3.0.00/Vendor 3.0.00/Giftcard 3.0.000/Affiliate 3.0.000- Customer Reward Program- Store Sale Option- Added XstreeSL Plugin- Server Security Update- Updater now updates all vendors in one pass

- Changed Vendor Button from “Use GiftCard” to “StoreCredit”- Fixed Menu alignment issues- Give Item has been restored.- Updated Messages on Vendor Readouts- User can change their login username- Active Store Cards page on website updated- Added “Cycle All” and “Show Ver” Button to HUD to start sales- Fixed Minimize Button on HUD- Added notication settings to turn off and on inworld and by email- Fixed Giftcard Menu Display and various other fixes

Server 2.0.003- Enhanced Security Update

Vendor 2.0.008/Giftcard 2.0.004- Unlocked Quick pay buttons without having to touch vendor to get menu. This allows customer to bypass menu’s and give quick pay price when idle.

Vendor 2.0.005- Resolved issue with customers seeing the buttons AdminReset and Give Item. Buttons were inoperable and are now removed.

Vendor 2.0.004- Resolved Problem when using giftcards when additional funds are required. Item failed to delivery. Resolved

Vendor 2.0.003- Fixed vendor display of current version. After being updated, vendor still said a newer version was available.

Vendor 2.0.002/Server 2.0.000/Giftcard 2.0.003- Lengthened timeout for vendors and giftcards on gifting option.

Vendor 2.0.000/Server 2.0.000/Giftcard 2.0.000- Official Release Version

Giftcard 1.2.006- Added “GiveItem” button to giftcard vendors so GC’s can be given by admin

Vendor 1.2.026/Server 1.2.003

- (CRITICAL UPDATE) Further resolution to delivery updates.- Reduced sim load, greatly increasing process time on vendor.- Further tracking info logged

Vendor 1.2.024- Resolved delivery error

Vendor 1.2.020- Minor fix with HUD/Vendor cross talk

Vendor 1.2.019/Server 1.2.002- Added Price Listing to purchase menu to vendor- Added Direct Give Button for Admin to vendor- Added Admin Reset Button for Admin to vendor

Vendor 1.2.018- Fixed Server Comms after server has been picked up and moved.

Vendor 1.1.017/Server 1.1.010/Kiosk 1.0.010- Added more definition to split pay tracking in vendor- Added location and access times for server for server

Server 1.0.009/Kiosk 1.0.009- Minor fix with DB tracking

Kiosk 1.0.008- Fixed problem with incorrect stats output

Vendor 1.1.016/Server 1.0.008/Kiosk 1.0.007- Set new primary web server to bejamble.net- Created new buttons in the kiosk update page for “Live Updates”

Vendor 1.1.015- Added troubleshooting data field to log vendor version

Vendor 1.1.014- Removed “Vendor Resetting” floating text- Added additional data field for owner uuid and transaction type- Minor fixes with configuration detail output on setup

Vendor 1.1.013- Checks for current version and gives SLURL for updates- Fixed issues with freebie itemsVendor 1.1.012- Critical Fix for processing orders when primary webhost is unavailable

Vendor 1.1.011/Server 1.1.007- Configured Mirrored webhosts in the event the webhost becomes un-reachable

Vendor 1.1.010/Server 1.1.006- Integrated Automated Updates for vendor and server scripts- Split pay was erratic problem fixed

Vendor 1.1.009/Server 1.1.005- Fixed a problem with prices not updating once changed- Placed Floating text above server