Understanding Categories for Organizers

Categories for Organizers

Overview

The following are important aspects of the set up of categories. Complete category configuration options are found here.

For each category, there are three dates that are set by you, Close Date, Start Date and Finish Date.

  • Midnight of the Close Date is the last day that a kiosk will sell or give tokens to authorized designers.
  • Midnight of the Start Date is the first day that the category appears on our HUD and on our web page index.
  • After the Finish Date concludes, then category disappears from the HUD and our web page index.
  • For events, it is okay if the close date is after the start date, however, the finish date must be within 30 calendar days of the start date.
  • For sales, we recommend against setting the close date on or after the start date.
  • Designers who register ads after the start date will appear in the category on the HUD and website at midnight the following morning.

How many Items can be Included with a Category?

  • Our platform supports 999 items per category.
  • Our HUD can display a maximum of 100 items per page.
    • We do have a design for a future HUD update that will correct that limitation.
  • When a category has more than 100 items, the category appears on the HUD as multiple pages.
  • Example: This is the art galleries category that has 3 pages.

Fees

We are not currently charging fees at this time.  When we do, these are our introductory fees:

  • We have a per token fee of L$15/week, so if your category lasts 17 days, we charge L$45/token.
  • Each token can register one and only one item.
  • A minimum of 15 tokens per category is required, this condition can be waved under special circumstances.  For example, around Christmas, weekly categories often have much fewer advertisements.
  • Each category can have an upper limit as to how many tokens can be you can get.
  • We charge you for the number of tokens that were created, rather than in blocks.  Any block prices you might see are for example purposes.
  • We expect an upfront fee with the balance due before the category is published.
    • If you expect to sell a minimum of 50 tokens, we expect an up-front fee of L$750/week of the category in order to create it.
  • Categories cannot last more than 30 calendar days.
  • We reserve the right to limit how many categories we create and who creates them.

Understanding the Item State Life

Overview:

  • An item is information or an advertisement about something, and a token is the key to registering the information for a category.
  • Each item has a state; Created, Registered, Issue and Accepted.  (see picture and explanation on this page).
  • In order for an item to appear on our HUD or website, it's state must be "Accepted".
  • When registration happens, the system assigns the state to "Registered" or "Accepted".
    • Registered - means the category administrator wants to review each submission and manually approve the item for publishing.  The administrator can then accept or raise issue with the item.
    • Accepted - means the category auto-accepts the token.

Sponsors and Sorting

A sponsor is an individual who pays a premium to be part of a 3rd party category.  You can identify who your sponsors are by using the "!Sponsors" notecard inside of the Token Kiosk.  You specify usernames by "first.last" or "username", one per line.  When a sponsor gets a token from the kiosk, they are automatically sorted to the top of the list.

With Index sorting they appear first in the order the sponsor got a token.  With Date sorting, they appear first in reverse chronological order before other submissions.

How Do You Create Items for a Category?

We offer three main ways to create items.

  1. Kiosk - An object that can sell or give away tokens to third parties.
    • Authority to set up using any one of these methods.
      • Public - Anybody can get a token.
      • Group - Anybody in a group can get a token.
      • Access List - Anybody on a pre-approved access list can get a token.
      • Banned List - You can ban people from your kiosks.  Generally, this is only used for kiosks that are public.
    • Notes:
      • The kiosk is deployed on your land, and if it sells tokens, all money goes to you.
      • When a person gets a token, they get a folder of items and a token code that they can use to register their item.
      • Category administrators can get as many tokens as they want from the kiosk.
  2. HUD - An object you attached to your viewer that gives away tokens with a folder, that is subsequently given away.
    • The HUD uses the same script as the Kiosk, and goes into administrator mode, allowing you to create as many tokens as you want, and transfer them to whomever you want.
    • The HUD gives you total authority as to who gets tokens and who does not.
  3. REST API - This is a internet web interface that allows third parties to get and delete tokens through automated platforms.  Documentation for this approach is not shown on this website.

We have two other methods that are not documented here, so if these methods don't work, we have other ways to register.

 

Token Kiosks

 

A Token Kiosk is an object that allows you to sell or give away tokens.  You use this style when you want to sell tokens through a Kiosk we provide.  If the kiosk sells tokens, you keep all of the proceeds.  The Kiosk lists this information (top t0 bottom):

  • Texture - The texture you assign to the category.  This image appears on the kiosk, HUD and website.  For monthly events, we strongly recommend you create a separate image that has your brand or category logo with dates on it.
  • Entry Code - A 15 character code you assign to the category.  The code is how you identify the category to your residents, and it also becomes the name that appears on the Listed Ads page; example: "EV401".
  • Close Date - The date the kiosk stops selling tokens.  The kiosk does show different values as the close date approaches (see below)
  • Dates - The inclusive date range.  Category runs from Sunday July 1st to end of day Tuesday December 31st.  Dates work independently of the Close Date.
  • Token/Person - Identifies the maximum number of tokens a person can get from the kiosk.  (can be 1 to 99, see below).
  • Available - Shows the tokens left that the kiosk can issue.
  • Fee - The L$ fee the person pays to get a token from the kiosk.  Or it can be free (see below).

 

