Lompat ke Konten Utama
@capgo/capacitor-gtm Analitik Sumber Terbuka

GTM Plugin Capacitor

Pengintegrasian Manajer Tag Google untuk analisis dan pelacakan

Install

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

Panduan

Cara menggunakan GTM di Capacitor

Uji coba di perangkat

Unduh aplikasi Capgo, kemudian scan kode QR code.

Tautan QR pratinjau code GTM

Menggunakan @capgo/capacitor-gtm

Antarmuka utama untuk plugin Manajer Tag Google.

Pasang

bun add @capgo/capacitor-gtm
bunx cap sync

bunx cap sync copies the plugin's native code into your native projects. Run it again after every plugin upgrade.

Impor

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

Pandangan API

Metode Deskripsi
initialize Memulai Manajer Tag Google dengan ID kontainer yang ditentukan.
push Mengirimkan suatu kejadian ke dataLayer Manajer Tag Google.
setUserProperty Mengatur sifat pengguna di dataLayer Manajer Tag Google.
getValue Mengambil nilai dari dataLayer Manajer Tag Google. Mencari nilai terbaru dari kunci yang ditentukan.
reset Mengatur ulang instance Manajer Tag Google dan menghapus semua data. Ini akan menghapus semua data dari dataLayer dan memerlukan inisialisasi ulang.

Examples

initialize()

Memulai Manajer Tag Google dengan ID kontainer yang ditentukan.

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

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

push()

Mengirimkan suatu kejadian ke dataLayer Manajer Tag Google.

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

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

setUserProperty()

Mengatur sifat pengguna di dataLayer Manajer Tag Google.

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

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

getValue()

Mengambil nilai dari dataLayer Manajer Tag Google. Mencari nilai terbaru dari kunci yang ditentukan.

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

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

reset()

Mengatur ulang instance Manajer Tag Google dan menghapus semua data. Ini akan menghapus semua data dari dataLayer dan memerlukan inisialisasi ulang.

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

await GoogleTagManager.reset();

Referensi lengkap

Teruskan dari Menggunakan @capgo/capacitor-gtm

Jika Anda menggunakan Menggunakan @capgo/capacitor-gtm Untuk merencanakan pekerjaan plugin native, hubungkannya dengan @capgo/capacitor-gtm untuk detail implementasi di @capgo/capacitor-gtm Mulai Menggunakan untuk detail implementasi di Mulai, Capgo Direktori Plugin untuk alur kerja produk di Capgo Direktori Plugin Capacitor Plugin oleh Capgo untuk detail implementasi di Capacitor Plugin oleh Capgo, dan Menginstal atau Mengupdate Plugin untuk detail implementasi di Menginstal atau Mengupdate Plugin.

FAQ

FAQ untuk plugin GTM

Bagaimana cara menginstal plugin GTM di aplikasi Capacitor?

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

Apakah @capgo/capacitor-gtm dapat digunakan dengan React, Vue, dan Angular?

Iya. GTM adalah paket Capacitor, sehingga dapat digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

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

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi plugin mayor yang sesuai dengan versi mayor Capacitor (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub menyebutkan versi yang masih dipelihara.

Apakah @capgo/capacitor-gtm gratis dan terbuka sumber?

Ya. Sumber code ini terbuka di GitHub di https://github.com/Cap-go/capacitor-gtm/ dan paket ini gratis untuk diinstal dari npm.

Apakah saya bisa memperbarui code yang menggunakan GTM tanpa melalui tinjauan App Store?

Pemasangan atau pengupgrade plugin ini mengubah native code, sehingga memerlukan build toko yang baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin ini bisa berlayar segera dengan Capgo live updates.

Kirim perubahan GTM tanpa menunggu tinjauan aplikasi

Setelah plugin masuk ke dalam toko aplikasi Anda, Capgo live updates meneruskan perubahan JavaScript, HTML, dan CSS Anda ke pengguna dalam menit.

Mulai dengan Capgo