The representation of the customer session.
Name | Type | Description | Notes |
---|---|---|---|
profileId | String | ID of the customer profile set by your integration layer. Note: If the customer does not yet have a known `profileId`, we recommend you use a guest `profileId`. | [optional] |
evaluableCampaignIds | List<Integer> | When using the `dry` query parameter, use this property to list the campaign to be evaluated by the Rule Engine. These campaigns will be evaluated, even if they are disabled, allowing you to test specific campaigns before activating them. | [optional] |
couponCodes | List<String> | Any coupon codes entered. Important: If you create a coupon budget for your campaign, ensure the session contains a coupon code by the time you close it. | [optional] |
referralCode | String | Any referral code entered. Important: If you create a referral budget for your campaign, ensure the session contains a referral code by the time you close it. | [optional] |
loyaltyCards | List<String> | Any loyalty cards used. | [optional] |
state | StateEnum | Indicates the current state of the session. Sessions can be created as `open` or `closed`. The state transitions are: 1. `open` → `closed` 2. `open` → `cancelled` 3. Either: - `closed` → `cancelled` (only via Update customer session) or - `closed` → `partially_returned` (only via Return cart items) - `closed` → `open` (only via Reopen customer session) 4. `partially_returned` → `cancelled` For more information, see Customer session states. | [optional] |
cartItems | List<CartItem> | The items to add to this sessions. - If cart item flattening is disabled: Do not exceed 1000 items (regardless of their `quantity`) per request. - If cart item flattening is enabled: Do not exceed 1000 items and ensure the sum of all cart item's `quantity` does not exceed 10.000 per request. | [optional] |
additionalCosts | Map<String, AdditionalCost> | Use this property to set a value for the additional costs of this session, such as a shipping cost. They must be created in the Campaign Manager before you set them with this property. See Managing additional costs. | [optional] |
identifiers | List<String> | Session custom identifiers that you can set limits on or use inside your rules. For example, you can use IP addresses as identifiers to potentially identify devices and limit discounts abuse in case of customers creating multiple accounts. See the tutorial. Important: Ensure the session contains an identifier by the time you close it if: - You create a unique identifier budget for your campaign. - Your campaign has coupons. | [optional] |
attributes | Object | Use this property to set a value for the attributes of your choice. Attributes represent any information to attach to your session, like the shipping city. You can use built-in attributes or custom ones. Custom attributes must be created in the Campaign Manager before you set them with this property. | [optional] |
Name | Value |
---|---|
OPEN | "open" |
CLOSED | "closed" |
PARTIALLY_RETURNED | "partially_returned" |
CANCELLED | "cancelled" |