Skip to content

Commit e227b37

Browse files
author
Takayuki Sei
committed
add SDK Ver 4.0.0
1 parent 89b07b1 commit e227b37

File tree

63 files changed

+1086
-206
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

63 files changed

+1086
-206
lines changed

‎HOW-TO-SETUP.md

+136
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,136 @@
1+
# fluct 広告配信 SDK for Android 簡易導入ガイド
2+
以下が簡易導入手順となります。
3+
4+
## app/build.gradle への追加
5+
### FluctSDK の リモート maven リポジトリ を設定します
6+
```gradle
7+
repositories {
8+
// FluctSDK maven repository
9+
maven {
10+
url 'https://raw.github.com/voyagegroup/FluctSDK-Android/master/m2/repository/'
11+
}
12+
}
13+
```
14+
15+
### dependencies へ以下の依存情報を設定します
16+
```gradle
17+
dependencies {
18+
...
19+
// FluctSDK
20+
compile 'jp.fluct:FluctSDK:+'
21+
// Google play services - base
22+
compile 'com.google.android.gms:play-services-base:+'
23+
...
24+
}
25+
```
26+
- この記述だと最新のバージョンを使用するようになっていますが、バージョン番号指定をしてもらうと、問題発生時にサポートしやすくなります。
27+
28+
## app/src/main/AndroidManifest.xml へ追加
29+
### FluctSDK を使用する上で必要な uses-permission を追加します
30+
```xml
31+
<manifest
32+
...
33+
<!-- FluctSDK using permission -->
34+
<uses-permission android:name="android.permission.INTERNET"/>
35+
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
36+
```
37+
38+
### Google play services version 定義を追加します
39+
```xml
40+
<application
41+
...
42+
<!-- Required Google play services definition for using FluctSDK -->
43+
<meta-data android:name="com.google.android.gms.version"
44+
android:value="@integer/google_play_services_version"/>
45+
```
46+
47+
### インタースティシャル広告 を使用する場合、以下の Activity 設定を追加します
48+
```xml
49+
<!-- Required Activity definition for using FluctInterstitial -->
50+
<activity
51+
android:name="jp.fluct.fluctsdk.FluctInterstitialActivity"
52+
android:configChanges="orientation|keyboardHidden|screenSize"
53+
android:theme="@android:style/Theme.Translucent.NoTitleBar"
54+
android:launchMode="singleTask">
55+
</activity>
56+
```
57+
58+
- 以上の記述追加/設定により、 FluctSDK を使用する準備ができます。
59+
60+
## メディア ID の設定
61+
- 広告を表示する際には、弊社システムで 貴社アプリ広告枠 を識別するため発行される **メディア ID** が必要となります。
62+
- 貴社アプリ広告枠毎の **メディア ID** は弊社担当営業にお問い合わせください。
63+
- アプリの開発時およびテスト時には、必ず **テスト用 メディア ID** を使用してください。
64+
- **0000000108** が バナー広告 および インタースティシャル広告 の **テスト用 メディア ID** となっています。
65+
- 公開前に実際の広告を表示する必要がある場合も、表示された広告をタップしないでください。
66+
67+
### AndroidManifest.xml で定義 (バナー広告/インタースティシャル広告)
68+
- アプリ内全般で使用されます。
69+
- こちらは **オプション** としての実装方法となります。
70+
```xml
71+
<application
72+
...
73+
<meta-data android:name="FLUCT_MEDIA_ID" android:value="{メディアID}"/>
74+
```
75+
76+
## バナー広告
77+
- 特定サイズでの広告表示となります。
78+
- レイアウト幅としては match_parent 、高さは wrap_content を指定する事を推奨しますが、固定サイズを指定する場合は、 320dp x 50dp は最低限確保するようにしてください。
79+
- 詳細は [導入仕様書](fluct広告配信SDK導入仕様書.pdf) を参照してください。
80+
81+
### 実装例 (レイアウトXML)
82+
83+
- 配置するレイアウトに FluctView を追加します。
84+
- ここで メディアID を指定する実装が、推奨実装方法となります。
85+
86+
```xml
87+
<jp.fluct.fluctsdk.FluctView
88+
android:layout_width="match_parent"
89+
android:layout_height="wrap_content"
90+
FLUCT_MEDIA_ID="{メディアID}"/>
91+
```
92+
93+
### 実装例 (コード)
94+
95+
- 配置する Activity / Fragment で FluctView を追加するコードを記述します。
96+
97+
```java
98+
FluctView banner = new FluctView(this, "{メディアID}");
99+
100+
...
101+
102+
addView(banner);
103+
```
104+
105+
## インタースティシャル広告
106+
- 全画面を覆う広告表示となります。
107+
- 詳細は [導入仕様書](fluct広告配信SDK導入仕様書.pdf) を参照してください。
108+
109+
### 実装例 (コード)
110+
111+
- 表示する Activity / Fragment で FluctInterstitial を使用します。
112+
- ここで メディアID を指定する実装が、推奨実装方法となります。
113+
114+
* 初期化
115+
```java
116+
FluctInterstitial mInterstitial;
117+
118+
...
119+
120+
mInterstitial = new FluctInterstitial(this, "{メディアID}");
121+
```
122+
123+
- 表示
124+
```java
125+
mInterstitial.showInterstitialAd();
126+
```
127+
128+
- 終了化
129+
```java
130+
mInterstitial.destroy();
131+
mInterstitial = null;
132+
```
133+
134+
---
135+
## LICENSE
136+
Copyright fluct, Inc. All rights reserved.

