IAd サービスの使用

提供: RAD Studio
移動先: 案内検索

IOS アプリケーションの作成 への移動


広告サービスを利用すると、アプリケーションで広告を表示して、いくらかの収入を得ることができます。iAd は Apple 社が提供している iOS 向けの広告サービスです。このトピックでは、FireMonkey を使ってアプリケーションに iAd による広告を表示する方法について説明します。

メモ: 続行する前に、「iOS モバイル アプリケーション開発」に目を通してください。以下の情報は、iOS 向け開発についての主要なドキュメント トピックを補完するものです。

サポートされているデバイス

FireMonkey では、サポート対象のすべての iOS デバイスiAd をサポートしています。

前提条件

iAd サービスを使用するには、開発環境の準備以外に、以下を行っておく必要があります。

  • iOS アプリケーションにコード署名をする準備ができている必要があります。「iOS モバイル アプリケーション開発」の「アプリケーションのコード署名準備」セクションを参照してください。
    • アプリケーションの App ID を作成するときには、com.mycompany.myapp のように、そのアプリケーションに特有の明示的な App ID を使用する必要があります。com.mycompany.* などのワイルドカード App ID を使用することはできません。
  • Apple 社の iAd App Network に参加する必要があります。「iAd App Network」で説明されている手順に従います。

iTunes Connect での iAd 向けアプリケーションの構成

  1. アプリケーションで iAd サービスを使用し、テストするには、まず iTunes Connect にアプリケーションのエントリを作成する必要があります。
  2. アプリケーションのエントリができたら、iTunes Connect の[Manage Your Apps]モジュールを開き、アプリケーションの[App Summary]ページを開きます
  3. [App Summary]ページの右側にある[Set Up iAd Network]をクリックします。
  4. その後で、[Enable iAds]をクリックし、[Save Changes]をクリックします。

モバイル アプリケーションへの iAd サポートの追加

iOS 上のマルチデバイス アプリケーションに iAd 広告を追加するための一般的な手順は以下のとおりです。

  1. アプリケーションに TBannerAd コンポーネントのインスタンスを追加します。
  2. iAd から広告を読み込むように TBannerAd を構成します。
  3. この広告に対するユーザーの操作を処理します。

広告を読み込む

お使いの広告サービスから取得した広告をアプリケーションに表示するには、そのサービスから広告を読み込みます。

広告サービスから広告を読み込む

お使いの広告サービスから広告を読み込むには、LoadAd を呼び出します。LoadAd 手続きは非同期的であり、処理が終了すると、次のイベントのどちらかをトリガします。

  • OnDidFail は、エラーが発生した場合にトリガされます。OnDidFail には Error というパラメータが用意されています。これは、バナーに広告を読み込めない原因となったエラーについての詳細な情報を提供します。
  • OnDidLoad は、要求が正常に処理された場合にトリガされます。

通常は、OnShow などのフォーム イベントから LoadAd を呼び出して、フォームが表示されるとすぐに広告を読み込みます。

広告に対するユーザーの操作を処理する

ユーザーが広告をタップすると、アクションがトリガされます。このアクションでは、通常、Web ブラウザに広告のフルスクリーン版を表示するか、特定の URL を開きます。

ユーザーが広告をタップしてからアクションがトリガされるまでの間に、TBannerAd が自分の OnActionCanBegin イベントをトリガします。このイベントを処理して、アクションを発生させるかどうかを決定します。

また、OnActionCanBegin イベントのハンドラを使用して、アプリケーションの実行中の機能をいくつか一時停止して、広告アクション時の処理の無駄を避けることもできます。その場合は、OnActionDidFinish イベントのイベント ハンドラを定義し、そこでアプリケーションのそれらの機能を再開することができます。

広告アクションをいつでもキャンセルする

ユーザーが広告をタップすると、アクションがトリガされます。このアクションでは、通常、Web ブラウザに広告のフルスクリーン版を表示するか、特定の URL を開きます。「広告に対するユーザーの操作を処理する」セクションを参照してください。

アプリケーションでユーザーの注目が必要な場合は、いつでも、以下のようにして、進行中の広告アクションがあるかどうかを確かめ、そのアクションを停止することができます。

Delphi の場合:

if MyBannerAd.IsActionInProgress then
    MyBannerAd.CancelAction;
C++ の場合:
if (MyBannerAd->IsActionInProgress())
    MyBannerAd->CancelAction();
メモ: 広告アクションをキャンセルすると、広告収入に影響します。詳細については、Apple 社のドキュメントを参照してください。

広告のテスト

iAd サービスでは、アプリケーションの作成方法に応じて、テスト用の広告か本物の広告のどちらかを自動的に表示します

トラブルシューティング:iAd から広告を読み込む

アプリケーションが広告を表示できない場合の問題とその対処方法の案を、次の表にいくつか示します。

原因 説明 対処方法

ネットワーク エラー

広告サーバーへのネットワーク接続が存在しない

Wi-Fi またはデータ接続を確認する

内部サーバー エラー

広告サーバーから受信した応答が無効である

--

広告一覧が存在しない

広告サーバーから現在ダウンロードできる広告がない

--

アプリケーション構成が正しくない

アプリケーションの広告サービス構成パラメータが正しくない

iTunes Connect で iAd 向けにアプリケーションを構成する

関連項目