The basebillingads from thangikcu

Use ADS library

Gradle project

allprojects {
	repositories {
			...
		maven { url 'https://jitpack.io' }
	}
}

Gradle app

implementation 'com.github.khoahihi:BaseBillingAds:$lasted_version'

Cấu hình GoogleID và keyStore

android {
    ...
    signingConfigs {
        production {
            keyAlias 'als_pkg_keystore_release_product'
            keyPassword 'pkg_keystore_release_product'
            storeFile file('keyStore/pkg_keystore_release_product.jks')
            storePassword 'pkg_keystore_release_product'
        } 
        develop {
            keyAlias 'dev_pkg_keystore_release_product'
            keyPassword 'dev_pkg_keystore_release_product'
            storeFile file('keyStore/dev_pkg_keystore_release_product.jks')
            storePassword 'dev_pkg_keystore_release_product'
        }
    }
    flavorDimensions "phone"
    productFlavors {
        production {
            dimension "phone"
            versionName "1.0"
            versionCode 1
            signingConfig signingConfigs.production
            resValue "string", "ADMOB_APP_ID", "ca-app-pub-4441205939351023~5650050109"
            resValue "string", "banner_ad_unit_id", "ca-app-pub-3940256099942544/6300978111"
            resValue "string", "interstial_ad_unit_id", "ca-app-pub-3940256099942544/1033173712"
        }
        dev {
            dimension "phone"
            versionName "dev-1.0.0"
            versionCode 1
            signingConfig signingConfigs.develop
            resValue "string", "ADMOB_APP_ID", "ca-app-pub-4441205939351023~5650050109"
            resValue "string", "banner_ad_unit_id", "ca-app-pub-3940256099942544/6300978111"
            resValue "string", "interstial_ad_unit_id", "ca-app-pub-3940256099942544/1033173712"
        }
    }
    ...
}

Thay đổi pkg = PackageName

Base Production ID

interface Google {
    String PROD_IN_APP_INTERSTITIAL = "pkg.inapp.nonconsum.rminitial";
    String PROD_IN_APP_BANNER = "pkg.inapp.nonconsum.rmbanner";
    String PROD_IN_APP_CONSUME_1 = "pkg.inapp.consume.item1";
    String PROD_IN_APP_CONSUME_2 = "pkg.inapp.consume.item2";
    String PROD_IN_APP_CONSUME_3 = "pkg.inapp.consume.item3";
    String PROD_SUBS_1 = "pkg.subs.nonconsum.item1";
    String PROD_COMPARE_CONSUME = "inapp.consume";
}

interface Amazon {
    String PROD_CONSUME_GOLD_1 = "pkg.amziap.consum.buygold1";
    String PROD_CONSUME_GOLD_2 = "pkg.amziap.consum.buygold2";
    String PROD_CONSUME_GOLD_3 = "pkg.amziap.consum.buygold3";
    String PROD_ENTITLE_GOLD_DISCOUNT_1 = "pkg.amziap.entitle.buygold.discount1";
    String PROD_SUBS_BANNER = "pkg.amziap.subs.rmbanner";
    String PROD_SUBS_INTERSTITIAL = "pkg.amziap.subs.rminitial";
}

Sau Khi thêm 2 interface này vào dự án, thay đổi pkg thành PackageName của dự án, Lưu ý, bỏ com. ở đằng trước

Google Billing

I, Extend `AdsApplication`

Override prodInAppIds Trả về danh sách product ID của loại IN_APP
Override prodSubsIds Trả về danh sách product ID của loại SUBS
Override billingType Trả về BillingType.AMAZON
Override function onCreated Nếu cần app cần config tác vụ thì override lại hàm này
Override function addConfig VD:

override fun addConfig() {
    AdsComponentConfig
        .updateInterstitialKey(Google.PROD_IN_APP_INTERSTITIAL)
        .updateBannerKey(Google.PROD_IN_APP_BANNER)
        .updateBillingMapper(
            Google.PROD_IN_APP_CONSUME_1 mapping "1000",
            Google.PROD_IN_APP_CONSUME_2 mapping "3000",
            Google.PROD_IN_APP_CONSUME_3 mapping "5000",
            Google.PROD_SUBS_1 mapping "5000"
        ).updateConsumeKey(Google.PROD_COMPARE_CONSUME)
        .addActivitiesNonLoadBackground(MainActivity::class.java.name)

    BackgroundManager.attach(this)
}

updateInterstitialKey(): Gửi vào ProductID khi billing thành công sẽ loại bỏ Interstitial. updateBannerKey(): Gửi vào ProductID khi billing thành công sẽ loại bỏ Banner. updateBillingMapper(): Hàm này để định nghĩa ra ProductID so với số tiền (Khi billing loại ProductID nào sẽ cộng GOLD vào đúng với số đã config) updateConsumeKey(): Hàm này chỉ áp dụng đối với BillingType = Google, Vì loại INAPP và CONSUME được Google gom vào là 1, nên cần đặt ProductID khác so với loại INAPP, gửi vào 1 cấu trúc có thể so sánh (Contains) BackgroundManager.attach(this): Dùng để attach background vào tất cả các activity (Với điều kiện các màn hình đó có background transparent)

II, Use Class `AdsComponents`

