すべてのプロダクト
Search
ドキュメントセンター

Quick Tracking:基本的な統合

最終更新日:Jun 20, 2025

macOS SDK 準拠

準拠声明

  • MIIT 準拠では、アプリはユーザーがプライバシーポリシーに同意する前に個人情報を取得することはできません。そのため、アプリが初めて起動されたときに「プライバシーポリシー」をポップアップ表示して、ユーザーの同意を得る必要があります。

  • アプリが QuickTracking SDK サービスを統合していることをユーザーに通知し、プライバシーポリシーに次の参照条項を追加する必要があります。

    • 当社の製品は Quick Tracking SDK を統合しており、Quick Tracking SDK は統計分析サービスを提供するために OS/OSVERSION/TIMEZONE/LANGUAGE/RESOLUTION /デバイスメーカー /デバイスモデル /デバイスブランド /ネットワークを収集する必要があります。

  • QuickTracking SDK を初期化する前に、ユーザーがプライバシーポリシーに同意していることを確認してください。ユーザーがプライバシーポリシーに同意しない場合、QuickTracking SDK を初期化することはできません。

SDK の初期化

注: プログラムエントリのメインスレッドで SDK を初期化する必要があります。そうしないと、一部のイベントデータが失われる可能性があります。

appkey の取得

SDK を初期化するときは、appkey パラメーターを指定する必要があります。 appkey は、QuickTracking におけるアプリケーションの一意の ID です。アプリケーションの作成時に生成されます。 appkey の取得または表示方法の詳細については、「アプリケーション管理」をご参照ください。

レシートのドメイン名の取得

収集ドメイン名は、SDK レポートログのドメイン名サーバーアドレスであり、「QuickTracking 管理バックグラウンド - 管理コンソール - 収集情報 - 収集ドメイン名」から取得されます。

SDK の初期化

#import <QuickTrackingSDK/QuickTrackingSDK.h>

- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
    QTSDKConfig *sdkConfig;
    // SDK 構成を初期化します。
    sdkConfig = [[QTSDKConfig alloc] initWithAppkey:@"The unique identifier of your application"
                                        trackDomain:@"https:// Your domain name"
                                      launchOptions:nil];
                                      
    // アプリケーションが公開されているチャネルを指定します。例: appstore。
    sdkConfig.channel = @"Your application release channel";
    
    // バッチ送信の最小間隔(ミリ秒単位)を設定します。デフォルト値: 3 秒。
    sdkConfig.batchSendInterval = 3000;
    
    // SDK ログ出力を有効にします。デフォルトでは無効になっています。
    sdkConfig.enableLog = YES; 
    
    // SDK が無効になっていないことを確認します。デフォルト値は NO です。
    // sdkConfig.disableSDK = NO;
    
    // アプリがバックグラウンドに入ったときにデータ送信結果を待ちます。デフォルト値は NO です。
    // sdkConfig.enableSendLogsBeforeEnterBackground = YES;
    
    // 「QuickTracking 管理バックグラウンド - データ収集 - トラッキング検証 - PC アプリケーション検証」
    // sdkConfig.debugKey = @"97052112091876_xxxxx";
    
    // ローカルキャッシュイベントの最大数を設定します。デフォルト値は 10000 です。ローカルキャッシュイベントの数が制限を超えると、一部のイベントが削除されます。
    // sdkConfig.maxCacheSize = 10000;
      
    // H5 ブリッジイベントリスニングを有効にするかどうかを指定します。デフォルトでは、H5 ブリッジイベントリスニングは無効になっています。
    // sdkConfig.enableJSBridge = YES;
    
    // SDK を初期化します。
    [QuickTrackingSDK initWithConfig:sdkConfig];
}

QTSDKConfig パラメーターの説明

パラメーター

タイプ

説明

必須

appkey

nonnull NSString

アプリケーションの一意のエンコーディング、つまりアプリケーションの appkey です。

はい

trackDomain

nonnull NSString

データ収集のドメイン名。送信されるデータの宛先を決定するために使用されます。

はい

launchOptions

nullable id

起動オプション。通常、アプリケーションの起動時の構成プロパティ(nil の場合もあります)が含まれています。

いいえ

QTSDKConfig プロパティリスト

パラメーター

タイプ

説明

必須

batchSendInterval

NSInteger

2 回のデータ送信間の最小時間間隔(ミリ秒単位)。デフォルト値は 3 秒です。最小値は 3 秒です。

いいえ

maxCacheSize

NSInteger

ローカルキャッシュイベントの最大数。デフォルト値は 10000 です。イベント数が制限を超えると、一部のイベントが削除されます。

いいえ

batchSendQueueSize

NSInteger

アップロードできるキャッシュログの最大数。デフォルト値: 100。このパラメーターを大きな値に設定すると、ネットワークリクエストパケット損失が発生する可能性があります。

いいえ

enableLog

BOOL

ログ出力を有効にするかどうか。デフォルト値は NO です。

いいえ

disableSDK

BOOL

SDK を無効にするかどうか。デフォルト値: NO。 SDK を無効にすると、SDK はイベントをトリガーせず、ネットワークリクエストを送信しません。

いいえ

enableSendLogsBeforeEnterBackground

BOOL

アプリがバックグラウンドに入ったときにデータ送信結果を待つかどうか。デフォルト値は NO です。 YES に設定すると、システムはデータ送信結果を待ちます。

いいえ

cacheFilePath

NSString

カスタムトラッキングデータが保存されるパス。このパスは、macOS 開発環境にのみ適用されます。

いいえ

channel

NSString

アプリケーションのリリースチャネル。アプリケーションのリリースチャネルを識別するために使用されます。

いいえ

debugKey

NSString

トラッキングポイント検証識別子は、検証データフロープロセスで確認識別子を提供するために使用されます。

いいえ

enableJSBridge

ブール値

H5 ブリッジスイッチ。 H5 ブリッジイベントをリッスンするために使用されます。デフォルトでは無効になっています。

いいえ