‎LICNSE ‎LICENSE

+2
Original file line numberDiff line numberDiff line change
@@ -1 +1,3 @@
11
Copyright fluct, Inc. All rights reserved.
2+
http://fluct.jp/
3+

‎MIGRATION-GUIDE.md

+115
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,115 @@
1+
# 旧バージョンからの移行ガイド
2+
3+
v4.0.0 より、ライブラリの形式を JAR から AAR に変更しました。
4+
それにより、使用中の SDK を削除して新しい SDK を使用する設定が必要となります。
5+
6+
## Android Studio にて使用中
7+
8+
### 旧バージョンの削除
9+
10+
- JAR ファイルを libs 等に直接配置をして使用していた場合
11+
1. libs 等に現在使用している FluctSDK の jar ファイルを削除します。
12+
13+
- サブモジュールとして JAR ファイルを追加して使用していた場合
14+
1. File > Project Structure を選択します。
15+
2. 左ペインの Modules にある FluctSDK のサブモジュールを選択します。
16+
3. 上にある 「-」 を押下でサブモジュールを削除します。
17+
18+
### build.gradle の修正
19+
1. FluctSDK を直接参照している記述がある場合、その記述を削除します。
20+
2. dependencies の Google play services 依存記述を base のみに変更します。
21+
22+
```gradle
23+
compile 'com.google.android.gms:play-services:+'
24+
```
25+
を
26+
```gradle
27+
compile 'com.google.android.gms:play-services-base:+'
28+
```
29+
に変更します。
30+
31+
- 上記のバージョン記述であれば、常に最新版を使用することになりますが、バージョン番号の指定を行うようにしてもらうと、問題発生時に原因の特定がしやすくなります。
32+
33+
### 新バージョン 設定
34+
35+
- [fluct 広告配信 SDK for Android 簡易導入ガイド](HOW-TO-SETUP.md) を参考に新バージョンを使用できる設定を行います。
36+
37+
### クラスパス 修正
38+
39+
- java ソース、 レイアウト XML、 AndroidManifest.xml 指定してあるクラスパスを変更します。
40+
41+
1. FluctView
42+
```java
43+
jp.co.voyagegroup.android.fluct.jar.FluctView
44+
```
45+
を
46+
```java
47+
jp.fluct.fluctsdk.FluctView
48+
```
49+
に変更します。
50+
51+
2. FluctInterstitial
52+
```java
53+
jp.co.voyagegroup.android.fluct.jar.FluctInterstitial
54+
```
55+
を
56+
```
57+
jp.fluct.fluctsdk.FluctInterstitial
58+
```
59+
に変更します。
60+
61+
3. FluctInterstitialActivity
62+
```xml
63+
jp.co.voyagegroup.android.fluct.jar.FluctInterstitialActivity
64+
```
65+
を
66+
```
67+
jp.fluct.fluctsdk.FluctInterstitialActivity
68+
```
69+
に変更します。
70+
71+
## Eclipse にて使用中でそのまま使用したい
72+
73+
- 基本的には Android Studio への移行をお勧めしますが、どうしても Eclipse でビルドを行いたい場合、JAR ファイルを個別にて提供しますので、弊社担当営業までご連絡ください。
74+
75+
### jar ファイルを差し替え
76+
77+
- 現在使用している SDK の JAR ファイル を 新しい SDK の JAR ファイル に差し替えます。
78+
79+
### ライブラリ参照変更
80+
81+
- プロジェクトプロパティ > Java Build Path > Libraries で、旧 SDK を削除し、新 SDK を追加します。
82+
83+
### クラスパス変更
84+
85+
- java ソース と レイアウト XML と AndroidManifest.xml にある FluctView と FluctInterstitial のクラスパスを変更します。
86+
87+
1. FluctView
88+
```java
89+
jp.co.voyagegroup.android.fluct.jar.FluctView
90+
```
91+
を
92+
```java
93+
jp.fluct.fluctsdk.FluctView
94+
```
95+
に変更します。
96+
97+
2. FluctInterstitial
98+
```java
99+
jp.co.voyagegroup.android.fluct.jar.FluctInterstitial
100+
```
101+
を
102+
```
103+
jp.fluct.fluctsdk.FluctInterstitial
104+
```
105+
に変更します。
106+
107+
3. FluctInterstitialActivity
108+
```xml
109+
jp.co.voyagegroup.android.fluct.jar.FluctInterstitialActivity
110+
```
111+
を
112+
```
113+
jp.fluct.fluctsdk.FluctInterstitialActivity
114+
```
115+
に変更します。

‎README.md

+31-8
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,38 @@
1-
# FluctSDK
1+
# fluct 広告配信 SDK for Android
22

