Skip to main content

Manage price types Closed beta

Price types allow you to define multiple categories of price for an individual item in a cart item catalog. This allows you to implement targeted pricing for specific customer segments.

Feature access

Only admins have access to this feature.

You can link a price type to one or more audiences to limit its benefit to those audience members only. Multiple price types can be created in an Application.

Price types work in conjunction with price adjustments, which are specific price values assigned to a cart item for a given price type. After creating a price type in the Campaign Manager, you programmatically update a cart item catalog connected to an Application to provide the price adjustment for the item.

For each new price type you create, new custom attributes appear in the Rule Builder: Price, Adjustment Reference ID, Price Adjustment Start Date, and Price Adjustment Expiry Date. Each attribute corresponds to a property of the selected price adjustment for that price type. Use cart item filters to reference these attributes in your rules.

tip

For more detailed information about price adjustments, setting up your integration to use price types, and payload examples, see the related developer docs page.

Example

Imagine you want to offer an item, for example a shirt, at a special price to customers who are members. You can create a price type called membersPrice and link an audience that includes members only. Customers who are not members can still purchase the item at its regular price, which is the base price in the catalog.

First, sync a catalog containing the shirt with your Application. Next, create a price type. After you create the price type, new built-in and custom attributes become available for use in cart item filters and per-item effects.

Sync the catalog again to assign the price adjustments to the membersPrice price type.

Create a new cart item filter named shirts to restrict the discount to items in the customer session that have the membersPrice price type. Use the Price Type attribute to reference the new price type in your rules.

When you apply the Discount individual items effect, select shirts as the list of items to discount and enter the following discount value:

(Item.Price * 10%).

After rule evaluation, members get 10% off the price value assigned to the membersPrice price type for the item. Other customers can purchase the item at its regular price.

Create a price type

Before creating a price type, ensure that you have created a cart item catalog and connected it to your Application.

To create a price type:

  1. On the leftmost menu, click Account, then click Tools > Price Types.

  2. In the top-right corner of the page, click Create Price Type.

  3. In Name, type the name of the price. This is the name that you see in the Rule Builder.

  4. In API name, type an identifier for the price type. This is used for integration purposes.

    note

    You cannot use the following reserved names for the price type Name or API name:

    • base: Refers to the base price value in the catalog, which is the regular price of the item.
    • custom: Refers to the price type sent in the response when a customer session is updated.
  5. (Optional) In Description, type a description for the price type.

  6. (Optional) In Audience, select one or more audiences to limit the price type to. If you select none, the price type can be used for all audiences.

  7. Click Create Price Type.

important
  • Price types are linked to all the catalogs in your account.
  • If a cart item is removed from a catalog, the price adjustments for the item are deleted.
  • If a catalog is deleted, any price adjustments are removed from the deleted catalog.

Edit a price type

To edit a price type:

  1. On the leftmost menu, click Account > Tools > Price Types.
  2. To the right of the price type you want to edit, click .
  3. Edit the name, description, or connected audiences.
  4. Click Save.

Delete a price type

To delete a price type:

  1. On the leftmost menu, click Account > Tools > Price Types.
  2. To the right of the price type you want to delete, click .
  3. In the confirmation window that appears, confirm your action and click Delete Price Type.