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 向けにアプリケーションを構成する

関連項目

「https://docwiki.embarcadero.com/RADStudio/Seattle/j/index.php?title=IAd_サービスの使用&oldid=226324」から取得