Khi application của app đã extend 1 library khác mà không thể chỉnh sửa, thì sử dụng class này thay cho việc extend AdsApplication
Cấu hình:

val adsComponents by lazy {
        AdsComponents.inject(this)
            .withProdInApp("")  
            .withProdSubs("")       
            .withProdAmazon("")      
            .withBillingState(StateAfterBuy.DISABLE)
            .withBilling(BillingType.AMAZON)        
            .build(::addConfigs)                    
}
private fun addConfigs() {
    AdsComponentConfig
        .updateInterstitialKey(ExampleAdMobID.ADS_CLEAR_INTERSTITIAL)
        .updateBannerKey(ExampleAdMobID.ADS_CLEAR_BANNER)
        .updateBillingMapper(
            Google.PROD_IN_APP_CONSUME_1 mapping "1000",
            Google.PROD_IN_APP_CONSUME_2 mapping "3000",
            Google.PROD_IN_APP_CONSUME_3 mapping "5000",
            Google.PROD_IN_APP_INTERSTITIAL mapping "5000",  
            Google.PROD_IN_APP_BANNER mapping "5000",  
            Google.PROD_SUBS_1 mapping "5000"   
        ).addActivitiesNonLoadBackground(AmazonIapActivity::class.java.name)
          
    BackgroundManager.attach(this)
}

Note: Đối với kotlin, khi sử dụng lazy, còn gọi lại adsComponents ở onCreate() của application để thực hiện init biến

VD:

override fun onCreate() {
    super.onCreate()
    adsComponents
}

Amazon Billing

Tương tự như Google, Amazon cũng cần config các thông số trên.

Lưu ý

Đối với trường hợp extend từ AdsApplication: add toàn bộ productID vào productInApp VD:

override val prodInAppIds: List<String>
    get() = listOf(
    Amazon.PROD_IN_APP_CONSUME_1,
    Amazon.PROD_IN_APP_CONSUME_2,
    Amazon.PROD_IN_APP_CONSUME_3,
    Amazon.PROD_ENTITLE_GOLD_DISCOUNT_1,
    Amazon.PROD_SUBS_INTERSTITIAL,
    Amazon.PROD_SUBS_BANNER
)

Trả về BillingType là BillingType.AMAZON

override val billingType: BillingType
    get() = BillingType.AMAZON

Show Interstitial, Banner

Manifest

<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="@string/ADMOB_APP_ID" />

Interstitial

1. Case extend AdsApplication

Gọi application.adsManager.forceShowInterstitial(...) VD:

ExampleAdsComponentsApplication.instance.adsComponents.adsManager.forceShowInterstitial(this, getString(R.string.interstial_ad_unit_id)) {
  // TODO: do something
}

2. Case sử dụng class `AdsComponents`

Gọi đến adsManager trong clz VD:

adsComponents.adsManager.forceShowInterstitial(...)

Banner

Sử dụng BannerAds widget VD:

<com.mmgsoft.modules.libs.widgets.BannerAds
    android:id="@+id/bannerAds"
    app:layout_constraintBottom_toBottomOf="parent"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:ba_adsUnitId="@string/banner_ad_unit_id"
    app:ba_autoLoad="true"/>

Billing Screen

Đối với Billing Google

Sử dụng PurchaseActivity VD:

PurchaseActivity.open(...)

Trong open có thể truyền vào các thuộc tính cho phù hợp với app

theme = ActionBarTheme (Hiển thị màu chữ trên thanh status bar)

enum class ActionBarTheme {
    DARK_MODE,
    LIGHT_MODE
}

colorTitle: Đặt màu chữ cho toolbar
colorHeader: Đặt màu nền cho toolbar

Đối với Billing Amazon

Sử dụng AmazonIapActivity VD:

AmazonIapActivity.open(this, AmazonScreenType.SUBSCRIPTION)

enum class AmazonScreenType {
    BUY_GOLD,
    SUBSCRIPTION
}

AmazonScreenType này để tách loại subscription và loại buy Gold ra làm 2 Đối với app, Chỉ sử dụng loại SUBSCRIPTION

Đối với Background

ChangeBackgroundActivity.open(context)

Quy trình sản xuất app

Thêm library Ads vào gradle
Thêm Google ID vào manifest
Thêm cấu hình GoogleID và keyStore
Thay đổi packageName, appName, resResource
Thay đổi ADMOB_APP_ID/banner_ad_unit_id/interstial_ad_unit_id của productFlavors -> production
Refactor code và fileName của resource ảnh
Tạo keyStore theo cấu hình
Tạo application hoặc sửa application theo các mục trên
Thêm action mở purchase và mở changeBackground
Kiểm tra các màn hình đã để background transparent chưa
Thêm forceShowInterstitial và banner vào layout
Thêm file .pem vào assets file (Chỉ với BillingType = Amazon)
Build lên và kiểm tra lại app
chụp ảnh. 4 ảnh device 7inch, 2 ảnh device 10inch, 3 ảnh device phone -> đẩy lên drive
Build app.bundle -> đẩy lên drive
Tạo file txt lưu lại toàn bộ BillingID của Google, Amazon và cấu hình bảng giá trong application -> đẩy lên drive

thangikcu / basebillingads Goto Github PK

basebillingads's Introduction