Skip to content

Latest commit

 

History

History
165 lines (133 loc) · 4.11 KB

README.md

File metadata and controls

165 lines (133 loc) · 4.11 KB

HGAdsKit

Download

HGAdsKit includes Google Ads(Firebase) and Huawei Ads capabilities. Google Ads doesn't avaliable on nonGMS devices. This situation affected most developers who want to publish their apps on Huawei App Gallery.

Goal

Google and Huawei ads can show to users in the app using the HGAdsKit. You will have completed both integrations using only HGAdsKit.

Type HMS GMS
Banner ✔️ ✔️
Interstitial ✔️ ✔️
Rewarded ✔️ ✔️
Splash
Native

Getting Started

Integrate HMS and GMS before adding the library to your project. Otherwise HGAdsKit won't work.

GMS Integration Guide HMS Integration Guide

Including in your project

Gradle:

implementation 'com.github.ekrmh:hgadskit:1.1'

Maven:

<dependency>
  <groupId>com.github.ekrmh</groupId>
  <artifactId>hgadskit</artifactId>
  <version>1.1</version>
  <type>pom</type>
</dependency>

Usage

Test Ids

Type Banner Intersitital Intersititital Video Rewarded
Huawei testw6vs28auh3 teste9ih9j0rc3 testb4znbuh3n2 testx9dtjwj8hp
Google ca-app-pub-3940256099942544/6300978111 ca-app-pub-3940256099942544/1033173712 ca-app-pub-3940256099942544/8691691433 ca-app-pub-3940256099942544/5224354917

Service Type

Get currently running service ( HUAWEI or GOOGLE)

val type = AdsCreator.getServiceType(this)

Banner

Add HGBannerView to the XML layout file

<com.ekrmh.hgadskit.ads.banner.HGBannerView  
  android:id="@+id/bannerAd"  
  android:layout_width="wrap_content"  
  android:layout_height="wrap_content" />

Configure banner ad ids and size

bannerAd.initializeAd(  
  HUAWEI_AD_ID,  
  GOOGLE_AD_ID,  
  BannerSize.BANNER_SIZE_SMART
)  

Load Ad

bannerAd.loadAd()

Interstitial

Configure

val interstitialAd = HGInterstitialAd(this)  
  
interstitialAd.initializeAd(  
  HUAWEI_AD_ID,  
  GOOGLE_AD_ID,  
)

Set AdListener (Optional)

interstitialAd.setAdListener(object: InterstitialListener {  
    override fun onAdFailed(errorCode: Int) {   }  
  
    override fun onAdClosed() {  }  
  
    override fun onAdClicked() {  }  
  
    override fun onAdLeave() {  }  
  
    override fun onAdOpened() {  }  
  
    override fun onAdImpression() {  }  
  
    override fun onAdLoaded() {  
        // Ad loaded 
        // You can show ad
    }  
})

Show

interstitialAd.showAd()  

Rewarded

Configure

val rewardedAd = HGRewardedAd(this)  
rewardedAd.initializeAd(  
  HUAWEI_AD_ID,  
  GOOGLE_AD_ID,
)

Load

rewardedAd.loadAd({  
  // Load Success
  // You can show ad
}, {  
  // Load Failure
})

Show Ad with Listener(Optional)

rewardedAd.showAd(object: RewardedListener {  
        override fun onRewardAdClosed() {  }  
        override fun onRewardAdOpened() {  }  
        override fun onRewarded(reward: Reward?) {  
	        // Reward success
	        val name = reward?.name
	        val amount = reward?.amount
        }  
        override fun onRewardAdFailedToShow(e: Int) {  }  
    })  

Licence

Copyright 2020 Ekrem Hatipoglu

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.