Set up price types Closed beta
Use price types to define multiple categories of price for an individual item in a cart item catalog.
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.
Only admins have access to this feature.
Price adjustments
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, programmatically update a cart item catalog connected to an Application to provide the price adjustment for the item. You do this by sending the following requests in this order:
- The first request adds the item to the catalog using the
ADDsync action type. You can send this request before or after you create the price type. - The second request assigns the price adjustment for the price type to the item using
the
ADD_PRICE_ADJUSTMENTsync action type.
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.
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, use the ADD sync action type to 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.
Use the ADD_PRICE_ADJUSTMENT sync action type to sync the catalog 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.
How it works
When a customer session is updated, Talon.One loads the price types and price adjustments from the catalog for each cart item and selects a price.
Price adjustment selection
For each price type, Talon.One selects the most recent, currently active price adjustment.
A price adjustment is currently active when the time of evaluation falls within the time
frame defined by the effectiveFrom and effectiveUntil parameters.
If no time frame is defined, the price adjustment is always active.
To select a price adjustment, Talon.One checks the time provided in the calculatedAt
parameter. If this time is provided, the price adjustment with the most recent
calculatedAt value is selected. If it is not provided, the price adjustment that was
most recently synced with the cart item catalog is selected.
If multiple price adjustments were either synced with the catalog or have a calculatedAt
parameter with the same time value, Talon.One selects the price adjustment that was
most recently synced.
Price type selection
If there are multiple price types for an item, Talon.One selects the price in the following priority order:
- The price adjustment defined in a customer session request, if provided. Talon.One only loads the prices for which the customer profile is eligible.
- The price with the lowest value. If the price types have the same value, Talon.One picks:
- The base price, if it matches the value of the price types.
- The price type that was created first, if the base price is higher than the value of the price types.
- 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.
Related pages
Payload examples
{
"actions": [
{
"type": "ADD_PRICE_ADJUSTMENT",
"payload": {
"sku": "25july_sku9",
"adjustments": [
{
"priceType": "priceA",
"price": 17.5,
"referenceId": "e6783c30-09f8-4c5a-8107-b58ade5fb5dd",
"effectiveFrom": "2024-08-14T16:18:00+02:00",
"effectiveUntil": "2026-08-14T16:18:00+02:00",
"contextId": "specialSaleId"
},
{
"priceType": "priceB",
"price": 19.8,
"referenceId": "b6a74b34-fb76-46a5-8c1d-07f3e124c69c",
"effectiveFrom": "2024-08-14T16:18:00+02:00",
"effectiveUntil": "2026-08-14T16:18:00+02:00"
}
]
}
},
{
"type": "ADD_PRICE_ADJUSTMENT",
"payload": {
"sku": "25july_sku10",
"adjustments": [
{
"priceType": "priceA",
"price": 27.99,
"referenceId": "8860a9b5-72d4-4bfb-8a9a-775c50623d6a",
"effectiveFrom": "2025-07-25T16:18:00+02:00",
"effectiveUntil": "2025-08-15T16:18:00+02:00",
"contextId": "specialSaleId"
}
]
}
}
]
}
{
"applicationId": 1,
"currentBatch": 0,
"totalBatches": 1,
"trigger": {
"id": 33,
"type": "NOTIFICATION_SETUP",
"triggeredAt": "2025-07-25T11:58:51.410829Z",
"totalAffectedItems": 7,
"payload": {
"accountId": 1,
"applicationId": 1,
"catalogId": 1,
"catalogVersion": 12
}
},
"changedItems": [
{
"id": 1,
"catalogId": 1,
"sku": "25july_sku1",
"version": 1,
"price": 60.000,
"prices": {
"base": {
"price": 60.000
},
"priceA": {
"price": 25.000,
"adjustmentReferenceId": "25july_sku1-ref1"
},
"priceB": {
"price": 23.000,
"adjustmentReferenceId": "25july_sku1-ref2"
},
"priceC": {
"price": 22.300,
"adjustmentReferenceId": "25july_sku1-ref3"
},
"priceD": {
"price": 35.320,
"adjustmentReferenceId": "25july_sku1-ref4"
}
},
"evaluatedAt": "2025-07-25T11:58:55.034976Z",
"effects": [
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 2.23
},
"selectedPriceType": "priceC",
"selectedPrice": 22.300,
"adjustmentReferenceId": "25july_sku1-ref3",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "priceC",
"numberParameterPayload - price value": "22.300"
}
},
"selectedPriceType": "priceC",
"selectedPrice": 22.300,
"adjustmentReferenceId": "25july_sku1-ref3",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
}
]
},
{
"id": 2,
"catalogId": 1,
"sku": "25july_sku2",
"version": 1,
"price": 0,
"prices": {
"priceA": {
"price": 31.000,
"adjustmentReferenceId": "25july_sku2-ref1"
},
"priceB": {
"price": 30.320,
"adjustmentReferenceId": "25july_sku2-ref4"
},
"priceC": {
"price": 33.000,
"adjustmentReferenceId": "25july_sku2-ref3"
}
},
"evaluatedAt": "2025-07-25T11:58:55.034994Z",
"effects": [
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 3.032
},
"selectedPriceType": "priceB",
"selectedPrice": 30.320,
"adjustmentReferenceId": "25july_sku2-ref4",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "priceB",
"numberParameterPayload - price value": "30.320"
}
},
"selectedPriceType": "priceB",
"selectedPrice": 30.320,
"adjustmentReferenceId": "25july_sku2-ref4",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
}
]
},
{
"id": 3,
"catalogId": 1,
"sku": "25july_sku3",
"version": 1,
"price": 0,
"prices": {
"priceA": {
"price": 130.100,
"adjustmentReferenceId": "25july_sku3-ref1"
},
"priceB": {
"price": 32.500,
"adjustmentReferenceId": "25july_sku3-ref2"
},
"priceC": {
"price": 33.000,
"adjustmentReferenceId": "25july_sku3-ref3"
},
"priceD": {
"price": 12.000,
"adjustmentReferenceId": "25july_sku3-ref4"
}
},
"evaluatedAt": "2025-07-25T11:58:55.035006Z",
"effects": [
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 3.25
},
"selectedPriceType": "priceB",
"selectedPrice": 32.500,
"adjustmentReferenceId": "25july_sku3-ref2",
"targets": [
{
"type": "NONE"
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "priceB",
"numberParameterPayload - price value": "32.500"
}
},
"selectedPriceType": "priceB",
"selectedPrice": 32.500,
"adjustmentReferenceId": "25july_sku3-ref2",
"targets": [
{
"type": "NONE"
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 1.2
},
"selectedPriceType": "priceD",
"selectedPrice": 12.000,
"adjustmentReferenceId": "25july_sku3-ref4",
"targets": [
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "priceD",
"numberParameterPayload - price value": "12.000"
}
},
"selectedPriceType": "priceD",
"selectedPrice": 12.000,
"adjustmentReferenceId": "25july_sku3-ref4",
"targets": [
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
}
]
},
{
"id": 4,
"catalogId": 1,
"sku": "25july_sku4",
"version": 1,
"price": 55.000,
"prices": {
"base": {
"price": 55.000
},
"priceA": {
"price": 245.000,
"adjustmentReferenceId": "25july_sku4-ref1"
},
"priceB": {
"price": 19.990,
"adjustmentReferenceId": "25july_sku4-ref2"
},
"priceC": {
"price": 122.300,
"adjustmentReferenceId": "25july_sku4-ref3"
},
"priceD": {
"price": 56.000,
"adjustmentReferenceId": "25july_sku4-ref4"
}
},
"evaluatedAt": "2025-07-25T11:58:55.034958Z",
"effects": [
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 1.999
},
"selectedPriceType": "priceB",
"selectedPrice": 19.990,
"adjustmentReferenceId": "25july_sku4-ref2",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "priceB",
"numberParameterPayload - price value": "19.990"
}
},
"selectedPriceType": "priceB",
"selectedPrice": 19.990,
"adjustmentReferenceId": "25july_sku4-ref2",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
}
]
},
{
"id": 5,
"catalogId": 1,
"sku": "25july_sku5",
"version": 1,
"price": 15.000,
"prices": {
"base": {
"price": 15.000
},
"priceC": {
"price": 27.000,
"adjustmentReferenceId": "25july_sku5-ref3",
"adjustmentEffectiveFrom": "2024-07-29T22:00:00Z",
"adjustmentEffectiveUntil": "2026-08-25T07:25:00Z"
},
"priceD": {
"price": 37.000,
"adjustmentReferenceId": "25july_sku5-ref4"
}
},
"evaluatedAt": "2025-07-25T11:58:55.034989Z",
"effects": [
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 1.5
},
"selectedPriceType": "base",
"selectedPrice": 15.000,
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "base",
"numberParameterPayload - price value": "15.000"
}
},
"selectedPriceType": "base",
"selectedPrice": 15.000,
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
}
]
},
{
"id": 6,
"catalogId": 1,
"sku": "25july_sku6",
"version": 1,
"price": 15.600,
"prices": {
"base": {
"price": 15.600
},
"priceA": {
"price": 11.600,
"adjustmentReferenceId": "25july_sku6-ref1"
},
"priceB": {
"price": 17.600,
"adjustmentReferenceId": "25july_sku6-ref2"
},
"priceC": {
"price": 27.600,
"adjustmentReferenceId": "25july_sku6-ref3"
},
"priceD": {
"price": 37.600,
"adjustmentReferenceId": "25july_sku6-ref4"
}
},
"evaluatedAt": "2025-07-25T11:58:55.035Z",
"effects": [
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 1.16
},
"selectedPriceType": "priceA",
"selectedPrice": 11.600,
"adjustmentReferenceId": "25july_sku6-ref1",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "priceA",
"numberParameterPayload - price value": "11.600"
}
},
"selectedPriceType": "priceA",
"selectedPrice": 11.600,
"adjustmentReferenceId": "25july_sku6-ref1",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
}
]
},
{
"id": 7,
"catalogId": 1,
"sku": "25july_sku7",
"version": 1,
"price": 15.700,
"prices": {
"base": {
"price": 15.700
},
"priceA": {
"price": 11.620,
"adjustmentReferenceId": "25july_sku7-ref9",
"adjustmentEffectiveFrom": "2025-07-24T22:00:00Z",
"adjustmentEffectiveUntil": "2025-07-25T12:00:00Z"
},
"priceB": {
"price": 17.620,
"adjustmentReferenceId": "25july_sku7-ref10",
"adjustmentEffectiveFrom": "2025-07-24T22:00:00Z",
"adjustmentEffectiveUntil": "2025-07-25T12:00:00Z"
},
"priceC": {
"price": 27.620,
"adjustmentReferenceId": "25july_sku7-ref11",
"adjustmentEffectiveFrom": "2025-07-24T22:00:00Z",
"adjustmentEffectiveUntil": "2025-07-25T12:00:00Z"
},
"priceD": {
"price": 37.620,
"adjustmentReferenceId": "25july_sku7-ref12",
"adjustmentEffectiveFrom": "2025-07-24T22:00:00Z",
"adjustmentEffectiveUntil": "2025-07-25T12:00:00Z"
}
},
"evaluatedAt": "2025-07-25T11:58:55.03497Z",
"effects": [
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "setDiscountPerItem",
"props": {
"name": "10% off per item",
"value": 1.162
},
"startTime": "2025-07-24T22:00:00Z",
"endTime": "2025-07-25T12:00:00Z",
"selectedPriceType": "priceA",
"selectedPrice": 11.620,
"adjustmentReferenceId": "25july_sku7-ref9",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
},
{
"campaignId": 1,
"rulesetId": 4,
"ruleIndex": 0,
"ruleName": "ST - 10% off + ce",
"type": "customEffectPerItem",
"props": {
"effectId": 1,
"name": "ce_item",
"payload": {
"stringParameterPayload - selected Price": "priceA",
"numberParameterPayload - price value": "11.620"
}
},
"startTime": "2025-07-24T22:00:00Z",
"endTime": "2025-07-25T12:00:00Z",
"selectedPriceType": "priceA",
"selectedPrice": 11.620,
"adjustmentReferenceId": "25july_sku7-ref9",
"targets": [
{
"type": "NONE"
},
{
"type": "AUDIENCE",
"audience": {
"id": 1
}
}
]
}
]
}
],
"NotificationType": "StrikethroughPrice"
}