Skip to content

Latest commit

 

History

History
360 lines (285 loc) · 11.8 KB

README.md

File metadata and controls

360 lines (285 loc) · 11.8 KB

Applovin-Ads

Description

This project implements various types of ads provided by Applovin, including:

  • Interstitial Ads
  • Native Manual Ads
  • Native Ad Placement
  • Native Templates
  • Banner Ads
  • App Open Ads
  • Reward Ads

It also features day and night modes for a more versatile user experience.

Screenshots

Image Image Image Image Image Image Image

Features

  • Interstitial Ads: Full-screen ads that appear at natural transition points in your app.
  • Native Manual Ads: Customizable native ads integrated manually for seamless user experience.
  • Native Ad Placement: Strategically placing native ads for optimal user engagement and visibility.
  • Native Templates: Pre-defined layouts for native ads to maintain consistent design across the app.
  • Banner Ads: Horizontal ads typically placed at the top or bottom of the screen.
  • App Open Ads: Ads are shown when the app is launched, providing immediate visibility to users.
  • Reward Ads: Users receive incentives, like in-app currency, for engaging with these ads.
  • Day/Night Modes: Toggle between light and dark themes for enhanced user comfort and accessibility.

Usage

Explain how to integrate and use the different ad types in your app. Provide code snippets, steps, or any other relevant information.

  1. Interstitial Ads
    private var interstitialAd: MaxInterstitialAd? = null
