Event Structure

The Salesforce Interactions Web SDK captures every customer interaction and behavior through a standardized event structure. Each event combines system-generated properties and context (automatically set by the SDK) and developer-defined data (set by you) to build comprehensive customer profiles and track meaningful interactions.

Every event captured by the Salesforce Interactions Web SDK follows a consistent structure with these properties.

The interaction, user, and account fields are your responsibility to populate when sending an event. These fields contain core data about the customer and their interactions.

interaction

This field captures the customer's engagement event data. At a minimum, an interaction requires a valid name value. The SDK supports several specialized interaction types that map to Data 360's unified data model:

• Cart Interaction
• Catalog Interaction
• Order Interaction

user

This field captures the individual user's profile data (for example, email, loyalty ID, and first name). This data is crucial for user identification and profile enrichment.

account

This field captures profile data at the account level. Use this to group interactions across multiple individual users belonging to the same company or account.

Salesforce Interactions SDK automatically populates these fields for every event, providing necessary context and tracking identifiers.

• source

  • : This field provides the context of the event, including the page url, the channel (always Web when using the Interactions SDK), and the current locale.

• time

  • : The precise server timestamp of the event capture.

  Note: The dateTime value is derived from the user’s browser/client clock (generated in UTC ISO-8601 format using JavaScript Date(...).toISOString()). If the user’s device time is incorrect or unsynced, this value can be skewed significantly (past/future).

• pageView

  • : A flag indicating if the event was part of the initial page load process.

• consents

  • : An array containing the current consent status, which is included automatically when the status changes or on the first event after initialization.

This example shows how a call to SalesforceInteractions.sendEvent() is expanded by the Interactions SDK into the complete, verbose event object containing all system-generating tracking and contextual data.

This call captures behavioral (interaction) and profile (user) data from a site instrumented using the Interactions SDK.

1SalesforceInteractions.sendEvent({
2  interaction: {
3    name: "View Catalog Object",
4    catalogObject: {
5      type: "Product",
6      id: "product-1",
7    },
8  },
9  user: {
10    attributes: {
11      email: "user@domain.com",
12    },
13  },
14});

Here’s what the complete, captured event structure looks like, including all automatically-included fields.

1{
2  interaction: {
3    name: "View Catalog Object",
4    catalogObject: {
5      type: "Product",
6      id: "product-1"
7    }
8  },
9  source: {
10    pageType: "homepage",
11    url: "https://my.domain.com/home",
12    urlReferrer: "https://my.domain.com/search",
13    channel: "Web",
14    locale: "en_US"
15  },
16  user: {
17    anonymousId: "aa19dc4fcdc636d8", // Automatically assigned by the SDK
18    attributes: {
19      email: "user@domain.com"
20    }
21  },
22  consents: [{
23    purpose: 'Tracking',
24    provider: 'Example Provider',
25    status: 'Opt In',
26  }]
27  pageView: 0, // Automatically set by the SDK
28  time: 1628700769593 // Automatically set timestamp
29}

See Also

• Translation of SDK Events to Web Connector Schemas
• Custom Events

j

Capture Web Interactions

Event Specifications

Event Structure

Cart Interaction

Catalog Interaction

Order Interaction

Line Item Data

User Data

Account Data

Consent Data

API Reference

Data 360 Module of the Salesforce Interactions SDK