Initializing a session

The defaultInteraction parameter

Version:

The defaultInteraction parameter enables you to construct a session that will automatically create interaction on a TrackEvent request if needed. The Interaction ID will be automatically saved and used for future event requests.

For example, to create a defaultInteraction object and pass it to a session:


var defaultInteraction = UTEntitiesBuilder.Interaction()
                                          .ChannelId("27b4e611-a73d-4a95-b20a-811d295bdf65")
                                          .Initiator(InteractionInitiator.Contact)
                                          .Contact("jsdemo", "demo")
                                          .Build();

var session = SitecoreUTSessionBuilder.SessionWithHost("https://mysite.com")
                                      .DefaultInteraction(defaultInteraction)
                                      .BuildSession();

You can reset the current Interaction ID by sending the new interaction request manually. For example:


var interactionRequest = UTRequestBuilder.Interaction(UTEvent.GetEmptyEvent())
                                         .ChannelId("27b4e611-a73d-4a95-b20a-811d295bdf65")
                                         .Initiator(InteractionInitiator.Contact)
                                         .Contact("jsdemo", "demo")
                                         .Build();

var interactionResponse = await session.TrackInteractionAsync(interactionRequest);

Note

You can start the Interaction manually by constructing and sending an Interaction request.

Property	Details
Session builder API	`DefaultInteraction(IUTInteraction)`
Sample value	`IUTInteraction` object
Parameter position	Any position after the `Instance URL`
Required\optional	Optional
Multiple invocations	Multiple invocations cause InvalidOperationException
Value validation	Must be a properly built `IUTInteraction` object

If you have suggestions for improving this article, let us know!