基本的な統合 - Quick Tracking - Alibaba Cloud ドキュメントセンター

1. コンプライアンスの初期化

1.1 初期化インターフェイス

1. コンプライアンス声明

MIIT のコンプライアンス要件では、ユーザーがプライバシーポリシーに同意する前に、アプリケーションが個人情報を取得することはできません。したがって、Quick Tracking は、次の操作を実行するために初期化されます。

アプリケーションに「プライバシーポリシー」があることを確認する必要があります。ユーザーがアプリケーションをインストールまたは初回起動する際に、「プライバシーポリシー」がポップアップ表示され、ユーザーの同意を得ます。
Quick Tracking SDK サービスを使用することを選択したことをユーザーに通知する必要があります。プライバシーポリシーに次の参照条項を追加してください。

「当社の製品は Quick Tracking SDK を統合しています。Quick Tracking SDK は、統計分析サービスを提供するために、お客様の OS/OSVERSION/MEMORY/MAC/CPU/TIMEZONE/LANGUAGE/RESOLUTION/デバイスメーカー/デバイスモデルを収集する必要があります。

2. コンプライアンスの初期化

[Quick Tracking] 統計 SDK の統合後、アプリケーションが工業情報化部 (MIIT) のコンプライアンス要件を満たせるようにするには、ユーザーがプライバシーポリシーを読み、ユーザーの権限付与を得た後に、アプリケーションが正式な初期化関数を呼び出して統計 SDK を初期化するようにする必要があります。この場合、SDK はデバイス情報を収集し、データをレポートします。逆に、ユーザーがプライバシーポリシーの権限付与に同意しない場合、初期化関数は呼び出せません。

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

パラメーター	タイプ	説明	必須
strAppKey	const char *	QT は、現在のアプリケーションプラットフォームによって発行される一意の識別子です。	はい
strProcessName	const char *	アプリケーションプロセスの名前。	はい
strTrackDomain	const char *	ログアップロード用のプライマリドメイン名のアドレス +"/event"	はい
param	const char *	その他の構成パラメーターの場合、入力パラメーターは map コレクションの形式である必要があり、その後 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 を初期化する際には、AppKey パラメーターを指定する必要があります。AppKey は、Quick Tracking におけるアプリケーションの一意の ID です。アプリケーションを作成する際に生成されます。AppKey の取得方法または表示方法の詳細については、「アプリケーション管理」をご参照ください。

2 日分のログ出力

QtConfigure.setLogEnabled(true) 操作を呼び出して、[Quick Tracking] ログの出力を制御できます。

// ログを出力します。
// 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 *	QT は、現在のアプリケーションプラットフォームによって発行される一意の識別子です。	はい
strProcessName	const char *	アプリケーションプロセスの名前。	はい
type	enum LOG_PRINT_TYPE	ログ出力モード。 LOG_PRINT_TYPE_NONE: なし LOG_PRINT_TYPE_STDOUT: 標準出力 stdout LOG_PRINT_TYPE_FILE: ファイル出力 %appdata%/qtforpc/appkey/	はい

重要

注:

initQTPC 操作を呼び出す前に、setQTLog 操作を呼び出してログ機能を有効にする必要があります。

例:

// ログを出力します。
qtInterface->setQTLog("appKey", "processname", LOG_PRINT_TYPE::LOG_PRINT_TYPE_FILE);
// 初期化
qtInterface->initQTPC("appKey", "processname", "http://xxxxx/event", sparam.c_str());

3 日間のロゴ送付ポリシー

Quick Tracking Windows SDK のデフォルトのイベントレポートポリシーは次のとおりです。

通常の要求ログは集約レポートされます。デフォルト値は 300 です。initQTPC 操作を呼び出して、maxReportDataSize パラメーターを使用して集約サイズを設定できます。
要求ログは 3 秒間隔で送信されます