Aktifkan pelaporan data H5 di aplikasi melalui Bridge - Quick Tracking

1 Skenario bridging H5

1.1 Bagaimana cara melaporkan data H5 ke aplikasi H5 dan aplikasi secara bersamaan?

Contoh skenario:

Aktivitas H5 "Spring Day" disematkan di beberapa terminal App dan dioperasikan dalam mode saat ini untuk memenuhi persyaratan analisis berikut:

Operasi App perlu melihat data tautan lengkap sebelum dan sesudah pelanggan berpartisipasi dalam aktivitas H5 di App.
Operasi aktivitas H5 perlu melihat data aktivitas H5 di semua terminal App.

Instruksi operasi:

Buat dua aplikasi:

Sebuah aplikasi App dengan Appkey_app sendiri.
Sebuah aplikasi Web/H5 dengan Appkey_h5 sendiri.

Panggil antarmuka attach di app untuk melakukan bridging H5.

Log pelaporan:

App melaporkan sebuah log:
1. Appkey adalah "Appkey_app" milik App.
2. Akun pengguna adalah akun pengguna untuk app.
3. ID Perangkat adalah ID Perangkat dari app.
4. Properti sistem adalah properti sistem dari app.
5. Atribut global adalah atribut global dari titik pelacakan di app.
6. Kode acara dan atribut acara adalah titik pelacakan di H5.
H5 melaporkan sebuah log:
1. Appkey adalah "Appkey_h5" milik H5.
2. Akun pengguna adalah akun pengguna untuk H5.
3. ID Perangkat adalah ID Perangkat dari H5.
4. Properti sistem adalah properti sistem dari H5.
5. Atribut global adalah atribut global dari titik pelacakan di H5.
6. Kode acara dan atribut acara adalah titik pelacakan di H5.

1.2 Bagaimana cara melaporkan data H5 hanya ke aplikasi App unik?

Contoh skenario:

Karena arsitektur teknis, beberapa halaman merupakan struktur teknis H5. Beroperasi dalam mode saat ini dapat memenuhi persyaratan analisis berikut:

Bisnis App, operasi, dan PD dapat melihat data tautan penuh lengkap di Data App.

Instruksi operasi:

Buat sebuah app dengan hanya satu Appkey_app.
Panggil antarmuka attach di app untuk melakukan bridging H5.
Appkey H5 disetel ke null dan panggil aplus-jsbridge-only sama dengan true untuk menonaktifkan pelaporan data H5.

Log pelaporan:

Hanya app yang melaporkan sebuah log:
1. Appkey adalah "Appkey_app" milik App.
2. Akun pengguna adalah akun pengguna untuk app.
3. ID Perangkat adalah ID Perangkat dari app.
4. Properti sistem adalah properti sistem dari app.
5. Atribut global adalah atribut global dari titik pelacakan di app.
6. Kode acara dan atribut acara adalah titik pelacakan di H5.

1.3 Jika data H5 hanya dilaporkan ke aplikasi H5?

Contoh skenario:

Bisnis App, operasi, dan PD tidak ingin melihat data H5 di App.

Instruksi operasi:

Buat dua aplikasi:

Sebuah aplikasi App dengan Appkey_app sendiri.
Sebuah aplikasi Web/H5 dengan Appkey_h5 sendiri.

Tidak ada panggilan API.

Log pelaporan:

Hanya H5 yang melaporkan satu log:
1. Appkey adalah "Appkey_h5" milik H5.
2. Akun pengguna adalah akun pengguna untuk H5.
3. ID Perangkat adalah ID Perangkat dari H5.
4. Properti sistem adalah properti sistem dari H5.
5. Atribut global adalah atribut global dari titik pelacakan di H5.
6. Kode acara dan atribut acara adalah titik pelacakan di H5.

2 Prinsip Bridging H5

yuque_diagram (2)

Premis dari metode di atas adalah:

Integrasi App QuickTrackingApp SDK.
dan integrasi H5 QuickTracking H5 SDK di dalam app.

Gambar berikut menunjukkan bahwa ketika pengguna memicu tombol2 pada halaman h5 di dalam app, dua log dilaporkan pada saat yang sama:

Melaporkan melalui App SDK: Dalam log yang dilaporkan, appkey adalah appkey dari app, atribut global adalah atribut global dari app, dan kode acara serta atribut acara adalah kode dan atribut dari titik pelacakan di h5. (panah hijau dalam gambar).
Melaporkan melalui H5 SDK: Dalam log yang dilaporkan, appkey adalah appkey dari h5, atribut global adalah atribut global dari h5, dan kode acara serta atribut acara adalah kode dan atribut dari titik tersembunyi di h5. (Panah kuning dalam gambar).

3 Saklar Bridge App H5

macOS: Dinonaktifkan secara default. Hanya dapat diaktifkan dengan menyetel parameter inisialisasi.

// Saklar bridge H5
@property (nonatomic) BOOL enableJSBridge;

Contoh

QTSDKConfig *sdkConfig = [[QTSDKConfig alloc] initWithAppkey:@"test_appkey"
                                                  trackDomain:@"https://xxxx.com"
                                                launchOptions:nil];
// Aktifkan bridging H5.
sdkConfig.enableJSBridge = YES;
[QuickTrackingSDK launchWithConfig:sdkConfig];

4 Saklar pelaporan log SDK H5

API saklar yang mengontrol tautan panah kuning:

API SDK H5:

Parameter SDK
aplus-jsbridge-only	true	Nonaktifkan pengiriman log H5 (panah kuning)
	false (Nilai default: false)	Aktifkan pengiriman log H5 (panah kuning)

aplus_queue.push({
  action: 'aplus.setMetaInfo',
  arguments: ['aplus-jsbridge-only', true]
});

Peringatan

Catatan: Jika Anda menyetel parameter aplus-jsbridge-only ke true, parameter utm dalam tautan web tidak dikenali secara otomatis sebagai parameter saluran. Anda harus menggunakan atribut global untuk menyetel parameter tersebut.

5 API sinkronisasi atribut global H5

Jika Anda menonaktifkan operasi API berikut di H5, properti global yang dikonfigurasikan menggunakan parameter globalproperty di aplus.appendMetaInfo atau aplus.setMetaInfo di H5 tidak berlaku di aplikasi native. (Antarmuka ini defaultnya adalah true.)

Perhatikan bahwa antarmuka ini didukung di qt_web_v2.0.12.

aplus_queue.push({
  action: 'aplus.setMetaInfo',
  arguments: ['Disable aplus-globalproperty-sync-enable, false] // Nonaktifkan sinkronisasi
});

Sebagai contoh, secara default, jika Anda menyetel atribut global "Kota Saat Ini: Beijing" di app dan menyetel atribut global "Kota Saat Ini: Shanghai" di app H5, atribut global dari acara yang dipicu di H5 dan app native akan menjadi "Kota Saat Ini: Shanghai". Jika Anda mematikan saklar ini, properti global yang disetel di H5 tidak disinkronkan ke aplikasi native.