Related Images

Kiosk - Showing Date/Time Display States
Kiosk - Closed

 

 

 

 

 

 

 

Kiosk - Token Options & Free
Kiosk - Out of Tokens

 

 

 

 

 

Token Kiosk - Security - Initialization

A kiosk can only be initialized if the owner of the kiosk is registered in our system as an administrator.  This ensures that only you retain control over tokens that are deployed by it:

Cannot Initialize Kiosk

Security - Item Deployment

You have these options for securing the kiosk: (note, usernames are the legacy name separated by "." or the resident name without resident as the last name; example: "jane8812" or "jane.doe")

  1. Open - This means anybody who clicks the kiosk can get an item from the kiosk.
  2. Sponsor List - This is a notecard called "!SponsorList" that contains a list user names.  Sponsors always appear first in on the website or HUD regardless of the sorting type.
  3. Access List - This is a notecard called "!AccessList" that contains a list of up to 50 user names that identifies users by name who can access the kiosk.  If you need more than 50 names, use a group instead.  Note, we don't check the number of names, if you list too many, your kiosk will run out of memory and stop working!
  4. Banned List - Notecard called "!BannedList" that contains, a list of users who are not allowed to use the kiosk.  You can specify up to 50 names.
  5. Group - This option ensures that only users who have the group tag that selected can use the kiosk.  Furthermore, if the token cost is FREE, we mention that in the price.  Note: Group Only access is a setting that is done when the category is set up.
Group Access & Free to Group Notice

When Do I Delete the Kiosk?

Kiosks should remain in your land until after the event concludes.  This is because Residents may need the kiosk to get information from it.  At any time they can click the kiosk and get these options:

Kiosk - Options
  • Get / Pay - This allows somebody to get or pay for a token.  When getting a token, the kiosk grabs one and delivers a folder.  When paying for a token, the kiosk goes into pay mode where the person has to pay an amount to get a token.  (Note: If they are using a hacked viewer and can override the fixed amount, any amount less than the pay amount is greeted with a "thank you for your donation" message, and no token is provided.)
  • Tokens - Provides them with a list of their token codes.  (Not shown if they have no tokens from this kiosk).
  • Redeliver - Provides a copy of the folder in case they lose it.
  • Info - Provides information about your category to them.  You can specify that information when we create the category.
  • Open - Provides a list of open categories.
  • Close - Closes the kiosk.  When somebody clicks the kiosk, they get exclusive control over it for up to a minute:
  • Restart - Only appears for the kiosk owner, allows you to reset the kiosk.  This is usually done when there is a change to the category.

Token HUD

The Token HUD uses the same script as the Token Kiosk, but it appears as a single object that you can attach to your viewer.  An administrator can get as many tokens as they want, to the maximum for the category.

Kiosk - HUD

 

Understanding the Registration HUD

