メインコンテンツにジャンプ
@capgo/capacitor-gtm 分析 オープンソース

GTM Capacitor プラグイン

Google タグ マネージャー統合

インストール

bun add @capgo/capacitor-gtm bunx cap sync
npm、pnpm または yarn
  • npm install @capgo/capacitor-gtm
  • pnpm add @capgo/capacitor-gtm
  • yarn add @capgo/capacitor-gtm

Guide

How to use GTM in Capacitor

Capgoはカスタム__CAPGO_KEEP_1__プラグインを作成および維持しています。

Download the Capgo app, then scan the QR code.

GTM プラグインプレビューQRコードのcode

@capgo/capacitor-gtmを使用

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

インストール

bun add @capgo/capacitor-gtm
bunx cap sync

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

Import

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

APIの概要

メソッド 概要
initialize 指定されたコンテナIDでGoogleタグマネージャーを初期化します。
push Googleタグマネージャーデータレイヤーにイベントをプッシュします。
setUserProperty Googleタグマネージャーデータレイヤーにユーザープロパティを設定します。
getValue Googleタグマネージャーデータレイヤーから値を取得します。指定されたキーに対してデータレイヤーを検索し、最新の値を取得します。
reset Googleタグマネージャーインスタンスをリセットし、すべてのデータをクリアします。この操作により、データレイヤーからすべてのデータが削除され、再初期化が必要になります。

例

initialize()

指定されたコンテナIDでGoogleタグマネージャーを初期化します。

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

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

push()

Googleタグマネージャーデータレイヤーにイベントをプッシュします。

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

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

setUserProperty()

Googleタグマネージャーデータレイヤーにユーザープロパティを設定します。

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

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

getValue()

Googleタグマネージャーデータレイヤーから値を取得します。指定されたキーに対してデータレイヤーを検索し、最新の値を取得します。

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

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

reset()

Googleタグマネージャーインスタンスをリセットし、すべてのデータをクリアします。この操作により、データレイヤーからすべてのデータが削除され、再初期化が必要になります。

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

await GoogleTagManager.reset();

全体参照

あなたが @capgo/@capacitor-gtm を使用している場合

@__CAPGO_KEEP_0__/@__CAPGO_KEEP_1__-gtm を使用して @capgo/@capacitor-gtm の実装詳細 Getting Started @capgo/capacitor-gtm @capgo/capacitor-gtmの実装詳細 続けて @__CAPGO_KEEP_0__/@__CAPGO_KEEP_1__-gtm から あなたが @__CAPGO_KEEP_0__/@__CAPGO_KEEP_1__-gtm を使用している場合 Capgo プラグイン ディレクトリ Capacitor製品ワークフロー向けに Capgo プラグイン ディレクトリを使用します。 Capacitor Capgo Capacitor-GTMの実装詳細については、Capacitor プラグインによって、Capgo が提供しています。 プラグインの追加または更新 プラグインの追加または更新の実装詳細を確認します。

FAQ

GTMプラグインFAQ

GTM プラグインを Capacitor アプリにインストールする方法は何ですか。

「bun add @capgo/capacitor-gtm」(または「npm install @capgo/capacitor-gtm」)を実行し、次に「bunx cap sync」を実行して、iOSとAndroidのプロジェクトがネイティブcodeを取得できるようにします。次に、@capgo/capacitor-gtmをアプリケーションcodeからインポートします。

@capgo/capacitor-gtmは、React、Vue、Angularとどのフレームワークでも動作しますか。

はい。GTMはCapacitorパッケージなので、Capacitor内で実行されるすべてのWebフレームワークと互換性があります。例えば、Ionic、React、Vue、Angular、Svelte、または単純なJavaScriptです。

Which Capacitor version does @capgo/capacitor-gtm support?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

Is @capgo/capacitor-gtm free and open source?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-gtm/ and the package is free to install from npm. Bug reports and pull requests are welcome.

GTMを使用するcodeをApp Storeのレビューなしでアップデートできますか?

プラグインをインストールまたはアップグレードすると、ネイティブ code が変更されるため、新しいストアビルドが必要になります。その後、Capgo のライブアップデートで即時実行できるように、JavaScript、HTML、CSS の変更が可能になります。

GTMの変更をアプリレビューの待たなくして配信する

プラグインがストアビルドに追加されたら、Capgoのライブアップデートは、JavaScript、HTML、CSSの変更をユーザーに数分で反映する

Capgoから始める