content/hifi-content/Experiences/Releases/usefulUtilities/marketplaceItemAdvertiser/2019-02-14_10-45-00

Marketplace Item Advertiser

When this script is attached to an entity as an entity script, the entity serves as a "Marketplace Item Advertiser".

Features

• When a user clicks with their mouse or uses the red hand controller laser on the entity that is running this script, the user will be presented with the Marketplace Checkout page associated with the Marketplace Item ID that is referenced in the userData of that entity.

Setup

1. Add an entity to your domain.
   • A Box primitive would work perfectly.
   • The entity should have some affordance to indicate that a user can click on the entity. A billboard with text "CLICK HERE TO PURCHASE XYZ APP" is one example.
   • Note that anyone who can modify the userData of this entity will be able to control which Checkout page that users see!
2. Add the below userData object to the attached entity's userData
   1. Fill in the marketplaceID value in the userData by adding Marketplace IDs to Items that you want users to purchase.
      • Obtain a Marketplace ID from the URL of your Marketplace item; the ID is the long string that comes after marketplace/items/ in the URL.
      • For example, to direct users to the checkout page of the Appreciate App v1.2, you would use: "marketplaceID": "4034dc57-09a2-4b5e-b589-c50862566f6c"
3. Add the marketplaceItemAdvertiser.js script to the entity

Here's the object to add to the zone entity's userData:

{
    "marketplaceID": "<Your Item's Marketplace ID>"
}

Releases

2019-02-14_10-45-00 :: 333e19d

• Initial release