Quertie will work with each category owner to devise a registration HUD that best works for them.  The HUD is driven from a specially formatted notecard that is set up by Marvelous Mania.  These are all the attributes we ask for during registration.  These questions are in English, but if you want, we can work with you to create them in any language you want.  You can remove items from the list, but current there is no way to add items.

  • Dialog
    • We usually have two introductory dialog boxes, one tell them what they are configuring and the other tells them what to expect when we ask questions.
  • Token
    • This is the token code they get when they get or buy a token from your kiosk.
    • The current code is 14 characters, randomly generated and guaranteed to be unique.
    • We can support token codes up to 50 characters, and we use that limit for other categories such as the Second Life Art Galleries index we integrate from Sasun Steinbeck.
    • Note:
      • Tokens Codes have security around the owner, so if I learn of your token code after you register it, I cannot corrupt it and replace your ad contents with my own.
      • Categories that do not allow the transfer of tokens are fixed to the owner after the token is registered or unlisted.
  • Store Name
    • This is the store, location or venue name for the token.
    • For each category, the question we ask when filling out this field is specific to the category.
  • Item Name
    • For Brands, Venues, Locations and Events (advertising Brands)
      • First of a two line comment about the store, location or venue.
    • For Single Item Sales
      • This is the "name" of the item being sold
    • For Hunts
      • This is the "name" of the item that hunters are looking for
    • For Events (advertising items)
      • The "names of items" being sold
      • This is because we only support one image per item
  • Texture
    • We ask for the UUID of the texture they want to use for their advertisement.
      • The image cannot contain transparent pixels.
    • With the UUID we can:
      • We can get access to the image without needing to worry about permissions of the texture in the designer's inventory.
      • Display the image on our HUD.
      • Display a thumbnail image (directly from second life) and display it on our website.  This is a 320x240 version that we squish back into a square format.
      • Extract an original resolution image (from second life) and display it on our website.  We convert Second Life's internal image format to a 80% quality JPEG image.
      • Notes:
        1. Webpages pull thumbnails directly from Second Life, while the original resolution images are extracted when the user submits their ad.
        2. On our web pages, we use lazy loading.  This means the high resolution image is not loaded by the browser until the resident opens the ad popup.  This makes loading of the individual category index extremely fast.
        3. In the future, after we start charging for our service, we will add a CDN to our website to decrease load times by 2-3x especially for clients who are not in North America.
  • Comment
    • For Brands, Venues, Locations and Events (advertising Brands)
      • Second of a two line comment about the store, location or venue.
    • For Single Item Sales
      • This is a comment about the Item, such as, colors, HUD options, variations, why it's the best, etc.
    • For Hunts
      • This is an optional hint where the hunter can find the item, or perhaps a comment about the item.
    • For Events (advertising items)
      • This is often a description for the pricing of the items.
      • This is because we only support one image per item, we cannot use the price option.
  • Price - For single item sales where the category is configured for user defined pricing (link)
    • We can ask for the amount that the designer will charge for their item.
    • Not shown in the link below
  • Group
    • This is the Group UUID for the store/venue/location.
    • When on the website, a user clicking the link will cause the group dialog to appear in their viewer.
  • URLs - We currently allow 5 Website URLs per item:
    • Second Life Marketplace - A link to their store or item they are advertising.
    • Image - A link to a Flickr site with their item images.
      • This URL only appears on the website, however, on the HUD there is a link that will take users to the website.
    • Store SLURL - A SLURL to a given store.
      • This is used for events that occur on a region ... it exists to allow a store that is advertising to identify their main store.
      • This can also be used for malls that are satellite stores to main stores.
    • URL1, URL2 - These are three additional websites.
    • URL3 - These are three additional websites.
      • This URL only appears on the website, however, on the HUD there is a link that will take users to the website.
  • SIM
    • The Sim feature can be used to for events to ensure that all of the destinations are on that region.
    • Without this feature on the Registration HUD, the designer can be anywhere on the grid.
    • It can be a fixed name such as "Orion" or a wildcard, such as "LEA*", which forces the region name to start with "LEA".

Example (of a monthly fair):

Administration

Administrators will have full access to the category, and can control on an item by item basis which items appear in their category.  See the Administrator HUD for more information.

Category Website

After a category is published to the HUD it is also published to our website.  Each image accesses a popup which shows a copy of the original texture with all aspects specified for the item.  This page is re-published every day, when there are changes and matches what is on the HUD.  Full example of this item ev401.html.  This page makes extensive use of CSS, so if you want to change the format, we do offer the ability to use your own CSS files to rebrand the output.

Item Popup

Images are scaled for the users browser window and the system has been tested to work on Chrome, Firefox, Safari on Windows, MacOS, iOS and Android.  Furthermore, we track impressions and engagements on the website (and HUD), see this link for more information.

Category Website Pre-Publish

This page is normally only generated when the category is active, but you can get the HTML version prior to it being published by using https://admin.mm4sl.info/ListedAds/Query.html.  Only tokens that are "Accepted" appear on the HTML page.  When the publish is complete, you are automatically sent to the generated web page.

 

 

 

Category Query

This feature allows you to perform an export of all items in a category regardless of state.  We use a CSV export format as compared to an XLSX format to avoid security issues.  CSV will always open in your local spreadsheet software, but XLSX usually requires a file to be unblocked before it can be opened.

You use the Category query in combination with the statistics output to know which tokens did better than others.  You can match based on the index or the token code.

The CSV Exports these fields.

To run the export you use this link: http://admin.mm4sl.info/inquiry/items.html

The result will be a CSV file with the same name as the category code.

Category Statistics

The only way to know if your category is reaching the right number of people is review the statistics.  We collect impression and engagement statistics for every token, and you can get a single the summarized statistics of every token in the category, by using https://admin.mm4sl.info/stats/query.html.  You will need your Entry Code, Administrator UUID and the Category Secret to use this form.  The output looks like this:

        1,TK9999-99-9999,20180801,122433,quertie,Impression,Item
        7,TK9999-99-9998,20180807,012027,quertie,Engagement,Item,TP,8,Button 

With a numerical token count, the token ID, followed by the other statistics collected.

Note: This data is only useful if you use a spreadsheet with a pivot table to summarize the statistics.  Furthermore, you won't be able to tell if the impressions and engagements are having the desired effect unless you study and compare the statistics of more than one category.

Note: We do not currently collect impressions or engagements on statistics gathered through out website. We will offer google ad statistics for categories in the future.

How to Start?

Contact "Quertie Resident" in-world to get started.