1. Inisialisasi Kepatuhan
1.1 Antarmuka Inisialisasi
1. Pernyataan Kepatuhan
Persyaratan kepatuhan MIIT mengharuskan aplikasi tidak dapat mengumpulkan informasi pribadi sebelum pengguna menyetujui kebijakan privasi. Oleh karena itu, Quick Tracking diinisialisasi untuk melakukan operasi berikut:
Pastikan aplikasi memiliki "kebijakan privasi", dan tampilkan "kebijakan privasi" saat pengguna menginstal atau pertama kali memulai aplikasi untuk mendapatkan persetujuan pengguna.
Beritahukan pengguna bahwa Anda menggunakan layanan Quick Tracking SDK. Tambahkan istilah referensi berikut dalam kebijakan privasi:
Produk kami terintegrasi dengan Quick Tracking SDK. Quick Tracking SDK perlu mengumpulkan OS/OSVERSION/MEMORY/MAC/CPU/TIMEZONE/LANGUAGE/RESOLUTION/pabrikan perangkat/model perangkat untuk menyediakan layanan analisis statistik.
2. Inisialisasi Kepatuhan
Untuk memastikan aplikasi Anda memenuhi persyaratan kepatuhan Kementerian Perindustrian dan Teknologi Informasi (MIIT) setelah integrasi SDK statistik [Quick Tracking], pastikan aplikasi memanggil fungsi inisialisasi formal untuk menginisialisasi SDK statistik setelah pengguna membaca kebijakan privasi dan memberikan otorisasi. Dalam hal ini, SDK akan mengumpulkan informasi perangkat dan melaporkan data. Jika pengguna tidak menyetujui otorisasi Kebijakan Privasi, fungsi inisialisasi tidak dapat dipanggil.
/**Inisialisasi Quick Tracking untuk semua produk komponen
* Parameter param perlu diserialisasi menggunakan metode QT::Helper::QT_Serializable yang disediakan oleh QTOrPCHelper.
*/
QTFORPC_API QT_VOID initQTPC(QT_CSTR strAppKey, QT_CSTR strProcessName, QT_CSTR strTrackDomain, QT_MAP param);Parameter | Tipe | Deskripsi | Diperlukan |
strAppKey | const char * | QT adalah pengenal unik yang dikeluarkan oleh platform aplikasi saat ini. | Ya |
strProcessName | const char * | Nama proses aplikasi. | Ya |
strTrackDomain | const char * | Alamat nama domain utama untuk pengunggahan log +"/event" | Ya |
param | const char * | Untuk parameter konfigurasi lainnya, parameter input harus dalam bentuk koleksi map, lalu panggil serialisasi QT::Helper::QT_Serializable.
| Tidak |
Contoh:
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 Pengambilan Appkey
Saat menginisialisasi SDK, Anda harus menentukan parameter AppKey. AppKey adalah ID unik aplikasi di Quick Tracking yang dibuat saat aplikasi dibuat. Untuk informasi lebih lanjut tentang cara memperoleh atau melihat AppKey, lihat Manajemen Aplikasi.
Pencatatan Log 2 Hari
Anda dapat memanggil operasi QtConfigure.setLogEnabled(true) untuk mengontrol keluaran log [Quick Tracking].
// Mencetak log.
// LOG_PRINT_TYPE_NONE: Tidak ada
// LOG_PRINT_TYPE_STDOUT: stdout
// LOG_PRINT_TYPE_FILE: keluaran file, direktori keluaran adalah %appdata%/qtforpc/appkey/
QTFORPC_API QT_VOID setQTLog(QT_CSTR strAppKey, QT_CSTR strProcessName, LOG_PRINT_TYPE type);Parameter | Tipe | Deskripsi | Diperlukan |
strAppKey | const char * | QT adalah pengenal unik yang dikeluarkan oleh platform aplikasi saat ini. | Ya |
strProcessName | const char * | Nama proses aplikasi. | Ya |
type | enum LOG_PRINT_TYPE | Mode keluaran log.
| Ya |
Catatan:
Panggil operasi setQTLog untuk mengaktifkan fitur pencatatan sebelum memanggil operasi initQTPC.
Contoh:
// Mencetak log.
qtInterface->setQTLog("appKey", "processname", LOG_PRINT_TYPE::LOG_PRINT_TYPE_FILE);
// Menginisialisasi
qtInterface->initQTPC("appKey", "processname", "http://xxxxx/event", sparam.c_str());Kebijakan Pengiriman Logo 3 Hari
Kebijakan pelaporan acara default untuk Quick Tracking Windows SDK adalah:
Log permintaan Normal agregat laporan. Nilai default adalah 300. Anda dapat memanggil operasi initQTPC untuk mengatur ukuran agregat menggunakan parameter maxReportDataSize.
Log permintaan dikirim dengan interval 3 detik.