Skip to content

khoahihi/BaseBillingAds

BranchesTags

Repository files navigation

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

  1. Override prodInAppIds Trả về danh sách product ID của loại IN_APP
  2. Override prodSubsIds Trả về danh sách product ID của loại SUBS
  3. Override billingType Trả về BillingType.AMAZON
  4. Override function onCreated Nếu cần app cần config tác vụ thì override lại hàm này
  5. 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

  1. 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
  2. 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

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

Lưu ý: với app google/amazon cần tạo ra 2 branch khác nhau, packageName và appName phải change khác nhau

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

1 star

Watchers

2 watching

Forks

1 fork
Report repository

Releases 25

0.2.5 Latest
Jul 16, 2022
+ 24 releases

Packages

No packages published

Contributors 2

  •  
  •  

Languages