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 ブリッジイベントをリッスンするために使用されます。デフォルトでは無効になっています。 | いいえ |