Langsung ke konten utama
@capgo/capacitor-gtm Analitik Open source

GTM plugin Capacitor

Integrasi Google Tag Manager untuk analytics dan tracking

Instal

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

Panduan

Cara menggunakan GTM di Capacitor

Menggunakan @capgo/capacitor-gtm

Antarmuka utama untuk plugin Google Tag Manager.

Instal

bun add @capgo/capacitor-gtm
bunx cap sync

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

Impor

import { GoogleTagManager } from '@capgo/capacitor-gtm';

Sekilas tentang API

Metode Deskripsi
initialize Menginisialisasi Google Tag Manager dengan container ID yang ditentukan.
push Mengirim event ke Google Tag Manager dataLayer.
setUserProperty Mengatur user property di Google Tag Manager dataLayer.
getValue Mengambil nilai dari Google Tag Manager dataLayer. Mencari nilai terbaru dari key yang ditentukan di dalam dataLayer.
reset Reset instance Google Tag Manager dan hapus semua data. Ini akan menghapus semua data dari dataLayer dan memerlukan inisialisasi ulang.

Contoh

initialize()

Menginisialisasi Google Tag Manager dengan container ID yang ditentukan.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

await GoogleTagManager.initialize({ containerId: 'container-id-123' });

push()

Mengirim event ke Google Tag Manager dataLayer.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

await GoogleTagManager.push({
  event: 'purchase',
  parameters: {
    value: 99.99,
    currency: 'USD'
  }
});

setUserProperty()

Mengatur user property di Google Tag Manager dataLayer.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

await GoogleTagManager.setUserProperty({
  key: 'user_type',
  value: 'premium'
});

getValue()

Mengambil nilai dari Google Tag Manager dataLayer. Mencari nilai terbaru dari key yang ditentukan di dalam dataLayer.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

const result = await GoogleTagManager.getValue({ key: 'key-123' });
console.log(result);

reset()

Reset instance Google Tag Manager dan hapus semua data. Ini akan menghapus semua data dari dataLayer dan memerlukan inisialisasi ulang.

import { GoogleTagManager } from '@capgo/capacitor-gtm';

await GoogleTagManager.reset();

Referensi lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-gtm

Jika Anda menggunakan Menggunakan @capgo/capacitor-gtm untuk merencanakan pekerjaan plugin native, hubungkan dengan @capgo/capacitor-gtm untuk detail implementasi di @capgo/capacitor-gtm, Panduan Memulai untuk detail implementasi di Getting Started, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi di Plugin Capacitor oleh Capgo, dan Menambahkan atau Memperbarui Plugin untuk detail implementasi di bagian Menambahkan atau Memperbarui Plugin.

FAQ

FAQ plugin GTM

Bagaimana cara install plugin GTM di aplikasi Capacitor?

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

Apakah @capgo/capacitor-gtm mendukung React, Vue, dan Angular?

Ya. GTM adalah paket Capacitor, jadi bisa digunakan dengan 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-gtm?

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-gtm gratis dan open source?

Ya. Source code tersedia secara publik di GitHub pada https://github.com/Cap-go/capacitor-gtm/ dan paketnya gratis untuk diinstal dari npm. Bug report dan pull request sangat kami terima.

Bisakah saya memperbarui code yang menggunakan GTM 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 GTM 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