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, true, false);
}
// 初期化コードの引数
activateGF(【Activity名】.this, カスタム広告の使用, アイコン広告の使用, 全画面広告の使用);

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

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

と記述をしてください。

アイコンの表示方法

アイコンを表示するActivityのレイアウトxmlファイルに下記のViewを追加します。

<view
    android:id="@+id/gf_icon1"
    android:layout_width="60dp"
    android:layout_height="60dp"
    android:layout_alignParentTop="true"
    class="jp.basicinc.gamefeat.android.sdk.view.GameFeatIconView" />
<view
    android:id="@+id/gf_icon2"
    android:layout_width="60dp"
    android:layout_height="60dp"
    android:layout_alignParentTop="true"
    class="jp.basicinc.gamefeat.android.sdk.view.GameFeatIconView" />

viewは通常のAndroidアプリと同様に、Layout上に配置します。

※アイコンの大きさは、layout_width, laout_heightで指定が可能です。

Activityのlayout.xmlに配置したviewをonCreateで初期化します。

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


GameFeatAppController gfAppController;

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

        // GFコントローラ
        gfAppController = new GameFeatAppController();
        gfAppController.init(【アクティビティ名】.this);
	
        // アイコン広告の自動更新間隔(秒)指定:標準で30秒
        gfAppController.setRefreshInterval(30);

        ((GameFeatIconView) findViewById(R.id.gf_icon1)).addLoader(gfAppController);
        ((GameFeatIconView) findViewById(R.id.gf_icon2)).addLoader(gfAppController);
        ((GameFeatIconView) findViewById(R.id.gf_icon3)).addLoader(gfAppController);
        ((GameFeatIconView) findViewById(R.id.gf_icon4)).addLoader(gfAppController);
}

※アイコン広告は最大20個まで設定が可能です。
※setRefreshIntervalメソッドを使って、アイコンの更新間隔を秒単位で指定できます。

初期化したアイコン広告は、onResumeでstartIconAdを呼び出すことで広告は表示されます。 startIconAdにより表示を開始したアイコン広告はデフォルトでは30秒毎に自動更新されます。

@Override
public void onResume() {
        super.onResume();
        // アイコン広告の自動更新開始
        gfAppController.startIconAd();
}

他のActivityに遷移する場合は、アイコン広告の自動更新を停止するため、stopIconAdを呼び出します。

@Override
public void onStop() {
        super.onStop();
        // アイコン広告の自動更新停止
        gfAppController.stopIconAd();
}

アイコン広告のテキスト非表示

アイコン広告のテキストを非表示にする場合は、setIconTextDisplayを呼び出します。
引数がtrueの場合表示、falseの場合非表示になります。
また呼び出さない場合は、自動的に表示になります。

@Override
 protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      // GFコントローラ
      gfAppController = new GameFeatAppController();
      //テキストを非表示
      gfAppController.setIconTextDisplay(false);
      //略...
 }

コンバージョン確認方法

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

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

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

個人用ツール
名前空間

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