interstitialAd = MaxInterstitialAd(activity.getString(R.string.applovinInterstitial), activity)
        requestNewInterstitial(interstitialAd!!)
        if (interstitialAd!!.isReady) {
            interstitialAd!!.showAd()
            interstitialAd!!.setListener(object : MaxAdViewAdListener {
                override fun onAdExpanded(ad: MaxAd) {}
                override fun onAdCollapsed(ad: MaxAd) {
                    Log.d(TAG, "onAdCollapsed: ")

                }

                override fun onAdLoaded(ad: MaxAd) {
                    Log.d(TAG, "onAdLoaded: ")
                }

                override fun onAdDisplayed(ad: MaxAd) {}
                override fun onAdHidden(ad: MaxAd) {
                    requestNewInterstitial(interstitialAd!!)
                    Log.d(TAG, "onAdHidden: ")

                }

                override fun onAdClicked(ad: MaxAd) {}
                override fun onAdLoadFailed(adUnitId: String, error: MaxError) {
                    requestNewInterstitial(interstitialAd!!)
                    Log.d(TAG, "onAdLoadFailed: ")
                }

                override fun onAdDisplayFailed(ad: MaxAd, error: MaxError) {
                    requestNewInterstitial(interstitialAd!!)
                    Log.d(TAG, "onAdDisplayFailed: ")
                }
            })
        }
  1. Native Manual Ads
  private fun createNativeAdView(
        context: Activity,
        nativeAdLayout: FrameLayout
    ): MaxNativeAdLoader {

        val binder: MaxNativeAdViewBinder =
            MaxNativeAdViewBinder.Builder(R.layout.manual_native_view)
                .setTitleTextViewId(R.id.title_text_view)
                .setBodyTextViewId(R.id.body_text_view)
                .setAdvertiserTextViewId(R.id.advertiser_text_view)
                .setIconImageViewId(R.id.icon_image_view)
                .setMediaContentViewGroupId(R.id.media_view_container)
                .setOptionsContentViewGroupId(R.id.options_view)
                .setStarRatingContentViewGroupId(R.id.star_rating_view)
                .setCallToActionButtonId(R.id.cta_button)
                .build()
        nativeAdView = MaxNativeAdView(binder, context)
        nativeAdLoader =
            MaxNativeAdLoader(context.getString(R.string.applovinNativeManual), context)

        nativeAdLoader!!.setNativeAdListener(object : MaxNativeAdListener() {
            override fun onNativeAdLoaded(nativeAdView: MaxNativeAdView?, ad: MaxAd) {
                if (nativeAd != null) {
                    Log.d(TAG, "ifNativeAdIsNotNull: ")
                    nativeAdLoader!!.destroy(nativeAd)
                }

                nativeAd = ad
                nativeAdLayout.removeAllViews()
                nativeAdLayout.addView(nativeAdView)
            }

            override fun onNativeAdLoadFailed(adUnitId: String, error: MaxError) {
            }

            override fun onNativeAdClicked(ad: MaxAd) {

            }

            override fun onNativeAdExpired(ad: MaxAd) {
            }

        })
        return nativeAdLoader as MaxNativeAdLoader
    }
  1. Native Ad Place
  val settings = MaxAdPlacerSettings(getString(R.string.applovinNativeSmall))
        settings.addFixedPosition(2)
        settings.addFixedPosition(5)
        settings.repeatingInterval = 5

        adapter = AdPlacerAdapter(adPlacerList)
        adAdapter = MaxRecyclerAdapter(settings, adapter, requireActivity())

        adAdapter.setListener(object : MaxAdPlacer.Listener {
            override fun onAdLoaded(position: Int) {
            }

            override fun onAdRemoved(position: Int) {
            }

            override fun onAdClicked(ad: MaxAd?) {
            }

            override fun onAdRevenuePaid(ad: MaxAd?) {}
        })

        binding.recyclerView.adapter = adAdapter
        binding.recyclerView.setHasFixedSize(true)
        adAdapter.loadAds()
  1. Native Templates Ad
    private fun showNativeTemplate(context: Activity, nativeAdContainer: FrameLayout) {
        nativeAdLoader =
            MaxNativeAdLoader(context.getString(R.string.applovinNativeMedium), context)
        nativeAdLoader!!.setNativeAdListener(object : MaxNativeAdListener() {

            override fun onNativeAdLoaded(nativeAdView: MaxNativeAdView?, ad: MaxAd) {
                if (nativeAd != null) {
                    nativeAdLoader!!.destroy(nativeAd)
                }

                nativeAd = ad

                // Add ad view to view.
                nativeAdContainer.removeAllViews()
                nativeAdContainer.addView(nativeAdView)
            }

            override fun onNativeAdLoadFailed(adUnitId: String, error: MaxError) {
            }

            override fun onNativeAdClicked(ad: MaxAd) {
            }
        })
        nativeAdLoader!!.loadAd()
    }
  1. Banner Ad
    override fun createBannerAd(context: Activity, banner: FrameLayout) {
        adView = MaxAdView(context.getString(R.string.applovinBanner), context)

        /*if you want to set background color.
            adView?.setBackgroundColor(...)
         */
        banner.addView(adView)
        adView!!.loadAd()
        adView!!.startAutoRefresh()
        adView!!.setListener(object : MaxAdViewAdListener {
            override fun onAdLoaded(p0: MaxAd?) {
                Log.d(TAG, "onAdLoaded: Banner")
            }

            override fun onAdDisplayed(p0: MaxAd?) {
                Log.d(TAG, "onAdDisplayed: Banner")
            }

            override fun onAdHidden(p0: MaxAd?) {
                Log.d(TAG, "onAdHidden: Banner")
            }

            override fun onAdClicked(p0: MaxAd?) {
                Log.d(TAG, "onAdClicked: Banner")
            }

            override fun onAdLoadFailed(p0: String?, p1: MaxError?) {
                Log.d(TAG, "onAdLoadFailed: Banner ${p1!!.message}")
            }

            override fun onAdDisplayFailed(p0: MaxAd?, p1: MaxError?) {
                Log.d(TAG, "onAdDisplayFailed: Banner ${p1!!.message}")
            }

            override fun onAdExpanded(p0: MaxAd?) {
                Log.d(TAG, "onAdExpanded: Banner")
            }

            override fun onAdCollapsed(p0: MaxAd?) {
                Log.d(TAG, "onAdCollapsed: Banner")
            }

        })
    }
  1. App Open Ad
