Mobile Platform as a Service:Konfigurasi pelacakan umum

Tentang tugas ini

Anda dapat mengonfigurasi pelacakan umum HTML5 yang berbeda dalam skenario bisnis yang berbeda. Untuk mempelajari skenario bisnis spesifik dan jenis pelacakan yang sesuai, lihat Jenis Pelacakan Umum.

Prosedur

1. Panggil langsung mtracker versi CDN. Saat mtracker dipanggil, objek Tracker disuntikkan ke dalam window global.

   Jika ada kode kacau dalam file JS mtracker yang diunduh, Anda masih dapat menggunakan file JS tersebut secara normal karena hal itu tidak akan memengaruhi konfigurasi pelacakan. Kode kacau mungkin disebabkan oleh perbedaan antara format pengkodean file dan format pengkodean yang ditafsirkan oleh browser.

2. Inisialisasi konfigurasi. Suntikkan informasi yang sesuai dalam file JS pelacakan HTML5 sesuai dengan situasi yang berbeda:

   • Untuk aplikasi yang terintegrasi dengan kontainer HTML5 mPaaS:

     <script>
     window._to = {
       bizScenario: 'alipay',  
       mtrDebug: true,        
     };
     </script>

     Parameter	Deskripsi
     bizScenario	Sumber saluran, opsional. Secara default kosong.
     mtrDebug	Apakah akan mengaktifkan mode debug untuk mtracker. Dalam mode debug, log yang dilaporkan akan dicetak, secara default "false".

   • Untuk aplikasi yang tidak terintegrasi dengan kontainer HTML5 mPaaS atau aplikasi sisi browser:

     <script>
     window._to = {
       server: 'https://cn-hangzhou-mas-log.cloud.alipay.com/loggw/webLog.do', 
       appId: 'xxxxxxxxxx', 
       workspaceId: 'default', 
       h5version: '1.0.0',    
       userId: '1234567890',     
       bizScenario: 'alipay',  
       mtrDebug: true,        
       extendParams: { test: 111 } 
     };
     </script>

     Parameter	Deskripsi
     server	Alamat layanan yang menerima pelacakan.
     appId	Pengenal unik Aplikasi.
     workspaceId	Pengenal ruang kerja.
     h5version	Versi Aplikasi atau versi halaman HTML5, opsional.
     userId	ID Pengguna, opsional.
     bizScenario	Sumber saluran, opsional. Secara default kosong.
     mtrDebug	Apakah akan mengaktifkan mode debug untuk mtracker. Dalam mode debug, log yang dilaporkan akan dicetak, secara default false.
     extendParams	Parameter ekstensi global, didukung di mtracker 1.2.0 dan versi lebih baru. Secara default kosong.

3. Inisialisasi objek mtracker.

   Secara default, mtracker diinisialisasi secara otomatis dan disuntikkan ke dalam objek window setelah file JS diperkenalkan. Jika inisialisasi manual diperlukan dalam beberapa skenario, Anda harus menyelesaikan inisialisasi dengan melakukan langkah-langkah berikut:

   1. Tambahkan kode berikut di depan lokasi di mana file JS diperkenalkan untuk melarang inisialisasi otomatis.

      window.notInitTrackerOnStart = true;

   2. Tambahkan kode inisialisasi.

      window.initTracker();

Modifikasi parameter ekstensi global sesuai kebutuhan. Dengan menyetel extendParams di window._to, parameter ekstensi yang Anda tetapkan dapat ditambahkan dalam log pelacakan berikutnya. Jika atribut duplikat ada dalam parameter ext yang ditetapkan dalam metode click atau expo, nilai dalam metode click atau expo akan berlaku.

Anda dapat memanggil kode berikut untuk mengubah extendParams, dan objek yang baru disetel akan menimpa semua nilai extendParams yang sebelumnya disetel.

window.changeTrackerExtendParams({ newValue: 11111 });

Apa yang harus dilakukan selanjutnya

Masuk ke Konsol Layanan Analisis Seluler, Anda dapat menganalisis log pelacakan umum HTML5 yang dilaporkan oleh mtracker di halaman analisis kustom. Lihat Analisis Log Pelacakan Umum untuk informasi lebih lanjut.