Universal Tracker SDKの使用

イベントリクエストの作成

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

リクエストの設定が完了したら、Build() メソッドを呼び出してリクエストオブジェクトを取得できます。

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

リクエストを作成するときは、次のルールに従う必要があります。

オプションのパラメータは任意の順序で定義できます。

たとえば、次の2つのコードサンプルはどちらも正しい要求です。

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();

Add…メソッドは値を蓄積するため、それらを呼び出す順序を考慮する必要があります。

たとえば、次の要求には2つのカスタム値が含まれます。

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

値を蓄積しないメソッドは、一度だけ呼び出す必要があります。

正しいリクエストの例:

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

InvalidOperationException例外をスローする誤った要求の例:

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

この記事を改善するための提案がある場合は、お知らせください!