GTM Capacitor プラグイン

@capgo/capacitor-gtm の使い方

Google Tag Manager プラグインのメインインターフェースです。

インストール

bun add @capgo/capacitor-gtm
bunx cap sync

bunx cap sync プラグインのネイティブcodeをネイティブプロジェクトにコピーします。プラグインをアップグレードするたびに再度実行してください。

インポート

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

API の概要

メソッド	説明
initialize	指定したコンテナIDで Google Tag Manager を初期化します。
push	Google Tag Manager の dataLayer にイベントをプッシュします。
setUserProperty	Google Tag Manager の dataLayer にユーザープロパティを設定します。
getValue	Google Tag Manager の dataLayer から値を取得します。dataLayer 内を検索して、指定したキーの最新の値を探します。
reset	Google Tag Manager のインスタンスをリセットし、すべてのデータをクリアします。dataLayer 内のデータはすべて削除され、再初期化が必要になります。

例

initialize()

指定したコンテナIDで Google Tag Manager を初期化します。

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

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

push()

Google Tag Manager の dataLayer にイベントをプッシュします。

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

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

setUserProperty()

Google Tag Manager の dataLayer にユーザープロパティを設定します。

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

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

getValue()

Google Tag Manager の dataLayer から値を取得します。dataLayer 内を検索して、指定したキーの最新の値を探します。

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

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

reset()

Google Tag Manager のインスタンスをリセットし、すべてのデータをクリアします。dataLayer 内のデータはすべて削除され、再初期化が必要になります。

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

await GoogleTagManager.reset();

完全なリファレンス

• GitHub リポジトリ
• ドキュメント
• API リファレンス

@capgo/capacitor-gtm の使用から続ける

使用している場合 @capgo/capacitor-gtm の使い方 ネイティブプラグインの作業を計画するには、次と連携してください： @capgo/capacitor-gtm @capgo/capacitor-gtm の実装詳細については、 スタートガイド スタートガイドの実装詳細については、 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor Plugins の実装詳細、および プラグインの追加または更新 プラグインの追加または更新に関する実装詳細についてはこちら。