メインコンテンツへスキップ
@capgo/capacitor-admob コマース オープンソース

AdMob Capacitor プラグイン

Google AdMob のバナー、インタースティシャル、リワード広告でアプリを収益化

インストール

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

ガイド

Capacitor で AdMob を使う方法

@capgo/capacitor-admob の使い方

Google AdMob 広告を Capacitor アプリで表示するための AdMob Plus プラグインインターフェース。

インストール

bun add @capgo/capacitor-admob
bunx cap sync

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

インポート

import { AdMob } from '@capgo/capacitor-admob';

API の概要

メソッド 説明
start AdMob SDK を初期化して開始します。
configure AdMob の設定を行います。
configRequest 広告リクエストの設定を行います。
adCreate 新しい広告インスタンスを作成します。
adIsLoaded 広告がロードされ、表示可能な状態か確認します。
adLoad 広告をロードします。
adShow ロード済みの広告を表示します。
adHide 現在表示されている広告を非表示にします。
trackingAuthorizationStatus 現在のトラッキング許可ステータスを取得します(iOSのみ)。
requestTrackingAuthorization ユーザーにトラッキングの許可をリクエストします(iOSのみ)。

例

start()

AdMob SDK を初期化して開始します。

import { AdMob } from '@capgo/capacitor-admob';

await AdMob.start();

configure()

AdMob の設定を行います。

import { AdMob } from '@capgo/capacitor-admob';

await AdMob.configure({
  appMuted: false,
  appVolume: 0.5
});

configRequest()

広告リクエストの設定を行います。

import { AdMob, MaxAdContentRating } from '@capgo/capacitor-admob';

await AdMob.configRequest({
  maxAdContentRating: MaxAdContentRating.PG,
  tagForChildDirectedTreatment: true,
  testDeviceIds: ['test-device-id']
});

adCreate()

新しい広告インスタンスを作成します。

import { AdMob } from '@capgo/capacitor-admob';

await AdMob.adCreate({
  adUnitId: 'ca-app-pub-3940256099942544/1033173712'
});

adIsLoaded()

広告がロードされ、表示可能な状態か確認します。

import { AdMob } from '@capgo/capacitor-admob';

const isLoaded = await AdMob.adIsLoaded({ id: 1 });
if (isLoaded) {
  await AdMob.adShow({ id: 1 });
}

adLoad()

広告をロードします。

import { AdMob } from '@capgo/capacitor-admob';

await AdMob.adLoad({ id: 1 });

上記の表には10個のコアメソッドが記載されています。リスナーとバージョンのヘルパー、および各メソッドの完全な仕様については、 GitHub リポジトリ.

イベントをリッスンする

addListener ハンドルを返します。画面がアンマウントされるときに handle.remove() を呼び出してください。

完全なリファレンス

@capgo/capacitor-admob の使用方法から続ける

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

よくある質問

AdMob プラグインの FAQ

Capacitor アプリに AdMob プラグインをインストールするにはどうすればよいですか?

"bun add @capgo/capacitor-admob"(または "npm install @capgo/capacitor-admob")を実行した後、"bunx cap sync" を実行して、iOS および Android プロジェクトにネイティブの code を反映させます。その後、アプリの code から "@capgo/capacitor-admob" をインポートしてください。

@capgo/capacitor-admob は React、Vue、Angular で動作しますか?

はい。AdMobはCapacitorパッケージなので、Ionic、React、Vue、Angular、Svelte、またはプレーンなJavaScriptなど、Capacitor上で動作するあらゆるWebフレームワークで使用可能です。

@capgo/capacitor-admobはどのCapacitorバージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-admobは無料のオープンソースですか?

はい。codeのソースコードはGitHub上の https://github.com/Cap-go/capacitor-admob/ で公開されており、パッケージはnpmから無料でインストールできます。バグ報告やプルリクエストも歓迎しています。

App Storeの審査なしで、AdMobを使用しているcodeをアップデートできますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリ審査を待たずにAdMobの変更を配信

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める