Skip to main content

Android - インテグレーションガイド

Vpon SDK 基本編


旧バージョンのSDKをご利用の場合、まず最新版のSDKにバージョンアップするための修正をご確認ください。 SDK4.5.1+ の最新バージョンへのアップデート方法

  1. まず下記URLから登録済みネットワークプラットフォームを確認してください:
    台湾: http://console.vpon.com/

  2. 台湾のプラットフォームを利用する場合、以下をご利用ください:
    vponBanner = new VpadnBanner(this, bannerId, VpadnAdSize.SMART_BANNER, “TW”);

概要


Vpon バナー広告は、小さなエリアを利用し、ユーザーにクリックさせることで、ウェブサイトもしくはアプリのダウンロードページなどの情報豊富なフルスクリーンページへ遷移させます。ここではあなたのアプリへバナー広告を配信する方法をご案内します。

Android アプリでバナー広告を表示させるためには、Eclipse プロジェクトにSDKを導入し、ユーザインターフ ェースに com.vpadn.ads.VpadnBanner を追加するだけです。

SDK の導入


Vpon provides two ways to integrate our SDK. Choose one of the following two options:

Streamlined, using Maven

Follow the description below and add the link of the Maven repository in allprojects in the project-level build.gradle.

allprojects {
    repositories {
        jcenter()
        maven{
            url 'https://dl.bintray.com/vpon-sdk/maven'
        }
    }
}

Add the compile dependency with the assigned version of the Vpon SDK in the app-level build.gradle (Here take SDK 4.6.0 for example).

dependencies {
    ...
    compile 'com.vpon:vpadnSDK:4.6.0'
}

Publisher can revise the above-mentioned to 'com.vpon:vpadnSDK:4.6.+' to gain the latest SDK in version 4.6.


Manual, using the SDK download

アプリにVpon広告を導入するためには、次の3つのステップを完了させてください。

  1. Android Studio プロジェクトに Vpon SDK JAR を追加します。
  2. AndroidManifest.xml で com.vpadn.widget.VpadnActivity を宣言 します。
  3. 情報マニフェストで必要な permissions を設定します。

Android Studio


  1. Find libs in your Android project (Route:Project Name -> app -> Android プロジェクトの「libs」を選んでください。(ルート:プロジェクト名 -> app -> libs)

  2. libs の所で右クリックをし、Reveal in Finder を選び左クリックしてください。

  3. ダウンロードした JAR を Finder にある libs に移動させてください。(IDE で libs に Vpon JAR をドラッグして入れることも可能です)

  4. Android プロジェクトに戻り、先ほど追加した Vpon JAR が libs に表示されていること を確認してください。参考リンク先をリンクさせるには、右クリックし、ライブラリとし て追加を選択してください。同時に、「コンパイルファイル (‘libs/vpon_SDK_version_name.jar’)」という文章があるか、 build.gradle を確認してくださ い。下の写真をご参考ください

VpadnActivity


以下の設定を AndroidManifest.xml に追加します。

<activity
  android:name="com.vpadn.widget.VpadnActivity"
  android:configChanges="orientation|keyboardHidden|navigation|keyboard|screenLayout|uiMode|screenSize|smallestScreenSize"
  android:theme="@android:style/Theme.Translucent"
  android:hardwareAccelerated="true" >
</activity>

Note: 上記の各属性はいずれも必須で、その値は全て同じとなります。


パーミション


以下のパーミッションを AndroidManifest.xml に追加します。

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

上記3つは 必須パーミッションとなります。さらに、下記のパーミッションを追加することで、より正確にエリアターゲティング広告を取得いただくことをお奨めいたします。

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

ビデオ広告をサポートするために、アクティビティにてハードウェアアクセラレータを有効にしていただくことをお奨めいたします。

<activity
  android:name="com.vpadn.example.MainActivity"
  android:label="@string/app_name"
  android:configChanges="keyboardHidden|orientation"
  android:hardwareAccelerated="true" >
  <intent-filter>
    <action android:name="android.intent.action.MAIN" />
    <category android:name="android.intent.category.LAUNCHER" />
  </intent-filter>
</activity>

3rd-party Library


Vpon SDK start to import 3rd-party Library - Retrofit from 4.8.0, please follow the steps below to import Retrofit:

  1. Import Retrofit manually: [Download Retrofit here] and import the .jar file to your project.
  2. Import Retrofit with Maven: Please add the snippet below to your build.gradle in App-level to import Retrofit.
dependencies {
    ...
    implementation 'com.squareup.retrofit2:retrofit:2.4.0'
}

Proguard Configuration


APP 自体が proguard の難読化を経る必要がある場合、次の設定を追加してください。

-dontwarn c.**
-dontwarn com.vpon.**
-dontwarn vpadn.**
-keep class c.**{ *; }
-keep class com.vpon.** { *; }
-keep class vpon.** { *; }
-keep class com.vpadn.** { *; }
-keep class vpadn.** { *; }

<!-- ----------- acquired since 4.8.0 start --------- -->
-dontnote retrofit2.Platform
-dontwarn retrofit2.Platform$Java8
-dontwarn okhttp3.internal.platform.*
-keepattributes Exceptions
-keepattributes Signature
-dontwarn okio.**
-dontwarn javax.annotation.**
<!-- ----------- acquired since 4.8.0 end --------- -->

Tips


より詳細な情報は

をご確認 ください。