Quick Tracking:基本的な統合

1. 準拠した初期化

1.1 初期化 API

1. コンプライアンスに関する声明

データプライバシー規制では、ユーザーがプライバシーポリシーに同意する前に個人情報を収集することが禁止されています。これに準拠するために、Quick Tracking では、SDK を以下のように初期化する必要があります：

1. アプリケーションの初回起動時にこのポリシーを表示し、ユーザーの同意を得る必要があります。

2. Quick Tracking SDK を使用していることをユーザーに通知する必要があります。プライバシーポリシーに以下のサンプル条項を追加してください：

「当社の製品には Quick Tracking SDK が組み込まれています。この SDK は、統計分析サービスを提供するために、お客様の OS、OS バージョン、メモリ、MAC アドレス、CPU、タイムゾーン、言語、解像度、デバイスメーカー、およびデバイスモデルを収集します。」

2. 準拠した初期化

データプライバシー規制に準拠するため、ユーザーがプライバシーポリシーに同意した後にのみ初期化関数を呼び出してください。SDK は、初期化されるまでデータの収集やレポートを行いません。

/** Quick Tracking 製品のすべてのコンポーネントを初期化します。
*   `param` パラメーターは、QTForPCHelper によって提供される QT::Helper::QT_Serializable メソッドを使用してシリアル化する必要があります。
*/
QTFORPC_API QT_VOID initQTPC(QT_CSTR strAppKey, QT_CSTR strProcessName, QT_CSTR strTrackDomain, QT_CSTR param);

パラメーター	タイプ	説明	必須
strAppKey	const char *	Quick Tracking によって提供される、アプリケーション用の一意の ID です。	はい
strProcessName	const char *	アプリケーションのプロセス名です。	はい
strTrackDomain	const char *	ログアップロード用の完全なエンドポイント URL です。末尾は /event である必要があります。	はい
param	const char *	追加の設定パラメーターです。マップとして渡し、QT::Helper::QT_Serializable を呼び出してシリアル化します。 appVersion：アプリケーションのバージョン番号です。 channel：アプリケーションチャネルです。 maxCacheDay：ローカルログキャッシュの最大保存期間 (日数) です。デフォルト： 3、最大： 366、最小： 1。 maxReportDataSize：集約レポートのバッチあたりのレコード数です。デフォルト： 300、最大： 300、最小： 1。	いいえ

例：

QT_INTERFACE_PTR qtInterface = NULL;
try
{
    qtInterface = loadQTDLL(L"QTForPC.dll");
	if (!qtInterface)
	{
		fprintf(stderr, "Error loading dll: %lx\n", -1);
		return -1;
	}

    std::map<string, string> param;
	param["appVersion"] = "testVersion";
	param["channel"] = "testChannel";
	param["maxCacheDay"] = "60";
	param["maxReportDataSize"] = "100";
	std::string sparam;
	QT::Helper::QT_Serializable(sparam, param);
			
    qtInterface->initQTPC("appKey", "processname", "http://xxxxx/event", sparam.c_str());
    ......

}
catch (...)
{
    return -1;
}

system("pause");
freeQTDLL(qtInterface);

1.2 Appkey の取得

SDK の初期化には、Quick Tracking でアプリケーションを一意に識別するための Appkey が必要です。 Appkey は、アプリケーションの作成時に生成されます。 Appkey を確認するには、アプリケーション管理をご参照ください。

2. ロギング

Quick Tracking のログ出力を制御するには、setQTLog 関数を呼び出します。

// ロギングを有効にします。
// LOG_PRINT_TYPE_NONE：出力なし。
// LOG_PRINT_TYPE_STDOUT：標準出力 (stdout)。
// LOG_PRINT_TYPE_FILE：ファイル出力。出力ディレクトリは %appdata%/qtforpc/appkey/ です。
QTFORPC_API QT_VOID setQTLog(QT_CSTR strAppKey, QT_CSTR strProcessName, LOG_PRINT_TYPE type);

パラメーター	タイプ	説明	必須
strAppKey	const char *	Quick Tracking によって提供される、アプリケーション用の一意の ID です。	はい
strProcessName	const char *	アプリケーションのプロセス名です。	はい
type	enum LOG_PRINT_TYPE	ログの出力先です。 LOG_PRINT_TYPE_NONE：なし LOG_PRINT_TYPE_STDOUT：標準出力 (stdout) LOG_PRINT_TYPE_FILE：ファイル出力。ログは %appdata%/qtforpc/appkey/ に保存されます。	はい

例：

// ロギングを有効化
qtInterface->setQTLog("appKey", "processname", LOG_PRINT_TYPE::LOG_PRINT_TYPE_FILE);
// SDK を初期化
qtInterface->initQTPC("appKey", "processname", "http://xxxxx/event", sparam.c_str());

3. ログレポートポリシー

Quick Tracking Windows SDK は、以下のデフォルトのログレポートポリシーを使用します：

• SDK はレポートを集計し、デフォルトでは 300 件ずつのバッチでログを送信します。バッチサイズは、initQTPC の maxReportDataSize パラメーターで設定します。

• SDK は 3 秒ごとにログを送信します。