--- schema_version: "1" id: 3ac2ee85edfc277125d1972c863b6e209b72b114dab090ee255c8236831e45b1 title: Translation of SDK Events to Web Connector Schemas collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/interactions-sdk/guides/c360a-api-translating-sdk-events-to-web-connector-schemas.md canonical_url: https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-translating-sdk-events-to-web-connector-schemas.html source_site: developer.salesforce.com content_type: documentation content_hash: 6b7f788dfe17854dfc34b9eb315dc37f7efaf9c9dc870728ba3def0b552d1205 products: - Salesforce Interactions SDK - Data 360 Developer Documentation --- # Translation of SDK Events to Web Connector Schemas Understanding how data from the Salesforce Interactions SDK is transformed for ingestion into Data 360 can be useful for troubleshooting instrumentation code and for extending your Web Connector schema to capture data not covered by the recommended schema. ## Automatic Population of Required Data 360 Fields The Data 360 event beacon currently injects a set of mandatory fields into every event payload. | Source Event Property | Target Schema Developer Name | Field Type | Description | | --------------------- | ---------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | - | `category` | text | **Required**. Use to define if the category is `Engagement` or `Profile`. | | - | `dateTime` | datetime | **Required**. Supports `yyyy-MM-dd'T'HH:mm:ss.SSS'Z'` format only. Important for engagement events since they’re used for data partitioning. | | - | `deviceId` | text | **Required**. The primary key for profile events. | | - | `eventId` | text | **Required**. The primary key for engagement events. | | - | `eventType` | text | **Required**. The `developerName` of an event defined in the [Web Connector schema](https://developer.salesforce.com/docs/atlas.en-us.c360a_api.meta/c360a_api/c360a_api_salesforce_cdp_module_of_the_salesforce_web_sdk.htm). | | - | `sessionId` | text | **Required**. An identifier for a session. | The Data 360 Module automatically sets these fields on events sent to Data 360. You don’t have to specify them except in certain cases like Profile Event Routing or when you're working with Custom Events when `eventType` can’t automatically be determined. ## Automatic Population of Salesforce Web SDK Fields Salesforce Interactions SDK automatically captures several fields as part of its [Event Structure](https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-event-structure.md). These fields are automatically attached to all profile and engagement events. | Source Event Property | Target Schema Developer Name | Field Type | Description | | --------------------- | ---------------------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `interaction.name` | `interactionName` | text | **Required**. A descriptive name for the interaction. | | `pageView` | `pageView` | number | The Salesforce Interactions SDK assigns a value of either `1` (true) or `0` (false). The value indicates if an event was triggered as part of a page load or from the user interacting with the page. | | `source.channel` | `sourceChannel` | text | The SDK channel the event was collected with. For the Salesforce Interactions SDK, this value is `Web`. | | `source.locale` | `sourceLocale` | text | The locale of the current page as an ISO 639 alpha-2 language code and ISO 3166 alpha-2 country code. For example, `en_US` or `de_DE`. | | `source.pageType` | `sourcePageType` | text | When an event is collected via the sitemap, this is the `pageType` of the matching configuration that triggered the event. | | `source.url` | `sourceUrl` | text | The URL of the page the event is being sent from. | | `source.urlReferrer` | `sourceUrlReferrer` | text | The previous URL visited by the user. When used, only the domain name is included in the request. If the URL entered is also used in a redirect, Salesforce shows an error message. | ## Cart Interaction Mapping An Event Structure containing a [Cart Interaction](https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-cart-interaction.md) is mapped to this schema: | Source Event Property | Target Schema Developer Name | Field Type | Description | | --------------------- | ---------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | - | `category = "Engagement"` | text | **Required**. Use to define if the category is `Engagement` or `Profile`. | | - | `dateTime` | datetime | **Required**. Supports `yyyy-MM-dd'T'HH:mm:ss.SSS'Z'` format only. Important for engagement events since they’re used for data partitioning. | | - | `deviceId` | text | **Required**. The primary key for profile events. | | - | `eventId` | text | **Required**. The primary key for engagement events. | | - | `eventType = "cart"` | text | **Required**. The `developerName` of an event defined in the [Web Connector schema](https://developer.salesforce.com/docs/atlas.en-us.c360a_api.meta/c360a_api/c360a_api_salesforce_cdp_module_of_the_salesforce_web_sdk.htm). | | - | `sessionId` | text | **Required**. An identifier for a session. | | `interaction.name` | `interactionName` | text | **Required**. A descriptive name for the interaction. | | `pageView` | `pageView` | number | The Salesforce Interactions SDK assigns a value of either `1` (true) or `0` (false). The value indicates if an event was triggered as part of a page load or from the user interacting with the page. | | `source.channel` | `sessionId` | text | The SDK channel the event was collected with. For the Salesforce Interactions SDK, this value is `Web`. | | `source.locale` | `sourceLocale` | text | The locale of the current page as an ISO 639 alpha-2 language code and ISO 3166 alpha-2 country code. For example, `en_US` or `de_DE`. | | `source.pageType` | `sourcePageType` | text | When an event is collected via the sitemap, this is the `pageType` of the matching configuration that triggered the event. | | `source.url` | `sourceUrl` | text | The URL of the page the event is being sent from. | | `source.urlReferrer` | `sourceUrlReferrer` | text | The previous URL visited by the user. When used, only the domain name is included in the request. If the URL entered is also used in a redirect, Salesforce shows an error message. | Each [Line Item Data](https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-line-item-data.md) contained in the [Cart Interaction](https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-cart-interaction.md) fields `interaction.lineItem` or `interaction.lineItems` gets mapped to a child event where `cartEventId` is set to the `eventId` of the parent `cart` event: | Source Event Property | Target Schema Developer Name | Field Type | Description | | ---------------------------------- | ---------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | - | `cartEventId` | text | **Required**. The `eventId` of the Cart Event containing this line item. | | - | `category = "Engagement"` | text | **Required**. Use to define if the category is `Engagement` or `Profile`. | | - | `dateTime` | datetime | **Required**. Supports `yyyy-MM-dd'T'HH:mm:ss.SSS'Z'` format only. Important for engagement events since they’re used for data partitioning. | | - | `deviceId` | text | **Required**. The primary key for profile events. | | - | `eventId` | text | **Required**. The primary key for engagement events. | | - | `eventType = "cartItem"` | text | **Required**. The `developerName` of an event defined in the [Web Connector schema](https://developer.salesforce.com/docs/atlas.en-us.c360a_api.meta/c360a_api/c360a_api_salesforce_cdp_module_of_the_salesforce_web_sdk.htm). | | - | `sessionId` | text | **Required**. An identifier for a session. | | `interaction.name` | `interactionName` | text | **Required**. A descriptive name for the interaction. | | `lineItem.attributes.customFieldN` | `attributeCustomFieldN` | any | A user-supplied value. | | `lineItem.attributes.customField0` | `attributeCustomField0` | any | A user-supplied value. | | `lineItem.catalogObjectId` | `catalogObjectId` | text | **Required**. A unique identifier representing the catalog object referenced in the line item. | | `lineItem.catalogObjectType` | `catalogObjectType` | text | **Required**. A type name representing the catalog object referenced in the line item. | | `lineItem.currency` | `currency` | text | The currency for the price field. | | `lineItem.price` | `price` | number | The price of the catalog object referenced in the line item. | | `lineItem.quantity` | `quantity` | number | The number of catalog objects in this line item. | **note:** Properties added to `lineItem.attributes` aren’t automatically defined in the recommended schema. To capture this data, manually add these properties to the schema. These properties are shown here just to demonstrate how the source properties are mapped to the target schema. ## Catalog Interaction Mapping An [Event Structure](https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-event-structure.md) containing a [Catalog Interaction](https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-catalog-interaction.md) is mapped to this schema: | Source Event Property | Target Schema Developer Name | Field Type | **Description** | | --------------------------------------------------------- | ------------------------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | - | `category = "Engagement"` | text | **Required**. Use to define if the category is `Engagement` or `Profile`. | | - | `dateTime` | datetime | **Required**. Supports `yyyy-MM-dd'T'HH:mm:ss.SSS'Z'` format only. Important for engagement events since they’re used for data partitioning. | | - | `deviceId` | text | **Required**. The primary key for profile events. | | - | `eventId` | text | **Required**. The primary key for engagement events. | | - | `eventType = "catalog"` | text | **Required**. The `developerName` of an event defined in the [Web Connector schema](https://developer.salesforce.com/docs/atlas.en-us.c360a_api.meta/c360a_api/c360a_api_salesforce_cdp_module_of_the_salesforce_web_sdk.htm). | | - | `sessionId` | text | **Required**. An identifier for a session. | | `interaction.catalogObject.attributes.customFieldN` | `attributeCustomFieldN` | any | A user-supplied value. | | `interaction.catalogObject.attributes.customField0` | `attributeCustomField0` | any | A user-supplied value. | | `interaction.catalogObject.id` | `id` | text | **Required**. A unique ID representing the catalog object. | | `interaction.catalogObject.relatedCatalogObjects.Example` | `relatedCatalogObjectExample0` | any | The first value in a list of related catalog object IDs. | | `interaction.catalogObject.type` | `type` | text | **Required**. A type name representing the catalog object. | | `interaction.name` | `interactionName` | text | **Required**. A descriptive name for the interaction. | | `pageView` | `pageView` | number | The Salesforce Interactions SDK assigns a value of either `1` (true) or `0` (false). The value indicates if an event was triggered as part of a page load or from the user interacting with the page. | | `source.channel` | `sessionId` | text | The SDK channel the event was collected with. For the Salesforce Interactions SDK, this value is `Web`. | | `source.locale` | `sourceLocale` | text | The locale of the current page as an ISO 639 alpha-2 language code and ISO 3166 alpha-2 country code. For example, `en_US` or `de_DE`. | | `source.pageType` | `sourcePageType` | text | When an event is collected via the sitemap, this is the `pageType` of the matching configuration that triggered the event. | | `source.url` | `sourceUrl` | text | The URL of the page the event is being sent from. | | `source.urlReferrer` | `sourceUrlReferrer` | text | The previous URL visited by the user. When used, only the domain name is included in the request. If the URL entered is also used in a redirect, Salesforce shows an error message. | | ... | `relatedCatalogObjectExampleN` | any | The nth value in a list of related catalog object IDs. | **note:** Properties added to `interaction.catalogObject.attributes` and `interaction.catalogObject.relatedCatalogObjects` aren’t automatically defined in the recommended schema. To capture this data, manually add these properties to the schema. These properties are shown here just to demonstrate how the source properties are mapped to the target schema. ## Order Interaction Mapping An [Event Structure](https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-event-structure.md) containing an [Order Interaction](https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-order-interaction.md) is mapped to this schema: | Source Event Property | Target Schema Developer Name | Field Type | Description | | ------------------------------------------- | ---------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | - | `category = "Engagement"` | text | **Required**. Use to define if the category is `Engagement` or `Profile`. | | - | `dateTime` | datetime | **Required**. Supports `yyyy-MM-dd'T'HH:mm:ss.SSS'Z'` format only. Important for engagement events since they’re used for data partitioning. | | - | `deviceId` | text | **Required**. The primary key for profile events. | | - | `eventId` | text | **Required**. The primary key for engagement events. | | - | `eventType = "order"` | text | **Required**. The `developerName` of an event defined in the [Web Connector schema](https://developer.salesforce.com/docs/atlas.en-us.c360a_api.meta/c360a_api/c360a_api_salesforce_cdp_module_of_the_salesforce_web_sdk.htm). | | - | `sessionId` | text | **Required**. An identifier for a session. | | `interaction.name` | `interactionName` | text | **Required**. A descriptive name for the interaction. | | `interaction.order.currency` | `orderCurrency` | text | The currency of the total value for the order. | | `interaction.order.attributes.customFieldN` | `attributeCustomFieldN` | any | A user-supplied value. | | `interaction.order.attributes.customField0` | `attributeCustomField0` | any | A user-supplied value. | | `interaction.order.id` | `orderId` | text | A unique identifier representing the order. | | `interaction.order.totalValue` | `orderTotalValue` | number | The total value of the order. | | `pageView` | `pageView` | number | The Salesforce Interactions SDK assigns a value of either `1` (true) or `0` (false). The value indicates if an event was triggered as part of a page load or from the user interacting with the page. | | `source.channel` | `sessionId` | text | The SDK channel the event was collected with. For the Salesforce Interactions SDK, this value is `Web`. | | `source.locale` | `sourceLocale` | text | The locale of the current page as an ISO 639 alpha-2 language code and ISO 3166 alpha-2 country code. For example, `en_US` or `de_DE`. | | `source.pageType` | `sourcePageType` | text | When an event is collected via the sitemap, this is the `pageType` of the matching configuration that triggered the event. | | `source.url` | `sourceUrl` | text | The URL of the page the event is being sent from. | | `source.urlReferrer` | `sourceUrlReferrer` | text | The previous URL visited by the user. When used, only the domain name is included in the request. If the URL entered is also used in a redirect, Salesforce shows an error message. | Each [Line Item Data](https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-line-item-data.md) contained in the [Order Interaction](https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-order-interaction.md) field `interaction.order.lineItems` gets mapped to a child event where `orderEventId` is set to the `eventId` of the parent `order` event: | Source Event Property | Target Schema Developer Name | Field Type | Description | | ---------------------------------- | ---------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | - | `category = "Engagement"` | text | **Required**. Use to define if the category is `Engagement` or `Profile`. | | - | `dateTime` | datetime | **Required**. Supports `yyyy-MM-dd'T'HH:mm:ss.SSS'Z'` format only. Important for engagement events since they’re used for data partitioning. | | - | `eventId` | text | **Required**. The primary key for engagement events. | | - | `eventType = "order"` | text | **Required.** The `developerName` of an event defined in the [Web Connector schema](https://developer.salesforce.com/docs/atlas.en-us.c360a_api.meta/c360a_api/c360a_api_salesforce_cdp_module_of_the_salesforce_web_sdk.htm). | | - | `deviceId` | text | **Required.** The primary key for profile events. | | - | `orderEventId` | text | **Required.** The `eventId` of the Order Event containing this line item. | | - | `sessionId` | text | **Required.** An identifier for a session. | | `lineItem.attributes.customFieldN` | `attributeCustomFieldN` | any | A user-supplied value. | | `lineItem.attributes.customField0` | `attributeCustomField0` | any | A user-supplied value. | | `lineItem.catalogObjectId` | `catalogObjectId` | text | **Required.** A unique identifier representing the catalog object referenced in the line item. | | `lineItem.catalogObjectType` | `catalogObjectType` | text | **Required**. A type name representing the catalog object referenced in the line item. | | `lineItem.currency` | `currency` | text | The currency for the price field. | | `lineItem.price` | `price` | number | The price of the catalog object referenced in the line item. | | `lineItem.quantity` | `quantity` | number | The number of catalog objects in this line item. | **note:** The properties added to `lineItem.attributes` aren’t automatically defined in the recommended schema. To capture this data, manually add these properties to the schema. These properties are shown here just to demonstrate how the source properties are mapped to the target schema. ## Consent Event Mapping Each [Consent Data](https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-consent-data.md) contained in the [Event Structure](https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-event-structure.md) `consents` field are mapped to this schema: | Source Event Property | Target Schema Developer Name | Field Type | Description | | --------------------- | ---------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | - | `category = "Engagement"` | text | **Required.** Use to define if the category is `Engagement` or `Profile`. | | - | `dateTime` | datetime | **Required.** Supports `yyyy-MM-dd'T'HH:mm:ss.SSS'Z'` format only. Important for engagement events since they’re used for data partitioning. | | - | `deviceId` | text | **Required.** The primary key for profile events. | | - | `eventId` | text | **Required.** The primary key for engagement events. | | - | `eventType = "consentLog"` | text | **Required.** The `developerName` of an event defined in the [Web Connector schema](https://developer.salesforce.com/docs/atlas.en-us.c360a_api.meta/c360a_api/c360a_api_salesforce_cdp_module_of_the_salesforce_web_sdk.htm). | | - | `sessionId` | text | **Required.** An identifier for a session. | | `consent.provider` | `provider` | text | **Required.** A named identifier indicating the consent management system providing the consent to the SDK. | | `consent.purpose` | `purpose` | text | What the user is consenting to. For example, `Tracking`. | | `consent.status` | `status` | text | Values: `Opt In` or `Opt Out` | ## Profile Event Mapping An [Event Structure](https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-event-structure.md) containing a [User Data](https://developer.salesforce.com/docs/data/salesforce-interactions-sdk/guide/c360a-api-user-data.md) is mapped to this schema: | Source Event Property | Target Schema Developer Name | Field Type | Description | | ------------------------------ | ---------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | - | `category = "Profile"` | text | **Required.** Use to define if the category is `Engagement` or `Profile`. | | - | `dateTime` | datetime | **Required.** Supports `yyyy-MM-dd'T'HH:mm:ss.SSS'Z'` format only. Important for engagement events since they’re used for data partitioning. | | - | `deviceId` | text | **Required.** The primary key for profile events. | | - | `eventId` | text | **Required.** The primary key for engagement events. | | - | `sessionId` | text | **Required.** An identifier for a session. | | `interaction.name` | `interactionName` | text | **Required.** A descriptive name for the interaction | | `pageView` | `pageView` | text | The Salesforce Interactions SDK sets a true or false value. The value indicates if an event was triggered as part of a page load or from the user interacting with the page. | | `source.channel` | `sessionId` | text | The SDK channel the event was collected with. For the Salesforce Interactions SDK, this value is `Web`. | | `source.locale` | `sourceLocale` | text | The locale of the current page as an ISO 639 alpha-2 language code and ISO 3166 alpha-2 country code. For example, `en_US` or `de_DE`. | | `source.pageType` | `sourcePageType` | text | When an event is collected via the sitemap, this is the `pageType` of the matching configuration that triggered the event. | | `source.url` | `sourceUrl` | text | The URL of the page the event is being sent from. | | `source.urlReferrer` | `sourceUrlReferrer` | text | The previous URL visited by the user. When used, only the domain name is included in the request. If the URL entered is also used in a redirect, Salesforce shows an error message. | | `user.attributes.customFieldN` | `customFieldN` | any | A user-supplied value. | | `user.attributes.customField0` | `customField0` | any | A user-supplied value. | | `user.attributes.eventType` | `eventType` | text | **Required.** The `developerName` of an event defined in the [Web Connector schema](https://developer.salesforce.com/docs/atlas.en-us.c360a_api.meta/c360a_api/c360a_api_salesforce_cdp_module_of_the_salesforce_web_sdk.htm). | **note:** Properties added to the `user.attributes.eventType` field are required. ## Contact Point Email Mapping | Source Event Property | Target Schema Developer Name | Field Type | Description | | --------------------------- | --------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | - | `dateTime` | datetime | **Required**. Supports `yyyy-MM-dd'T'HH:mm:ss.SSS'Z'` format only. Important for engagement events since they’re used for data partitioning. | | - | `eventId` | text | **Required**. The primary key for engagement events. | | `user.attributes.eventType` | `eventType = "contactPointEmail"` | text | **Required**. The `developerName` of an event defined in the [Web Connector schema](https://developer.salesforce.com/docs/atlas.en-us.c360a_api.meta/c360a_api/c360a_api_salesforce_cdp_module_of_the_salesforce_web_sdk.htm). | | - | `sessionId` | text | **Required**. An identifier for a session. | | - | `deviceId` | text | **Required**. The primary key for profile events. | | - | `category = "Profile"` | text | **Required**. Use to define if the category is `Engagement` or `Profile`. | | `interaction.name` | `interactionName` | text | **Required**. A descriptive name for the interaction | | `pageView` | `pageView` | number | The Salesforce Interactions SDK assigns a value of either `1` (true) or `0` (false). The value indicates if an event was triggered as part of a page load or from the user interacting with the page. | | `source.channel` | `sessionId` | text | The SDK channel the event was collected with. For the Salesforce Interactions SDK, this value is `Web`. | | `source.locale` | `sourceLocale` | text | The locale of the current page as an ISO 639 alpha-2 language code and ISO 3166 alpha-2 country code. For example, `en_US` or `de_DE`. | | `source.pageType` | `sourcePageType` | text | When an event is collected via the sitemap, this is the `pageType` of the matching configuration that triggered the event. | | `source.url` | `sourceUrl` | text | The URL of the page the event is being sent from. | | `source.urlReferrer` | `sourceUrlReferrer` | text | The previous URL visited by the user. When used, only the domain name is included in the request. If the URL entered is also used in a redirect, Salesforce shows an error message. | | `user.attributes.email` | `email` | text | The email address of the user. | | `user.attributes.eventType` | `eventType = "contactPointEmail"` | text | **Required**. The `developerName` of an event defined in the [Web Connector schema](https://developer.salesforce.com/docs/atlas.en-us.c360a_api.meta/c360a_api/c360a_api_salesforce_cdp_module_of_the_salesforce_web_sdk.htm). | ## Contact Point Phone Mapping | Source Event Property | Target Schema Developer Name | Field Type | Description | | ----------------------------- | --------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | - | `category = "Profile"` | text | **Required.** Use to define if the category is `Engagement` or `Profile`. | | - | `dateTime` | datetime | **Required.** Supports `yyyy-MM-dd'T'HH:mm:ss.SSS'Z'` format only. Important for engagement events since they’re used for data partitioning. | | - | `deviceId` | text | **Required.** The primary key for profile events. | | - | `eventId` | text | **Required.** The primary key for engagement events. | | - | `sessionId` | text | **Required.** An identifier for a session. | | `interaction.name` | `interactionName` | text | **Required.** A descriptive name for the interaction | | `pageView` | `pageView` | number | The Salesforce Interactions SDK assigns a value of either `1` (true) or `0` (false). The value indicates if an event was triggered as part of a page load or from the user interacting with the page. | | `source.channel` | `sessionId` | text | The SDK channel the event was collected with. For the Salesforce Interactions SDK, this value is `Web`. | | `source.locale` | `sourceLocale` | text | The locale of the current page as an ISO 639 alpha-2 language code and ISO 3166 alpha-2 country code. For example, `en_US` or `de_DE`. | | `source.pageType` | `sourcePageType` | text | When an event is collected via the sitemap, this is the `pageType` of the matching configuration that triggered the event. | | `source.url` | `sourceUrl` | text | The URL of the page the event is being sent from. | | `source.urlReferrer` | `sourceUrlReferrer` | text | The previous URL visited by the user. When used, only the domain name is included in the request. If the URL entered is also used in a redirect, Salesforce shows an error message. | | `user.attributes.eventType` | `eventType = "contactPointPhone"` | text | **Required**. The `developerName` of an event defined in the [Web Connector schema](https://developer.salesforce.com/docs/atlas.en-us.c360a_api.meta/c360a_api/c360a_api_salesforce_cdp_module_of_the_salesforce_web_sdk.htm). | | `user.attributes.phoneNumber` | `phoneNumber` | text | **Required.** The phone number for the user. | ## Identity Mapping | Source Event Property | Target Schema Developer Name | Field Type | Description | | ----------------------------- | ---------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | - | `category = "Profile"` | text | **Required.** Use to define if the category is `Engagement` or `Profile`. | | - | `dateTime` | datetime | **Required.** Supports `yyyy-MM-dd'T'HH:mm:ss.SSS'Z'` format only. Important for engagement events since they’re used for data partitioning. | | - | `deviceId` | text | **Required.** The primary key for profile events. | | - | `eventId` | text | **Required.** The primary key for engagement events. | | - | `sessionId` | text | **Required.** An identifier for a session. | | `interaction.name` | `interactionName` | text | **Required.** A descriptive name for the interaction | | `pageView` | `pageView` | number | The Salesforce Interactions SDK assigns a value of either `1` (true) or `0` (false). The value indicates if an event was triggered as part of a page load or from the user interacting with the page. | | `source.channel` | `sessionId` | text | The SDK channel the event was collected with. For the Salesforce Interactions SDK, this value is `Web`. | | `source.locale` | `sourceLocale` | text | The locale of the current page as an ISO 639 alpha-2 language code and ISO 3166 alpha-2 country code. For example, `en_US` or `de_DE`. | | `source.pageType` | `sourcePageType` | text | When an event is collected via the sitemap, this is the `pageType` of the matching configuration that triggered the event. | | `source.url` | `sourceUrl` | text | The URL of the page the event is being sent from. | | `source.urlReferrer` | `sourceUrlReferrer` | text | The previous URL visited by the user. When used, only the domain name is included in the request. If the URL entered is also used in a redirect, Salesforce shows an error message. | | `user.attributes.eventType` | `eventType = "identity"` | text | **Required.** The `developerName` of an event defined in the [Web Connector schema](https://developer.salesforce.com/docs/atlas.en-us.c360a_api.meta/c360a_api/c360a_api_salesforce_cdp_module_of_the_salesforce_web_sdk.htm). | | `user.attributes.firstName` | `firstName` | text | **Required.** The user’s first name. | | `user.attributes.isAnonymous` | `isAnonymous` | text | **Required.** A value that indicates whether this profile event identifies a known user or an anonymous user. For example, a value of `0` to indicate an anonymous user and `1` to indicate a known user. | | `user.attributes.lastName` | `lastName` | text | **Required.** The user’s last name. | ## Party Identification Mapping | Source Event Property | Target Schema Developer Name | Field Type | Description | | --------------------------- | ----------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | - | `category = "Profile"` | text | **Required.** Use to define if the category is `Engagement` or `Profile`. | | - | `dateTime` | datetime | **Required.** Supports `yyyy-MM-dd'T'HH:mm:ss.SSS'Z'` format only. Important for engagement events since they’re used for data partitioning. | | - | `deviceId` | text | **Required.** The primary key for profile events. | | - | `eventId` | text | **Required.** The primary key for engagement events. | | - | `sessionId` | text | **Required.** An identifier for a session. | | `interaction.name` | `interactionName` | text | **Required.** A descriptive name for the interaction | | `pageView` | `pageView` | number | The Salesforce Interactions SDK assigns a value of either `1` (true) or `0` (false). The value indicates if an event was triggered as part of a page load or from the user interacting with the page. | | `source.channel` | `sessionId` | text | The SDK channel the event was collected with. For the Salesforce Interactions SDK, this value is `Web`. | | `source.locale` | `sourceLocale` | text | The locale of the current page as an ISO 639 alpha-2 language code and ISO 3166 alpha-2 country code. For example, `en_US` or `de_DE`. | | `source.pageType` | `sourcePageType` | text | When an event is collected via the sitemap, this is the `pageType` of the matching configuration that triggered the event. | | `source.url` | `sourceUrl` | text | The URL of the page the event is being sent from. | | `source.urlReferrer` | `sourceUrlReferrer` | text | The previous URL visited by the user. When used, only the domain name is included in the request. If the URL entered is also used in a redirect, Salesforce shows an error message. | | `user.attributes.eventType` | `eventType = "partyIdentification"` | text | The `developerName` of an event defined in the [Web Connector schema](https://developer.salesforce.com/docs/atlas.en-us.c360a_api.meta/c360a_api/c360a_api_salesforce_cdp_module_of_the_salesforce_web_sdk.htm) | | `user.attributes.IDNameWeb` | `IDNameWeb` | text | **Required.** The party identification name. | | `user.attributes.IDType` | `IDType` | text | **Required.** The party identification type. | | `user.attributes.userId` | `userId` | text | **Required.** The user identifier in the party. |