Pricing Configuration

On the Pricing Configuration page, you should see a searchable/sortable table with the following columns:

  • Status: whether AristanderAI is enabled for the product - this means that AristanderAI will attempt to optimize your price

  • Product ID/SKU: a unique identifier for a product - this should include size, color, and other attributes for configurable products

  • Product: the name of the product

  • Brand: the name of the brand

  • Default: your default price

  • Net Unit Cost: your net unit cost

  • Minimum: the absolute minimum price AristanderAI can set for the product - currently only tax inclusive

  • Maximum: the absolute maximum price AristanderAI can set for the product - currently only tax inclusive

  • AristanderAI: the AristanderAI-optimized price (for the current time period) - this price will frequently change, but will only update your prices according to your pricing interval (explained below)

Additionally, there's a purple button in the top-right hand corner labeled 'Update Prices', allowing you to upload a CSV to the table (explained below).

Lastly, on the bottom you will see your pricing interval - this reflects when your next/future price changes will occur.

Pricing Configuration Terms

One of the most important features of AristanderAI is being able to configure your prices according to status, minimum price, maximum price, default price, and net unit costs.

It's important to understand these parameters as they greatly affect the performance of AristanderAI and metric calculation.

The Status parameter refers to whether or not AristanderAI is enabled for a specific product. It has two possible values: enabled or disabled. If enabled, AristanderAI will deliver an optimized price for that product. If disabled, only the default price will be delivered - AristanderAI will not change the configured price set in the 'default' price).

The minimum price parameter refers to the tax-inclusive minimum the price can be set to for that product. For example, if the minimum is set to 200 (200 cents) then AristanderAI will be able to set the price for that product to 200 - but not to 199. Likewise, the maximum price refers to the upper bound of the price. Both the minimum and maximum prices are a requirement for AristanderAI to work - and it's important to set these values properly. A minimum price that is too high or a maximum price that is too low won't allow for AristanderAI to truly exploit cross-product demand inefficiencies. Therefore, it's extremely important that these values are set to a reasonable value.

The default price is the price that you currently set the product to - this price affects the baseline that AristanderAI compares itself to when performing A/B testing. If A/B testing is enabled, AristanderAI flips a coin every pricing interval (for example, one hour, 6 hours, etc.) and sets all the prices either to default or AristanderAI-optimized price.

The net unit cost this value will be used to calculate profit - for all completed orders, AristanderAI subtracts the net unit cost from the price paid for by the user. The closer you get to the actual net unit cost of the item, the more accurate the metrics and A/B testing will be.

Uploading New Configuration

There are two ways to upload a new configuration to AristanderAI.

Currently, AristanderAI accepts a CSV upload via the Pricing page (on your dashboard) or directly via our API endpoint.

First, you'll need to create the CSV to upload: All CSVs need to be:

  • UTF-8 encoded

  • Headered

  • Comma-delimited (,)

  • Quoted with single quotes (')

The header row should be the first row and have the following value:

product_id,product_name,product_brand,default_price,minimum_price,maximum_price,net_unit_cost,status

Every single column needs a value.

Status can be set to 'enabled' or 'disabled'.

Important: All price values (default, minimum, maximum, net unit cost) are in WHOLE CENTS. If your item is normally priced at 12.05, then the equivalent value in the CSV would be 1205. If a decimal point is found in your pricing, our API will throw an error!

Each row represents one product - the product ID is unique - and all values associated with the product ID will be overwritten by new CSVs.

To upload via the web interface, login to your dashboard, navigate to the pricing page, and select "Update Prices" - you will be shown a file dialog to select your CSV.

Your pricing configuration table should immediately reflect your new changes.