Integrasikan tracking otomatis untuk Nebula HTML5 container di iOS-Mobile Platform as a Service-Alibaba Cloud

Ketika menggunakan kontainer Nebula yang disediakan oleh mPaaS untuk memuat halaman HTML5, kontainer tersebut secara otomatis mengumpulkan statistik terkait tindakan dan kinerja pemuatan halaman serta menangkap pengecualian. Hal ini membantu Anda melacak data terkait pemuatan halaman HTML5. Topik ini menjelaskan cara mengintegrasikan fungsi pemantauan otomatis kontainer Nebula dan melihat data pelacakan.

Prasyarat

Untuk mengintegrasikan fungsi pelacakan otomatis kontainer HTML5 yang disediakan oleh mPaaS, pastikan:

Anda telah membuat aplikasi di konsol mPaaS.
Anda telah menyelesaikan langkah-langkah untuk menambahkan SDK, dan proyek klien telah mengintegrasikan NebulaLogging.framework.

Prosedur

Inisialisasi konfigurasi

Untuk mengintegrasikan fungsi pelacakan otomatis kontainer Nebula, aktifkan pemantauan pelacakan HTML5 selama inisialisasi kontainer.

// Delegasi pemantauan. Tambahkan pelacakan otomatis kontainer HTML5.
 NBLogConfigurationGet().shouldInjectSPMJS=YES;
 #ifdef DEBUG
 NBLogConfigurationGet().enableConsoleLog = YES;
 #endif
 [NBLogServiceGet() start];
 [[NBMonitor defaultMonitor] setDelegate:NBLogServiceGet()];

Setelah pemantauan pelacakan HTML5 diaktifkan, kontainer Nebula akan secara otomatis mengumpulkan statistik terkait tindakan pemuatan halaman, kinerja, dan pengecualian ketika digunakan untuk memuat halaman HTML5. Berdasarkan skenario melihat data pelacakan, ada dua metode:
- Lihat log klien: Lihat data pelacakan lokal di klien. Mode ini berlaku untuk pemecahan masalah dalam fase pengembangan aplikasi. Lihat Lihat log klien.
- Lihat log server: Lihat data pelacakan aktual yang dihasilkan untuk pengguna online. Mode ini berlaku untuk pemecahan masalah online setelah aplikasi dirilis. Lihat Lihat log server.

Lihat log klien

Setelah halaman HTML5 dimuat, cari kata kunci [h5log] di konsol Xcode untuk melihat informasi utama tentang data pelacakan terkait pemuatan halaman, seperti yang ditunjukkan pada gambar berikut.

Tabel berikut mencantumkan informasi utama yang termasuk dalam data pelacakan kontainer HTML5 yang dikeluarkan oleh konsol Xcode.

SeedId	Contoh	Deskripsi
bizType	`webapp`	Jenis log. Ditulis ke nama file log lokal.
seedId	`H5_AL_SESSION_FROM_NATIVE`	ID pelacakan unik. Untuk deskripsi rinci, lihat Set pelacakan kontainer HTML5.
head	`HD-VM`	Model log. Lihat Pelacakan kinerja.
params	`https://www.baidu.com`	URL halaman saat ini.

	`currentTimestamp=1553072784000`	Parameter kustom, seperti timestamp dan status pemuatan halaman.

-	Parameter kustom, seperti posisi elemen halaman.
`^url=https://www.baidu.com^referer=MPH5DemoVC^viewId` `=MPH5DemoVC^refviewId=MPHomeViewController^token=` `A994169ddd50640fa262dbc2dfebb2bb3^h5SessionToken=` `db4db9cfd83521aa2bc31a2e5a6df30e/td>`	Informasi pelacakan: Termasuk ID paket offline app, nomor versi paket offline, URL dimuat oleh halaman HTML5 saat ini, nama kelas VC, dan token halaman saat ini.
formatter	`header = "HD-VM"`	Sama dengan deskripsi bidang head.

Untuk melihat isi lengkap catatan log di konsol Xcode, temukan file yang namanya dimulai dengan bizType di bawah direktori Library/log di sandbox, lalu cari berdasarkan kata kunci seedId.

Lihat log server

Untuk melihat data pelacakan kontainer HTML5 dari pengguna online, cari data tersebut melalui Replay log di konsol mPaaS.

server log

Set pelacakan kontainer HTML5

Data pelacakan otomatis yang diukur oleh kontainer HTML5 diidentifikasi secara unik oleh seedId. Ada tiga jenis set pelacakan berdasarkan metode pemuatan halaman HTML5.

Set Pelacakan Terkait Membuka URL Online

SeedId	Deskripsi
H5_AL_SESSION_FROM_NATIVE	Kontainer telah dimulai.
H5_AL_PAGE_START	Pemuatan halaman dimulai.
H5_AL_NETWORK_START	Halaman mulai mengirim permintaan jaringan.
H5_OPEN_PAGE_FINISH	Pemuatan halaman selesai.
H5_AL_PAGE_APPEAR	Halaman muncul untuk pertama kali.
H5_AL_JSAPI_SENDEVENT	Halaman memanggil JSAPI.
H5_AL_JSAPI_NOTFOUND	Pemanggilan JSAPI pada halaman HTML5 gagal.
H5_TITLEBAR_BACK_BT	Tombol Kembali di bilah navigasi ditekan.
H5_PAGE_PERFORMANCE	Kinerja pemuatan halaman diukur.

Set Pelacakan Terkait Membuka Halaman Paket Offline

SeedId	Deskripsi
H5_APP_REQUEST	Minta informasi paket offline.
H5_APP_LOAD_DATASOURCE	Muat informasi paket offline.
H5_AL_SESSION_FROM_NATIVE	Kontainer telah dimulai.
H5_APP_DOWNLOAD	Unduh paket offline.
H5_APP_UNZIP	Dekompres paket offline.
H5_APP_POOL	Lakukan operasi pada kolam informasi manajemen paket, termasuk menambah, menghapus, dan memodifikasi informasi di kolam.
H5_APP_VERIFY	Lakukan verifikasi tanda tangan untuk paket offline.
H5_AL_SESSION_VERIFYTAR_FAIL	Verifikasi tanda tangan untuk paket offline gagal.
H5_AL_PAGE_START	Pemuatan halaman dimulai.
H5_AL_SESSION_MAP_SUCCESS	Paket offline lokal berhasil dimuat.
H5_AL_SESSION_FALLBACK	Pemuatan paket offline lokal gagal. Fungsi fallback dieksekusi untuk meminta halaman online.
H5_OPEN_PAGE_FINISH	Pemuatan halaman selesai.
H5_AL_PAGE_APPEAR	Halaman muncul untuk pertama kali.

Set Pelacakan Pengecualian

seedId	Deskripsi
H5_AL_NETWORK_PERFORMANCE_ERROR	Pengecualian permintaan sumber daya.
H5_PAGE_ABNORMAL	Pengecualian halaman.
H5_AL_PAGE_JSERROR	Pengecualian JS.
H5_AL_JSAPI_RESULT_ERROR	Pengecualian JSAPI.