class AppOpenManager(applicationContext: Context) : LifecycleObserver, MaxAdListener {
    private var appOpenAd: MaxAppOpenAd
    private var context = applicationContext


    init {
        ProcessLifecycleOwner.get().lifecycle.addObserver(this)
        context.let {
            appOpenAd = MaxAppOpenAd(context.getString(R.string.applovinOpen), it)
            appOpenAd.setListener(this)
            appOpenAd.loadAd()
        }
    }

    fun showAdIfReady() {
        if (!AppLovinSdk.getInstance(context).isInitialized) return
        appOpenAd?.let {
            if (appOpenAd.isReady) {
                appOpenAd.showAd()
            } else {
                appOpenAd.loadAd()
            }
        }
    }

    @OnLifecycleEvent(Lifecycle.Event.ON_START)
    fun onStart() {
        showAdIfReady()
    }

    override fun onAdLoaded(ad: MaxAd) {
    }

    override fun onAdLoadFailed(adUnitId: String, error: MaxError) {
        appOpenAd.loadAd()
    }

    override fun onAdDisplayed(ad: MaxAd) {
        appOpenAd.loadAd()
    }

    override fun onAdClicked(ad: MaxAd) {}

    override fun onAdHidden(ad: MaxAd) {
        appOpenAd.loadAd()
    }

    override fun onAdDisplayFailed(ad: MaxAd, error: MaxError) {
        appOpenAd.loadAd()
    }

}
  1. Reward Ad
class RewardedAds(private val context: Activity) : MaxRewardedAdListener {
    private lateinit var rewardedAd: MaxRewardedAd
    private var retryAttempt = 0.0


    fun createRewardedAd() {
        rewardedAd = MaxRewardedAd.getInstance(context.getString(R.string.applovinReward), context)
        rewardedAd.setListener(this)
        rewardedAd.loadAd()
        if (rewardedAd.isReady) {
            rewardedAd.showAd()
        } else {
            Toast.makeText(
                context,
                context.getString(R.string.reward_ad_is_not_ready_yet), Toast.LENGTH_SHORT
            ).show()
        }
    }

    override fun onAdLoaded(maxAd: MaxAd) {
        retryAttempt = 0.0
    }

    override fun onAdLoadFailed(adUnitId: String?, error: MaxError?) {
        Toast.makeText(context, error!!.message.toString(), Toast.LENGTH_SHORT).show()
        retryAttempt++
        rewardedAd.loadAd()
    }

    override fun onAdDisplayFailed(ad: MaxAd?, error: MaxError?) {
        rewardedAd.loadAd()
    }

    override fun onAdDisplayed(maxAd: MaxAd) {}

    override fun onAdClicked(maxAd: MaxAd) {}

    override fun onAdHidden(maxAd: MaxAd) {
        rewardedAd.loadAd()
    }

    override fun onRewardedVideoStarted(maxAd: MaxAd) {}

    override fun onRewardedVideoCompleted(maxAd: MaxAd) {

    }

    override fun onUserRewarded(maxAd: MaxAd, maxReward: MaxReward) {

    }
}

Installation

Clone the repository and run the app in your IDE:

Clone repository to run app

you can download whole code as zip file:

Click here to download code as zip

or download demo app for testing purpse:

Download Demo App

How to Contribute

If you would like to contribute to the project, follow these steps:

  1. Fork the repository
  2. Create a new branch (git checkout -b feature/your-feature)
  3. Make your changes and commit them (git commit -m 'Add some feature')
  4. Push to the branch (git push origin feature/your-feature)
  5. Create a pull request

Don't Forget to Star ⭐

If you found this project useful or had fun exploring it, please consider giving it a star. It's a great way to show your appreciation and it puts a smile on my face! 😊🌟