実装ガイドを終了いたします

まだ以前の実装ガイドを終了していない場合は、ここから全設定をご確認ください。

バナー広告を表示させるためのコーディング

Android アプリは、View オブジェクトで構成され、つまりテキストエリアとボタン等のコントロールの形でユーザに表示される Java インスタンスです。VpadnBanner はユーザーのタップ操作に反応して HTML5 の小さな広告を表示するもう 1 つの View のサブクラスです。全ての View と同じように、AdView もコードだけで作成できます。また、大部分は XML でも作成できます。バナーを追加するには、次の 5 つのコードが必要です。

com.vpadn.ads.*をインポートする
VpadnBanner インスタンスを宣言する
BannerId、つまり Vpon を申請する License Key を指定してインスタンスを作成する
ビューをユーザインターフェースに追加する
広告を通じてインスタンスを読み込む
これらすべての処理を最も簡単に実行できるのはアプリの Activity 内です。

import com.vpadn.ads.*
public class MainActivity extends Activity {
  	private RelativeLayout adBannerLayout;
  	private VpadnBanner vponBanner = null;
  	//TODO: Vpon プロパティID
  	private String bannerId = "License Key";

         @Override
  	protected void onCreate(Bundle savedInstanceState) {
  		super.onCreate(savedInstanceState);
  		setContentView(R.layout.activity_main);
  		//バナーのレイアウトを設定
  		adBannerLayout = (RelativeLayout) findViewById(R.id.adLayout);
  		//VpadnBannerインスタンスの作成
                  vponBanner = new VpadnBanner(this, bannerId, VpadnAdSize.SMART_BANNER, "TW");
  		VpadnAdRequest adRequest = new VpadnAdRequest();
  		//自動リフレッシュでバナーをリクエストできるよう設定する
  		adRequest.setEnableAutoRefresh(true);
                   //バナーを取得開始する
  		vpadnBanner.loadAd(adRequest);
                    //レイアウト上にバナーを設定する
  		adBannerLayout.addView(vponBanner);
  	}

  	@Override
  	protected void onDestroy() {
  		super.onDestroy();
  		if (vponBanner != null) {
  			/バナーを表示する準備ができたら、必ずdestroy を呼び出す
  			vponBanner.destroy();
  			vponBanner = null;
  		}
  	}
}

XMLでバナーを表示する

直接XMLでバナーを定義することができます。この場合、Java codeを作成する必要はありません。

  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:vpadn="http://schemas.android.com/apk/lib/com.vpadn.ads"
      android:id="@+id/mainLayout"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      android:orientation="vertical" >

  <RelativeLayout
          android:id="@+id/adLayout"
          android:layout_width="match_parent"
          android:layout_height="wrap_content" >

          <com.vpadn.ads.VpadnBanner
              android:id="@+id/vpadnBannerXML"
              android:layout_width="wrap_content"
              android:layout_height="wrap_content"
              vpadn:adSize="SMART_BANNER"
              vpadn:autoFresh="true"
              vpadn:bannerId= "License Key"
              vpadn:loadAdOnCreate="true"
              vpadn:platform="TW" />
      </RelativeLayout>
  </LinearLayout>

上記の vpon:bannerId=に実際のプロパティID を記入することを忘れないでください。プロパティID がまだ審査を完了していない場合、以下の方法でテスト広告を取得することができます。

      VpadnAdRequest adRequest =  new VpadnAdRequest();
      HashSet<String> testDeviceImeiSet = new HashSet<String>();
      testDeviceImeiSet.add("your device advertising id");
      //TODO: テスト用端末のAdvertising IDを入力
      adRequest.setTestDevices(testDeviceImeiSet);
      vponBanner.loadAd(adRequest);

以下のコードで端末の Advertising IDを取得することができます。

Eclipse上のログから”advertisingId”を検索する
端末を直接操作する：Google設定＞広告＞この端末の広告ID

バナー広告のサイズ

スマートフォン用の 320x50 以外に、タブレット向けの広告サイズもサポートしています。

サイズ (幅 x 高さ)	説明	VponAdSize 定数値
320x50	標準のバナー広告	VpadnAdSize.BANNER
300x250	IAB ミディアムレクタングル広告	VpadnAdSize.IAB_MRECT
468x60	IAB フルサイズバナー広告	VpadnAdSize.IAB_BANNER
728x90	IAB ビッグバナー広告	VpadnAdSize.IAB_LEADERBOARD
device width x auto height	Smart Banner	VpadnAdSize.SMART_BANNER

特定のニーズがない場合、Smart banner の使用で十分です (現在、 VpadnAdSize.IAB_WIDE_SKYSCRAPER はサポートしていません)

広告のリフレッシュ

以下のサンプルコードを使用するとバナーの自動リフレッシュがオンとなります。

   VpadnAdRequest adRequest = new VpadnAdRequest();
   //true に設定すると、自動リフレッシュが可能
   adRequest.setEnableAutoRefresh(true);
   adShowBanner.loadAd(adRequest);

サンプルコードのダウンロード

Go to download page

結果

実行すると、ディスプレイ上部にバナーが表示されます。 successful result example

ヒント

より詳細な情報はンタースティシャル広告、メディエーション、詳細設定をご確認ください。

Android - バナー広告