FMX.Analytics.AppAnalytics.TAppAnalytics.TrackEvent

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

procedure TrackEvent(const ACategory: string; const AAction: string = string.Empty;
const ALabel: string = string.Empty; const AValue: Double = 0.0);

C++

void __fastcall TrackEvent(const System::UnicodeString ACategory, const System::UnicodeString AAction = System::UnicodeString(), const System::UnicodeString ALabel = System::UnicodeString(), const double AValue = 0.000000E+00);

プロパティ

種類 可視性 ソース ユニット
procedure
function
public
FMX.Analytics.AppAnalytics.pas
FMX.Analytics.AppAnalytics.hpp
FMX.Analytics.AppAnalytics TAppAnalytics


説明

カスタム イベントを追跡します。

このメソッドを呼び出すと、独自のイベント追跡を行えます。情報が匿名のままであれば、これを使用して、機能の使用状況、パフォーマンス データ、その他望むものは何でも追跡できます。

一連の入力パラメータを指定して、追跡対象となるイベントを記述することができます。これらの入力パラメータとその簡単な説明を次の表に示します。

パラメータ 説明

ACategory

ACategory パラメータは必須です。64 文字以内の任意の文字列です。これは、通常、追跡されるイベントの広義のカテゴリに使用されますが、どのように使用してもかまいません。

AAction

AAction は任意指定です。これも 64 文字以内の文字列です。これは、このイベントの原因となるユーザー アクションを示すのに使用されます。

ALabel

ALabel は任意指定です。これも 64 文字以内の文字列です。これは、実行されたアクションの詳細を指定するのに使用されます。

AValue

AValue は任意指定です。これは数値です。通常、パフォーマンス測定値、処理されたデータのサイズ、金額などの値をアクションに関連付けるのに使用されます。Usertility Web インターフェイスには、値に関する集計統計情報がカテゴリ、ラベル、値などで分類されて表示されます。

メモ: ACategory のみ必須です。AppAnalytics サービスでは、ACategoryAActionALabel のそれぞれ最初の 64 文字を記録します。

お使いのアプリケーション アナリティクス コンポーネントが有効になっていなければ、TrackEvent は効果がありません。

ACategory が空の文字列の場合、TrackEvent では、次のメッセージを伴う EAppAnalyticsCategoryMissingException 例外が発生します。

AppAnalytics カスタム イベントのエラー: カテゴリが設定されていません。

関連項目