# Cart Schema

Map an Engagement Mobile SDK cart event to the cart schema.

| Source Event Property                                                                                                                                              | Target Schema Developer Name                                              | Field Type | Description                                                                                                                                                                            | Customer 360 Data Model Object / Attribute          |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| Automatically Assigned                                                                                                                                             | `eventId`                                                                 | text       | **Required**. Typically, the primary key for the engagement events.                                                                                                                    | Engagement / Engagement Id                          |
| Automatically Assigned                                                                                                                                             | `dateTime`                                                                | datetime   | **Required**. Used for data partitioning for engagement events. ISO8601 supported format.                                                                                              | Engagement / Engagement Date Time                   |
| Automatically Assigned                                                                                                                                             | `eventType = "cart"`                                                      | text       | **Required**. The `developerName` of an event defined in the [Web Connector schema](https://help.salesforce.com/s/articleView?id=c360_a_mobile_web_sdk_schema_quick_guide.htm&type=5). | -                                                   |
| Automatically Assigned                                                                                                                                             | `sessionId`                                                               | text       | **Required**. The session identifier.                                                                                                                                                  | -                                                   |
| Automatically Assigned                                                                                                                                             | `deviceId`                                                                | text       | **Required**. Typically, the primary key for profile events.                                                                                                                           | Shopping Cart Engagement / Individual               |
| Automatically Assigned                                                                                                                                             | `category = "Engagement"`                                                 | text       | **Required**. Possible values are: <ul><li>`Engagement`</li><li>`Profile`</li></ul>                                                                                                    | -                                                   |
| Automatically Assigned                                                                                                                                             | `interactionName = "Add To Cart" \| "Remove From Cart" \| "Replace Cart"` | text       | **Required**. An event’s descriptive name.                                                                                                                                             | Shopping Cart Engagement / Shopping Cart Event Type |
| Automatically Assigned                                                                                                                                             | `channel = "mobile"`                                                      | text       | The SDK event channel. For Engagement Mobile SDK, the value is `mobile`.                                                                                                               | Engagement / Engagement Channel Type                |
| Automatically Assigned when [Location Tracking](/docs/data/data-cloud-engagement-mobile-sdk/guide/c360a-api-engagement-mobile-sdk-location-tracking.md) is allowed | `longitude`                                                               | number     | The longitudinal coordinate, in decimal degrees, reported by the device at the time the event was captured.                                                                            | Device Longitude                                    |
| Automatically Assigned when [Location Tracking](/docs/data/data-cloud-engagement-mobile-sdk/guide/c360a-api-engagement-mobile-sdk-location-tracking.md) is allowed | `latitude`                                                                | number     | The latitudinal coordinate, in decimal degrees, reported by the device at the time the event was captured.                                                                             | Device Latitude                                     |

Each [Line Item Attribute](/docs/data/data-cloud-engagement-mobile-sdk/guide/c360a-api-engagement-mobile-sdk-line-item-attribute.md) contained in the [Cart Event](/docs/data/data-cloud-engagement-mobile-sdk/guide/c360a-api-engagement-mobile-sdk-cart-event.md) is mapped to a child event where `cartEventId` is set to the parent `cart` event’s `eventId`.

| Source Event Property              | Target Schema Developer Name | Field Type | Description                                                                                                                                                                            | Customer 360 Data Model Object / Attribute                  |
| ---------------------------------- | ---------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| Automatically Assigned             | `eventId`                    | text       | **Required**. Typically, the primary key for the engagement events.                                                                                                                    | -                                                           |
| Automatically Assigned             | `dateTime`                   | datetime   | **Required**. Used for data partitioning for engagement events. ISO8601 supported format.                                                                                              | -                                                           |
| Automatically Assigned             | `eventType = "cartItem"`     | text       | **Required**. The `developerName` of an event defined in the [Web Connector schema](https://help.salesforce.com/s/articleView?id=c360_a_mobile_web_sdk_schema_quick_guide.htm&type=5). | -                                                           |
| Automatically Assigned             | `sessionId`                  | text       | **Required**. The session identifier.                                                                                                                                                  | -                                                           |
| Automatically Assigned             | `deviceId`                   | text       | **Required**. Typically, the primary key for profile events.                                                                                                                           | -                                                           |
| Automatically Assigned             | `category = "Engagement"`    | text       | **Required**. Possible values are: <ul><li>`Engagement`</li><li>`Profile`</li></ul>                                                                                                    | -                                                           |
| Automatically Assigned             | `cartEventId`                | text       | **Required**. The `eventId` of the cart event containing the line item.                                                                                                                | Shopping Cart Product Engagement / Shopping Cart Engagement |
| `lineItem.catalogObjectType`       | `catalogObjectType`          | text       | **Required**. A type name of the catalog object referenced in the line item.                                                                                                           | Shopping Cart Product Engagement / Product Category         |
| `lineItem.catalogObjectId`         | `catalogObjectId`            | text       | **Required**. A unique identifier representing the catalog object referenced in the line item.                                                                                         | Shopping Cart Product Engagement / Product                  |
| `lineItem.quantity`                | `quantity`                   | number     | The number of catalog objects in the line item.                                                                                                                                        | Shopping Cart Product Engagement / Product Quantity         |
| `lineItem.price`                   | `price`                      | number     | The price of the catalog object referenced in the line item.                                                                                                                           | Shopping Cart Product Engagement / Product Price            |
| `lineItem.currency`                | `currency`                   | text       | The currency for the price field.                                                                                                                                                      | Shopping Cart Product Engagement / Currency                 |
| `lineItem.attributes.customField0` | `attributeCustomField0`      | any        | A user-supplied value.                                                                                                                                                                 | -                                                           |
| `lineItem.attributes.customFieldN` | `attributeCustomFieldN`      | any        | A user-supplied value.                                                                                                                                                                 | -                                                           |

:::note
Properties added to `lineItem.attributes` aren’t automatically defined in the recommended schema. They’re shown to demonstrate how the source properties are mapped to the target schema. You must manually add the properties to the schema.
:::