Quick Tracking:基本的な統合

1. ドメイン設定

初期化前に、開発者は他の SDK API を呼び出す前に、setCustomDomain API を呼び出して非公開環境のドメイン名を設定する必要があります。

API:

/**統計ログを報告するためのプライマリ ドメイン名と代替ドメイン名を設定します。 この関数は、SDK が関数呼び出しを初期化する前に呼び出す必要があります。
*
@ param primaryDomain ログが渡されるプライマリ ドメイン名の受信アドレス。 パラメーターは null または空の文字列にすることはできません。
@ param standbyDomain ログをアップロードするためのバックアップ ドメイン名の受信アドレス。 パラメーターは null または空の文字列にすることができます。 このパラメーターが空の場合、SDK はプライマリ ドメイン名をバックアップ ドメイン名として自動的に設定します。
*/

+ (void)setCustomDomain:(NSString *)primaryDomain standbyDomain:(NSString *)standbyDomain;

パラメーター:

APM 安定性データベースに関連するドメイン API:

+ (void)setLogUploadUrl:(NSString* _Nonnull)uploadUrl;

APM パフォーマンス ライブラリに関連するドメイン API:

+ (void) setLogUploadUrl: (NSString *) uploadUrl;

例

#import <UMAPM/UMAPMConfig.h>
#import <UMAPM/UMCrashConfigure.h>
#import <UMEFS/UMEFS.h>
#import <UMEFS/UMEFSConfig.h>
#import <UMEFS/UMEFSConfigure.h>
#import <QTCommon/QTCommon.h>
# import <UMCommonLog/UMCommonLogManager.h> // 追加する必要があります

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    UMAPMConfig* config = [UMAPMConfig defaultConfig];   
    config.crashAndBlockMonitorEnable = YES;
    [UMCrashConfigure setAPMConfig:config];

    UMEFSConfig* configForEFS = [UMEFSConfig defaultConfig];
    configForEFS.networkEnable = YES;
    configForEFS.launchMonitorEnable = YES;
    configForEFS.memMonitorEnable = YES;
    configForEFS.javaScriptBridgeEnable = YES;
    configForEFS.oomMonitorEnable = YES;
    configForEFS.pageMonitorEnable = YES;
    configForEFS.logCollectEnable = YES;
    configForEFS.logCollectUserId = @"user1";
    configForEFS.initSendPVEnable = YES;
    [UMEFSConfigure setAPMConfig:configForEFS];

    [QTConfigure setCustomDomain:@"Your collection service domain name" standbyDomain:@""]; // データ収集サービス ドメイン名
    [QTConfigure initWithAppkey:@"Your appkey" channel:@"App Store"]; // アプリケーションキー、App Store
    
    /**
     * APM ドメイン名を個別に設定する必要がある場合は、次のインターフェースを使用して設定してください。
     * [UMCrashConfigure setLogUploadUrl:@"Your collection service domain name"]; // v2.1.0 以降でサポートされています
     * [UMEFSConfigure setLogUploadUrl:@"Your collection service domain name"]; // v2.1.0 以降でサポートされています
     * [QTConfigure initWithAppkey:@"Your appkey" channel:@"App Store" shouldPluginsTrackDomainIndepent:YES]; // V1.5.6.PX 以降でサポートされています
     */
  
    return YES;
}

注: データ統計とパフォーマンス エクスペリエンスでデータ収集エンドポイントを使用する場合は、 [QTConfigure setCustomDomain:@"Your collection service domain name" standbyDomain:@""]; を設定するだけで済みます。

2. オプション。 ユーザー ID を設定します。

インターフェース:

+ (void)profileSignInWithPUID:(NSString *)puid;
+ (void)profileSignOff;

パラメーター:

例

[QTMobClick profileSignInWithPUID:@"UserID"];

3. 初期化

3.1 初期化 API

統計 SDK を統合した後、アプリが工業情報化部 (MIIT) のコンプライアンス要件を確実に満たせるようにするには、アプリの最初のコールド スタート時に、初期初期化関数を呼び出して統計 SDK を初期化し、ユーザーが プライバシー ポリシー を読み、ユーザーの承認を得たことを確認する必要があります。 この場合、SDK はデバイス情報を収集し、データを報告します。 逆に、ユーザーが プライバシー ポリシー の承認に同意しない場合、初期化関数を呼び出すことはできません。

/**すべてのコンポーネント プロダクトを初期化します
 @ param appKey 開発者が QT で申請したアプリケーションキー。
 @ param channel チャンネル識別子。 nil を「App Store」に設定できます。
 */
+ (void)initWithAppkey:(NSString *)appKey channel:(NSString *)channel;

アプリが プライバシー ポリシー のユーザー承認を取得したら、開発者は後続のアプリのコールド スタートで初期化関数が呼び出されることを確認する必要があります。

3.2. アプリケーションキーの取得

プロダクト「管理コンソール」->「アプリケーション管理」で、アプリケーションを見つけて取得します。

4. ログ記録を有効にする

API:

+ (void)setLogEnable:(BOOL)enable;

SDK の初期化中に生成されたログを表示する場合は、SDK を初期化する前にログ記録を有効にする必要があります。 API を呼び出す前にログ記録を有効にすることをお勧めします。

ヘッダーファイル:

#import <UMEFS/WPKLog.h>

例:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    
    [UMCommonLogManager setUpUMCommonLogManager];
    [QTConfigure setLogEnabled:YES];// データ統計ログを有効に設定します。
    [WPKLog setLogEnable:YES];// パフォーマンス エクスペリエンス ログを有効にするように指定します。
    [QTConfigure setCustomDomain:@"Your collection service domain name" standbyDomain:nil];// 収集ドメイン名を設定します。
    [QTConfigure initWithAppkey:@"Your appkey" channel:@"App Store"];
}