# Android スタートガイド

このガイドでは、アプリにGeniee広告SDKをインストールする手順を説明します。

インストール手順:

1. 事前準備
2. Mavenでライブラリを導入する
3. 手動でライブラリを導入する
4. マニフェストファイルの記述

# 事前準備

Geniee 広告SDKを使用するには、Google Play Services SDKを必ず導入する必要があります。 Google Play Services SDKの導入手順は以下の通りです。

1. Module>build.gradleのdependenciesに以下を追加します。

dependencies {
        implementation 'com.google.android.gms:play-services-ads:20.0.0'
}

• Google Play Services SDKを既に導入済み場合、追加は必要ありません。
  • Google Developers公式サイトSetting Up Google Play Services
  • Project StructureのDependenciesに追加されていることを確認します。

<manifest>
	<application>
		<!-- TODO: Replace with your real AdMob app ID -->
		<meta-data
			android:name="com.google.android.gms.ads.APPLICATION_ID"
			android:value="ca-app-pub-################~##########"/>
	</application>
</manifest>

<manifest>
	<application>
		<meta-data
			android:name="com.google.android.gms.ads.AD_MANAGER_APP"
			android:value="true"/>
	</application>
</manifest>

dependencies {
        implementation 'com.google.android.gms:play-services-ads-identifier:{{$version.android.playServicesAdsIdentifier}}'
}

# Mavenでライブラリを導入する(推奨)

1. Project>build.gradleのallprojects>repositoriesに以下を追加します。

allprojects {
		repositories {
			maven { 
				url 'http://raw.github.com/geniee-ssp/Geniee-Android-SDK/master/repository'
			}
		}
}  

2. Module>build.gradleのdependenciesに以下を追加します。

dependencies {
    implementation 'jp.co.geniee.gnadsdk:GNAdSDK:8.5.1'
}

3. 実装例

• Project>build.gradle

allprojects {
		repositories {
			google()
			jcenter()
			maven { url "https://github.com/geniee-ssp/Geniee-Android-SDK/raw/master/repository" }
		}
}

• Module>build.gradle

dependencies {
	implementation fileTree(include: ['*.jar'], dir: 'libs')
	implementation 'com.android.support:appcompat-v7:26.1.0'
	implementation 'com.android.support.constraint:constraint-layout:1.1.1'
        implementation 'com.google.android.gms:play-services-ads:20.0.0'
	//Geniee SDK
	implementation 'jp.co.geniee.gnadsdk:GNAdSDK:8.5.1'
}

# 手動でライブラリを導入する

Mavenでライブラリを導入する の手順を実行した場合、この手順は実行する必要はありません。

dependencies {
	implementation fileTree(include: ['*.jar'], dir: 'libs')
	implementation 'com.android.support:appcompat-v7:26.1.0'
	implementation 'com.android.support.constraint:constraint-layout:1.1.3'
        implementation 'com.google.android.gms:play-services-ads:{{$version.android.playServicesAds}}'
}

# マニフェストファイルの記述

マニフェストファイル AndroidManifest.xml に必要情報を記述します。

# Mavenでライブラリを導入する,手動でライブラリを導入する共通のマニフェストファイルの記述

1. SDKが使用する Google Play Services SDK 情報を記述します。マニフェストファイルの<application>に記述します。

<meta-data android:name="com.google.android.gms.version"
android:value="@integer/google_play_services_version"/>

2. RewardVideo以外の場合、SDKが使用する位置情報取得パーミッションを記述します。（オプション）
   • 「ACCESS_COARSE_LOCATION」、「ACCESS_FINE_LOCATION」どちらか一方の記述でも問題ありません。
   • 位置情報利用しない場合については記述不要です。

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

# 手動でライブラリを導入するを実施した場合のマニフェストファイルの記述

GNAdSDK4.0.0以降でMavenでライブラリを導入するの手順を実行した場合、以下の手順は実行する必要はありません。

3. SDKが使用するアクティビティの情報を記述します。

   • マニフェストファイルの<application>に記述します。
     
     • Bannerの場合

   <!-- Banner -->
   <activity android:name="jp.co.geniee.gnadsdk.banner.GNAdWebActivity"
   android:label="@string/app_name" android:screenOrientation="portrait"/>
   

   1
   2
   3
   
   • 動画リワードの場合
     動画リワード広告で記載。

4. 以下のパーミッションを記述します。

   <uses-permission android:name="android.permission.INTERNET"/>
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
   <uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES" />
   

   1
   2
   3