カスタムタグの使用¶
ビルド設定による方法¶
-
build.gradleで複数のproductFlavorsを作成し、タグを区別します。 -
RUM設定に対応するBuildConfig定数を追加します。
実行時にファイルを読み書きする方法¶
-
SharedPreferencesなどのファイル型データを保存し、SDKを使用する設定の箇所にタグデータを取得するコードを追加します。 -
必要なときにファイルデータを変更するメソッドを追加します。
-
最後にアプリを再起動します。詳細は SDK Demo を参照してください。
SDK 実行時の追加¶
SDK の初期化完了後、FTSdk.appendGlobalContext(globalContext)、FTSdk.appendRUMGlobalContext(globalContext)、FTSdk.appendLogGlobalContext(globalContext) を使用してタグを動的に追加できます。設定後はすぐに反映されます。その後、RUM または Log で後続送信されるデータには、対応するタグが自動的に付与されます。
この使用方法は、タグデータがログイン、API リクエスト、またはローカルの非同期初期化の後にしか取得できない場合など、データ取得が遅延するシナリオに適しています。
Warning
SDK 初期化設定の globalContext または SDK 組み込みフィールドと同じ key を使用しないでください。名前が同じ場合、初期化設定の静的タグが動的に追加されたタグより優先されます。
使用方法¶
/**
* グローバルタグを動的に設定
* @param globalContext
*/
public static void appendGlobalContext(HashMap<String,Object> globalContext)
/**
* RUM グローバルタグを動的に設定
* @param globalContext
*/
public static void appendRUMGlobalContext(HashMap<String,Object> globalContext)
/**
* ロググローバルタグを動的に設定
* @param globalContext
*/
public static void appendLogGlobalContext(HashMap<String,Object> globalContext)
/**
* グローバルタグを動的に設定
* @param globalContext
*/
fun appendGlobalContext(globalContext: HashMap<String, Any>)
/**
* RUM グローバルタグを動的に設定
* @param globalContext
*/
fun appendRUMGlobalContext(globalContext: HashMap<String, Any>)
/**
* ロググローバルタグを動的に設定
* @param globalContext
*/
fun appendLogGlobalContext(globalContext: HashMap<String, Any>)
// SDK 初期化の疑似コード。ネットワークからパラメータを取得した後、タグを設定します
FTSdk.init()
getInfoFromNet(info){
HashMap<String, Object> globalContext = new HashMap<>();
globalContext.put("delay_key", info.value);
FTSdk.appendGlobalContext(globalContext)
}
コード例¶
HashMap<String, Object> globalContext = new HashMap<>();
globalContext.put("global_key", "global_value");
FTSdk.appendGlobalContext(globalContext);
HashMap<String, Object> rumGlobalContext = new HashMap<>();
rumGlobalContext.put("rum_key", "rum_value");
FTSdk.appendRUMGlobalContext(rumGlobalContext);
HashMap<String, Object> logGlobalContext = new HashMap<>();
logGlobalContext.put("log_key", "log_value");
FTSdk.appendLogGlobalContext(logGlobalContext);
val globalContext = hashMapOf<String, Any>(
"global_key" to "global_value"
)
FTSdk.appendGlobalContext(globalContext)
val rumGlobalContext = hashMapOf<String, Any>(
"rum_key" to "rum_value"
)
FTSdk.appendRUMGlobalContext(rumGlobalContext)
val logGlobalContext = hashMapOf<String, Any>(
"log_key" to "log_value"
)
FTSdk.appendLogGlobalContext(logGlobalContext)