AyanAdManager SDK

Introduction

The AyanAdManager SDK is a robust solution for managing advertisements in Android applications. It seamlessly integrates with multiple ad providers (e.g., AdMob, HamrahAds, Adivery), enabling developers to display ads efficiently while tracking essential statistics.

---

Installation

Step 1: Add the SDK to your Project In your project-level build.gradle file, include the following repository:

repositories {
    maven { url "https://jitpack.io" }
}

In the app-level build.gradle, add the dependency:

dependencies {
    implementation 'com.github.AyanTech:AyanAds:Tag'
}

---

Getting Started

Step 1: Initialize the SDK Before using the SDK, initialize it in your Application class:

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()

        AyanAdManager.initialize(
            context = this,
            appMarket = "YOUR_APP_MARKET",
            appKey = "YOUR_APP_KEY",
            onSuccess = { Logger.d("AyanAdManager initialized successfully.") },
            onError = { Logger.e("Failed to initialize AyanAdManager: $it") }
        )
    }
}

Step 2: Display an Ad To display an ad, use the following example:

AyanAdManager.showAd(
    useDefaultNativeAdView = true,
    containerKey = "CONTAINER_KEY",
    context = this,
    adSize = BannerAdSize.BANNER_320x50, // Required for banner ad, has own default value (optional)
    adContainerId = findViewById(R.id.view)
)

Native Ad Customization

When displaying native ads, you can configure the behavior based on whether you want to use the default native ad view or customize it:

1. Use the Default Native Ad View: Set useDefaultNativeAdView = true to use the SDK's default view without customization.

   AyanAdManager.showAd(
       useDefaultNativeAdView = true,
       containerKey = "CONTAINER_KEY",
       context = this,
       adContainerId = findViewById(R.id.view)
   )

2. Customize the Default Native Ad View: Set useDefaultNativeAdView = true and provide a nativeAdAttributes object to customize the default view.

   AyanAdManager.showAd(
       useDefaultNativeAdView = true,
       containerKey = "CONTAINER_KEY",
       context = this,
       adContainerId = findViewById(R.id.view),
       nativeAdAttributes = NativeAdAttributes(
           titleColor = ContextCompat.getColor(this, R.color.black),
           buttonTextColor = Color.parseColor("#000000"),
           buttonBackgroundTint = Color.parseColor("#ffffff"),
           typeface = ResourcesCompat.getFont(this, R.font.medium)
       )
   )

3. Use a Custom Native Ad View: If you want to provide your own custom view for displaying native ads, set useDefaultNativeAdView = false and define your own layout.

   AyanAdManager.showAd(
       useDefaultNativeAdView = false,
       containerKey = "CONTAINER_KEY",
       context = this,
       adContainerId = findViewById(R.id.view)
   )

ProGuard Configuration

If you're using ProGuard, add the following rules to your ProGuard configuration file:

-keep public class ir.ayantech.hamrahads.** { *; }
-keep class ir.ayantech.ayanadmanager.model.api.** { *; }
-keep class ir.ayantech.ayanadmanager.utils.constant.** { *; }