Android 全画面型 終了時 v3.3

提供: GAMEFEAT マニュアル
移動: 案内検索

Android 全画面広告をアプリ終了時(バックキー押下)の実装方法の手順を解説します。

目次

Android広告IDについて

GAMEFEAT SDK v3.3.0から、Android広告IDに対応しました。SDKの導入には、Google Play Serviceへの対応が必要になります。

また、動作環境としてはAndroid2.3以降となります。

Google Play Servicesの対応はこちらをご覧ください

SDKファイルのダウンロード

パートナー管理画面 SDK/マニュアルからAndroidのSDKファイルをダウンロードして下さい。

jarファイルの読み込み

ダウンロードしたSDKに付属されている「GameFeatSdk.jar」をEclipseのlibsディレクトリへ配置してください。

配置方法は、プロジェクト名を右クリックして、「Javaのビルド・パス > ライブラリ」で「外部Jar追加...」を選択し、GameFeatSdk.jarを追加します。

AndroidManifest.xmlの編集

パーミッション設定

AndroidManifest.xmlのmanifestタグ内に以下のコードを記述してください。

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

※ GameFeatSDKではインターネット通信が必要となるため、上記のパーミッションが必要となります。

GAME FEATの基本設定

GameFeatSDKの基本情報を設定します。

AndoridManifest.xmlのapplicationタグ内に、以下のコードを記述してください。

<!-- GameFeat START -->
<meta-data android:name="gamefeat_site_id" android:value="【メディアID】" />
<activity
	android:name="jp.basicinc.gamefeat.android.sdk.view.GameFeatAppActivity"
	android:configChanges="orientation|keyboardHidden"
	android:label="GameFeat" >
</activity>
<activity
  	android:name="jp.basicinc.gamefeat.android.sdk.view.GameFeatAppChildActivity"
  	android:configChanges="orientation|keyboardHidden"
	android:label="GameFeat"
	android:screenOrientation="sensor" >
</activity>
<receiver
	android:name="jp.basicinc.gamefeat.android.sdk.receiver.GameFeatBroadcastReceiver"
	android:enabled="true"
	android:exported="false">
	<intent-filter>
		<action android:name="android.intent.action.PACKAGE_ADDED"/>
		<data android:scheme="package"/>
	</intent-filter>
</receiver>
<meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" />
<!-- GameFeat END -->

※【メディアID】は管理画面よりご確認いただけます。

APIレベルが13以上の場合は android:configChanges 属性に screenSize を追加して下さい。

<activity
	android:name="jp.basicinc.gamefeat.android.sdk.view.GameFeatAppActivity"
	android:configChanges="orientation|keyboardHidden|screenSize"
	android:label="GameFeat" >
</activity>
<activity
  	android:name="jp.basicinc.gamefeat.android.sdk.view.GameFeatAppChildActivity"
  	android:configChanges="orientation|keyboardHidden|screenSize"
	android:label="GameFeat"
	android:screenOrientation="sensor" >
</activity>

GAME FEAT初期化設定

GAME FEATの広告を表示するために、メインアクティビティ(一番最初に起動されるアクティビティ)にて、SDKの初期化設定が必要です。

import jp.basicinc.gamefeat.android.sdk.controller.GameFeatAppController;
// 略…


GameFeatAppController gfAppController;

@Override
protected void onCreate(Bundle savedInstanceState) {
	super.onCreate(savedInstanceState);
	setContentView(R.layout.activity_main);

	// GFコントローラ
	gfAppController = new GameFeatAppController();
}

@Override
public void onStart() {
	super.onStart();
	// 広告設定初期化
	gfAppController.activateGF(MainActivity.this, false, false, false);
}

// 初期化コードの引数
activateGF(【Activity名】.this, カスタム広告の使用, アイコン広告の使用, 全画面広告の使用);

使用する広告の種類に合わせてBoolean(true / false)を引数として設定をしてください。 全画面型のみを使用される場合は、

gfAppController.activateGF(MainActivity.this, false, false, true);

と記述をしてください。

全画面広告(終了時)の表示方法

全画面広告を表示したいタイミング(バックキー押下時など)に以下のコードを記述してください。

import jp.basicinc.gamefeat.android.sdk.controller.GameFeatAppController;
// 略…


GameFeatAppController gfAppController;

@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
	if (keyCode == KeyEvent.KEYCODE_BACK) {
		gfAppController.showExitPopupAdDialog(【アクティビティ名】.this);
		return true;
	}
	return super.onKeyDown(keyCode, event);
}

実行すると、全画面広告が表示されます。

※【Activity名】は、任意のActivityクラス名に差し替えてください

全画面広告のリスナー設定

全画面広告を開いた時/閉じた時/開けなかった時に、イベントリスナーを設定することが出来ます。

import jp.basicinc.gamefeat.android.sdk.controller.GameFeatAppController;
import jp.basicinc.gamefeat.android.sdk.view.listener.GameFeatPopupListener;
// 略…


GameFeatAppController gfAppController;

@Override
protected void onCreate(Bundle savedInstanceState) {
	super.onCreate(savedInstanceState);
	setContentView(R.layout.activity_main);

	// GFコントローラ
	gfAppController = new GameFeatAppController();

	// 指定した数値を母数としてランダム表示します(例えば2を指定した場合は、1/2の確立で表示されます)
	gfAppController.setPopupProbability(1);

	// GF 全画面起動
	gfAppController.showExitPopupAdDialog(【アクティビティ名】.this, new GameFeatPopupListener() {

		@Override
		public void onViewSuccess() {
			// 全画面広告を開いた時
		}

		@Override
		public void onViewError() {
			// 全画面広告が開けなかった時
		}

		@Override
		public void onClickFinished() {
			// アプリ終了ボタン押下時(終了時広告時に使用)
		}

		@Override
		public void onClickClosed() {
			// 広告閉じるボタン押下時
		}

		@Override
		public void onDismiss() {
			// 広告閉じるボタン押下 + Android端末の戻るボタン押下時
		}
	});
}

コンバージョン確認方法

GameFeat SDKの広告一覧画面よりアプリを選択するとGoogle Playが起動いたしますので、対象のアプリをインストールしてください。

インストール完了後、GameFeat SDKがインストール情報をGameFeatサーバーへ送信いたしますので、管理画面より成果をご確認いただけます。

※管理画面の反映には10分程度かかります。

個人用ツール
名前空間

変種
操作
Androidへの導入
iOSへの導入 (新SDK)
iOSへの導入 (旧 GAMEFEAT SDK)
Unityへの導入方法
Cocos2dx(Android)への導入方法
Cocos2dx(iOS)への導入方法
Q&A
ツールボックス