Langsung ke konten utama

Firebase Analytics plugin Capacitor

Plugin Capacitor untuk Firebase Analytics

Instal

bun add @capgo/capacitor-firebase-analytics bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-firebase-analytics
  • pnpm add @capgo/capacitor-firebase-analytics
  • yarn add @capgo/capacitor-firebase-analytics

Panduan

Cara menggunakan Firebase Analytics di Capacitor

Menggunakan @capgo/capacitor-firebase-analytics

Plugin Capacitor untuk Firebase Analytics.

Instal

bun add @capgo/capacitor-firebase-analytics
bunx cap sync

bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.

Impor

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

Sekilas tentang API

Metode Deskripsi
getAppInstanceId Mengambil ID instance aplikasi.
getSessionId Mengambil ID sesi saat ini (ga_session_id).
setConsent Mengatur mode persetujuan user.
setUserId Mengatur properti user ID.
setUserProperty Menetapkan custom user property ke nilai tertentu.
setCurrentScreen Mengatur nama screen saat ini.
logEvent Mencatat event aplikasi.
setSessionTimeoutDuration Mengatur durasi tidak aktif yang mengakhiri sesi saat ini.
setEnabled Mengaktifkan/menonaktifkan pengumpulan data otomatis. Nilai ini baru akan diterapkan pada saat aplikasi dijalankan berikutnya.
isEnabled Mengembalikan status apakah pengumpulan data otomatis aktif atau tidak.
resetAnalyticsData Menghapus semua data analitik aplikasi ini dari perangkat. Mereset app instance id.
logTransaction Mencatat transaksi StoreKit 2 ke dalam logs.
initiateOnDeviceConversionMeasurementWithEmailAddress Memulai pengukuran konversi on-device menggunakan alamat email.
initiateOnDeviceConversionMeasurementWithPhoneNumber Memulai pengukuran konversi on-device menggunakan nomor telepon.
initiateOnDeviceConversionMeasurementWithHashedEmailAddress Memulai pengukuran konversi on-device menggunakan alamat email yang di-hash.
initiateOnDeviceConversionMeasurementWithHashedPhoneNumber Memulai pengukuran konversi on-device menggunakan nomor telepon yang di-hash.

Contoh

getAppInstanceId()

Mengambil app instance id.

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

const result = await FirebaseAnalytics.getAppInstanceId();
console.log(result);

getSessionId()

Mengambil session id saat ini (ga_session_id).

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

const result = await FirebaseAnalytics.getSessionId();
console.log(result);

setConsent()

Mengatur mode persetujuan pengguna.

import { FirebaseAnalytics, ConsentStatus, ConsentType } from '@capgo/capacitor-firebase-analytics';

await FirebaseAnalytics.setConsent({
  type: ConsentType.AdPersonalization,
  status: ConsentStatus.Granted,
});

setUserId()

Mengatur properti user ID.

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

await FirebaseAnalytics.setUserId({ userId: 'user-id-123' });

setUserProperty()

Menetapkan custom user property ke nilai tertentu.

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

await FirebaseAnalytics.setUserProperty({
  key: 'key-123',
  value: 'value',
});

setCurrentScreen()

Menetapkan nama layar saat ini.

import { FirebaseAnalytics } from '@capgo/capacitor-firebase-analytics';

await FirebaseAnalytics.setCurrentScreen({ screenName: 'screen' });

Tabel di atas mencantumkan 16 metode inti. Helper listener, versi, dan kontrak lengkap setiap metode didokumentasikan di repositori GitHub.

Referensi lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-firebase-analytics

Jika Anda menggunakan Menggunakan @capgo/capacitor-firebase-analytics untuk merencanakan pekerjaan plugin native, hubungkan dengan Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi pada Menambahkan atau Memperbarui Plugin, Alternatif Plugin Ionic Enterprise untuk alur kerja produk di alternatif plugin Ionic Enterprise, dan Capgo Native Build untuk alur kerja produk di Capgo Native Builds.

FAQ

FAQ plugin Firebase Analytics

Bagaimana cara install plugin Firebase Analytics di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-firebase-analytics" (atau "npm install @capgo/capacitor-firebase-analytics"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mendeteksi code native. Import dari "@capgo/capacitor-firebase-analytics" di dalam code aplikasi Anda.

Apakah @capgo/capacitor-firebase-analytics bisa digunakan dengan React, Vue, dan Angular?

Ya. Firebase Analytics adalah paket Capacitor, jadi bisa berjalan di framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript murni.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-firebase-analytics?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-firebase-analytics gratis dan open source?

Ya. Source code tersedia secara publik di GitHub pada https://github.com/Cap-go/capacitor-firebase/tree/main/packages/analytics dan paketnya gratis untuk diinstal dari npm. Laporan bug dan pull request sangat kami terima.

Bisakah saya memperbarui code yang menggunakan Firebase Analytics tanpa melalui review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Deploy perubahan Firebase Analytics tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo