Quick Tracking:Integrasi Dasar

Integrasi dasar

1. Pengaturan Domain

Sebelum memanggil metode pra-inisialisasi, pengembang perlu memanggil API setTrackDomain untuk menetapkan titik akhir pengumpulan data lingkungan privat sebelum menggunakan API lain dari SDK.

import { setTrackDomain } from '@quicktracking/analytics';

/**
* Tetapkan domain utama dan alternatif untuk mengunggah log statistik.
* SDK akan melaporkan statistik ke domain utama terlebih dahulu. Jika gagal, maka akan mencoba melaporkan data ke domain alternatif lagi.
* Domain utama primaryDomain tidak boleh null atau string kosong. Jika null atau string kosong ditentukan, SDK akan mencetak "Domain tidak boleh kosong. Silakan periksa pengaturan domain!" "Log pengecualian.
* Anda dapat menentukan null atau string kosong untuk domain alternatif. Dalam hal ini, SDK menganggap bahwa domain alternatif sama dengan domain utama. Setelah SDK gagal mengunggah data, data dilaporkan ke domain utama untuk kedua kalinya.
* Parameter domain yang masuk harus berisi awalan "https://".
*/

function setTrackDomain(primaryDomain: string, standaryDomain?: string)

Catatan: Hanya awalan HTTP dan HTTPS yang didukung. Jika Anda tidak menentukan awalan protokol, HTTPS digunakan secara default.

2. Inisialisasi Kepatuhan

Berdasarkan persyaratan kepatuhan dari Kementerian Industri dan Teknologi Informasi (MIIT), aplikasi tidak dapat mengakses informasi pribadi apa pun sebelum pengguna menyetujui kebijakan privasi. Oleh karena itu, SDK QuickTracking Next dibagi menjadi dua tahap: pra-inisialisasi dan inisialisasi. Untuk menyelesaikan inisialisasi kepatuhan, lakukan langkah-langkah berikut:

1. Pastikan bahwa aplikasi memiliki Kebijakan Privasi, dan tampilkan Kebijakan Privasi serta minta persetujuan pengguna saat pertama kali aplikasi dijalankan.

2. Beritahukan kepada pengguna bahwa layanan pengumpulan QuickTrackingSDK digunakan. Tambahkan klausul referensi berikut ke Kebijakan Privasi: "Produk kami mengintegrasikan QuickTracking SDK. QuickTracking SDK mengumpulkan OAID/Huawei AAID/IMSI kartu SIM/nomor seri perangkat keras/MCC (kode negara seluler) dan MNC (nomor jaringan seluler) untuk menyediakan layanan analisis statistik."

3. QuickTracking SDK hanya dapat diinisialisasi setelah pengguna menyetujui kebijakan privasi.

2.1. API Pra-inisialisasi

Panggil API pra-inisialisasi SDK. Pemanggilan API ini tidak melacak informasi perangkat atau melaporkan data ke layanan pengumpulan QuickTracking.

2.1.1. Deskripsi API

import { preInit } from '@quicktracking/analytics';

function preInit(cfg: UMConfig):void

2.1.2. Deskripsi Parameter

2.2. Inisialisasi API init

Setelah pengguna menyetujui kebijakan privasi, panggil API inisialisasi SDK. Pelacakan dan transmisi log dimulai hanya setelah metode init dipanggil.

2.2.1. Deskripsi API

import { init } from '@quicktracking/analytics';

function init():Promise<void>

2.3. Panggil SDK untuk Menginisialisasi API

Di direktori modul aplikasi, tambahkan file proyek abilityStage, misalnya, entry/src/main/ets/abilityStage/MyAbilityStage.ets. Tangkapan layar lokasi spesifik adalah sebagai berikut:

Tambahkan srcEntry ke file module.json5 untuk menunjuk alamat file abilityStage.

2.3.1. Contoh panggilan lengkap

import AbilityStage from '@ohos.app.ability.AbilityStage';
import { preInit, InternalPlugin, setLogEnabled, init, setTrackDomain } from '@quicktracking/analytics';

setLogEnabled(true); // Aktifkan pencatatan debug.
setTrackDomain("Titik akhir pengumpulan data utama", "Titik akhir pengumpulan data sub"); // Tetapkan domain pengumpulan.

export default class MyAbilityStage extends AbilityStage {
  onCreate() {
    preInit({
      appKey: 'Your AppKey'
      context: this.context.getApplicationContext(),
      enableJSBridge: true,
      enableAutoTrackApplication: true,
      enableAutoTrackPage: true,
      plugins: [new InternalPlugin()]
    });
    init();
  }
}

Perhatian: Pelacakan dan transmisi log hanya dimulai setelah metode init dipanggil dan pengguna menyetujui kebijakan privasi.

3. Pencetakan Log

Log SDK dapat diaktifkan atau dinonaktifkan dengan memanggil API setLogEnable.

import { setLogEnabled } from '@quicktracking/analytics';

function setLogEnabled(enable: boolean):void

Catatan:

• Jika Anda ingin melihat log selama inisialisasi, pastikan sakelar log dihidupkan sebelum memanggil metode inisialisasi.

• Log dibagi menjadi tiga tingkat:

• error: Mencetak pesan kesalahan terkait integrasi SDK atau waktu proses.

• warn: Mencetak pesan peringatan SDK.

• info: Mencetak informasi prompt SDK.