Using the Universal Tracker SDK

Building an event request

Version:

When the request configuration is complete, you can invoke the Build() method to get the request object.

var eventRequest = UTRequestBuilder.EventWithDefinitionId("01f8ffbf-d662-4a87-beee-413307055c48")
                                          .AddCustomValues("key1", "value1")
                                          .AddCustomValues("key2", "value2")
                                          .Timestamp(DateTime.Now)
                                          .Build();

When you build a request, you must observe the following rules:

You can define optional parameters in any order.

For example, the following two code samples are both correct requests:

UTRequestBuilder.SearchEvent("some keywords")
                .DefinitionId("01f8ffbf-d662-4a87-beee-413307055c48")
                .Timestamp(DateTime.Now)
                .AddCustomValues("key", "value")
                .Build();

UTRequestBuilder.SearchEvent("some keywords")
                .AddCustomValues("key", "value")
                .Timestamp(DateTime.Now)
                .DefinitionId("01f8ffbf-d662-4a87-beee-413307055c48")
                .Build();

The Add… methods accumulate values, so you must consider the order in which you invoke them.

For example, the following request will contain two custom values:

UTRequestBuilder.EventWithDefinitionId("01f8ffbf-d662-4a87-beee-413307055c48")
                .AddCustomValues("key1", "value1")
                .AddCustomValues("key2", "value2")
                .Build();

Methods that do not accumulate values should only be invoked once.

An example of a correct request:

UTRequestBuilder.SearchEvent("some keywords")
                .DefinitionId("01f8ffbf-d662-4a87-beee-413307055c48")
                .Build();

An example of an incorrect request that throws an InvalidOperationException exception:

UTRequestBuilder.SearchEvent("some keywords")
                .DefinitionId("01f8ffbf-d662-4a87-beee-413307055c48")
                .DefinitionId("01f8ffbf-d662-4a87-beee-413307055c48")
                .Timestamp(DateTime.Now)
                .Timestamp(DateTime.Now)
                .Build();

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