3-
## Installation
4-
* [fluct広告配信SDK導入仕様書(Android).pdf](https://github.com/voyagegroup/FluctSDK-Android/blob/master/fluct%E5%BA%83%E5%91%8A%E9%85%8D%E4%BF%A1SDK%E5%B0%8E%E5%85%A5%E4%BB%95%E6%A7%98%E6%9B%B8(Android).pdf)をご確認下さい
3+
## 前提条件
4+
* Android Studio 1.0 以降
5+
* Android レベル 9 (Gingerbread) 以降
56

6-
# FluctSDK Release Note
7+
## 導入
8+
以下のいずれかを参照してください
9+
* [fluct 広告配信 SDK for Android 簡易導入ガイド](HOW-TO-SETUP.md)
10+
* [fluct 広告配信 SDK for Android 導入仕様書 (PDF)](fluct広告配信SDK導入仕様書.pdf)
711

8-
## v3.2.2 2016/01/15
9-
* GitHub上で公開
12+
## 旧バージョンからの移行
13+
* [旧バージョンからの移行ガイド](MIGRATION-GUIDE.md)
1014

11-
## v3.2.2 以前の変更点について
12-
* [fluct広告配信SDK導入仕様書(Android).pdf](https://github.com/voyagegroup/FluctSDK-Android/blob/master/fluct%E5%BA%83%E5%91%8A%E9%85%8D%E4%BF%A1SDK%E5%B0%8E%E5%85%A5%E4%BB%95%E6%A7%98%E6%9B%B8(Android).pdf)をご確認下さい
15+
## 最新リリースノート
1316

17+
### v4.0.0 - 2016/10/17
18+
19+
#### 新規追加
20+
* FluctView コールバック
21+
22+
#### 変更
23+
* 主開発環境を Android Studio
24+
* ライブラリファイル形式を Android Library (.AAR)
25+
* ライブラリ提供方式を リモート maven リポジトリ
26+
* FluctSDK クラスパス
27+
* FluctInterstitial コールバック
28+
29+
## 以前の変更点について
30+
* [改版履歴](RELEASES.md)をご確認下さい。
31+
32+
## JAR 提供について
33+
v4.0.0 より提供するライブラリファイル形式を変更させていただきました。<br/>
34+
もし .JAR ファイルにて fluct 広告配信 SDK for Android を提供して欲しい場合は、弊社営業担当までご連絡ください。
35+
36+
---
1437
## LICENSE
1538
Copyright fluct, Inc. All rights reserved.

‎RELEASES.md

+75
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
# 改版履歴
2+
3+
## v3.2.2 - 2016/01/15
4+
* GitHub 上で公開
5+
6+
## v3.2.2 - 2015/10/22
7+
* 内部コードの Android 6 対応
8+
9+
## v3.2.1 - 2014/12/11
10+
* 内部リソースの最適化
11+
12+
## v3.2.0 - 2014/08/12
13+
* Google 広告 ID ("advertising ID") 対応
14+
* デモグラ機能の削除
15+
16+
## v3.1.0 - 2014/06/01
17+
* メディア ID 英数字対応
18+
19+
## v3.0.1 - 2013/12/10
20+
* アプリ起動時に圏外の際に広告表示を行うと View サイズが拡大する不具合に対応
21+
22+
## v3.0.0 - 2013/10/25
23+
* インタースティシャル広告対応追加
24+
25+
## v2.1.0 - 2013/10/17
26+
* アニメーション対応追加
27+
28+
## v2.0.3 - 2013/09/12
29+
* 広告更新の際に自動でスクロールしてしまう不具合に対応
30+
31+
## v2.0.2 - 2013/05/21
32+
* 不具合修正
33+
34+
## v2.0.1 - 2013/02/13
35+
* AdNetwork 向け対応
36+
37+
## v2.0.0 - 2013/02/12
38+
* 広告表示高速化対応
39+
40+
## v1.3.2 - 2012/09/27
41+
* 不具合修正
42+
43+
## v1.3.1 - 2012/09/20
44+
* 動的 API 追加対応
45+
* AdNetwork 向け対応
46+
47+
## v1.3.0 - 2012/07/18
48+
* 広告表示高速化対応
49+
50+
## v1.1.5 - 2012/07/06
51+
* Unity や jsWaffle にて広告をタップした際にリセットが発生する不具合に対応
52+
53+
## v1.1.4 - 2012/07/03
54+
* 不具合修正
55+
56+
## v1.1.3 - 2012/04/02
57+
* F-05D / ISW11F にて初回起動時にリセットが発生する不具合に対応
58+
59+
## v1.1.2 - 2012/03/15
60+
* アップデート時の不具合修正
61+
62+
## v1.1.1 - 2012/02/16
63+
* 不具合修正
64+
65+
## v1.1.0 - 2012/01/04
66+
* デモグラ機能追加
67+
68+
## v1.0.2 - 2011/12/02
69+
* 複数広告表示対応
70+
71+
## v1.0.1 - 2011/10/17
72+
* 不具合修正
73+
74+
## v1.0.0 - 2011/09/30
75+
* 新規リリース

0 commit comments

Comments
 (0)