Skip to content

Latest commit

 

History

History
33 lines (22 loc) · 4.58 KB

NewCustomerSessionV2.md

File metadata and controls

33 lines (22 loc) · 4.58 KB

NewCustomerSessionV2

The representation of the customer session.

Properties

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]

Enum: StateEnum

Name Value
OPEN "open"
CLOSED "closed"
PARTIALLY_RETURNED "partially_returned"
CANCELLED "cancelled"