コンテンツにスキップ

カスタムタグの使用

ビルド設定による方法

  1. build.gradle で複数の productFlavors を作成し、タグを区別します。

    android{
        //…
        productFlavors {
            prodTest {
                buildConfigField "String", "CUSTOM_VALUE", "\"Custom Test Value\""
                //…
            }
            prodPublish {
                buildConfigField "String", "CUSTOM_VALUE", "\"Custom Publish Value\""
                //…
            }
        }
    }
    
  2. RUM 設定に対応する BuildConfig 定数を追加します。

    FTSdk.initRUMWithConfig(
            new FTRUMConfig()
                .addGlobalContext(CUSTOM_STATIC_TAG, BuildConfig.CUSTOM_VALUE)
                //... その他の設定を追加
    );
    
    FTSdk.initRUMWithConfig(
                FTRUMConfig()
                    .addGlobalContext(CUSTOM_STATIC_TAG, BuildConfig.CUSTOM_VALUE)
                    //… その他の設定を追加
            )
    

実行時にファイルを読み書きする方法

  1. SharedPreferences などのファイル型データを保存し、SDK を使用する設定の箇所にタグデータを取得するコードを追加します。

    SharedPreferences sp = context.getSharedPreferences(SP_STORE_DATA, MODE_PRIVATE);
    String customDynamicValue = sp.getString(CUSTOM_DYNAMIC_TAG, "not set");
    
    // RUM を設定
    FTSdk.initRUMWithConfig(
         new FTRUMConfig().addGlobalContext(CUSTOM_DYNAMIC_TAG, customDynamicValue)
         //… その他の設定を追加
    );
    
    val sp = context.getSharedPreferences(SP_STORE_DATA, MODE_PRIVATE)
    val customDynamicValue = sp.getString(CUSTOM_DYNAMIC_TAG, "not set")
    
    // RUM を設定
    FTSdk.initRUMWithConfig(
         FTRUMConfig().addGlobalContext(CUSTOM_DYNAMIC_TAG, customDynamicValue!!)
         //… その他の設定を追加
    )
    
  2. 必要なときにファイルデータを変更するメソッドを追加します。

    public void setDynamicParams(Context context, String value) {
        SharedPreferences sp = context.getSharedPreferences(SP_STORE_DATA, MODE_PRIVATE);
        sp.edit().putString(CUSTOM_DYNAMIC_TAG, value).apply();
    }
    
    fun setDynamicParams(context: Context, value: String) {
                val sp = context.getSharedPreferences(SP_STORE_DATA, MODE_PRIVATE)
                sp.edit().putString(CUSTOM_DYNAMIC_TAG, value).apply()
    
            }
    
  3. 最後にアプリを再起動します。詳細は 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)

フィードバック

このページは役に立ちましたか?