すべてのプロダクト
Search

このプロダクト

    Mobile Platform as a Service:Android クライアント開発

    ドキュメントセンター

    Mobile Platform as a Service:Android クライアント開発

    最終更新日:Jan 17, 2025

    このトピックでは、Android クライアントでカスタムイベント分析機能を開発する方法について説明します。内容は次のとおりです。

    1. MAS コンポーネントを統合する

    2. イベントログを記録する

    3. ログをレポートする

    MAS コンポーネントを統合する

    Android へのアクセス - クイックスタートガイドを参照して、MAS コンポーネントを統合します。

    イベントログを記録する

    このセクションでは、コードサンプルを使用してイベントログを記録する方法を説明し、コードサンプルに含まれるパラメーターを紹介します。

    コードサンプル

    次のコード例では、クライアントは、イベントに対応するビジネス ID、イベント ID、支払時間、ユーザー ID、および支払方法を記録します。

    import com.mpaas.mas.adapter.api.MPLogger;

import java.util.HashMap;
import java.util.Map;

// ビジネス ID を指定します
String bizType = "Pay";
// イベント ID
String logId = "PayResults";
// 属性を追加します
Map<String, String> params = new HashMap<>(4);
// 属性：支払時間。Key は属性 ID に対応し、Value は属性値に対応します。
params.put("pay_time", String.valueOf(System.currentTimeMillis()));
// 属性：ユーザー ID
params.put("user_id", "the-userId");
// 属性：支払モード
params.put("payment_method", "alipay");
// ログを出力します
MPLogger.event(logId, bizType, params);

    パラメーターの説明

    パラメーター

    説明

    bizType

    • bizType は、ビジネスの一意の識別子である ビジネス ID（ビジネスコードまたは ビジネスタイプとも呼ばれます）を指定します。コードサンプルでは、bizType は Pay に設定されており、支払ビジネスを示します。

    • bizType は、クライアント上のログファイル名に影響します。ログファイルの命名形式は timestamp_package name-process_bizType です。

    logId

    logId は、イベントの一意の識別子である イベント ID を指定します。詳細については、「このチュートリアルについて」のチュートリアルシナリオの説明をご参照ください。

    params

    params は、イベントに関連付けられた属性を格納します。params.put("param-key", "param-value") では、次のようになります。

    • param-key：属性 ID に対応します。詳細については、「このチュートリアルについて」のチュートリアルシナリオの説明をご参照ください。

    • Param-value：属性値に対応します。属性値は、クライアントに文字列として格納されます。実際の分析では、サーバーは属性値を文字、整数、または浮動小数点値に変換できます。

    ログをレポートする

    デフォルトでは、クライアントにキャッシュされたログが一定数に達した場合、またはプログラムがバックグラウンドで一定期間実行された場合、ローカルログは MAS サーバーに自動的にレポートされます。開発テスト中は、次の API を呼び出して、ローカルログをサーバーに強制的にすぐにレポートできます。

    import com.mpaas.mas.adapter.api.MPLogger;
MPLogger.uploadAll();