The defaultInteraction parameter

Version: 10.4

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:

RequestResponse
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:

RequestResponse
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

Do you have some feedback for us?

If you have suggestions for improving this article,