カスタムタグの使用¶
静的設定¶
複数の Configurations を作成し、プリプロセッサディレクティブを使用して値を設定できます。
- 複数の Configurations を作成します
- プリセット属性を設定して、異なる Configurations を区別します
- プリプロセッサディレクティブを使用します
// Target -> Build Settings -> GCC_PREPROCESSOR_DEFINITIONS でプリセット定義を設定します
#if PRE
#define Track_id @"0000000001"
#define STATIC_TAG @"preprod"
#elif DEVELOP
#define Track_id @"0000000002"
#define STATIC_TAG @"common"
#else
#define Track_id @"0000000003"
#define STATIC_TAG @"prod"
#endif
FTRumConfig *rumConfig = [[FTRumConfig alloc] init];
rumConfig.globalContext = @{@"track_id":Track_id,@"static_tag":STATIC_TAG};
... // その他の設定操作
[[FTSDKAgent sharedInstance] startRumWithConfigOptions:rumConfig];
動的設定¶
RUM 起動後に設定した globalContext は有効になりません。そのため、ユーザーはローカルに保存し、次回のアプリ起動時に設定を適用する必要があります。
- ファイルに保存してローカルに保持します（例：
NSUserDefaults）。SDK を使用する設定の箇所で、タグデータを取得するコードを追加します。
NSString *dynamicTag = [[NSUserDefaults standardUserDefaults] valueForKey:@"DYNAMIC_TAG"] ?: @"NO_VALUE";
FTRumConfig *rumConfig = [[FTRumConfig alloc] init];
rumConfig.globalContext = @{@"dynamic_tag":dynamicTag};
... // その他の設定操作
[[FTSDKAgent sharedInstance] startRumWithConfigOptions:rumConfig];
- 任意の場所にファイルデータを変更するメソッドを追加します。
- 最後にアプリケーションを再起動して有効にします。
注意事項¶
- 特別なキー：
track_id（RUM で設定し、追跡機能に使用します） - ユーザーが
globalContextを使用してカスタムタグを追加した場合、SDK の内部タグと重複すると、SDK のタグがユーザー設定の値を上書きします。タグの命名には、プロジェクトの略称プレフィックスを追加することを推奨します（例：custom_tag_name）。 -startRumWithConfigOptionsメソッドを呼び出して RUM を起動する前にglobalContextを設定する必要があります。FTSDKConfigで設定したカスタムタグは、すべての種類のデータに追加されます。
詳細については、SDK Demo を参照してください。