AdMob サービスの使用
Android アプリケーションの作成 への移動
広告サービスを利用すると、アプリケーションで広告を表示して、いくらかの収入を得ることができます。AdMob は、Google 社が提供している Android 向けの広告サービスです。このトピックでは、FireMonkey を使ってアプリケーションに AdMob による広告を表示する方法について説明します。
- メモ： 以下の情報は、Android 向け開発についての主要なドキュメント トピックを補完するものです。続行する前に、「Android モバイル アプリケーション開発」に目を通してください。
目次
サポートされているデバイス
FireMonkey では、Android 2.3 以降を搭載したデバイスで AdMob をサポートしています。「FireMonkey プラットフォームに必要な準備」の「Android の要件」セクションも参照してください。
前提条件
AdMob サービスを利用するには、開発環境の準備とAdMob アカウントの登録が必要です。
AdMob でのアプリケーションの広告ユニットの作成
AdMob サービスに接続するように TBannerAd を構成できるようにするには、まず、AdMob に広告ユニットを作成する必要があります。AdMob に接続するように TBannerAd のインスタンスを構成する場合は、お使いの広告ユニットの ID を AdUnitID プロパティにコピーする必要があります。
モバイル アプリケーションへの AdMob サポートの追加
モバイル プラットフォーム上のマルチデバイス アプリケーションに広告を追加するための一般的な手順は以下のとおりです。
- アプリケーションに TBannerAd コンポーネントのインスタンスを追加します。
- AdMob から広告を読み込むように TBannerAd を構成します。
- この広告に対するユーザーの操作を処理します。
広告を読み込む
AdMob から取得した広告をアプリケーションに表示するには、AdMob に接続するように TBannerAd を構成し、そのサービスから広告を読み込む必要があります。
AdMob 用接続データを構成する
Android で AdMob サービスに接続するには：
- 1. 広告ユニット ID を作成します。
- 2. フォームの OnCreate イベントなどのイベントで、その広告ユニット ID を TBannerAd の AdUnitID プロパティにコピーします。
-
- Delphi の場合：
BannerAd1.AdUnitID := 'YourAdUnitID';
- Delphi の場合：
-
- C++ の場合：
BannerAd1->AdUnitID = "YourAdUnitID";
- C++ の場合：
- 3. ［プロジェクト｜オプション...｜資格リスト］を開き、［AdMob サービス］を選択します。その値を
Trueに設定します。
AdMob から広告を読み込む
AdMob から広告を読み込むには、LoadAd を呼び出します。LoadAd 手続きは非同期的であり、処理が終了すると、次のイベントのどちらかをトリガします。
- OnDidFail は、エラーが発生した場合にトリガされます。OnDidFail には
Errorというパラメータが用意されています。これは、バナーに広告を読み込めない原因となったエラーについての詳細な情報を提供します。 - OnDidLoad は、要求が正常に処理された場合にトリガされます。
通常は、OnShow などのフォーム イベントから LoadAd を呼び出して、フォームが表示されるとすぐに広告を読み込みます。
広告に対するユーザーの操作を処理する
ユーザーが広告をタップすると、アクションがトリガされます。このアクションでは、通常、Web ブラウザに広告のフルスクリーン版を表示するか、特定の URL を開きます。
ユーザーが広告をタップしてからアクションがトリガされるまでの間に、TBannerAd が自分の OnActionCanBegin イベントをトリガします。このイベントを処理して、アクションを発生させるかどうかを決定します。
また、OnActionCanBegin イベントのハンドラを使用して、アプリケーションの実行中の機能をいくつか一時停止して、広告アクション時の処理の無駄を避けることもできます。その場合は、OnActionDidFinish イベントのイベント ハンドラを定義し、そこでアプリケーションのそれらの機能を再開することができます。
広告のテスト
Android でテスト用の広告を表示するには、TBannerAd.TestMode プロパティを True に設定すればよいだけです。
トラブルシューティング：AdMob から広告を読み込む
アプリケーションが広告を表示できない場合の問題とその対処方法の案を、次の表にいくつか示します。
| 原因 | 説明 | 対処方法 |
|---|---|---|
|
ネットワーク エラー |
広告サーバーへのネットワーク接続が存在しない |
Wi-Fi またはデータ接続を確認する |
|
内部サーバー エラー |
広告サーバーから受信した応答が無効である |
-- |
|
広告要求が無効 |
有効なユニット ID（AdUnitID）を使用する | |
|
広告一覧が存在しない |
広告サーバーから現在ダウンロードできる広告がない |
-- |
| 広告プロパティが正しくない | TBannerAd の Visible プロパティが False に設定されている
|
TBannerAd の Visible プロパティを True に設定する
|
| バナーの固定サイズが画面解像度に対して大きすぎる | 広告のサイズのプロパティを適切な値に設定する | |
|
アプリケーション構成が正しくない |
アプリケーションの広告サービス構成パラメータが正しくない |
アプリケーションの AdMob サービス プロパティを設定する（「手順 3」を参照） |